# HVAC Community Events Plugin - URL Structure Migration

## URL Mapping - Old to New

| Current URL | New URL | Priority | Status |
|-------------|---------|----------|--------|
| `/community-login/` | `/training-login/` | HIGH | ✅ Complete |
| `/trainer-registration/` | `/trainer/registration/` | HIGH | ✅ Complete |
| `/hvac-dashboard/` | `/trainer/dashboard/` | HIGH | ✅ Complete |
| `/master-dashboard/` | `/master-trainer/dashboard/` | HIGH | ✅ Complete |
| `/manage-event/` | `/trainer/event/manage/` | HIGH | ✅ Complete |
| `/event-summary/` | `/trainer/event/summary/` | MEDIUM | ✅ Complete |
| `/trainer-profile/` | `/trainer/my-profile/` | HIGH | ✅ Complete |
| `/attendee-profile/` | `/trainer/attendee-profile/` | LOW | ✅ Complete |
| `/email-attendees/` | `/trainer/email-attendees/` | MEDIUM | ✅ Complete |
| `/communication-templates/` | `/trainer/communication-templates/` | MEDIUM | ✅ Complete |
| `/communication-schedules/` | `/trainer/communication-schedules/` | MEDIUM | ✅ Complete |
| `/generate-certificates/` | `/trainer/generate-certificates/` | MEDIUM | ✅ Complete |
| `/certificate-reports/` | `/trainer/certificate-reports/` | MEDIUM | ✅ Complete |
| `/google-sheets/` | `/master-trainer/google-sheets/` | MEDIUM | ✅ Complete |
| `/hvac-documentation/` | `/trainer/documentation/` | LOW | ✅ Complete |
| `/certificate-fix/` | `/master-trainer/certificate-fix/` | HIGH | ✅ Complete |

## References to Update

### High Priority Files (Core Navigation/Authentication)
1. **Main Plugin File** (`hvac-community-events.php`)
   - Page creation array (lines 46-117)
   - Asset loading checks (lines 260-266, 342, 358, 374, 433)

2. **Login Handler** (`includes/community/class-login-handler.php`)
   - Redirect URLs (lines 143, 175, 182, 202, 209, 214)

3. **HVAC Community Events Class** (`includes/class-hvac-community-events.php`)
   - Authentication redirects (lines 154, 166, 178, 188, 191, 198, 212, 219)

4. **Dashboard Templates**
   - `templates/template-hvac-dashboard.php`
   - `templates/template-hvac-master-dashboard.php`

### Medium Priority Files (Navigation/Features)
5. **Dashboard Class** (`includes/class-hvac-dashboard.php`)
6. **Manage Event Class** (`includes/class-hvac-manage-event.php`)
7. **Registration Class** (`includes/class-hvac-registration.php`)
8. **Settings Class** (`includes/class-hvac-settings.php`)
9. **Help System** (`includes/class-hvac-help-system.php`)

### Low Priority Files (Templates/Tests)
10. **Certificate Templates** (multiple files)
11. **Profile Templates**
12. **Test Files** (50+ files in `/bin/` and root)

## Implementation Strategy

### Phase 1: Core Structure (HIGH Priority)
1. Update page creation code in main plugin file
2. Create URL mapping helper functions
3. Update login redirection logic
4. Add backward compatibility redirects

### Phase 2: Navigation (HIGH Priority)  
5. Update dashboard navigation links
6. Update authentication redirect URLs
7. Update template hardcoded links

### Phase 3: Features (MEDIUM Priority)
8. Update shortcode references
9. Update help system links
10. Update asset loading checks

### Phase 4: Testing & Documentation (LOW Priority)
11. Update test files
12. Update documentation
13. Comprehensive testing

## Backward Compatibility Plan

### 301 Redirects Required
All old URLs must redirect to new URLs using WordPress redirect functions:

```php
// Example redirect mapping
$legacy_redirects = [
    'community-login' => 'training-login',
    'hvac-dashboard' => 'trainer/dashboard',
    'master-dashboard' => 'master-trainer/dashboard',
    'manage-event' => 'trainer/event/manage',
    'trainer-profile' => 'trainer/my-profile',
    'certificate-fix' => 'master-trainer/certificate-fix',
    // ... etc
];
```

### Implementation Notes
- Use WordPress `wp_redirect()` with 301 status
- Preserve query parameters during redirects
- Implement in `template_redirect` hook
- Log redirects for monitoring

## Security Considerations

### Access Control Updates
- **Certificate Fix**: Move to `/master-trainer/` hierarchy requires permission check updates
- **Role-based URLs**: Ensure URL structure matches permission model
- **Capability Checks**: Update template redirect logic for new URLs

## Testing Checklist

### Functional Testing
- [ ] All new URLs load correctly
- [ ] All old URLs redirect properly
- [ ] Login redirects to correct dashboard
- [ ] Navigation between trainer/master trainer dashboards works
- [ ] Certificate fix page restricted to master trainers only

### Technical Testing  
- [ ] No 404 errors on any URL
- [ ] Query parameters preserved in redirects
- [ ] Assets load correctly on all pages
- [ ] Help system links work
- [ ] Test suite passes with new URLs

## Deployment Plan

### Pre-deployment
1. Create database backup
2. Test in staging environment
3. Verify all redirects work
4. Update user documentation

### Deployment
1. Deploy plugin with URL changes
2. Clear all caches
3. Test key user journeys
4. Monitor for 404 errors

### Post-deployment
1. Monitor redirect usage
2. Update external documentation
3. Communicate changes to users
4. Plan to remove redirects after transition period

## Files to Modify

### Core Files (16 files)
- `hvac-community-events.php`
- `includes/class-hvac-community-events.php`
- `includes/community/class-login-handler.php`
- `includes/class-hvac-dashboard.php`
- `includes/class-hvac-manage-event.php`
- `includes/class-hvac-registration.php`
- `includes/class-hvac-settings.php`
- `includes/class-hvac-help-system.php`
- `templates/template-hvac-dashboard.php`
- `templates/template-hvac-master-dashboard.php`
- `templates/template-trainer-profile.php`
- `templates/template-event-summary.php`
- Multiple certificate template files
- Test files (50+ files)

### Estimated Effort
- **Planning/Analysis**: ✅ Complete
- **Core Implementation**: 4-6 hours
- **Template Updates**: 2-3 hours  
- **Testing**: 2-3 hours
- **Documentation**: 1-2 hours
- **Total**: 10-15 hours