upskill-event-manager/docs/WORDPRESS_ADMIN_TASKS.md

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:

// 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 '<script>
                document.addEventListener("DOMContentLoaded", function() {
                    var navHTML = ' . json_encode($nav->get_navigation_html()) . ';
                    var headerContent = document.querySelector(".site-header .container, .header-content, .main-header");
                    if (headerContent) {
                        headerContent.insertAdjacentHTML("afterend", navHTML);
                    }
                });
            </script>';
        }
    }
});

2. Add Breadcrumb Hook to Theme

Add this code to your active theme's single.php or page.php templates:

// 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:

# 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