example-usage.php

<?php
/**
 * Resume Parser Plugin - Example Usage
 * 
 * This file demonstrates how to use the Resume Parser plugin
 * in various scenarios and integrations.
 */

// Prevent direct access
if (!defined('ABSPATH')) {
    exit;
}

/**
 * Example 1: Basic shortcode usage in a WordPress page/post
 */
function example_basic_shortcode() {
    // Add this shortcode to any page or post content
    return '[resume_parser]';
}

/**
 * Example 2: Advanced shortcode with custom fields and API
 */
function example_advanced_shortcode() {
    // Custom fields and API endpoint
    return '[resume_parser fields="name,email,phone,experience,education,skills,summary,address" api_endpoint="https://api.resumeparser.com/parse" class="job-application-form"]';
}

/**
 * Example 3: Programmatic shortcode rendering
 */
function example_programmatic_usage() {
    $atts = array(
        'fields' => 'name,email,phone,experience',
        'api_endpoint' => 'https://your-api.com/parse',
        'class' => 'resume-form'
    );
    
    return do_shortcode('[resume_parser fields="' . $atts['fields'] . '" api_endpoint="' . $atts['api_endpoint'] . '" class="' . $atts['class'] . '"]');
}

/**
 * Example 4: Custom form integration
 */
function example_custom_form_integration() {
    ob_start();
    ?>
    <form id="job-application-form" method="post" action="">
        <h3>Job Application Form</h3>
        
        <!-- Resume Parser Shortcode -->
        <?php echo do_shortcode('[resume_parser fields="name,email,phone,experience,education,skills"]'); ?>
        
        <!-- Additional custom fields -->
        <div class="form-group">
            <label for="position">Position Applied For:</label>
            <select id="position" name="position" required>
                <option value="">Select Position</option>
                <option value="developer">Software Developer</option>
                <option value="designer">UI/UX Designer</option>
                <option value="manager">Project Manager</option>
            </select>
        </div>
        
        <div class="form-group">
            <label for="salary_expectation">Salary Expectation:</label>
            <input type="text" id="salary_expectation" name="salary_expectation" placeholder="e.g., $80,000 - $100,000">
        </div>
        
        <div class="form-group">
            <label for="cover_letter">Cover Letter:</label>
            <textarea id="cover_letter" name="cover_letter" rows="6" placeholder="Tell us why you're perfect for this role..."></textarea>
        </div>
        
        <div class="form-group">
            <input type="submit" value="Submit Application" class="submit-btn">
        </div>
    </form>
    
    <style>
    #job-application-form {
        max-width: 600px;
        margin: 20px auto;
        padding: 20px;
        background: #f9f9f9;
        border-radius: 8px;
    }
    
    .form-group {
        margin-bottom: 20px;
    }
    
    .form-group label {
        display: block;
        margin-bottom: 5px;
        font-weight: bold;
    }
    
    .form-group input,
    .form-group select,
    .form-group textarea {
        width: 100%;
        padding: 10px;
        border: 1px solid #ddd;
        border-radius: 4px;
        font-size: 14px;
    }
    
    .submit-btn {
        background: #007cba;
        color: white;
        border: none;
        padding: 12px 30px;
        border-radius: 4px;
        cursor: pointer;
        font-size: 16px;
    }
    
    .submit-btn:hover {
        background: #005a87;
    }
    </style>
    <?php
    return ob_get_clean();
}

/**
 * Example 5: Contact Form 7 Integration
 */
function example_cf7_integration() {
    // Create a Contact Form 7 form with resume parser
    $form_content = '
    <h3>Contact Form with Resume Parser</h3>
    
    [resume_parser fields="name,email,phone"]
    
    <label>Your Message
        [textarea your-message placeholder "Your message here..."]
    </label>
    
    <label>Subject
        [text your-subject placeholder "Subject"]
    </label>
    
    [submit "Send Message"]
    ';
    
    return $form_content;
}

/**
 * Example 6: Custom API endpoint handler
 */
