705e6b563c
- Add comprehensive Training Leads system for HVAC trainers * New /trainer/training-leads/ page with tabular contact submission display * HVAC_Training_Leads class with AJAX status updates and filtering * Empty state messaging and profile sharing CTA * Database integration with existing contact forms system - Restructure trainer navigation menu for better UX * Rename "Customize" to "Profile" with logical groupings * Move "Logout" under "Profile" submenu * Change "Personal Profile" to "Trainer Profile" * Add "Training Leads" under Profile section * Update help menu to show only question mark icon positioned far right - Enhance documentation system * Fix /trainer/documentation/ page styling and navigation integration * Update content to reflect current platform features * Add Training Leads documentation and navigation guide * Implement proper WordPress template structure - Update user management * Change joe@upskillhvac.com display name to "Joe Medosch" * Assign Joe as author of measureQuick headquarters venue * Assign Joe as author of measureQuick and Upskill HVAC organizers 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
492 lines
No EOL
24 KiB
PHP
492 lines
No EOL
24 KiB
PHP
<?php
|
|
/**
|
|
* HVAC Help System
|
|
*
|
|
* Manages welcome guide, tooltips, and documentation for the HVAC Community Events plugin
|
|
*/
|
|
|
|
class HVAC_Help_System {
|
|
|
|
private static $instance = null;
|
|
|
|
public static function instance() {
|
|
if (null === self::$instance) {
|
|
self::$instance = new self();
|
|
}
|
|
return self::$instance;
|
|
}
|
|
|
|
private function __construct() {
|
|
add_action('wp_enqueue_scripts', array($this, 'enqueue_help_assets'));
|
|
add_action('wp_footer', array($this, 'render_welcome_guide'));
|
|
add_shortcode('hvac_documentation', array($this, 'render_documentation_page'));
|
|
add_action('wp_ajax_hvac_dismiss_welcome', array($this, 'handle_welcome_dismissal'));
|
|
add_action('wp_ajax_nopriv_hvac_dismiss_welcome', array($this, 'handle_welcome_dismissal'));
|
|
}
|
|
|
|
/**
|
|
* Enqueue help system assets
|
|
*/
|
|
public function enqueue_help_assets() {
|
|
// Only load on HVAC pages for authenticated trainers
|
|
if (!$this->is_hvac_page() || !$this->is_trainer_logged_in()) {
|
|
return;
|
|
}
|
|
|
|
// Enqueue Font Awesome for icons
|
|
wp_enqueue_style(
|
|
'font-awesome',
|
|
'https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css',
|
|
array(),
|
|
'6.0.0'
|
|
);
|
|
|
|
wp_enqueue_style(
|
|
'hvac-help-system',
|
|
HVAC_PLUGIN_URL . 'assets/css/hvac-help-system.css',
|
|
array('hvac-common-style', 'font-awesome'),
|
|
HVAC_PLUGIN_VERSION
|
|
);
|
|
|
|
wp_enqueue_script(
|
|
'hvac-help-system',
|
|
HVAC_PLUGIN_URL . 'assets/js/hvac-help-system.js',
|
|
array('jquery'),
|
|
HVAC_PLUGIN_VERSION,
|
|
true
|
|
);
|
|
|
|
wp_localize_script('hvac-help-system', 'hvacHelp', array(
|
|
'ajaxUrl' => admin_url('admin-ajax.php'),
|
|
'nonce' => wp_create_nonce('hvac_help_nonce'),
|
|
'showWelcome' => $this->should_show_welcome_guide()
|
|
));
|
|
}
|
|
|
|
/**
|
|
* Check if current page is an HVAC custom page
|
|
*/
|
|
private function is_hvac_page() {
|
|
$hvac_pages = array(
|
|
'hvac-dashboard', 'trainer-registration', 'community-login',
|
|
'trainer-profile', 'event-summary', 'email-attendees',
|
|
'certificate-reports', 'generate-certificates', 'hvac-documentation'
|
|
);
|
|
|
|
foreach ($hvac_pages as $page) {
|
|
if (is_page($page)) {
|
|
return true;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Check if current user is a logged-in trainer
|
|
*/
|
|
private function is_trainer_logged_in() {
|
|
return is_user_logged_in() && (current_user_can('hvac_trainer') || current_user_can('administrator'));
|
|
}
|
|
|
|
/**
|
|
* Check if welcome guide should be shown
|
|
*/
|
|
private function should_show_welcome_guide() {
|
|
if (!$this->is_trainer_logged_in()) {
|
|
return false;
|
|
}
|
|
|
|
// Check cookie for dismissal
|
|
if (isset($_COOKIE['hvac_welcome_dismissed'])) {
|
|
return false;
|
|
}
|
|
|
|
// Only show on dashboard page
|
|
return is_page('hvac-dashboard');
|
|
}
|
|
|
|
/**
|
|
* Render welcome guide modal
|
|
*/
|
|
public function render_welcome_guide() {
|
|
if (!$this->should_show_welcome_guide()) {
|
|
return;
|
|
}
|
|
|
|
$cards = $this->get_welcome_cards();
|
|
?>
|
|
<div id="hvac-welcome-modal" class="hvac-modal-overlay">
|
|
<div class="hvac-modal-content">
|
|
<div class="hvac-modal-header">
|
|
<h2>Welcome to Upskill HVAC Training Network!</h2>
|
|
<button class="hvac-modal-close" aria-label="Close welcome guide">×</button>
|
|
</div>
|
|
|
|
<div class="hvac-welcome-cards">
|
|
<?php foreach ($cards as $index => $card): ?>
|
|
<div class="hvac-welcome-card <?php echo $index === 0 ? 'active' : 'hidden'; ?>" data-card="<?php echo $index; ?>">
|
|
<div class="hvac-card-icon">
|
|
<i class="<?php echo esc_attr($card['icon']); ?>"></i>
|
|
</div>
|
|
<div class="hvac-card-content">
|
|
<h3><?php echo esc_html($card['title']); ?></h3>
|
|
<p><?php echo esc_html($card['description']); ?></p>
|
|
</div>
|
|
</div>
|
|
<?php endforeach; ?>
|
|
</div>
|
|
|
|
<div class="hvac-modal-navigation">
|
|
<button id="hvac-prev-card" class="hvac-nav-btn" disabled>Previous</button>
|
|
<div class="hvac-card-indicators">
|
|
<?php for ($i = 0; $i < count($cards); $i++): ?>
|
|
<span class="hvac-indicator <?php echo $i === 0 ? 'active' : ''; ?>" data-card="<?php echo $i; ?>"></span>
|
|
<?php endfor; ?>
|
|
</div>
|
|
<button id="hvac-next-card" class="hvac-nav-btn">Next</button>
|
|
</div>
|
|
|
|
<div class="hvac-modal-footer">
|
|
<label class="hvac-dismiss-checkbox">
|
|
<input type="checkbox" id="hvac-dont-show-again"> Don't show this again
|
|
</label>
|
|
<button id="hvac-get-started" class="hvac-primary-btn">Get Started</button>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<?php
|
|
}
|
|
|
|
/**
|
|
* Get welcome guide cards data
|
|
*/
|
|
private function get_welcome_cards() {
|
|
return array(
|
|
array(
|
|
'icon' => 'fas fa-chalkboard-teacher',
|
|
'title' => 'Welcome to Your Training Hub',
|
|
'description' => 'As a verified HVAC trainer, you have access to powerful tools for managing your training business. Your dashboard shows real-time stats, upcoming events, and revenue tracking.'
|
|
),
|
|
array(
|
|
'icon' => 'fas fa-calendar-plus',
|
|
'title' => 'Create Events in Minutes',
|
|
'description' => 'Click "Create Event" to set up new trainings. Add details, set pricing, and manage capacity. Your events appear immediately in your dashboard - no WordPress admin needed!'
|
|
),
|
|
array(
|
|
'icon' => 'fas fa-certificate',
|
|
'title' => 'Professional Certificates Made Easy',
|
|
'description' => 'After your event, generate beautiful certificates with your name, attendee details, and the Upskill HVAC logo. Click "Certificate Issued" to view any certificate instantly.'
|
|
),
|
|
array(
|
|
'icon' => 'fas fa-users',
|
|
'title' => 'Manage Everything in One Place',
|
|
'description' => 'Email attendees, track registrations, generate reports, and monitor your progress. Use the navigation menu to access all features - tooltips guide you every step of the way.'
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Handle AJAX request to dismiss welcome guide
|
|
*/
|
|
public function handle_welcome_dismissal() {
|
|
if (!wp_verify_nonce($_POST['nonce'], 'hvac_help_nonce')) {
|
|
wp_die('Invalid nonce');
|
|
}
|
|
|
|
if (!$this->is_trainer_logged_in()) {
|
|
wp_die('Unauthorized');
|
|
}
|
|
|
|
// Set cookie to expire in 30 days
|
|
setcookie('hvac_welcome_dismissed', '1', time() + (30 * 24 * 60 * 60), COOKIEPATH, COOKIE_DOMAIN);
|
|
|
|
wp_send_json_success();
|
|
}
|
|
|
|
/**
|
|
* Render documentation page content
|
|
*/
|
|
public function render_documentation_page($atts) {
|
|
if (!$this->is_trainer_logged_in()) {
|
|
return '<p>Please log in to access the documentation.</p>';
|
|
}
|
|
|
|
ob_start();
|
|
?>
|
|
<div class="hvac-documentation">
|
|
<div class="hvac-doc-header">
|
|
<h1>Trainer Documentation</h1>
|
|
<p class="hvac-doc-subtitle">Everything you need to know about managing your training events</p>
|
|
</div>
|
|
|
|
<div class="hvac-doc-navigation">
|
|
<ul class="hvac-doc-nav">
|
|
<li><a href="#getting-started" class="hvac-doc-link">Getting Started</a></li>
|
|
<li><a href="#managing-events" class="hvac-doc-link">Managing Events</a></li>
|
|
<li><a href="#attendee-management" class="hvac-doc-link">Attendee Management</a></li>
|
|
<li><a href="#certificates" class="hvac-doc-link">Certificates</a></li>
|
|
<li><a href="#faq" class="hvac-doc-link">FAQ</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="hvac-doc-content">
|
|
<?php echo $this->get_documentation_content(); ?>
|
|
</div>
|
|
</div>
|
|
<?php
|
|
return ob_get_clean();
|
|
}
|
|
|
|
/**
|
|
* Get main documentation content
|
|
*/
|
|
private function get_documentation_content() {
|
|
return '
|
|
<section id="getting-started" class="hvac-doc-section">
|
|
<h2><i class="fas fa-play-circle"></i> Getting Started</h2>
|
|
<div class="hvac-doc-intro">
|
|
<p class="hvac-welcome-message">Welcome to Upskill HVAC! You\'re part of our comprehensive training platform designed to help HVAC trainers get discovered, share training events, build professional reputation, and connect with the HVAC community.</p>
|
|
</div>
|
|
<div class="hvac-doc-grid">
|
|
<div class="hvac-doc-card">
|
|
<h3>1. Your Dashboard is Home Base</h3>
|
|
<p>Everything starts at your dashboard. See your total events, upcoming trainings, revenue progress, and quick links to all features. Track your performance metrics and manage everything from one place.</p>
|
|
<a href="' . home_url('/trainer/dashboard/') . '" class="hvac-doc-btn">Go to Dashboard</a>
|
|
</div>
|
|
<div class="hvac-doc-card">
|
|
<h3>2. Update Your Profile First</h3>
|
|
<p>Your trainer profile is your professional showcase in our directory. Complete your profile to appear in "Find A Trainer" searches and generate more training leads.</p>
|
|
<a href="' . home_url('/trainer/profile/') . '" class="hvac-doc-btn">Edit Profile</a>
|
|
</div>
|
|
<div class="hvac-doc-card">
|
|
<h3>3. Create Your First Event</h3>
|
|
<p>Ready to host training? Create events with pricing, capacity limits, and venue information. Your events integrate with The Events Calendar for seamless management.</p>
|
|
<a href="' . home_url('/tribe/events/add/') . '" class="hvac-doc-btn">Create Event</a>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section id="managing-events" class="hvac-doc-section">
|
|
<h2><i class="fas fa-calendar-alt"></i> Managing Events & Training</h2>
|
|
<div class="hvac-feature-list">
|
|
<div class="hvac-feature">
|
|
<h3>Integrated Event System</h3>
|
|
<p>Our platform integrates with The Events Calendar to provide comprehensive event management:</p>
|
|
<ul>
|
|
<li><strong>Training Events:</strong> Sessions with pricing, capacity, and location</li>
|
|
<li><strong>Venues:</strong> Physical or virtual training locations</li>
|
|
<li><strong>Organizers:</strong> Business entities with logos and contact info</li>
|
|
<li><strong>Revenue Tracking:</strong> Monitor training income and attendance</li>
|
|
</ul>
|
|
</div>
|
|
<div class="hvac-feature">
|
|
<h3>Quick Event Management</h3>
|
|
<ol>
|
|
<li><strong>Dashboard Overview:</strong> See all your events at a glance</li>
|
|
<li><strong>New Event:</strong> Click to create from navigation menu</li>
|
|
<li><strong>Event Management:</strong> Access manage page for detailed controls</li>
|
|
<li><strong>Analytics:</strong> View performance metrics and revenue data</li>
|
|
</ol>
|
|
</div>
|
|
<div class="hvac-feature">
|
|
<h3>Venues & Organizers</h3>
|
|
<p>Manage your training infrastructure:</p>
|
|
<ul>
|
|
<li><strong>Training Venues:</strong> Add locations where you conduct training</li>
|
|
<li><strong>Training Organizers:</strong> Set up business entities with branding</li>
|
|
<li><strong>Auto-Creation:</strong> We\'ve tried to auto-create these for you!</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section id="profile-directory" class="hvac-doc-section">
|
|
<h2><i class="fas fa-user-circle"></i> Your Professional Profile</h2>
|
|
<div class="hvac-feature-list">
|
|
<div class="hvac-feature">
|
|
<h3>Directory Listing</h3>
|
|
<p>Your profile appears in our "Find A Trainer" directory where potential students can discover you:</p>
|
|
<ul>
|
|
<li><strong>Map Integration:</strong> Shows your location and service areas</li>
|
|
<li><strong>Contact Form:</strong> Students can reach out directly</li>
|
|
<li><strong>QR Code Sharing:</strong> Easy sharing at events and conferences</li>
|
|
<li><strong>Professional Showcase:</strong> Display credentials and experience</li>
|
|
</ul>
|
|
</div>
|
|
<div class="hvac-feature">
|
|
<h3>Training Leads</h3>
|
|
<p>When potential students find you in the directory, they can submit contact requests that appear in your Training Leads page:</p>
|
|
<ul>
|
|
<li><strong>Lead Management:</strong> Track contact requests from potential clients</li>
|
|
<li><strong>Status Tracking:</strong> Mark leads as read, replied, or archived</li>
|
|
<li><strong>Direct Contact:</strong> Email and phone information included</li>
|
|
<li><strong>Message History:</strong> View full inquiry details</li>
|
|
</ul>
|
|
<a href="' . home_url('/trainer/training-leads/') . '" class="hvac-doc-btn">View Training Leads</a>
|
|
</div>
|
|
<div class="hvac-feature">
|
|
<h3>Pro Tip: Share Your Profile</h3>
|
|
<p>The more you share your profile, the more training leads you can generate! Use social media, business cards, or the built-in QR code feature.</p>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section id="certificates" class="hvac-doc-section">
|
|
<h2><i class="fas fa-certificate"></i> Certificate Generation</h2>
|
|
<div class="hvac-feature-list">
|
|
<div class="hvac-feature">
|
|
<h3>Professional Certificates</h3>
|
|
<p>Generate beautiful completion certificates with the Upskill HVAC logo, your name as instructor, and attendee details. Each certificate has a unique number and can be verified.</p>
|
|
<ul>
|
|
<li><strong>Automated Generation:</strong> Create certificates for event attendees</li>
|
|
<li><strong>Professional Design:</strong> Branded with Upskill HVAC styling</li>
|
|
<li><strong>Unique Verification:</strong> Each certificate has a verification number</li>
|
|
<li><strong>Easy Distribution:</strong> Download and share with attendees</li>
|
|
</ul>
|
|
</div>
|
|
<div class="hvac-feature">
|
|
<h3>Certificate Workflow</h3>
|
|
<ol>
|
|
<li><strong>Navigate to Certificates:</strong> Use the navigation menu</li>
|
|
<li><strong>Generate New Certificates:</strong> Select event and attendees</li>
|
|
<li><strong>View Certificate Reports:</strong> Track all issued certificates</li>
|
|
<li><strong>Download & Share:</strong> Distribute to your trainees</li>
|
|
</ol>
|
|
<div class="hvac-feature-links">
|
|
<a href="' . home_url('/trainer/generate-certificates/') . '" class="hvac-doc-btn">Generate Certificates</a>
|
|
<a href="' . home_url('/trainer/certificate-reports/') . '" class="hvac-doc-btn hvac-doc-btn-secondary">View Reports</a>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section id="navigation" class="hvac-doc-section">
|
|
<h2><i class="fas fa-compass"></i> Navigation Guide</h2>
|
|
<div class="hvac-feature-list">
|
|
<div class="hvac-feature">
|
|
<h3>Updated Navigation Menu</h3>
|
|
<p>Our streamlined navigation makes it easy to access all platform features:</p>
|
|
<ul>
|
|
<li><strong>Events:</strong> Dashboard and create new events</li>
|
|
<li><strong>Certificates:</strong> Generate and view certificate reports</li>
|
|
<li><strong>Profile:</strong> Your professional profile, training leads, venues, and organizers</li>
|
|
<li><strong>Help (?):</strong> Access this documentation anytime</li>
|
|
</ul>
|
|
</div>
|
|
<div class="hvac-feature">
|
|
<h3>Quick Access Features</h3>
|
|
<ul>
|
|
<li><strong>Dashboard:</strong> Your training business overview</li>
|
|
<li><strong>Training Leads:</strong> Manage contact requests from potential clients</li>
|
|
<li><strong>Profile Management:</strong> Update your professional information</li>
|
|
<li><strong>Venue & Organizer Setup:</strong> Configure your training infrastructure</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section id="faq" class="hvac-doc-section">
|
|
<h2><i class="fas fa-question-circle"></i> Frequently Asked Questions</h2>
|
|
<div class="hvac-faq-list">
|
|
<div class="hvac-faq-item">
|
|
<h3>Where do I start?</h3>
|
|
<p>Start by updating your trainer profile to appear in our directory, then create your first training event. Your dashboard provides an overview of everything.</p>
|
|
</div>
|
|
<div class="hvac-faq-item">
|
|
<h3>How do I get more training leads?</h3>
|
|
<p>Complete your profile and share it! The more visible you are in our "Find A Trainer" directory, the more potential students will contact you through the Training Leads system.</p>
|
|
</div>
|
|
<div class="hvac-faq-item">
|
|
<h3>What\'s the difference between venues and organizers?</h3>
|
|
<p>Venues are physical or virtual locations where you conduct training. Organizers are business entities (like your company) that host the training and can have logos and branding.</p>
|
|
</div>
|
|
<div class="hvac-faq-item">
|
|
<h3>How do certificates work?</h3>
|
|
<p>After your training event, you can generate professional certificates for attendees. Each certificate is uniquely numbered and includes your name as the instructor and the Upskill HVAC branding.</p>
|
|
</div>
|
|
<div class="hvac-faq-item">
|
|
<h3>Can I track my training revenue?</h3>
|
|
<p>Yes! Your dashboard shows revenue tracking and analytics for all your training events. You can monitor your training business performance over time.</p>
|
|
</div>
|
|
<div class="hvac-faq-item">
|
|
<h3>What if I need help?</h3>
|
|
<p>Click the "?" icon in the navigation menu to return to this documentation anytime. You can also reach out to our support team for additional assistance.</p>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section id="getting-help" class="hvac-doc-section">
|
|
<h2><i class="fas fa-life-ring"></i> Getting Support</h2>
|
|
<div class="hvac-feature-list">
|
|
<div class="hvac-feature">
|
|
<h3>Quick Start Checklist</h3>
|
|
<ol>
|
|
<li><strong>✓ Update Your Profile</strong> - Make sure your information is complete</li>
|
|
<li><strong>✓ Add Training Venues</strong> - Set up your training locations</li>
|
|
<li><strong>✓ Create Training Organizer</strong> - Add your business entity</li>
|
|
<li><strong>✓ Create First Event</strong> - Host your first training session</li>
|
|
<li><strong>✓ Share Your Profile</strong> - Start generating training leads</li>
|
|
</ol>
|
|
</div>
|
|
<div class="hvac-feature">
|
|
<h3>Remember</h3>
|
|
<p>We\'ve tried to auto-create venues and organizers for you based on your profile information, but you may need to make corrections or updates to ensure everything is accurate.</p>
|
|
<p><strong>Pro tip:</strong> The more complete your profile, the more professional you appear to potential students and the more training leads you\'ll generate!</p>
|
|
</div>
|
|
</div>
|
|
</section>';
|
|
}
|
|
|
|
/**
|
|
* Add tooltip data attribute to elements
|
|
*/
|
|
public static function add_tooltip($content, $tooltip_text, $position = 'top') {
|
|
return sprintf(
|
|
'<span class="hvac-tooltip-wrapper" data-tooltip="%s" data-position="%s">%s</span>',
|
|
esc_attr($tooltip_text),
|
|
esc_attr($position),
|
|
$content
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get common tooltip texts for consistent help messaging
|
|
*/
|
|
public static function get_tooltip_text($key) {
|
|
$tooltips = array(
|
|
// Dashboard tooltips
|
|
'total_events' => 'All events you\'ve created, including past and future trainings',
|
|
'upcoming_events' => 'Events scheduled for the future that attendees can register for',
|
|
'total_revenue' => 'Your total earnings from all ticket sales (after Stripe fees)',
|
|
'revenue_target' => 'Annual revenue goal to maintain your trainer status',
|
|
|
|
// Event management tooltips
|
|
'create_event' => 'Start here to add a new training event',
|
|
'event_status' => 'Draft = not published yet, Published = live for registration',
|
|
'edit_event' => 'Click to modify event details like date, price, or description',
|
|
'view_attendees' => 'See who registered and their check-in status',
|
|
|
|
// Certificate tooltips
|
|
'generate_certificates' => 'Create professional completion certificates for your attendees',
|
|
'certificate_issued' => 'Click to view or download the certificate PDF',
|
|
'select_attendees' => 'Choose who receives certificates - typically checked-in attendees',
|
|
'bulk_generate' => 'Generate multiple certificates at once to save time',
|
|
|
|
// Profile tooltips
|
|
'trainer_profile' => 'Your public profile that attendees see when browsing events',
|
|
'credentials' => 'Add certifications and experience to build trust',
|
|
'business_info' => 'Company name and contact details for professional appearance',
|
|
|
|
// Email tooltips
|
|
'email_attendees' => 'Send updates or reminders to your event registrants',
|
|
'cc_recipients' => 'Add email addresses separated by commas to receive copies',
|
|
'email_preview' => 'Preview how your email will look before sending'
|
|
);
|
|
|
|
return isset($tooltips[$key]) ? $tooltips[$key] : '';
|
|
}
|
|
}
|
|
|
|
// Initialize the help system
|
|
HVAC_Help_System::instance();
|