Files
wordpress-theme-aksrt/inc/helpers/menu-decoration.php
T
kate522 2e25894eb5 fix(navigation): stop mangling zibsvg/customsvg menu icons
aksrt_render_menu_icon() prefixed any value without an fa substring
with fa fas fa-, turning picker values like zibsvg-hot into
fa fas fa-zibsvg-hot — blank icons in the frontend nav. Sprite and
inline SVG values now flow through aksrt_icon_markup with the
menu-item-icon classes attached; FA values keep the legacy padding.
2026-09-06 14:27:49 +08:00

86 lines
2.7 KiB
PHP

<?php
/**
* Menu decoration helpers — legacy's aksrt_menu_options contract.
*
* @package AKSRT
*/
defined('ABSPATH') || exit;
/**
* Read one menu item option from post meta aksrt_menu_options.
*
* @param int $id Menu item ID.
* @param string $key Option key.
* @param mixed $default Default.
* @return mixed
*/
function aksrt_menu_pz(int $id, string $key = '', $default = '') {
static $options = [];
if (!isset($options[$id])) {
$raw = get_post_meta($id, 'aksrt_menu_options', true);
$options[$id] = is_array($raw) ? $raw : [];
}
if ($key === '') {
return $options[$id];
}
return $options[$id][$key] ?? $default;
}
/**
* Decoration for a menu item (meta only).
*
* @param WP_Post|object $menu_item Menu item.
* @return array{icon:string,badge_text:string,badge_class:string,submenu_s:bool,submenu_type:string}
*/
function aksrt_get_menu_item_decoration($menu_item): array {
$id = (int) ($menu_item->ID ?? 0);
return [
'icon' => (string) aksrt_menu_pz($id, 'icon', ''),
'badge_text' => (string) aksrt_menu_pz($id, 'badge', ''),
'badge_class' => (string) aksrt_menu_pz($id, 'badge_class', ''),
'submenu_s' => !empty(aksrt_menu_pz($id, 'submenu_s', false)),
'submenu_type' => sanitize_key((string) aksrt_menu_pz($id, 'submenu_type', '')),
];
}
/**
* @param string $icon_class Icon-picker value (FA5 class, zibsvg- or customsvg-).
* @param bool $enabled Global switch.
*/
function aksrt_render_menu_icon(string $icon_class, bool $enabled = true): string {
if (!$enabled || $icon_class === '') {
return '';
}
// Sprite/inline values must reach aksrt_icon_markup untouched — the legacy
// fa-prefix padding below would corrupt them (zibsvg-hot → fa fas fa-zibsvg-hot).
if (str_starts_with($icon_class, 'zibsvg-')) {
return aksrt_icon_markup($icon_class, 'icon mr3 menu-item-icon');
}
if (str_starts_with($icon_class, 'customsvg-')) {
return aksrt_icon_markup($icon_class, 'mr3 menu-item-icon');
}
// legacy uses the Font Awesome 5 `fa` prefix.
if (strpos($icon_class, 'fa') === false) {
$icon_class = 'fa fas fa-' . ltrim($icon_class, '-');
} elseif (strpos($icon_class, 'fa-') === 0 && strpos($icon_class, ' ') === false) {
$icon_class = 'fa ' . $icon_class;
}
return aksrt_icon_markup($icon_class, 'mr3 menu-item-icon');
}
/**
* @param string $text Badge text.
* @param string $class Extra class (jb-red etc.).
* @param bool $enabled Global switch.
*/
function aksrt_render_menu_badge(string $text, string $class = '', bool $enabled = true): string {
if (!$enabled || $text === '') {
return '';
}
$cls = trim('menu-item-badge ' . $class);
return ' <badge class="' . esc_attr($cls) . '">' . esc_html($text) . '</badge>';
}