📋 Overview

The IC HR ERP Extension plugin provides complete Human Resources management system integration with WP ERP Free. This plugin enables you to:

Key Benefits

• Streamline Hiring: Automate the entire applicant tracking process
• Employee Self-Service: Reduce HR administrative workload
• Professional Branding: Customizable email templates with company branding
• Data Security: Secure applicant data with proper access controls
• Compliance Ready: Age verification and data protection features

⚙️ Requirements

WordPress Requirements

• WordPress 6.2 or higher
• PHP 7.4 or higher
• File upload permissions enabled

Required Plugins

Server Requirements

• PHP file uploads enabled
• PDF MIME type supported
• Minimum 100MB disk space for resumes
• Email sending capability (SMTP recommended)

🚀 Installation

Step 1: Install Required Plugins

1. Install and activate WP ERP Free from WordPress.org
2. Install and activate Simple Cloudflare Turnstile from WordPress.org
3. Configure Cloudflare Turnstile with your Site Key and Secret Key

Step 2: Install IC HR ERP Extension

1. Upload the plugin files to the /wp-content/plugins/ic-hr-erp-extension directory
2. Activate the plugin through the ‘Plugins’ screen in WordPress
3. The setup wizard will guide you through initial configuration

Step 3: Initial Setup Wizard

Upon activation, you’ll be redirected to the setup wizard:

1. Configure Email Settings: Set admin notification email, from name/email
2. Company Information: Enter your company name for branding
3. Age & File Settings: Set minimum applicant age and maximum file size
4. Complete Setup: Save settings to finish initial configuration

/hr-portal

[employee_portal]

⚙️ Configuration

Plugin Settings

Navigate to HR Management → Settings to configure:

Required Fields

Fields marked with * are required for plugin functionality:

• Admin Notification Email
• From Name
• From Email
• Company Name

HR Portal Page

The plugin automatically creates and manages the HR Portal page:

• URL: https://yoursite.com/hr-portal
• Content: [employee_portal] shortcode
• Access: Employees only (requires login with employee role)
• Management: Page is automatically updated if modified

🎯 Usage

Applicant Form Shortcode

Employee Portal Shortcode

Form Placement Examples

<div class="job-application-page">
<h1>Join Our Team</h1>
<p>We're always looking for talented individuals to join our company.</p>
[applicant_form]
</div>

<div class="careers-page">
<h1>Career Opportunities</h1>
<div class="job-listings">
<!-- Your job listings here -->
</div>
<div class="application-section">
<h2>Apply Now</h2>
<p>See a position that fits your skills? Submit your application.</p>
[applicant_form]
</div>
</div>

HR Portal Page

The plugin automatically creates the HR Portal page at /hr-portal. You can also manually create additional employee portal pages:

<!-- Custom Employee Portal Page -->
<div class="employee-resources">
<h1>Employee Resources</h1>
<p>Welcome to the employee resource portal.</p>
[employee_portal]
</div>

Managing Applicants

Access the applicant management system:

1. Go to HR Management → Applicants in WordPress admin
2. View applicants by status: Pending, Reviewed, Approved, Rejected
3. Click on any applicant to view full details and resume
4. Update applicant status with one click
5. Convert approved applicants to employees automatically

Employee Management

Once applicants are converted to employees:

• Employees are automatically assigned the “employee” role
• Admin bar is hidden for employees (cleaner interface)
• Employees are redirected to HR Portal after login
• Employee access is restricted to frontend only

Form Styling

The plugin includes responsive CSS styling. For custom styling:

/* Custom form styling */
#applicant-form-container {
    max-width: 800px;
    margin: 0 auto;
}

#applicant-form-container .form-section {
    background: white;
    padding: 25px;
    border-radius: 8px;
    box-shadow: 0 2px 10px rgba(0,0,0,0.1);
    margin-bottom: 30px;
}

#applicant-form-container .form-row {
    display: flex;
    gap: 20px;
    margin-bottom: 20px;
}

#applicant-form-container .form-group {
    flex: 1;
}

#applicant-form-container label {
    display: block;
    margin-bottom: 8px;
    font-weight: 600;
    color: #333;
}

#applicant-form-container input,
#applicant-form-container select,
#applicant-form-container textarea {
    width: 100%;
    padding: 12px;
    border: 1px solid #ddd;
    border-radius: 4px;
    font-size: 16px;
}

#applicant-form-container input:focus,
#applicant-form-container select:focus,
#applicant-form-container textarea:focus {
    border-color: #0073aa;
    outline: none;
    box-shadow: 0 0 0 3px rgba(0, 115, 170, 0.1);
}

/* Success message styling */
.success-message {
    background: #f0fff0;
    border: 2px solid #00cc00;
    padding: 30px;
    border-radius: 8px;
    text-align: center;
    margin: 20px 0;
}

.spanish-message {
    background: #f8f9fa;
    border: 1px solid #dee2e6;
    padding: 20px;
    border-radius: 8px;
    margin-top: 20px;
}

🔧 Troubleshooting

Common Issues

Plugin Conflict Testing

If experiencing issues:

1. Deactivate all other plugins temporarily
2. Test HR ERP Extension functionality
3. Reactivate plugins one by one to identify conflicts
4. Test with default WordPress theme

Database Issues

// Check database tables exist:
wp_icllc_hr_applicants
wp_icllc_hr_documents

// Check required options are set:
icllc_hr_admin_email
icllc_hr_from_name  
icllc_hr_from_email
icllc_hr_company_name
icllc_hr_setup_complete
            

🔗 API Reference

AJAX Endpoints

The plugin uses AJAX for form processing:

Custom Integration Examples

<form id="custom-application-form">
    <input type="text" name="first_name" placeholder="First Name" required>
    <input type="text" name="last_name" placeholder="Last Name" required>
    <input type="email" name="email" placeholder="Email" required>
    <input type="tel" name="phone" placeholder="Phone" required>
    <!-- Add other required fields -->
    <!-- Turnstile container -->
    <div class="cf-turnstile" data-sitekey="your-site-key"></div>
    <button type="submit">Submit Application</button>
</form>

<script>
jQuery('#custom-application-form').on('submit', function(e) {
    e.preventDefault();
    
    var formData = new FormData(this);
    formData.append('action', 'submit_application');
    formData.append('cf-turnstile-response', jQuery('[name="cf-turnstile-response"]').val());
    
    jQuery.ajax({
        url: '',
        type: 'POST',
        data: formData,
        processData: false,
        contentType: false,
        success: function(response) {
            if (response.success) {
                // Show success message
                jQuery('#custom-application-form').html(
                    '<div class="success-message">' +
                    '<h2>Application Submitted!</h2>' +
                    '<p>' + response.data.message_english + '</p>' +
                    '</div>'
                );
            } else {
                alert('Error: ' + response.data);
            }
        }
    });
});
</script>
                

💬 Support

Getting Help

If you need assistance with the IC HR ERP Extension plugin:

Contact Information

• Website: IC HR ERP Extension
• Support: Contact Form
• GitHub: Source Code & Issues
• License: GPL v2 or later