diff --git a/docs/WORDPRESS_ADMIN_TASKS.md b/docs/WORDPRESS_ADMIN_TASKS.md new file mode 100644 index 00000000..c814b525 --- /dev/null +++ b/docs/WORDPRESS_ADMIN_TASKS.md @@ -0,0 +1,152 @@ +# WordPress Admin Tasks - HVAC Trainer Features + +## Pages to Create Manually + +### 1. Venue Manage Page +- **Parent**: /trainer/venue/ +- **Slug**: manage +- **Title**: Manage Venue +- **Template**: page-trainer-venue-manage.php +- **Status**: Publish + +### 2. Organizer List Page +- **Parent**: /trainer/organizer/ +- **Slug**: list +- **Title**: Training Organizers +- **Template**: page-trainer-organizer-list.php +- **Status**: Publish + +### 3. Organizer Manage Page +- **Parent**: /trainer/organizer/ +- **Slug**: manage +- **Title**: Manage Organizer +- **Template**: page-trainer-organizer-manage.php +- **Status**: Publish + +## Navigation Integration + +### 1. Add Navigation Hook to Theme +Add this code to your active theme's `functions.php`: + +```php +// Add HVAC Navigation to trainer pages +add_action('wp_footer', function() { + if (is_page() && strpos($_SERVER['REQUEST_URI'], '/trainer/') !== false) { + if (class_exists('HVAC_Trainer_Navigation')) { + $nav = HVAC_Trainer_Navigation::get_instance(); + echo ''; + } + } +}); +``` + +### 2. Add Breadcrumb Hook to Theme +Add this code to your active theme's `single.php` or `page.php` templates: + +```php +// Add breadcrumbs to trainer pages +if (strpos($_SERVER['REQUEST_URI'], '/trainer/') !== false && class_exists('HVAC_Breadcrumbs')) { + $breadcrumbs = HVAC_Breadcrumbs::get_instance(); + echo $breadcrumbs->get_breadcrumbs(); +} +``` + +## Cache Clearing + +### 1. Clear All Caches +Run these commands on the server: + +```bash +# WordPress cache +wp cache flush + +# Breeze cache +wp breeze clear all + +# OPcache +wp opcache reset + +# Rewrite rules +wp rewrite flush +``` + +### 2. CDN Cache (if applicable) +- Clear CloudFlare cache if using CDN +- Clear any other CDN caches + +## Testing Checklist + +### Navigation Testing +- [ ] Navigation menu appears on all trainer pages +- [ ] Dropdown menus work correctly +- [ ] Mobile hamburger menu functions +- [ ] Active page highlighting works +- [ ] Keyboard navigation accessible + +### Breadcrumb Testing +- [ ] Breadcrumbs appear on trainer pages +- [ ] Breadcrumb trail is accurate +- [ ] Links work correctly +- [ ] Schema.org markup present + +### Page Functionality Testing +- [ ] Venue management CRUD operations +- [ ] Organizer management CRUD operations +- [ ] Profile editing and photo upload +- [ ] Form validation and AJAX submission +- [ ] File uploads working correctly + +## Troubleshooting + +### If Navigation Doesn't Appear +1. Check if theme hook is added correctly +2. Verify JavaScript console for errors +3. Ensure HVAC_Trainer_Navigation class is loaded +4. Check CSS for display:none rules + +### If Breadcrumbs Don't Show +1. Verify breadcrumb hook placement +2. Check HVAC_Breadcrumbs class availability +3. Confirm URL pattern matching +4. Check CSS styling conflicts + +### If Pages Return 404 +1. Go to WordPress Admin > Settings > Permalinks +2. Click "Save Changes" to flush rewrite rules +3. Verify page hierarchy and slugs +4. Check if parent pages exist + +## Implementation Priority + +1. **High Priority** (Essential for functionality) + - Create missing pages + - Clear caches + - Test core functionality + +2. **Medium Priority** (Enhanced UX) + - Add navigation hooks + - Add breadcrumb integration + - Style integration testing + +3. **Low Priority** (Nice to have) + - Advanced styling tweaks + - Performance optimizations + - Analytics integration + +## Completion Verification + +After completing all tasks, verify: +- All 7 trainer pages are accessible (no 404s) +- Navigation appears consistently +- Breadcrumbs show proper trail +- CRUD operations work +- Mobile responsiveness maintained +- No JavaScript console errors \ No newline at end of file