function example_custom_api_endpoint() {
    // This would be your custom API endpoint that receives resume data
    
    if ($_SERVER['REQUEST_METHOD'] === 'POST') {
        $input = json_decode(file_get_contents('php://input'), true);
        
        if (isset($input['file_data'])) {
            // Decode the base64 file data
            $file_content = base64_decode($input['file_data']);
            
            // Here you would integrate with your resume parsing service
            // For example, using a third-party API like HireAbility, Sovren, etc.
            
            $parsed_data = parse_resume_with_external_service($file_content, $input['file_type']);
            
            if ($parsed_data) {
                header('Content-Type: application/json');
                echo json_encode($parsed_data);
            } else {
                http_response_code(400);
                echo json_encode(['error' => true, 'message' => 'Failed to parse resume']);
            }
        }
    }
}

/**
 * Example resume parsing function (mock implementation)
 */
function parse_resume_with_external_service($file_content, $file_type) {
    // This is a mock function - replace with actual API integration
    
    // Example using a hypothetical resume parsing API
    $api_url = 'https://api.resumeparser.com/v1/parse';
    $api_key = 'your-api-key';
    
    $post_data = array(
        'file_content' => base64_encode($file_content),
        'file_type' => $file_type,
        'output_format' => 'json'
    );
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $api_url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($post_data));
    curl_setopt($ch, CURLOPT_HTTPHEADER, array(
        'Content-Type: application/json',
        'Authorization: Bearer ' . $api_key
    ));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    return json_decode($response, true);
}

/**
 * Example 7: WordPress hook integrations
 */

// Hook into resume parsing success
add_action('resume_parser_after_success', function($parsed_data) {
    // Save resume data to user meta or custom table
    if (is_user_logged_in()) {
        $user_id = get_current_user_id();
        update_user_meta($user_id, 'parsed_resume_data', $parsed_data);
    }
    
    // Send notification email to admin
    wp_mail(
        get_option('admin_email'),
        'New Resume Parsed',
        'A new resume has been parsed with the following data: ' . print_r($parsed_data, true)
    );
});

// Modify allowed file types
add_filter('resume_parser_allowed_types', function($types) {
    // Add text files to allowed types
    $types[] = 'text/plain';
    return $types;
});

// Customize API request data
add_filter('resume_parser_api_data', function($data, $file_info) {
    // Add additional metadata
    $data['timestamp'] = current_time('timestamp');
    $data['user_id'] = is_user_logged_in() ? get_current_user_id() : 0;
    $data['ip_address'] = $_SERVER['REMOTE_ADDR'];
    
    return $data;
}, 10, 2);

/**
 * Example 8: AJAX handler for custom processing
 */
add_action('wp_ajax_custom_resume_processing', 'handle_custom_resume_processing');
add_action('wp_ajax_nopriv_custom_resume_processing', 'handle_custom_resume_processing');

function handle_custom_resume_processing() {
    // Verify nonce
    if (!wp_verify_nonce($_POST['nonce'], 'custom_resume_nonce')) {
        wp_die('Security check failed');
    }
    
    // Get the parsed resume data
    $resume_data = $_POST['resume_data'];
    
    // Custom processing logic
    $processed_data = array();
    
    // Example: Extract skills and match with job requirements
    if (isset($resume_data['skills'])) {
        $skills = explode(',', $resume_data['skills']);
        $required_skills = array('PHP', 'JavaScript', 'WordPress', 'MySQL');
        
        $matched_skills = array_intersect($skills, $required_skills);
        $processed_data['skill_match_percentage'] = (count($matched_skills) / count($required_skills)) * 100;
        $processed_data['matched_skills'] = $matched_skills;
    }
    
    // Example: Calculate experience level
    if (isset($resume_data['experience'])) {
        $experience_text = strtolower($resume_data['experience']);
        $years = 0;
        
        if (preg_match('/(\d+)\s*years?/', $experience_text, $matches)) {
            $years = intval($matches[1]);
        }
        
        $processed_data['experience_years'] = $years;
        
        if ($years < 2) {
            $processed_data['experience_level'] = 'Junior';
        } elseif ($years < 5) {
            $processed_data['experience_level'] = 'Mid-level';
        } else {
            $processed_data['experience_level'] = 'Senior';
        }
    }
    
    wp_send_json_success($processed_data);
}

