- Create new WordPress page template for trainer documentation (page-trainer-documentation.php) - Add editable documentation content via Gutenberg editor - Implement automatic table of contents sidebar with smooth scrolling - Create comprehensive help content covering: - Platform overview and mission - Core concepts (Events, Venues, Organizers, Tickets, RSVPs, Orders, Certificates) - Profile customization guide - Venue and organizer management - Event creation and management process - Event attendance tracking methods - Certificate generation workflow - Comprehensive FAQs section - Support resources and contact information - Add responsive design with mobile-friendly layout - Include interactive TOC with active section highlighting - Update deployment script to set correct page template - Fix documentation page to use new template system The documentation page now provides trainers with a complete guide to using the platform, including step-by-step instructions for all major features and answers to common questions. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
		
			
				
	
	
		
			481 lines
		
	
	
		
			No EOL
		
	
	
		
			20 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
			
		
		
	
	
			481 lines
		
	
	
		
			No EOL
		
	
	
		
			20 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
| <?php
 | |
| /**
 | |
|  * HVAC Documentation Content
 | |
|  * 
 | |
|  * Provides default documentation content for the help page
 | |
|  */
 | |
| 
 | |
| class HVAC_Documentation_Content {
 | |
|     
 | |
|     private static $instance = null;
 | |
|     
 | |
|     public static function instance() {
 | |
|         if (null === self::$instance) {
 | |
|             self::$instance = new self();
 | |
|         }
 | |
|         return self::$instance;
 | |
|     }
 | |
|     
 | |
|     private function __construct() {
 | |
|         add_shortcode('hvac_documentation_content', array($this, 'render_documentation_content'));
 | |
|     }
 | |
|     
 | |
|     /**
 | |
|      * Render the default documentation content
 | |
|      */
 | |
|     public function render_documentation_content() {
 | |
|         ob_start();
 | |
|         ?>
 | |
|         
 | |
|         <h1>Upskill HVAC Training Platform Guide</h1>
 | |
|         <p class="lead">Welcome to the comprehensive guide for creating and managing HVAC training events on the Upskill platform.</p>
 | |
|         
 | |
|         <h2 id="overview">Platform Overview</h2>
 | |
|         <p>The Upskill HVAC Training Network connects skilled trainers with trainees throughout the HVAC industry. Our mission is to elevate the entire industry through accessible, high-quality training opportunities.</p>
 | |
|         
 | |
|         <div class="hvac-highlight-box">
 | |
|             <h3>Why Choose Upskill HVAC?</h3>
 | |
|             <ul>
 | |
|                 <li><strong>Free Listing Service:</strong> List any HVAC training event at no cost</li>
 | |
|                 <li><strong>Full Revenue:</strong> Keep 100% of your training fees (minus standard Stripe processing fees)</li>
 | |
|                 <li><strong>Integrated Ticketing:</strong> Professional ticketing and registration system included</li>
 | |
|                 <li><strong>Certificate Generation:</strong> Automatic certificate creation for attendees</li>
 | |
|                 <li><strong>Marketing Support:</strong> Your events are promoted across the Upskill network</li>
 | |
|             </ul>
 | |
|         </div>
 | |
|         
 | |
|         <h2 id="core-concepts">Core Concepts</h2>
 | |
|         <p>Understanding these key components will help you navigate the platform effectively:</p>
 | |
|         
 | |
|         <div class="hvac-concepts-grid">
 | |
|             <div class="hvac-concept-card">
 | |
|                 <h3>🎯 Events</h3>
 | |
|                 <p>Your training sessions, workshops, or classes. Each event has its own page with details, registration options, and venue information.</p>
 | |
|             </div>
 | |
|             
 | |
|             <div class="hvac-concept-card">
 | |
|                 <h3>📍 Venues</h3>
 | |
|                 <p>Physical or virtual locations where training occurs. Venues can be reused across multiple events.</p>
 | |
|             </div>
 | |
|             
 | |
|             <div class="hvac-concept-card">
 | |
|                 <h3>🏢 Organizers</h3>
 | |
|                 <p>The entity hosting the training (you, your company, or affiliated organization). Helps attendees identify who's providing the training.</p>
 | |
|             </div>
 | |
|             
 | |
|             <div class="hvac-concept-card">
 | |
|                 <h3>🎫 Tickets</h3>
 | |
|                 <p>Paid registration options for your events. Set prices, early bird discounts, and capacity limits.</p>
 | |
|             </div>
 | |
|             
 | |
|             <div class="hvac-concept-card">
 | |
|                 <h3>📝 RSVPs</h3>
 | |
|                 <p>Free registration option for events. Perfect for community events or when you want to track attendance without charging.</p>
 | |
|             </div>
 | |
|             
 | |
|             <div class="hvac-concept-card">
 | |
|                 <h3>📊 Orders</h3>
 | |
|                 <p>Completed registrations for your events. Track who's attending and manage check-ins.</p>
 | |
|             </div>
 | |
|             
 | |
|             <div class="hvac-concept-card">
 | |
|                 <h3>🏆 Certificates</h3>
 | |
|                 <p>Professional completion certificates for attendees. Automatically generated with unique IDs for verification.</p>
 | |
|             </div>
 | |
|         </div>
 | |
|         
 | |
|         <h2 id="customizing-profile">Customizing Your Profile</h2>
 | |
|         <p>Your trainer profile is your public face on the Upskill platform. It appears in the "Find a Trainer" directory and helps potential trainees discover your expertise.</p>
 | |
|         
 | |
|         <h3>Profile Setup Steps:</h3>
 | |
|         <ol>
 | |
|             <li><strong>Navigate to Your Profile:</strong> Click "Profile" → "Trainer Profile" in the navigation menu</li>
 | |
|             <li><strong>Upload Your Photo:</strong> Add a professional headshot to build trust with potential trainees</li>
 | |
|             <li><strong>Complete Your Bio:</strong> Share your experience, certifications, and training philosophy</li>
 | |
|             <li><strong>Add Contact Information:</strong> Include your business email and phone number</li>
 | |
|             <li><strong>Specify Your Location:</strong> Help local trainees find you easily</li>
 | |
|             <li><strong>List Certifications:</strong> Highlight your measureQuick certifications and other credentials</li>
 | |
|             <li><strong>Set Training Preferences:</strong> Indicate your training formats, audience types, and specialties</li>
 | |
|         </ol>
 | |
|         
 | |
|         <div class="hvac-tip">
 | |
|             <strong>💡 Pro Tip:</strong> Your profile was auto-created when you registered, but it likely needs updates. A complete profile generates 3x more training leads than incomplete ones.
 | |
|         </div>
 | |
|         
 | |
|         <h2 id="venues-organizers">Managing Venues & Organizers</h2>
 | |
|         <p>Venues and organizers were automatically created for you during registration, but they need your attention to be fully effective.</p>
 | |
|         
 | |
|         <h3>Updating Your Venues</h3>
 | |
|         <ol>
 | |
|             <li><strong>Review Existing Venues:</strong> Go to "Profile" → "Training Venues" to see your auto-created venue</li>
 | |
|             <li><strong>Edit Venue Details:</strong> Click "Edit" to update address, capacity, and amenities</li>
 | |
|             <li><strong>Add Photos:</strong> Upload images of your training facility to attract attendees</li>
 | |
|             <li><strong>Create Additional Venues:</strong> If you train at multiple locations, create a venue for each</li>
 | |
|             <li><strong>Check for Duplicates:</strong> Before creating new venues, search existing ones to avoid duplicates</li>
 | |
|         </ol>
 | |
|         
 | |
|         <h3>Managing Organizers</h3>
 | |
|         <ol>
 | |
|             <li><strong>Access Organizers:</strong> Navigate to "Profile" → "Training Organizers"</li>
 | |
|             <li><strong>Update Your Organization:</strong> Add your company logo and description</li>
 | |
|             <li><strong>Set Contact Information:</strong> Ensure phone and email are current</li>
 | |
|             <li><strong>Add Affiliated Entities:</strong> Create additional organizers for partner organizations</li>
 | |
|             <li><strong>Use Existing When Possible:</strong> You can select any existing organizer when creating events</li>
 | |
|         </ol>
 | |
|         
 | |
|         <div class="hvac-important">
 | |
|             <strong>⚠️ Important:</strong> You can only edit venues and organizers that you created, but you can use any existing venue or organizer when setting up events. Always check for existing entries before creating new ones.
 | |
|         </div>
 | |
|         
 | |
|         <h2 id="creating-events">Creating & Managing Events</h2>
 | |
|         <p>Events are the heart of your training business on Upskill. Here's how to create compelling training opportunities:</p>
 | |
|         
 | |
|         <h3>Creating Your First Event</h3>
 | |
|         <ol>
 | |
|             <li><strong>Start Creation:</strong> Click "Events" → "New Event" in the navigation menu</li>
 | |
|             <li><strong>Choose Event Type:</strong>
 | |
|                 <ul>
 | |
|                     <li>In-Person Training: For hands-on workshops at a physical location</li>
 | |
|                     <li>Virtual/Webinar: For online training sessions</li>
 | |
|                     <li>Hybrid: Combination of in-person and virtual attendance</li>
 | |
|                 </ul>
 | |
|             </li>
 | |
|             <li><strong>Set Essential Details:</strong>
 | |
|                 <ul>
 | |
|                     <li><strong>Title:</strong> Make it descriptive and searchable (e.g., "HVAC System Diagnostics Workshop - Dallas")</li>
 | |
|                     <li><strong>Date & Time:</strong> Set clear start and end times</li>
 | |
|                     <li><strong>Venue:</strong> Select from existing venues or create new</li>
 | |
|                     <li><strong>Organizer:</strong> Choose the appropriate organizing entity</li>
 | |
|                 </ul>
 | |
|             </li>
 | |
|             <li><strong>Write Compelling Description:</strong>
 | |
|                 <ul>
 | |
|                     <li>Learning objectives</li>
 | |
|                     <li>Prerequisites or skill level</li>
 | |
|                     <li>What to bring</li>
 | |
|                     <li>Agenda or schedule</li>
 | |
|                     <li>Instructor credentials</li>
 | |
|                 </ul>
 | |
|             </li>
 | |
|             <li><strong>Add Event Image:</strong> Upload an eye-catching image (recommended: 1920x1080px)</li>
 | |
|             <li><strong>Configure Registration:</strong>
 | |
|                 <ul>
 | |
|                     <li>Set ticket prices (or make it free)</li>
 | |
|                     <li>Define capacity limits</li>
 | |
|                     <li>Add early bird pricing if desired</li>
 | |
|                     <li>Enable RSVPs for free events</li>
 | |
|                 </ul>
 | |
|             </li>
 | |
|             <li><strong>Virtual Event Settings:</strong> If online, add:
 | |
|                 <ul>
 | |
|                     <li>Video conference link (Zoom, Teams, etc.)</li>
 | |
|                     <li>Access instructions</li>
 | |
|                     <li>Technical requirements</li>
 | |
|                 </ul>
 | |
|             </li>
 | |
|         </ol>
 | |
|         
 | |
|         <h3>Event Approval Process</h3>
 | |
|         <div class="hvac-notice hvac-notice-info">
 | |
|             <strong>📋 Note:</strong> New events must be approved by a Master Trainer (currently Joe Medosch) before appearing publicly. This ensures quality and consistency across the platform. Approval typically occurs within 24 hours.
 | |
|         </div>
 | |
|         
 | |
|         <h3>Editing Existing Events</h3>
 | |
|         <ul>
 | |
|             <li>Access your events from the dashboard</li>
 | |
|             <li>Click "Edit" to modify details</li>
 | |
|             <li>Changes to approved events may require re-approval</li>
 | |
|             <li>Notify registered attendees of significant changes</li>
 | |
|         </ul>
 | |
|         
 | |
|         <h2 id="event-attendance">Managing Event Attendance</h2>
 | |
|         <p>Efficiently tracking attendance ensures accurate certificates and helps build your training reputation.</p>
 | |
|         
 | |
|         <h3>Check-In Methods</h3>
 | |
|         
 | |
|         <h4>Method 1: Manual Check-In (Web Interface)</h4>
 | |
|         <ol>
 | |
|             <li>Go to your event page</li>
 | |
|             <li>Click "View Attendees"</li>
 | |
|             <li>Mark attendees as "Checked In" as they arrive</li>
 | |
|             <li>Add notes for partial attendance if needed</li>
 | |
|         </ol>
 | |
|         
 | |
|         <h4>Method 2: Event Tickets Plus App</h4>
 | |
|         <ol>
 | |
|             <li>Download the Event Tickets Plus app on your mobile device</li>
 | |
|             <li>Connect to your Upskill account</li>
 | |
|             <li>Scan QR codes or search attendee names</li>
 | |
|             <li>Real-time sync with the platform</li>
 | |
|         </ol>
 | |
|         
 | |
|         <p><strong>App Setup Guide:</strong> <a href="https://theeventscalendar.com/knowledgebase/connecting-event-tickets-plus-app/" target="_blank">Connect Event Tickets Plus App →</a></p>
 | |
|         
 | |
|         <h2 id="certificates">Certificate Generation</h2>
 | |
|         <p>Professional certificates add value to your training and help attendees document their continuing education.</p>
 | |
|         
 | |
|         <h3>Certificate Requirements</h3>
 | |
|         <ul>
 | |
|             <li>Event must be completed (past the end date)</li>
 | |
|             <li>Event must be approved by a Master Trainer</li>
 | |
|             <li>Attendees must be marked as checked-in</li>
 | |
|         </ul>
 | |
|         
 | |
|         <h3>Generating Certificates</h3>
 | |
|         <ol>
 | |
|             <li><strong>Navigate to Certificates:</strong> Click "Certificates" → "New Certificate"</li>
 | |
|             <li><strong>Select Event:</strong> Choose from your completed events</li>
 | |
|             <li><strong>Choose Recipients:</strong> Select all or specific attendees</li>
 | |
|             <li><strong>Review Information:</strong> Verify names, dates, and training details</li>
 | |
|             <li><strong>Generate PDFs:</strong> Click "Generate Certificates"</li>
 | |
|             <li><strong>Distribution Options:</strong>
 | |
|                 <ul>
 | |
|                     <li>Email directly to attendees (automatic)</li>
 | |
|                     <li>Download for manual distribution</li>
 | |
|                     <li>Attendees can access via their profile</li>
 | |
|                 </ul>
 | |
|             </li>
 | |
|         </ol>
 | |
|         
 | |
|         <div class="hvac-feature">
 | |
|             <strong>✨ Certificate Features:</strong>
 | |
|             <ul>
 | |
|                 <li>Unique certificate ID for verification</li>
 | |
|                 <li>Professional design with Upskill branding</li>
 | |
|                 <li>Trainer name and credentials displayed</li>
 | |
|                 <li>QR code for digital verification</li>
 | |
|                 <li>PDF format for easy sharing and printing</li>
 | |
|             </ul>
 | |
|         </div>
 | |
|         
 | |
|         <h2 id="faqs">Frequently Asked Questions</h2>
 | |
|         
 | |
|         <div class="hvac-faq">
 | |
|             <h3>How do I change my password?</h3>
 | |
|             <p>Navigate to your Profile page and look for the "Change Password" section. Enter your current password, then your new password twice to confirm.</p>
 | |
|         </div>
 | |
|         
 | |
|         <div class="hvac-faq">
 | |
|             <h3>Why can't I see my events publicly?</h3>
 | |
|             <p>New events require approval from a Master Trainer before appearing publicly. This typically happens within 24 hours. If your event hasn't been approved after 48 hours, contact support at <a href="mailto:joe@upskillhvac.com">joe@upskillhvac.com</a>.</p>
 | |
|         </div>
 | |
|         
 | |
|         <div class="hvac-faq">
 | |
|             <h3>How do I get paid for my training events?</h3>
 | |
|             <p>Val Buckles from our finance team will contact you to set up payment processing. You'll receive 100% of ticket sales minus standard Stripe processing fees (2.9% + $0.30 per transaction). Payments are typically processed weekly.</p>
 | |
|         </div>
 | |
|         
 | |
|         <div class="hvac-faq">
 | |
|             <h3>Who do I contact if I need help?</h3>
 | |
|             <p>For technical support and event approval questions, email Joe Medosch at <a href="mailto:joe@upskillhvac.com">joe@upskillhvac.com</a>. Joe is our Master Trainer and platform administrator.</p>
 | |
|         </div>
 | |
|         
 | |
|         <div class="hvac-faq">
 | |
|             <h3>Can I list any type of HVAC training event?</h3>
 | |
|             <p>Yes! We welcome all HVAC-related training events, including:</p>
 | |
|             <ul>
 | |
|                 <li>Technical skills workshops</li>
 | |
|                 <li>Certification prep courses</li>
 | |
|                 <li>Safety training</li>
 | |
|                 <li>Business development seminars</li>
 | |
|                 <li>Product-specific training</li>
 | |
|                 <li>Soft skills for HVAC professionals</li>
 | |
|             </ul>
 | |
|         </div>
 | |
|         
 | |
|         <div class="hvac-faq">
 | |
|             <h3>Do I need to be a Certified measureQuick Trainer?</h3>
 | |
|             <p>No, you don't need measureQuick certification to use the platform. While many of our trainers are measureQuick certified, we welcome all qualified HVAC trainers. The platform is open to anyone providing quality HVAC education.</p>
 | |
|         </div>
 | |
|         
 | |
|         <div class="hvac-faq">
 | |
|             <h3>How do I promote my events?</h3>
 | |
|             <p>Your events are automatically:</p>
 | |
|             <ul>
 | |
|                 <li>Listed in the public events calendar</li>
 | |
|                 <li>Searchable by location and topic</li>
 | |
|                 <li>Promoted in the Upskill newsletter (for approved events)</li>
 | |
|                 <li>Shareable via direct link and social media</li>
 | |
|             </ul>
 | |
|             <p>You can also share your trainer profile link to drive traffic to all your events.</p>
 | |
|         </div>
 | |
|         
 | |
|         <div class="hvac-faq">
 | |
|             <h3>Can I offer discounts or promo codes?</h3>
 | |
|             <p>Yes, you can create:</p>
 | |
|             <ul>
 | |
|                 <li>Early bird pricing with automatic date cutoffs</li>
 | |
|                 <li>Group discounts for bulk registrations</li>
 | |
|                 <li>Custom promo codes for marketing campaigns</li>
 | |
|                 <li>Member-only pricing for associations</li>
 | |
|             </ul>
 | |
|         </div>
 | |
|         
 | |
|         <h2 id="getting-help">Getting Additional Help</h2>
 | |
|         
 | |
|         <div class="hvac-help-resources">
 | |
|             <div class="hvac-help-card">
 | |
|                 <h3>📧 Email Support</h3>
 | |
|                 <p>For questions and technical issues:</p>
 | |
|                 <p><a href="mailto:joe@upskillhvac.com" class="hvac-button">joe@upskillhvac.com</a></p>
 | |
|             </div>
 | |
|             
 | |
|             <div class="hvac-help-card">
 | |
|                 <h3>💰 Payment Questions</h3>
 | |
|                 <p>Val Buckles handles all payment setup:</p>
 | |
|                 <p>She will contact you directly</p>
 | |
|             </div>
 | |
|             
 | |
|             <div class="hvac-help-card">
 | |
|                 <h3>🎥 Video Tutorials</h3>
 | |
|                 <p>Coming soon: Step-by-step video guides for common tasks</p>
 | |
|             </div>
 | |
|         </div>
 | |
|         
 | |
|         <style>
 | |
|         /* Documentation Specific Styles */
 | |
|         .lead {
 | |
|             font-size: 20px;
 | |
|             color: #666;
 | |
|             margin-bottom: 30px;
 | |
|             line-height: 1.6;
 | |
|         }
 | |
|         
 | |
|         .hvac-highlight-box {
 | |
|             background: linear-gradient(135deg, #f5f7fa 0%, #c3cfe2 100%);
 | |
|             border-left: 4px solid #E9AF28;
 | |
|             padding: 20px;
 | |
|             margin: 30px 0;
 | |
|             border-radius: 8px;
 | |
|         }
 | |
|         
 | |
|         .hvac-highlight-box h3 {
 | |
|             margin-top: 0;
 | |
|             color: #333;
 | |
|         }
 | |
|         
 | |
|         .hvac-concepts-grid {
 | |
|             display: grid;
 | |
|             grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
 | |
|             gap: 20px;
 | |
|             margin: 30px 0;
 | |
|         }
 | |
|         
 | |
|         .hvac-concept-card {
 | |
|             background: #f8f9fa;
 | |
|             padding: 20px;
 | |
|             border-radius: 8px;
 | |
|             border: 1px solid #e9ecef;
 | |
|             transition: transform 0.2s, box-shadow 0.2s;
 | |
|         }
 | |
|         
 | |
|         .hvac-concept-card:hover {
 | |
|             transform: translateY(-2px);
 | |
|             box-shadow: 0 4px 12px rgba(0,0,0,0.1);
 | |
|         }
 | |
|         
 | |
|         .hvac-concept-card h3 {
 | |
|             margin-top: 0;
 | |
|             font-size: 20px;
 | |
|             color: #333;
 | |
|         }
 | |
|         
 | |
|         .hvac-concept-card p {
 | |
|             margin-bottom: 0;
 | |
|             color: #666;
 | |
|         }
 | |
|         
 | |
|         .hvac-tip {
 | |
|             background: #fff3cd;
 | |
|             border: 1px solid #ffc107;
 | |
|             padding: 15px;
 | |
|             margin: 20px 0;
 | |
|             border-radius: 6px;
 | |
|         }
 | |
|         
 | |
|         .hvac-important {
 | |
|             background: #f8d7da;
 | |
|             border: 1px solid #f5c6cb;
 | |
|             padding: 15px;
 | |
|             margin: 20px 0;
 | |
|             border-radius: 6px;
 | |
|             color: #721c24;
 | |
|         }
 | |
|         
 | |
|         .hvac-feature {
 | |
|             background: #d4edda;
 | |
|             border: 1px solid #c3e6cb;
 | |
|             padding: 15px;
 | |
|             margin: 20px 0;
 | |
|             border-radius: 6px;
 | |
|         }
 | |
|         
 | |
|         .hvac-faq {
 | |
|             background: #fff;
 | |
|             border: 1px solid #dee2e6;
 | |
|             padding: 20px;
 | |
|             margin: 20px 0;
 | |
|             border-radius: 8px;
 | |
|             box-shadow: 0 2px 4px rgba(0,0,0,0.05);
 | |
|         }
 | |
|         
 | |
|         .hvac-faq h3 {
 | |
|             margin-top: 0;
 | |
|             color: #E9AF28;
 | |
|             font-size: 18px;
 | |
|         }
 | |
|         
 | |
|         .hvac-help-resources {
 | |
|             display: grid;
 | |
|             grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
 | |
|             gap: 20px;
 | |
|             margin: 30px 0;
 | |
|         }
 | |
|         
 | |
|         .hvac-help-card {
 | |
|             background: #f8f9fa;
 | |
|             padding: 25px;
 | |
|             text-align: center;
 | |
|             border-radius: 8px;
 | |
|             border: 1px solid #e9ecef;
 | |
|         }
 | |
|         
 | |
|         .hvac-help-card h3 {
 | |
|             margin-top: 0;
 | |
|             color: #333;
 | |
|         }
 | |
|         
 | |
|         .hvac-button {
 | |
|             display: inline-block;
 | |
|             background: #E9AF28;
 | |
|             color: white;
 | |
|             padding: 10px 20px;
 | |
|             border-radius: 6px;
 | |
|             text-decoration: none;
 | |
|             transition: background 0.2s;
 | |
|         }
 | |
|         
 | |
|         .hvac-button:hover {
 | |
|             background: #d49a1e;
 | |
|             color: white;
 | |
|         }
 | |
|         
 | |
|         /* Responsive adjustments */
 | |
|         @media (max-width: 768px) {
 | |
|             .hvac-concepts-grid {
 | |
|                 grid-template-columns: 1fr;
 | |
|             }
 | |
|             
 | |
|             .hvac-help-resources {
 | |
|                 grid-template-columns: 1fr;
 | |
|             }
 | |
|         }
 | |
|         </style>
 | |
|         
 | |
|         <?php
 | |
|         return ob_get_clean();
 | |
|     }
 | |
| }
 | |
| 
 | |
| // Initialize
 | |
| HVAC_Documentation_Content::instance();
 |