ben/upskill-event-manager
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 2
HVAC Community Events WordPress Plugin with Comprehensive Testing Framework
207 commits 2 branches 0 tags 131 MiB
JavaScript 60.5%
PHP 27.5%
CSS 7.7%
Shell 4%
TypeScript 0.2%
Other 0.1%
Find a file
bengizmo 34f06709f0 feat: Implement comprehensive manual geocoding trigger system with 85% coverage 
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>
2025-08-01 23:49:27 -03:00
assets feat: Implement comprehensive trainer profile custom post type system 2025-08-01 18:45:41 -03:00
docs feat: Implement comprehensive manual geocoding trigger system with 85% coverage 2025-08-01 23:49:27 -03:00
includes feat: Implement comprehensive manual geocoding trigger system with 85% coverage 2025-08-01 23:49:27 -03:00
scripts feat: Complete HVAC Trainer CSV import system with comprehensive functionality 2025-08-01 12:15:22 -03:00
templates feat: Implement comprehensive manual geocoding trigger system with 85% coverage 2025-08-01 23:49:27 -03:00
tests feat: Implement trainer approval workflow with status management 2025-07-28 12:38:34 -03:00
wordpress-dev/tests/e2e feat: Implement comprehensive user role field and certification tracking system 2025-08-01 10:52:11 -03:00
.gitattributes Remove LFS tracking for all files 2025-05-18 19:44:31 -03:00
.gitignore fix: Remove remaining debug log statements from production 2025-07-24 15:25:42 -03:00
.roomodes feat(testing): Implement comprehensive trainer journey test suite with Page Object Model 2025-05-18 15:42:00 -03:00
admin-import-trainers.php fix: Ensure import script sets correct hvac_trainer role for all users 2025-06-18 12:26:06 -03:00
CLAUDE.md feat: Implement comprehensive manual geocoding trigger system with 85% coverage 2025-08-01 23:49:27 -03:00
hvac-community-events.php fix: Resolve duplicate initialization and jQuery selector errors 2025-07-28 17:58:39 -03:00
README.md Fix legacy URL redirects being intercepted by access control 2025-07-28 19:45:43 -03:00

README.md

Network Events

Status: Active/Authoritative - Production Ready Last Updated: July 23, 2025 Test Coverage: 85-90% achieved User Base: 15 active HVAC trainers, 3 master trainers Scope: Main project documentation

A specialized community events platform for trainers using The Events Calendar suite.

Description

Network Events is a WordPress plugin that extends The Events Calendar suite to create a specialized platform for trainers. It provides a custom user role for trainers, registration and login forms, a trainer dashboard, and event management capabilities.

Features

  • Custom user role for HVAC trainers (✅ 15 active trainers)
  • Master trainer role with aggregate dashboard (✅ 3 master trainers)
  • Trainer registration and login (✅ Verified functional)
  • Trainer dashboard (✅ Verified functional)
  • Event creation and management (✅ Verified functional)
  • Event summary and reporting (✅ Verified functional)
  • Attendee management (✅ Verified functional)
  • Certificate generation and download (✅ Verified functional)
  • Email communication with attendees (✅ Verified functional)
  • Integration with The Events Calendar suite (✅ Verified functional)
  • Master dashboard with trainer analytics (✅ Verified functional)

Architecture

The plugin follows a modular architecture with single-responsibility classes:

Core Components

  • HVAC_Plugin: Main plugin controller
  • HVAC_Shortcodes: Centralized shortcode management
  • HVAC_Scripts_Styles: Asset management
  • HVAC_Route_Manager: URL routing and redirects
  • HVAC_Template_Loader: Template handling
  • HVAC_Page_Manager: WordPress page creation

See docs/ARCHITECTURE.md for detailed architecture documentation.

Requirements

WordPress Environment

  • WordPress 5.9 or higher
  • PHP 7.4 or higher

Required Plugins (Pre-installed on Production)

All required plugins are automatically synced from production during development environment setup:

  1. The Events Calendar Suite:

    • The Events Calendar (6.10.2+)
    • Events Calendar Pro (7.4.2+)
    • Event Tickets (5.19.3+)
    • Event Tickets Plus (6.2.0+)
    • Community Events (4.10.0+)

  2. Additional Plugins (present on the Upskill HVAC Website):

    • Spectra Pro (2.0.0+)
    • Premium Starter Templates (4.4.14+)
    • Essential Blocks (5.3.2+)

License

Copyright (c) 2025 Teal Maker Consulting

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2, as published by the Free Software Foundation. You may NOT assume that you can use any other version of the GPL.

Credits

Developed by Teal Maker Consulting