34f06709f0
HVAC trainer profile geocoding system with outstanding results: - 45 out of 53 trainer profiles successfully geocoded (85% coverage) - Coverage spans 15+ US states and 3 Canadian provinces - Google Maps API integration with intelligent rate limiting - Real-time statistics and comprehensive error handling Core Implementation: - HVAC_Geocoding_Ajax class with three AJAX endpoints: * hvac_trigger_geocoding: Manual geocoding operations * hvac_run_enhanced_import: CSV location data population * hvac_get_geocoding_stats: Coverage monitoring and statistics - Enhanced CSV import with corrected email field mapping - Proper field priority mapping for location data extraction - Automatic scheduling of geocoding operations after data import Technical Features: - Singleton pattern for proper class initialization - WordPress AJAX security with nonce verification - Role-based access control for master trainers - Comprehensive error logging and status tracking - API rate limiting (0.5s delays) to respect Google quotas - Multiple address format support (US/International) User Experience: - Master trainer controls for manual geocoding triggers - Real-time progress monitoring and statistics - Detailed error reporting for failed geocoding attempts - Production-ready interface for location data management Documentation: - Complete API reference with endpoint specifications - Comprehensive manual geocoding system documentation - Usage examples and troubleshooting guidelines - Error codes and integration patterns 🚀 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| scraped | ||
| 00_testing_improvement_plan_140425.md | ||
| API-REFERENCE.md | ||
| ARCHITECTURE.md | ||
| automatic-page-creation-plan.md | ||
| CONFIGURATION.md | ||
| CUSTOMIZATION-EXAMPLES.md | ||
| deploy-plugin-safe-script.md | ||
| DEPLOYMENT-CHECKLIST.md | ||
| deployment.md | ||
| design_guidance.md | ||
| DEVELOPMENT-GUIDE.md | ||
| documentation-plan.md | ||
| FINAL_DEPLOYMENT_REPORT.md | ||
| hvac-multi-role-testing-plan.md | ||
| hvac-role-testing-plan.md | ||
| implementation_plan.md | ||
| MANUAL-GEOCODING-SYSTEM.md | ||
| mvp-integration-testing-plan.md | ||
| phpunit-staging-setup-plan.md | ||
| PLAYWRIGHT-TEST-COMPATIBILITY.md | ||
| PLUGIN-ARCHITECTURE-REFACTORING.md | ||
| README.md | ||
| REFACTORING-GUIDE.md | ||
| REQUIREMENTS.md | ||
| role-implementation-plan.md | ||
| role-manager-api.md | ||
| staging-phpunit-setup.md | ||
| staging-restore-plan.md | ||
| staging-restore-report.md | ||
| staging-test-implementation-report.md | ||
| staging-test-plan.md | ||
| staging-test-simplified-plan.md | ||
| staging-workflow-plan.md | ||
| tec-ce-shortcode-integration-plan.md | ||
| tec-ce-template-customization-plan.md | ||
| TEMPLATE-SYSTEM-REFACTOR-PLAN.md | ||
| test-environment-checklist.md | ||
| TESTING_PLAN_TRAINER_FEATURES.md | ||
| TESTING_REPORT_TRAINER_FEATURES.md | ||
| TRAINER-IMPORT.md | ||
| TRAINER-PROFILE-IMPLEMENTATION.md | ||
| TRAINER-PROFILE-TECHNICAL-ADDENDUM.md | ||
| trainer-role.md | ||
| trainer_page_refactor_30July2025.md | ||
| TROUBLESHOOTING.md | ||
| Upskill_HVAC_Prod_WP_Info.txt | ||
| WORDPRESS_ADMIN_TASKS.md | ||
HVAC Community Events Plugin Documentation
Overview
The HVAC Community Events plugin is a comprehensive event management system designed specifically for HVAC trainers. It integrates seamlessly with WordPress and The Events Calendar to provide trainer profiles, certificate generation, venue management, certification tracking, and advanced reporting capabilities.
Documentation Structure
📋 Configuration Guide
Complete reference for plugin configuration including:
- System architecture overview
- Configuration files and constants
- User roles and permissions
- URL structure and routing
- Theme integration (Astra)
- Database structure
💻 Development Guide
Best practices and guidelines for developers:
- Development environment setup
- Coding standards (WordPress, PHP, JS, CSS)
- Architecture principles and patterns
- Git workflow and deployment process
- Testing strategies
- Security best practices
- Performance optimization
🔧 Troubleshooting Guide
Solutions to common issues:
- 404 errors and missing pages
- Navigation and menu problems
- CSS and theme conflicts
- Database issues
- Performance problems
- Recovery procedures
- Debugging techniques
🏗️ Architecture Documentation
Technical architecture details:
- Plugin structure
- Class responsibilities
- Hook system
- Data flow
- Integration points
Quick Start
Installation
- Upload plugin to
/wp-content/plugins/ - Activate through WordPress admin
- Plugin automatically creates required pages
- Configure settings as needed
Key Features
- Trainer Profiles: Comprehensive trainer management with photos, certifications, and statistics
- Event Management: Full integration with The Events Calendar
- Certificate Generation: Automated PDF certificate creation with custom templates
- Venue Management: Organize training locations with TEC integration
- Master Dashboard: Aggregate reporting for master trainers
- Hierarchical URLs: SEO-friendly URL structure (
/trainer/dashboard/)
User Roles
-
hvac_trainer: Standard trainer role
- Manage own events
- Generate certificates
- Manage profile, venues, organizers
-
hvac_master_trainer: Advanced trainer role
- All trainer capabilities
- View aggregate reports
- Access master dashboard
- Manage other trainers
Important Notes
- Dual-role users (both trainer and master trainer) will only see the master trainer navigation
- Plugin requires The Events Calendar to be installed and active
- Optimized for Astra theme but compatible with most WordPress themes
- PHP 7.4+ required (PHP 8.0+ recommended)
Support
For issues or questions:
- Check the Troubleshooting Guide
- Review error logs in
/wp-content/debug.log - Contact development team with detailed error information
Recent Fixes & Updates
Certificate Pages Template System (August 1, 2025) ✅
Fixed critical template loading issue affecting certificate pages
- Problem: Certificate pages (
/trainer/certificate-reports/,/trainer/generate-certificates/) were bypassing WordPress template system, showing bare shortcode content without theme headers, navigation, or styling - Root Cause:
load_custom_templates()method loading content-only templates instead of proper page templates - Solution: Updated template paths to use full page templates with proper WordPress integration
- Additional Fixes:
- Eliminated duplicate breadcrumbs by disabling Astra theme breadcrumbs on plugin pages
- Restored missing navigation menu by removing problematic constant checks
- Result: Certificate pages now display with complete theme integration, proper headers/footers, navigation, and consistent styling
Previous Major Updates
- Navigation and Layout System (August 1, 2025) - Dual-role user navigation, sidebar removal, profile page templates
- Role and Certification System (August 1, 2025) - Comprehensive user roles and certification tracking with 10 role options
- Major Plugin Refactor (July 30, 2025) - Registration system overhaul, new trainer pages, comprehensive navigation system
Version History
- v2.0.0 (Current) - Major refactor with modular architecture
- v1.0.0 - Initial release
Last updated: August 2025