kate522
3bec2a5777
主题打包的是 Font Awesome 5，solid 字形必须带样式类 fas。全站有 18 处仍写成 FA4 的裸 fa fa-*，FA5 下并不存在对应字形，表现为图标位置空白；而 FA5-only 契约此前只扫描部分运行时文件，没有覆盖模板与渲染器，这些写法一直没被拦下。 同时发现一处真实的失效图标名：profile-level.php 用的是 fa-line-chart。这是 FA4 名称，FA5 把该系列重命名为 chart-*，正确写法是 fa-chart-line。 - 18 处 "fa fa-*" 补上 fas：首页模板、组件标记、评论表单、用户等级页、菜单 装饰、SchemaPayment 促销标签默认值、VIP 服务弹窗、ContentRenderer / GeneralRenderer、后台卡片样式校验、pay-vip.js - profile-level.php 的 fa-line-chart 修正为 fa-chart-line - 三处注释里的示例值同步为合法形态（"fa fas fa-star"），避免被当成正确写法 抄走；credits.css 注释中直接写出旧字体族名的一处改为描述性表述，否则会被 FA5-only 契约当作违规命中 - legacy-navigation-contract：FA 资产断言改为跟随 aksrt_enqueue_fontawesome() 这一间接层（注册点已从脚本文件移到 inc/helpers/aksrt-icons.php），并把 fa-zibsvg-<key> 识别为项目自有 SVG sprite 族，而非 Font Awesome 字形 - vip-points-exchange-modal 契约同步断言 fa fas fa-angle-right 验证：改动前在干净 HEAD 上跑 node --test（已追踪用例）为 327 项 / 325 通过 / 2 失败，两项失败正是本次修复的失效图标名断言与 FA 版本号断言；改动后 333 项 / 333 通过（含 5 个本地专用用例共 370 项全部通过）。php -l 全部改动的 PHP 文件 通过。
86 lines
2.7 KiB
PHP
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 class 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>';
|
|
}
|