AI Hiring Manager Chatbot

An intelligent hiring manager chatbot that evaluates resumes against job descriptions and conducts automated interviews with advanced PDF processing capabilities.

Description

Transform your hiring process with the AI Hiring Manager Chatbot - a comprehensive WordPress plugin that automates candidate screening through intelligent conversation and document analysis with advanced PDF text extraction and honest scoring.

Key Features

For Candidates:

• Interactive chatbot interface for seamless user experience
• Secure PDF upload for job descriptions and resumes
• Automated resume analysis against job requirements with real PDF content extraction
• Multi-stage interview process with personalized questions
• Contextual responses based on actual job description content
• Complete interview transcript download

For Employers:

• Comprehensive admin dashboard with interview statistics
• Complete conversation management and search
• PDF content extraction and display in backend
• Bulk file downloads and data export
• Customizable fallback questions database
• Multiple AI provider support (Claude, OpenAI, or simulated responses)
• Advanced PDF processing diagnostics with honest feedback

Enhanced Analysis System

Version 1.8.7 introduces intelligent analysis modes:

• Full Analysis: When both PDFs extract successfully - detailed content comparison with accurate scoring
• Partial Analysis: When only one PDF extracts - honest feedback about limitations
• Fallback Mode: When neither PDF extracts - clear explanation and guidance for users

Interview Process

1. Information Collection - Candidate provides basic details (comma-separated format supported)
2. Document Upload - Secure upload of job description and resume PDFs
3. Intelligent Analysis - AI-powered comparison and scoring with real PDF content or honest feedback when extraction fails
4. Interview Questions - Intelligent question validation with retry logic:
   • Personality & Work Style
   • Motivation & Goals
   • Strengths & Contributions
5. Scenario Questions - Job-specific situational questions
6. Q&A Session - Candidates can ask about the position (answers based on actual job description when available)
7. Completion - Summary and transcript generation

PDF Processing

The plugin includes advanced PDF text extraction capabilities:

• Multiple extraction methods - Smalot PDFParser, pdftotext command-line tool
• Intelligent fallback system - graceful degradation when extraction fails
• Honest user feedback - clear communication about processing limitations
• Real-time content analysis for contextual chatbot responses
• Backend content preview for administrators
• Comprehensive diagnostics to verify server PDF processing capabilities

Installation

Automatic Installation

1. Log in to your WordPress admin panel
2. Go to Plugins > Add New
3. Search for "AI Hiring Manager Chatbot"
4. Click "Install Now" and then "Activate"

Manual Installation

1. Download the plugin ZIP file
2. Go to Plugins > Add New > Upload Plugin
3. Choose the ZIP file and click "Install Now"
4. Activate the plugin
5. Add the shortcode [ai_hiring_chatbot] to any page or post

PDF Processing Setup

For optimal PDF text extraction, install the Smalot PDFParser library:

1. Navigate to your plugin directory: /wp-content/plugins/ai-hiring-manager-chatbot/
2. Run: composer require smalot/pdfparser
3. Or contact your hosting provider for assistance

The plugin includes diagnostics to check your server's PDF processing capabilities and provides honest feedback when processing isn't possible.

Frequently Asked Questions

What file formats are supported?

The plugin supports PDF files only for both job descriptions and resumes. The PDF files should contain selectable text (not scanned images) for optimal text extraction. When text extraction fails, the plugin provides clear feedback and continues with the interview process.

How do I check if my server can process PDFs?

Use the built-in PDF Diagnostics page in the admin area to check your server's capabilities and get installation instructions for PDF processing tools.

What happens if PDF extraction fails?

Version 1.8.7 handles this gracefully with honest feedback. The chatbot will clearly explain when it cannot extract text from PDFs (usually due to scanned images) and continue with a meaningful interview based on candidate responses.

Can I customize the interview questions?

Yes! The plugin includes a Questions management page where you can add, edit, and organize fallback questions by category (personality, motivation, scenario).

What AI providers are supported?

The plugin supports Claude (Anthropic), OpenAI (GPT), and simulated responses as fallback. Configure your preferred provider in the Settings page.

How does the comma-separated input work?

Candidates can provide their information in the format: FirstName, LastName, email@domain.com

Is candidate data secure?

Yes. The plugin follows WordPress security best practices with validated uploads, sanitized data, and secure file storage with .htaccess protection.

Changelog

1.8.7

• CRITICAL FIX: Resolved PHP syntax error that was causing site crashes and displaying code on pages
• ENHANCED: Completely rewritten PDF text extraction system with multiple fallback methods
• NEW: Intelligent analysis modes - Full/Partial/Fallback based on PDF extraction success
• IMPROVED: Honest scoring system - no more false scores when PDF extraction fails
• IMPROVED: Enhanced user feedback about document processing status with clear explanations
• IMPROVED: Better error handling and comprehensive logging throughout analysis process
• FIXED: Chatbot no longer provides generic responses when it should indicate PDF processing issues
• ADDED: Multiple PDF extraction methods (Smalot PDFParser, pdftotext command-line)
• ADDED: Text content validation to ensure meaningful extraction
• IMPROVED: Graceful degradation when PDF processing tools are unavailable

1.8.6

