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