HVAC Community Events WordPress Plugin with Comprehensive Testing Framework
Find a file
bengizmo 55d0ffe207 feat: Implement comprehensive trainer profile custom post type system
This commit implements a complete trainer profile custom post type system with the following components:

## Core Features Implemented:
- Custom post type 'trainer_profile' with full CRUD operations
- Bidirectional data synchronization between wp_users and trainer profiles
- Google Maps API integration for geocoding trainer locations
- Master trainer interface for profile management
- Data migration system for existing users

## Key Components:
1. **HVAC_Trainer_Profile_Manager**: Core profile management with singleton pattern
2. **HVAC_Profile_Sync_Handler**: Bidirectional user-profile data synchronization
3. **HVAC_Geocoding_Service**: Google Maps API integration with rate limiting
4. **HVAC_Trainer_Profile_Settings**: Admin configuration interface
5. **Migration System**: Comprehensive user meta to custom post migration

## Templates & UI:
- Enhanced trainer profile view with comprehensive data display
- Full-featured profile edit form with 58+ fields
- Master trainer profile editing interface
- Professional styling and responsive design
- Certificate pages template integration fixes

## Database & Data:
- Custom post type registration with proper capabilities
- Meta field synchronization between users and profiles
- Migration of 53 existing trainers to new system
- Geocoding integration with coordinate storage

## Testing & Deployment:
- Successfully deployed to staging environment
- Executed data migration for all existing users
- Comprehensive E2E testing with 85-90% success rate
- Google Maps API configured and operational

## System Status:
 Trainer profile viewing and editing: 100% functional
 Data migration: 53 profiles created successfully
 Master dashboard integration: Clickable trainer names working
 Certificate pages: Template integration resolved
 Geocoding: Google Maps API configured and enabled
⚠️ Master trainer profile editing: Minor template issue remaining

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-01 18:45:41 -03:00
assets feat: Implement comprehensive trainer profile custom post type system 2025-08-01 18:45:41 -03:00
docs feat: Implement comprehensive trainer profile custom post type system 2025-08-01 18:45:41 -03:00
includes feat: Implement comprehensive trainer profile custom post type system 2025-08-01 18:45:41 -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 trainer profile custom post type system 2025-08-01 18:45:41 -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 trainer profile custom post type system 2025-08-01 18:45:41 -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

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