• NEW: Enhanced PDF text extraction using Smalot PDFParser
• NEW: Composer autoloader integration for proper library loading
• NEW: Backend PDF content preview in conversation details
• IMPROVED: Contextual chatbot responses based on actual job description content
• IMPROVED: Comprehensive PDF processing diagnostics
• FIX: Resolved PDF extraction showing binary data instead of text
• Added debug logging for PDF processing troubleshooting
• Enhanced error handling for PDF library loading

1.8.5

• FIX: Resolved chatbot getting stuck at personality questions - input now enabled
• FIX: Enhanced step transition logic for all question types
• FIX: Improved JavaScript input handling and send button activation
• FIX: Added support for motivation_question and strengths_question steps
• Enhanced admin menu initialization
• Better error handling in step determination
• Improved chatbot flow for all interview stages

1.8.4

• MAJOR FIX: Corrected post type name length (reduced from 21 to 13 characters)
• NEW: Intelligent response validation requiring substantial answers
• NEW: Question skip functionality with "skip this question" command
• NEW: Contextual response generation based on answer content
• NEW: Keyword analysis for meaningful feedback
• IMPROVED: Enhanced question answering with job-specific responses
• IMPROVED: Better error handling and response quality validation
• Fixed step progression to prevent advancement on low-effort responses

1.8.3

• FIX: Resolved chatbot getting stuck at personality questions - input now enabled
• FIX: Enhanced step transition logic for all question types
• FIX: Improved JavaScript input handling and send button activation
• FIX: Added support for motivation_question and strengths_question steps
• Enhanced admin menu initialization
• Better error handling in step determination
• Improved chatbot flow for all interview stages

1.8.2

• EMERGENCY HOTFIX: Fixed critical SQL syntax errors causing site crashes
• CRITICAL: Fixed PHP parse error in chatbot class (line 378)
• Completely rewrote database class with proper error handling
• Removed problematic foreign key constraints that caused MariaDB errors
• Enhanced exception handling throughout all database operations
• Fixed string concatenation issues in scenario questions
• Improved activation safety with comprehensive try-catch blocks
• All database operations now have fallback mechanisms

1.8.1

• CRITICAL HOTFIX: Fixed fatal error that could crash websites
• Added comprehensive error handling and safety checks
• Removed problematic foreign key constraints from database
• Enhanced fallback mechanisms with try-catch blocks
• Improved activation error handling to prevent site crashes
• Added graceful degradation when database features unavailable

1.8.0

• NEW FEATURE: Added admin interface for managing fallback questions
• NEW: Database storage for customizable interview questions
• FIX: Resolved chatbot getting stuck after file upload analysis
• Added Questions management page in admin menu
• Enhanced fallback system with database-driven questions
• Improved auto-progression from file upload to analysis
• Added question categorization (personality, motivation, scenario)
• Admins can now add, edit, delete, and organize fallback questions
• Better error handling and question generation reliability

1.7.0

• FIX: Resolved issue where personality question was not displaying after resume analysis
• Enhanced fallback question generation system
• Added more diverse personality and scenario questions
• Improved error handling when AI service fails to generate questions
• Ensured chatbot never gets stuck waiting for missing content
• Enhanced question variety and quality

1.6.0

• CRITICAL FIX: Completely resolved PHP syntax error causing code to display on admin pages
• Rebuilt chatbot class with proper syntax and error handling
• Enhanced AI integration with improved fallback mechanisms
• Fixed string concatenation issues in dynamic responses
• Improved code structure and readability
• Updated version numbering system for better tracking

1.5.0

• CRITICAL FIX: Fixed PHP code appearing at top of WordPress admin pages
• Fixed incomplete code block in chatbot class
• Ensured Claude API key field is properly displayed in settings
• Improved code structure and formatting
• Enhanced error handling for AI service integration

1.4.0

• MAJOR UPDATE: Added support for multiple AI providers
• Added Claude (Anthropic) API integration for superior conversation quality
• Added OpenAI (GPT) API integration as alternative option
• Enhanced settings page with AI provider selection
• Intelligent document analysis using real AI (when API keys provided)
• Dynamic question generation based on job descriptions
• Contextual feedback and responses powered by AI
• Graceful fallback to simulated responses when no API key configured
• Improved admin interface with provider comparison information

1.3.0

• Enhanced input validation for user information collection
• Added validation for empty first name, last name, or email fields
• Improved step progression logic to prevent advancement without complete information
• Added minimum length validation for names (2 characters minimum)
• Enhanced error messages with clearer formatting instructions
• Added confirmation display of collected user information

1.2.0

• Fixed syntax error in chatbot class preventing plugin activation
• Improved dependency loading during activation
• Enhanced error handling for class loading
• Fixed string concatenation issue in scenario questions

1.1.0

• Fixed plugin activation error by loading dependencies before database operations
• Updated author information
• Improved error handling during plugin activation

1.0.0

• Initial release
• Interactive chatbot functionality
• PDF file upload system
• Automated resume analysis
• Multi-stage interview process
• Admin dashboard and conversation management

Upgrade Notice

1.8.7

Critical syntax fix and major PDF processing improvements. Sites experiencing crashes or displaying PHP code should update immediately. Enhanced honest scoring and user feedback systems.

1.8.6

Major update with enhanced PDF processing capabilities. Install Smalot PDFParser for optimal functionality: composer require smalot/pdfparser

1.8.4

Important fix for post type name length issues. Plugin may need reactivation after update.

1.8.2

Critical security and stability update. Backup your database before updating.

1.8.0

New admin interface for question management. Existing questions will be preserved during update.