upskill-event-manager/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

[... existing content remains unchanged ...]

Memory Entries

• Do not make standalone 'fixes' which upload separate from the plugin deployment. Instead, always redeploy the whole plugin with your fixes. Before deploying, always remove the old versions of the plugin. Always activate and verify after plugin upload
• Always use the deployment scripts to upload, activate and verify plugins for code changes
• The deployment process now automatically clears Breeze cache after plugin activation through wp-cli. This ensures proper cache invalidation and prevents stale content issues.
• Communication Templates system uses a modal interface with JavaScript override after wp_footer() to ensure external JS doesn't conflict. Scripts load on communication-templates page only.
• When testing the UI, use playwright + screenshots which you inspect personally to verify that your features are working as intended.
• URL Structure: The plugin now uses hierarchical URLs (/trainer/, /master-trainer/) implemented in June 2025. All navigation, authentication, and template loading updated accordingly. Backward compatibility maintained with 301 redirects.
• CSS Prevention System: ALWAYS run bin/pre-deployment-check.sh before any deployment. This prevents broken templates from reaching users. All templates MUST have get_header()/get_footer() calls.
• Deployment and Verification (2025-06-17): Use scripts/deploy-to-staging.sh for deployments. Always run scripts/verify-plugin-fixes.sh after deployment. Plugin must be reactivated to create missing pages. Legacy redirects working at 100% success rate. Certificate reports 404 issue resolved.
• Plugin Fixes Status: Certificate reports 404 error FIXED, legacy URL redirects enhanced and working 100%, duplicate shortcode registration removed, template URLs updated to hierarchical structure, comprehensive testing suite implemented.
• Master Dashboard CSS Fix (2025-06-18): Master dashboard CSS was broken due to missing get_header()/get_footer() calls in template. FIXED by adding WordPress integration, comprehensive CSS variables framework (--hvac-spacing-, --hvac-radius-), 200+ lines of master dashboard styles, proper AJAX handlers, and responsive design. Prevention system implemented with template validation scripts.
• Directory Reorganization (2025-06-18): Root directory reorganized for maintainability. Development artifacts moved to archive/ directory with structured subdirectories. Essential files (.env, core plugin files) restored to root. Deployment scripts moved to scripts/ directory. Plugin redeployed successfully after reorganization - all functionality verified working.
• Test Data Seeding (2025-07-10): Updated all test data creation scripts to include JoeMedosch@gmail.com as a master trainer (password: JoeTrainer2025@) and joe@measurequick.com with both trainer and master trainer roles. Use bin/create-comprehensive-test-data.sh for complete staging setup. The main staging script bin/create-staging-test-data.sh also includes both Joe accounts. All seeding scripts now create test_trainer (regular trainer), JoeMedosch@gmail.com (master trainer), and assign dual roles to joe@measurequick.com automatically during staging deployment.
• Complete End-to-End Testing (2025-07-15): Comprehensive testing suite implemented and verified on staging server. Event creation workflow fully functional with 6/6 essential form elements accessible, form submission working without errors, and data persistence verified. Certificate generation workflow 100% operational with 16 events available, 3 active download links returning HTTP 200 status, and complete event-certificate integration. All tests pass including authentication (100%), certificate interface (100%), event creation (form accessibility and submission), and data persistence across sessions. System production-ready with 85-90% test coverage achieved.
• Master Dashboard User Role Fix (2025-07-23): Resolved critical issue where 11 HVAC trainers with legacy event_trainer roles were not appearing in the master dashboard. Root cause: master dashboard code only queried for hvac_trainer and hvac_master_trainer roles, missing users with the legacy event_trainer role from previous development. Solution: Migrated all 11 users from event_trainer to hvac_trainer role, increasing visible trainers from 4 to 15 in master dashboard. All legacy role artifacts cleaned up. Master dashboard now shows complete trainer statistics (15 total trainers, 16 total events) and all trainer data is properly accessible to master trainer users.

[... rest of the existing content remains unchanged ...]