roles) && !current_user_can('manage_options')) {
return;
}
$menu_items = $this->get_master_menu_structure();
echo '';
}
/**
* Get master trainer menu structure
* Simplified to 5 essential items following UX best practices
*/
private function get_master_menu_structure() {
// Define simplified menu structure (5 primary items max)
$menu = array(
// Dashboard - Primary landing page
array(
'title' => esc_html__('Dashboard', 'hvac-community-events'),
'url' => home_url('/master-trainer/master-dashboard/'),
'icon' => 'dashicons-dashboard',
'cap' => 'hvac_master_trainer'
),
// Trainers - Core management function
array(
'title' => esc_html__('Trainers', 'hvac-community-events'),
'url' => home_url('/master-trainer/trainers/'),
'icon' => 'dashicons-groups',
'cap' => 'hvac_master_trainer',
'children' => array(
array(
'title' => esc_html__('All Trainers', 'hvac-community-events'),
'url' => home_url('/master-trainer/trainers/'),
'icon' => 'dashicons-list-view',
'cap' => 'hvac_master_trainer'
),
array(
'title' => esc_html__('Pending Approvals', 'hvac-community-events'),
'url' => home_url('/master-trainer/pending-approvals/'),
'icon' => 'dashicons-clock',
'cap' => 'approve_trainers'
)
)
),
// Tools - Administrative functions
array(
'title' => esc_html__('Tools', 'hvac-community-events'),
'url' => home_url('/master-trainer/communication-templates/'),
'icon' => 'dashicons-admin-tools',
'cap' => 'manage_communication_templates',
'children' => array(
array(
'title' => esc_html__('Google Sheets', 'hvac-community-events'),
'url' => home_url('/master-trainer/google-sheets/'),
'icon' => 'dashicons-media-spreadsheet',
'cap' => 'manage_google_sheets_integration'
),
array(
'title' => esc_html__('Communication Templates', 'hvac-community-events'),
'url' => home_url('/master-trainer/communication-templates/'),
'icon' => 'dashicons-email',
'cap' => 'manage_communication_templates'
),
array(
'title' => esc_html__('Announcements', 'hvac-community-events'),
'url' => home_url('/master-trainer/announcements/'),
'icon' => 'dashicons-megaphone',
'cap' => 'manage_announcements'
),
array(
'title' => esc_html__('Import/Export', 'hvac-community-events'),
'url' => home_url('/master-trainer/import-export/'),
'icon' => 'dashicons-database-import',
'cap' => 'import_export_data'
)
)
),
// Account - User options
array(
'title' => esc_html__('Account', 'hvac-community-events'),
'url' => '#',
'icon' => 'dashicons-admin-users',
'cap' => 'read',
'children' => array(
array(
'title' => esc_html__('Trainer Dashboard', 'hvac-community-events'),
'url' => home_url('/trainer/dashboard/'),
'icon' => 'dashicons-dashboard',
'cap' => 'read'
),
array(
'title' => esc_html__('Logout', 'hvac-community-events'),
'url' => wp_logout_url(home_url('/training-login/')),
'icon' => 'dashicons-exit',
'cap' => 'read',
'class' => 'menu-item-logout'
)
)
),
// Help - Documentation
array(
'title' => esc_html__('Help', 'hvac-community-events'),
'url' => home_url('/trainer/documentation/'),
'icon' => 'dashicons-editor-help',
'cap' => 'read',
'class' => 'hvac-help-menu-item'
)
);
// Allow other plugins to modify menu
$menu = apply_filters('hvac_master_menu_items', $menu);
// Filter menu items by user capabilities
$menu = $this->filter_menu_by_capabilities($menu);
return $menu;
}
/**
* Filter menu items by user capabilities
* Removes items the current user cannot access
*
* @param array $menu_items Menu items array
* @return array Filtered menu items
*/
private function filter_menu_by_capabilities($menu_items) {
$filtered_menu = array();
foreach ($menu_items as $item) {
// Check if user has capability for this item
$required_cap = isset($item['cap']) ? $item['cap'] : 'hvac_master_trainer';
// Handle role names vs capabilities properly
$user = wp_get_current_user();
$has_access = false;
if ($required_cap === 'hvac_master_trainer') {
$has_access = in_array('hvac_master_trainer', (array) $user->roles, true) || current_user_can('manage_options');
} else {
$has_access = current_user_can($required_cap);
}
if (!$has_access) {
continue; // Skip this item
}
// Filter children if they exist
if (isset($item['children']) && is_array($item['children'])) {
$filtered_children = array();
foreach ($item['children'] as $child) {
$child_cap = isset($child['cap']) ? $child['cap'] : 'hvac_master_trainer';
// Handle role names vs capabilities properly for children too
$has_child_access = false;
if ($child_cap === 'hvac_master_trainer') {
$has_child_access = in_array('hvac_master_trainer', (array) $user->roles, true) || current_user_can('manage_options');
} else {
$has_child_access = current_user_can($child_cap);
}
if ($has_child_access) {
$filtered_children[] = $child;
}
}
// Only include parent if it has accessible children or is directly accessible
if (!empty($filtered_children)) {
$item['children'] = $filtered_children;
$filtered_menu[] = $item;
} elseif (!isset($item['children']) || empty($item['children'])) {
// Include parent items without children
$filtered_menu[] = $item;
}
} else {
// Include items without children
$filtered_menu[] = $item;
}
}
return $filtered_menu;
}
/**
* Render a single menu item
*
* @param array $item Menu item configuration
*/
private function render_menu_item($item) {
$has_children = !empty($item['children']);
$current_url = $_SERVER['REQUEST_URI'];
// Check if this item or any of its children are active
$is_active = $this->is_menu_item_active($item, $current_url);
$li_classes = array('menu-item');
if ($is_active) {
$li_classes[] = 'current-menu-item';
}
if ($has_children) {
$li_classes[] = 'has-children';
}
if (!empty($item['class'])) {
$li_classes[] = $item['class'];
}
echo '';
// Main link
$link_attrs = array(
'href="' . esc_url($item['url']) . '"'
);
if ($has_children) {
$link_attrs[] = 'aria-haspopup="true"';
$link_attrs[] = 'aria-expanded="false"';
}
echo '';
if (!empty($item['icon'])) {
echo '';
}
echo '';
if ($has_children) {
echo '';
}
echo '';
// Children
if ($has_children) {
echo '';
}
echo '';
}
/**
* Check if menu item is active
*
* @param array $item Menu item
* @param string $current_url Current URL
* @return bool
*/
private function is_menu_item_active($item, $current_url) {
// Clean URLs for comparison
$item_path = parse_url($item['url'], PHP_URL_PATH);
$current_path = parse_url($current_url, PHP_URL_PATH);
// Check exact match
if ($item_path === $current_path) {
return true;
}
// Check if current URL starts with item URL (for parent items)
if (!empty($item_path) && $item_path !== '/' && strpos($current_path, $item_path) === 0) {
return true;
}
// Check children
if (!empty($item['children'])) {
foreach ($item['children'] as $child) {
if ($this->is_menu_item_active($child, $current_url)) {
return true;
}
}
}
return false;
}
}
// Initialize the class
HVAC_Master_Menu_System::instance();