- Troubleshooted and fixed issues with the plugin deployment script (`deploy-plugin.sh`) to ensure all necessary plugin files, including the main plugin file, are correctly transferred to the staging environment. - Corrected a role name mismatch in the test user creation script (`setup-staging-test-users.sh`) to successfully create a test user with the `hvac_trainer` role on staging. - Updated the E2E test runner script (`run-tests.sh`) to replace deprecated Docker commands with SSH commands targeting the staging environment and explicitly pass the staging URL to Playwright. - Increased the global timeout and enabled retries in the Playwright configuration (`playwright.config.ts`) to aid in debugging test failures on the staging environment. - Updated documentation files (`docs/mvp-integration-testing-plan.md`, `wordpress-dev/README.md`, and `wordpress-dev/MIGRATION_GUIDE.md`) to include instructions on setting up the test user for the staging environment and corrected section numbering in the testing plan.
126 lines
No EOL
3.5 KiB
Markdown
126 lines
No EOL
3.5 KiB
Markdown
# Product Context
|
|
|
|
This file provides a high-level overview of the project and the expected product that will be created.
|
|
2025-04-23 19:00:00 - Updated with Cloudways staging environment workflow
|
|
|
|
## Project Goal
|
|
|
|
Network Events is a WordPress plugin that extends The Events Calendar suite to create a specialized platform for HVAC trainers. The system enables independent trainers to manage their own events, sell tickets, and track performance without accessing the WordPress admin panel.
|
|
|
|
## Development Environment
|
|
|
|
### Core Components
|
|
* **Cloudways Staging Environment**
|
|
* WordPress (PHP 8.1-FPM)
|
|
* Nginx web server
|
|
* MariaDB database
|
|
* Cloudways dashboard for management
|
|
* **Development Tools**
|
|
* Playwright testing framework
|
|
* Git version control
|
|
* SSH and rsync for deployment
|
|
* Development scripts
|
|
* Debug tools
|
|
|
|
### Development Workflow
|
|
* **Staging-Based Approach**
|
|
* Production data backup creation
|
|
* Staging environment deployment
|
|
* Testing on staging environment
|
|
* Consistent development environment
|
|
* Collaborative development capability
|
|
* **Script Suite**
|
|
* deploy-config-staging.sh - Deploy configuration to staging
|
|
* configure-staging-tests.sh - Configure test environment
|
|
* run-staging-tests.sh - Run tests on staging
|
|
* verify-staging.sh - Verify staging environment
|
|
* sync-staging.sh - Sync data from staging
|
|
* deploy-plugin.sh - Deploy plugin to staging
|
|
* run-staging-unit-tests.sh - Run unit tests on staging
|
|
|
|
### Configuration Management
|
|
* **Environment Settings**
|
|
* Staging-specific configurations
|
|
* Debug mode enabled
|
|
* Error display active
|
|
* SSL enabled
|
|
* Staging URLs
|
|
* **Production Preparation**
|
|
* Secure configurations ready
|
|
* SSL support enabled
|
|
* Error logging configured
|
|
* Performance optimizations
|
|
* Security measures
|
|
|
|
## Key Features
|
|
|
|
* Custom user role for HVAC trainers
|
|
* Trainer registration and login system
|
|
* Comprehensive trainer dashboard
|
|
* Event creation and management
|
|
* Event summary and reporting
|
|
* Attendee management
|
|
* Email communication with attendees (Phase 2)
|
|
* Certificate generation and management (Phase 3)
|
|
* Integration with The Events Calendar suite
|
|
* Future Zoho CRM integration (Phase 2)
|
|
|
|
## Implementation Phases
|
|
|
|
### Phase 1 (In Progress)
|
|
* Community Login Page (Completed)
|
|
* Registration Page (Completed)
|
|
* Basic Dashboard (In Progress)
|
|
* Create/Modify Event Pages (Planned)
|
|
* Event Summary Page (Planned)
|
|
|
|
### Phase 2 (Future)
|
|
* Zoho CRM API Integration
|
|
* Email Attendees functionality
|
|
* Enhanced event management
|
|
* Advanced reporting
|
|
|
|
### Phase 3 (Future)
|
|
* Certificate generation
|
|
* Request Training Page
|
|
* My Training Page
|
|
* Advanced reporting
|
|
|
|
## Technical Architecture
|
|
|
|
### WordPress Integration
|
|
* Core WordPress 6.7+
|
|
* The Events Calendar suite integration
|
|
* Custom plugin development
|
|
* Theme compatibility
|
|
* Security measures
|
|
|
|
### Required Plugins
|
|
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 Required Plugins:
|
|
* Spectra Pro (2.0.0+)
|
|
* Premium Starter Templates (4.4.14+)
|
|
* Essential Blocks (5.3.2+)
|
|
|
|
### Development Standards
|
|
* PHP 8.1+ compatibility
|
|
* WordPress coding standards
|
|
* Modern JavaScript practices
|
|
* Responsive design
|
|
* Accessibility compliance
|
|
* Security best practices
|
|
|
|
### Testing Strategy
|
|
* Unit testing
|
|
* Integration testing
|
|
* E2E testing with Playwright
|
|
* Performance testing
|
|
* Security testing
|
|
|
|
2025-04-23 19:00:00 - Updated with Cloudways staging environment workflow |