/**
 * Example 9: Shortcode in widget
 */
function example_widget_integration() {
    // Add this to your theme's functions.php to create a custom widget
    
    class Resume_Parser_Widget extends WP_Widget {
        
        public function __construct() {
            parent::__construct(
                'resume_parser_widget',
                'Resume Parser Widget',
                array('description' => 'Add a resume parser form to your sidebar')
            );
        }
        
        public function widget($args, $instance) {
            echo $args['before_widget'];
            
            if (!empty($instance['title'])) {
                echo $args['before_title'] . apply_filters('widget_title', $instance['title']) . $args['after_title'];
            }
            
            $fields = !empty($instance['fields']) ? $instance['fields'] : 'name,email,phone';
            echo do_shortcode('[resume_parser fields="' . $fields . '"]');
            
            echo $args['after_widget'];
        }
        
        public function form($instance) {
            $title = !empty($instance['title']) ? $instance['title'] : 'Upload Resume';
            $fields = !empty($instance['fields']) ? $instance['fields'] : 'name,email,phone';
            ?>
            <p>
                <label for="<?php echo $this->get_field_id('title'); ?>">Title:</label>
                <input class="widefat" id="<?php echo $this->get_field_id('title'); ?>" name="<?php echo $this->get_field_name('title'); ?>" type="text" value="<?php echo esc_attr($title); ?>">
            </p>
            <p>
                <label for="<?php echo $this->get_field_id('fields'); ?>">Fields:</label>
                <input class="widefat" id="<?php echo $this->get_field_id('fields'); ?>" name="<?php echo $this->get_field_name('fields'); ?>" type="text" value="<?php echo esc_attr($fields); ?>">
            </p>
            <?php
        }
        
        public function update($new_instance, $old_instance) {
            $instance = array();
            $instance['title'] = (!empty($new_instance['title'])) ? strip_tags($new_instance['title']) : '';
            $instance['fields'] = (!empty($new_instance['fields'])) ? strip_tags($new_instance['fields']) : '';
            return $instance;
        }
    }
    
    // Register the widget
    add_action('widgets_init', function() {
        register_widget('Resume_Parser_Widget');
    });
}

/**
 * Example 10: Page template integration
 */
function example_page_template() {
    // Create a custom page template: page-job-application.php
    
    $template_content = '
    <?php
    /*
    Template Name: Job Application
    */
    
    get_header(); ?>
    
    <div id="primary" class="content-area">
        <main id="main" class="site-main">
            <article class="page job-application-page">
                <header class="page-header">
                    <h1 class="page-title">Job Application</h1>
                </header>
                
                <div class="page-content">
                    <p>Please upload your resume to auto-fill the application form:</p>
                    
                    <!-- Resume Parser Integration -->
                    <?php echo do_shortcode(\'[resume_parser fields="name,email,phone,experience,education,skills,summary"]\'); ?>
                    
                    <!-- Additional application fields -->
                    <div class="additional-fields">
                        <h3>Additional Information</h3>
                        <form id="application-form" method="post">
                            <div class="form-row">
                                <label for="position">Position:</label>
                                <select id="position" name="position" required>
                                    <option value="">Select Position</option>
                                    <option value="frontend">Frontend Developer</option>
                                    <option value="backend">Backend Developer</option>
                                    <option value="fullstack">Full Stack Developer</option>
                                </select>
                            </div>
                            
                            <div class="form-row">
                                <label for="availability">Start Date:</label>
                                <input type="date" id="availability" name="availability" required>
                            </div>
                            
                            <div class="form-row">
                                <button type="submit">Submit Application</button>
                            </div>
                        </form>
                    </div>
                </div>
            </article>
        </main>
    </div>
    
    <?php get_footer(); ?>
    ';
    
    return $template_content;
}

// Initialize examples if called directly (for testing)
if (defined('WP_CLI') && WP_CLI) {
    // WP-CLI commands for testing
    WP_CLI::add_command('resume-parser test', function() {
        WP_CLI::success('Resume Parser Plugin examples loaded successfully!');
    });
}