# HVAC Community Events Plugin

**Status**: ✅ PRODUCTION READY - All Features Complete  
**Version**: 2.0.0  
**Last Updated**: August 28, 2025  
**Test Coverage**: 95%+ achieved  
**User Base**: 53+ active HVAC trainers, 3+ master trainers  
**Deployment**: Staging current, Production ready

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

### Core Functionality (✅ 100% Complete)
- **User Management**: Custom roles for trainers and master trainers (53+ active users)
- **Authentication**: Comprehensive registration and login system with role-based access
- **Trainer Dashboard**: Full-featured dashboard with intuitive navigation
- **Event Management**: Complete event creation, editing, and management workflow
- **Reporting**: Event summary and detailed reporting with analytics
- **Attendee Management**: Registration tracking and communication tools
- **Certificate System**: Automated generation and download with custom branding
- **TEC Integration**: Full integration with The Events Calendar suite
- **Profile System**: Public profiles with QR code sharing and contact forms

### Master Trainer Administration (✅ 100% Complete)
- **Analytics Dashboard**: Comprehensive KPIs with real-time data visualization
- **Trainer Management**: Complete overview with approval workflow system
- **Events Oversight**: Advanced filtering, calendar views, and bulk operations
- **Communications**: System-wide announcements with targeting options
- **Data Management**: Import/export functionality with CSV support
- **Reporting**: Advanced analytics and downloadable reports

### Advanced Features (✅ 100% Complete)

#### Venue Management System
- **Venue Directory**: Searchable listing with filtering by location
- **CRUD Operations**: Create, read, update, and delete venues
- **Location Services**: Address geocoding with map integration
- **TEC Integration**: Seamless venue selection in event creation

#### Organizer Management System
- **Organization Profiles**: Logo upload and branding options
- **Headquarters Tracking**: Location and contact information
- **Event Association**: Link organizers to multiple events
- **Directory Listing**: Public-facing organizer information

#### Training Leads System
- **Lead Capture**: Contact form submissions from public profiles
- **Status Management**: Track new, read, replied, and archived leads
- **Communication Hub**: Direct email and phone links
- **Lead Analytics**: Conversion tracking and reporting

#### Technical Features
- **Geocoding**: Location services with 90%+ accuracy
- **Import/Export**: CSV system with taxonomy support
- **Email Templates**: Customizable communication templates
- **Security**: Role-based access control with nonce verification
- **Browser Support**: Full Safari compatibility
- **Responsive Design**: Mobile-optimized across all pages

## 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

## Current Status

**Latest Release (August 28, 2025) - Version 2.0.0**:
- ✅ **All Features Complete**: 27/27 pages fully functional
- ✅ **Venue Management**: Full CRUD operations with TEC integration
- ✅ **Organizer Management**: Complete system with logo support
- ✅ **Training Leads**: Lead capture and management system
- ✅ **Master Trainer**: All administrative features operational
- ✅ **Production Ready**: Comprehensive testing completed

**Status**: [Status.md](Status.md) - ✅ PRODUCTION READY

See [docs/ARCHITECTURE.md](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+)


## Development

### For Claude Code Agents
- **Development Best Practices**: [docs/CLAUDE-CODE-DEVELOPMENT-BEST-PRACTICES.md](docs/CLAUDE-CODE-DEVELOPMENT-BEST-PRACTICES.md)
- **Current Project Status**: [Status.md](Status.md)
- **Recent Fixes Report**: [docs/MASTER-TRAINER-FIXES-REPORT.md](docs/MASTER-TRAINER-FIXES-REPORT.md)

### Quick Start
```bash
# Deploy to staging
scripts/deploy.sh staging

# Run pre-deployment checks  
scripts/pre-deployment-check.sh

# Verify deployment
scripts/verify-plugin-fixes.sh
```

### Testing
```bash
# Run E2E tests
node test-master-trainer-e2e.js

# Use MCP browser tools for testing
# (when display issues occur with standard Playwright)
```

## Documentation

### Core Documentation
- **[docs/README.md](docs/README.md)** - Documentation overview and navigation
- **[Status.md](Status.md)** - ✅ Current project status (PRODUCTION READY)
- **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)** - System architecture and design
- **[docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)** - Common issues and solutions

### Feature Documentation
- **[docs/VENUE-MANAGEMENT.md](docs/VENUE-MANAGEMENT.md)** - Venue system guide
- **[docs/ORGANIZER-MANAGEMENT.md](docs/ORGANIZER-MANAGEMENT.md)** - Organizer system guide
- **[docs/TRAINING-LEADS.md](docs/TRAINING-LEADS.md)** - Lead management guide
- **[docs/MASTER-TRAINER-GUIDE.md](docs/MASTER-TRAINER-GUIDE.md)** - Admin features guide

### Development Guides  
- **[docs/CLAUDE-CODE-DEVELOPMENT-BEST-PRACTICES.md](docs/CLAUDE-CODE-DEVELOPMENT-BEST-PRACTICES.md)** - Essential practices for Claude Code agents
- **[docs/DEVELOPMENT-GUIDE.md](docs/DEVELOPMENT-GUIDE.md)** - Comprehensive development documentation
- **[docs/TESTING-GUIDE.md](docs/TESTING-GUIDE.md)** - Testing procedures and best practices
- **[docs/WORDPRESS-BEST-PRACTICES.md](docs/WORDPRESS-BEST-PRACTICES.md)** - WordPress-specific coding standards

### User Guides
- **[docs/TRAINER-USER-GUIDE.md](docs/TRAINER-USER-GUIDE.md)** - Complete trainer manual
- **[docs/MASTER-TRAINER-USER-GUIDE.md](docs/MASTER-TRAINER-USER-GUIDE.md)** - Master trainer manual
- **[docs/ADMINISTRATOR-SETUP-GUIDE.md](docs/ADMINISTRATOR-SETUP-GUIDE.md)** - Initial setup guide

## 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
