refactor(autoload): migrate theme classes to Composer PSR-4

Move 288 types from global AKSRT_* + inc/classes manual requires into
namespace AKSRT\{Domain} under src/AKSRT/, wire composer.json psr-4,
and slim bootstrap to helpers/modules/hooks only. Split multi-class
widget/gateway files, update admin contract audit paths, and document
the layout in ADR/README.
This commit is contained in:
kate522 committed 2026-07-17 13:29:22 +08:00
1 parent 8f349b40fb
commit aaf458af1c
404 files changed
+13602 -7705

No files matched your search

+58
View File
@@ -0,0 +1,58 @@
<?php
/**
* @package AKSRT
*/
namespace AKSRT\Frontend;
defined('ABSPATH') || exit;
class CustomCodeRenderer {
public function output_header(): void {
$custom_css = class_exists('\AKSRT\Settings\Settings')
? \AKSRT\Settings\Settings::custom_css()
: aksrt_get_setting('custom_css', '');
$head_code = class_exists('\AKSRT\Settings\Settings')
? \AKSRT\Settings\Settings::custom_head_code()
: aksrt_get_setting('custom_head_code', get_option('aksrt_custom_head_code', ''));
$trackcode = class_exists('\AKSRT\Settings\Settings')
? \AKSRT\Settings\Settings::trackcode()
: '';
echo $this->format((string) $custom_css, 'css', 'aksrt-custom-css');
if ($head_code) {
echo $this->format((string) $head_code, 'js', 'aksrt-custom-js-header');
}
if ($trackcode) {
echo $this->format((string) $trackcode, 'js', 'aksrt-trackcode');
}
}
public function output_footer(): void {
$footer_code = class_exists('\AKSRT\Settings\Settings')
? \AKSRT\Settings\Settings::custom_footer_code()
: aksrt_get_setting('custom_footer_code', get_option('aksrt_custom_footer_code', ''));
if ($footer_code) {
echo $this->format((string) $footer_code, 'js', 'aksrt-custom-js-footer');
}
}
private function format(string $code, string $type, string $id): string {
$code = trim($code);
if ($code === '') {
return '';
}
if (preg_match('/<\s*(script|style|meta|link|noscript)\b/i', $code)) {
return $code . "\n";
}
if ($type === 'css') {
return '<style id="' . esc_attr($id) . '">' . "\n" . $code . "\n</style>\n";
}
return '<script id="' . esc_attr($id) . '">' . "\n" . $code . "\n</script>\n";
}
}
+172
View File
@@ -0,0 +1,172 @@
<?php
/**
* @package AKSRT
*/
namespace AKSRT\Frontend;
defined('ABSPATH') || exit;
class InlineStyleBuilder {
public function output(): void {
$logo_url = class_exists('\AKSRT\Settings\Settings') ? \AKSRT\Settings\Settings::logo_url() : (string) aksrt_get_setting('logo_url', '');
$dark_logo_url = class_exists('\AKSRT\Settings\Settings') ? \AKSRT\Settings\Settings::logo_dark_url() : (string) aksrt_get_setting('site_logo_dark', '');
$favicon = class_exists('\AKSRT\Settings\Settings') ? \AKSRT\Settings\Settings::favicon_url() : (string) aksrt_get_setting('favicon_url', '');
$primary_color = class_exists('\AKSRT\Settings\Settings') ? \AKSRT\Settings\Settings::resolved_primary_color() : '#f04494';
$dark_primary = class_exists('\AKSRT\Settings\Settings') ? \AKSRT\Settings\Settings::dark_primary_color() : '#f04494';
$border_radius = class_exists('\AKSRT\Settings\Settings') ? \AKSRT\Settings\Settings::border_radius() : 8;
$card_radius = class_exists('\AKSRT\Settings\Settings') ? \AKSRT\Settings\Settings::card_radius() : ($border_radius + 4);
$container_max = class_exists('\AKSRT\Settings\Settings') ? \AKSRT\Settings\Settings::container_max_width() : 1200;
$font_family = class_exists('\AKSRT\Settings\Settings') ? \AKSRT\Settings\Settings::font_family() : 'system';
$logo_width = class_exists('\AKSRT\Settings\Settings') ? \AKSRT\Settings\Settings::logo_width() : 150;
$sidebar_cfg = class_exists('\AKSRT\Settings\Settings') ? \AKSRT\Settings\Settings::get_sidebar_config() : ['width' => 311, 'enabled' => true, 'position' => 'right'];
$content_width = $container_max === 0 ? '100%' : $container_max . 'px';
$content_no_sidebar_max = $container_max === 0 ? '100%' : max(860, $container_max - 220) . 'px';
$container_wide = $container_max === 0 ? '100%' : max(1280, $container_max + 160) . 'px';
$radius_sm = max(0, $border_radius - 2);
$radius_lg = $border_radius + 4;
$radius_xl = $border_radius + 10;
$rgb = $this->hex_to_rgb($primary_color);
$primary_hover = $this->adjust_hex_color($primary_color, -0.12);
$primary_active = $this->adjust_hex_color($primary_color, -0.22);
$font_stacks = $this->resolve_font_stacks($font_family);
$dark_rgb = $this->hex_to_rgb($dark_primary);
$dark_hover = $this->adjust_hex_color($dark_primary, -0.12);
$dark_active = $this->adjust_hex_color($dark_primary, -0.22);
// Zibll hard-codes 311px dual-column math; keep runtime width aligned to that
// baseline when settings still hold the old 300 default (or empty).
$sidebar_width = (int) ($sidebar_cfg['width'] ?? 311);
if ($sidebar_width <= 0 || $sidebar_width === 300) {
$sidebar_width = 311;
}
$sidebar_width = max(200, min(400, $sidebar_width));
$layout_vars = [
'--content-max' => $content_width,
'--content-no-sidebar-max' => $content_no_sidebar_max,
'--container' => $content_width,
'--container-wide' => $container_wide,
'--mian-max-width' => $content_width, // zibll typo token
'--sidebar-width' => $sidebar_width . 'px',
'--color-primary' => $primary_color,
'--color-primary-hover' => $primary_hover,
'--color-primary-active' => $primary_active,
'--color-primary-soft' => sprintf('rgba(%d, %d, %d, 0.12)', $rgb[0], $rgb[1], $rgb[2]),
'--color-primary-softer' => sprintf('rgba(%d, %d, %d, 0.06)', $rgb[0], $rgb[1], $rgb[2]),
'--color-primary-rgb' => implode(', ', $rgb),
'--focus-color' => $primary_color,
'--radius-sm' => $radius_sm . 'px',
'--radius' => $border_radius . 'px',
'--radius-card' => $card_radius . 'px',
// Zibll --main-radius tracks the base radius (8), not the larger card radius.
'--main-radius' => $border_radius . 'px',
'--radius-btn' => $border_radius . 'px',
'--radius-code' => $border_radius . 'px',
'--radius-lg' => $radius_lg . 'px',
'--radius-xl' => $radius_xl . 'px',
'--shadow-md' => '0 8px 24px rgba(20, 28, 48, 0.10)',
'--main-shadow' => 'rgba(116, 116, 116, 0.08)',
'--font-body' => $font_stacks['body'],
'--font-display' => $font_stacks['display'],
'--font-ui' => $font_stacks['ui'],
'--font-heading' => $font_stacks['ui'],
'--aksrt-logo-width' => $logo_width . 'px',
'--nav-height' => '60px',
'--single-cover-scale' => '35%',
'--posts-list-scale' => (class_exists('\AKSRT\Settings\Settings') ? \AKSRT\Settings\Settings::get_post_list_style_settings()['list_scale'] ?? 70 : 70) . '%',
'--posts-card-scale' => (class_exists('\AKSRT\Settings\Settings') ? \AKSRT\Settings\Settings::get_post_list_style_settings()['card_scale'] ?? 70 : 70) . '%',
];
echo '<style id="aksrt-runtime-vars">:root{';
foreach ($layout_vars as $name => $value) {
echo esc_html($name) . ':' . esc_attr($value) . ';';
}
if ($logo_url) {
echo '--aksrt-logo-url:"' . esc_url($logo_url) . '";';
}
if ($dark_logo_url) {
echo '--aksrt-logo-dark-url:"' . esc_url($dark_logo_url) . '";';
}
if ($favicon) {
echo '--aksrt-favicon:"' . esc_url($favicon) . '";';
}
if ($dark_primary !== $primary_color) {
echo '}html.dark{';
echo '--color-primary:' . esc_attr($dark_primary) . ';';
echo '--color-primary-hover:' . esc_attr($dark_hover) . ';';
echo '--color-primary-active:' . esc_attr($dark_active) . ';';
echo '--color-primary-soft:' . sprintf('rgba(%d,%d,%d,0.12)', $dark_rgb[0], $dark_rgb[1], $dark_rgb[2]) . ';';
echo '--color-primary-softer:' . sprintf('rgba(%d,%d,%d,0.06)', $dark_rgb[0], $dark_rgb[1], $dark_rgb[2]) . ';';
echo '--color-primary-rgb:' . esc_attr(implode(', ', $dark_rgb)) . ';';
echo '--focus-color:' . esc_attr($dark_primary) . ';';
}
echo '}</style>' . "\n";
if (class_exists('\AKSRT\Settings\Settings') && !empty(\AKSRT\Settings\Settings::get_value('close_backdrop', false))) {
echo '<style id="aksrt-no-backdrop">.aksrt-header,.header-inner,.site-header,.mobile-nav-overlay,.modal-backdrop,.aksrt-drawer-overlay,.aksrt-float-btn,.sidebar-inner{backdrop-filter:none!important;-webkit-backdrop-filter:none!important;background-color:var(--bg-card,#fff)!important}</style>' . "\n";
}
echo '<style id="aksrt-runtime-components">'
. '.aksrt-search-hot-keywords{display:flex;align-items:center;gap:10px;flex-wrap:wrap;margin-top:12px;font-family:var(--font-ui);}'
. '.aksrt-search-hot-keywords__label{font-size:12px;color:var(--color-ink-3);}'
. '.aksrt-search-hot-keywords__list{display:flex;gap:8px;flex-wrap:wrap;}'
. '.aksrt-search-hot-keywords__item{display:inline-flex;align-items:center;padding:4px 10px;border-radius:999px;background:var(--surface-2,#f3f4f6);color:var(--color-ink-2,#374151);font-size:12px;line-height:1.4;text-decoration:none;}'
. '.aksrt-search-hot-keywords__item:hover{background:var(--color-primary,#2563eb);color:#fff;}'
. '.site-footer__copyright--extra{margin-top:8px;opacity:.78;}'
. '</style>' . "\n";
}
private function resolve_font_stacks(string $family): array {
switch ($family) {
case 'noto-sans-sc':
return [
'body' => '"Noto Sans SC", "PingFang SC", "Microsoft YaHei", sans-serif',
'display' => '"Noto Sans SC", "PingFang SC", "Microsoft YaHei", sans-serif',
'ui' => 'Inter, "Noto Sans SC", "PingFang SC", "Microsoft YaHei", sans-serif',
];
case 'noto-serif-sc':
return [
'body' => '"Noto Serif SC", Georgia, "Songti SC", serif',
'display' => '"Noto Serif SC", Georgia, "Songti SC", serif',
'ui' => 'Inter, "Noto Sans SC", "PingFang SC", "Microsoft YaHei", sans-serif',
];
default:
return [
'body' => '"Source Serif 4", "Noto Serif SC", Georgia, "Songti SC", "STSong", serif',
'display' => '"Source Serif 4", "Noto Serif SC", Georgia, "Songti SC", "STSong", serif',
'ui' => 'Inter, Manrope, "Noto Sans SC", "PingFang SC", "Microsoft YaHei", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif',
];
}
}
private function hex_to_rgb(string $hex): array {
$hex = ltrim($hex, '#');
if (strlen($hex) === 3) {
$hex = preg_replace('/(.)/', '$1$1', $hex);
}
if (!is_string($hex) || strlen($hex) !== 6) {
return [136, 171, 218];
}
return [
hexdec(substr($hex, 0, 2)),
hexdec(substr($hex, 2, 2)),
hexdec(substr($hex, 4, 2)),
];
}
private function adjust_hex_color(string $hex, float $amount): string {
$rgb = $this->hex_to_rgb($hex);
$adjusted = array_map(
static function (int $channel) use ($amount): int {
$base = $amount >= 0
? $channel + ((255 - $channel) * $amount)
: $channel * (1 + $amount);
return max(0, min(255, (int) round($base)));
},
$rgb
);
return sprintf('#%02X%02X%02X', $adjusted[0], $adjusted[1], $adjusted[2]);
}
}
@@ -0,0 +1,66 @@
<?php
/**
* @package AKSRT
*/
namespace AKSRT\Frontend;
defined('ABSPATH') || exit;
class LoadingOverlayRenderer {
public function output(): void {
if (!class_exists('\AKSRT\Settings\Settings') || !\AKSRT\Settings\Settings::is_qj_loading_enabled()) {
return;
}
$style = \AKSRT\Settings\Settings::get_qj_loading_style();
?>
<style id="aksrt-loading-css">
.aksrt-loading-overlay{position:fixed;inset:0;z-index:99999;display:flex;align-items:center;justify-content:center;background:var(--bg-card,#fff);transition:opacity .4s ease,visibility .4s ease}
.aksrt-loading-overlay .loader{width:48px;height:48px;position:relative}
[data-loading-style="no1"] .loader{border:4px solid var(--color-primary-soft,rgba(240,68,148,.15));border-top-color:var(--color-primary,#f04494);border-radius:50%;animation:aksrt-load-spin .8s linear infinite}
[data-loading-style="no2"] .loader{border:4px solid var(--color-primary-soft,rgba(240,68,148,.15));border-radius:50%;animation:aksrt-load-pulse 1.2s ease-in-out infinite}
[data-loading-style="no3"] .loader::before,[data-loading-style="no3"] .loader::after{content:'';position:absolute;border-radius:50%;animation:aksrt-load-ripple 1.6s linear infinite;border:3px solid var(--color-primary,#f04494);inset:0}
[data-loading-style="no3"] .loader::after{animation-delay:-.8s}
[data-loading-style="no4"] .loader{display:flex;gap:6px;align-items:center;justify-content:center}
[data-loading-style="no4"] .loader::before,[data-loading-style="no4"] .loader::after,[data-loading-style="no4"] .loader i{width:12px;height:12px;border-radius:50%;background:var(--color-primary,#f04494);display:block;animation:aksrt-load-bounce .6s ease-in-out infinite alternate}
[data-loading-style="no4"] .loader::after{animation-delay:.2s}
[data-loading-style="no4"] .loader i{animation-delay:.4s}
[data-loading-style="no5"] .loader{background:var(--color-primary,#f04494);animation:aksrt-load-rotate-square 1.2s ease-in-out infinite}
[data-loading-style="no6"] .loader{width:60px;height:6px;border-radius:3px;background:var(--color-primary-soft,rgba(240,68,148,.15));overflow:hidden;position:relative}
[data-loading-style="no6"] .loader::after{content:'';position:absolute;left:-40%;top:0;width:40%;height:100%;background:var(--color-primary,#f04494);border-radius:3px;animation:aksrt-load-bar 1.2s ease-in-out infinite}
[data-loading-style="no7"] .loader{display:grid;grid-template-columns:repeat(3,1fr);gap:4px}
[data-loading-style="no7"] .loader i{width:12px;height:12px;background:var(--color-primary,#f04494);border-radius:2px;animation:aksrt-load-grid-fade 1s ease-in-out infinite}
[data-loading-style="no7"] .loader i:nth-child(1){animation-delay:0s}[data-loading-style="no7"] .loader i:nth-child(2){animation-delay:.1s}[data-loading-style="no7"] .loader i:nth-child(3){animation-delay:.2s}
[data-loading-style="no7"] .loader i:nth-child(4){animation-delay:.3s}[data-loading-style="no7"] .loader i:nth-child(5){animation-delay:.4s}[data-loading-style="no7"] .loader i:nth-child(6){animation-delay:.5s}
[data-loading-style="no7"] .loader i:nth-child(7){animation-delay:.6s}[data-loading-style="no7"] .loader i:nth-child(8){animation-delay:.7s}[data-loading-style="no7"] .loader i:nth-child(9){animation-delay:.8s}
[data-loading-style="no8"] .loader{display:flex;gap:5px;align-items:flex-end;height:40px}
[data-loading-style="no8"] .loader i{width:6px;background:var(--color-primary,#f04494);border-radius:2px;animation:aksrt-load-wave 1s ease-in-out infinite}
[data-loading-style="no8"] .loader i:nth-child(1){animation-delay:0s}[data-loading-style="no8"] .loader i:nth-child(2){animation-delay:.1s}[data-loading-style="no8"] .loader i:nth-child(3){animation-delay:.2s}
[data-loading-style="no8"] .loader i:nth-child(4){animation-delay:.3s}[data-loading-style="no8"] .loader i:nth-child(5){animation-delay:.4s}
[data-loading-style="no9"] .loader{display:flex;gap:8px;align-items:center;justify-content:center}
[data-loading-style="no9"] .loader i{width:10px;height:10px;background:var(--color-primary,#f04494);border-radius:50%;animation:aksrt-load-dot-scale .8s ease-in-out infinite alternate}
[data-loading-style="no9"] .loader i:nth-child(2){animation-delay:.15s}[data-loading-style="no9"] .loader i:nth-child(3){animation-delay:.3s}
[data-loading-style="no10"] .loader{border:4px solid transparent;border-top-color:var(--color-primary,#f04494);border-bottom-color:var(--color-primary,#f04494);border-radius:50%;animation:aksrt-load-spin 1s linear infinite}
[data-loading-style="no10"] .loader::after{content:'';position:absolute;inset:4px;border:4px solid transparent;border-left-color:var(--color-primary-soft,rgba(240,68,148,.35));border-right-color:var(--color-primary-soft,rgba(240,68,148,.35));border-radius:50%;animation:aksrt-load-spin .6s linear infinite reverse}
@keyframes aksrt-load-spin{to{transform:rotate(360deg)}}
@keyframes aksrt-load-pulse{0%,100%{transform:scale(1);opacity:1}50%{transform:scale(1.15);opacity:.5}}
@keyframes aksrt-load-ripple{0%{transform:scale(.5);opacity:1}100%{transform:scale(1.2);opacity:0}}
@keyframes aksrt-load-bounce{to{transform:translateY(-12px);opacity:.5}}
@keyframes aksrt-load-rotate-square{0%{transform:rotate(0) scale(1)}50%{transform:rotate(180deg) scale(.6)}100%{transform:rotate(360deg) scale(1)}}
@keyframes aksrt-load-bar{0%{left:-40%}100%{left:100%}}
@keyframes aksrt-load-grid-fade{0%,100%{opacity:.3;transform:scale(.8)}50%{opacity:1;transform:scale(1)}}
@keyframes aksrt-load-wave{0%,100%{height:10px}50%{height:36px}}
@keyframes aksrt-load-dot-scale{from{transform:scale(1)}to{transform:scale(1.8);opacity:.4}}
body.aksrt-loading-done .aksrt-loading-overlay{opacity:0;visibility:hidden;pointer-events:none}
[data-theme="dark"] .aksrt-loading-overlay{background:var(--bg-card,#1a1a2e)}
</style>
<div class="aksrt-loading-overlay" data-loading-style="<?php echo esc_attr($style); ?>">
<div class="loader"><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i></div>
</div>
<script>
(function(){function d(){document.body.classList.add('aksrt-loading-done')}if(document.readyState==='complete'){d()}else{window.addEventListener('load',d)}})();
</script>
<?php
}
}
+139
View File
@@ -0,0 +1,139 @@
<?php
/**
* @package AKSRT
*/
namespace AKSRT\Frontend;
defined('ABSPATH') || exit;
class NavWalker extends Walker_Nav_Menu {
/**
* @var array Decoration settings from aksrt_get_menu_decoration_settings().
*/
private $settings;
public function __construct(array $settings = []) {
$this->settings = $settings;
}
/**
* 当前处理的菜单项是否为 Mega Menu 容器
* @var bool
*/
private $is_mega_menu = false;
/**
* Mega Menu 列数
* @var int
*/
private $mega_columns = 3;
/**
* Start level: open submenu with appropriate class based on style.
*/
public function start_lvl(&$output, $depth = 0, $args = null): void {
$indent = str_repeat("\t", $depth);
if ($this->is_mega_menu && $depth === 0) {
// Mega Menu 子菜单容器
$output .= "\n{$indent}<ul class=\"sub-menu mega-menu__panel mega-menu__columns-{$this->mega_columns}\">\n";
} else {
$output .= "\n{$indent}<ul class=\"sub-menu\">\n";
}
}
/**
* Start element: add icon, badge, and classes.
*/
public function start_el(&$output, $item, $depth = 0, $args = null, $id = 0): void {
$indent = ($depth) ? str_repeat("\t", $depth) : '';
$classes = (array) $item->classes;
$decoration = function_exists('aksrt_get_menu_item_decoration')
? aksrt_get_menu_item_decoration($item)
: ['icon' => '', 'badge_text' => '', 'badge_type' => 'new', 'submenu_style' => ''];
// 检测 Mega Menu 标记
$this->is_mega_menu = false;
$this->mega_columns = 3;
if ($depth === 0) {
foreach ($classes as $cls) {
if ($cls === 'mega-menu') {
$this->is_mega_menu = true;
}
if (preg_match('/^mega-menu-columns-(\d)$/', $cls, $m)) {
$this->mega_columns = max(2, min(5, (int) $m[1]));
}
}
}
// Build li classes
$li_classes = ['menu-item', 'menu-item-' . $item->ID];
if (in_array('current-menu-item', $classes, true)) {
$li_classes[] = 'current-menu-item';
}
if (in_array('menu-item-has-children', $classes, true)) {
$li_classes[] = 'menu-item-has-children';
}
if ($this->is_mega_menu) {
$li_classes[] = 'mega-menu-item';
}
// Add decoration classes
$li_classes[] = 'aksrt-nav__item';
if ($decoration['icon'] !== '' && !empty($this->settings['icon_enabled'])) {
$li_classes[] = 'aksrt-nav__item--has-icon';
}
if ($decoration['badge_text'] !== '' && !empty($this->settings['badge_enabled'])) {
$li_classes[] = 'aksrt-nav__item--has-badge';
}
$hover = $this->settings['hover_effect'] ?? 'underline';
if ($hover !== 'none') {
$li_classes[] = 'aksrt-nav__item--hover-' . $hover;
}
$class_str = implode(' ', array_unique($li_classes));
$output .= $indent . '<li class="' . esc_attr($class_str) . '" data-menu-item-id="' . (int) $item->ID . '" data-menu-depth="' . (int) $depth . '"' . (in_array('menu-item-has-children', $classes, true) ? ' data-menu-has-children="1"' : '') . '>';
// Build link content
$icon_html = '';
if ($decoration['icon'] !== '' && !empty($this->settings['icon_enabled'])) {
$icon_html = aksrt_render_menu_icon($decoration['icon'], true);
}
$badge_html = '';
if ($decoration['badge_text'] !== '' && !empty($this->settings['badge_enabled'])) {
$badge_html = aksrt_render_menu_badge($decoration['badge_text'], $decoration['badge_type'], true);
}
// Mega Menu 子项:检查是否有描述文字(用作卡片副标题)
$description_html = '';
if ($this->is_mega_menu && $depth === 1 && !empty($item->description)) {
$description_html = '<span class="mega-menu__item-desc">' . esc_html($item->description) . '</span>';
}
$atts = [
'href' => $item->url,
'title' => $item->attr_title ?: '',
];
$link_inner = $icon_html . '<span>' . esc_html($item->title) . '</span>' . $description_html . $badge_html;
$output .= '<a';
foreach ($atts as $attr => $value) {
if ('' !== $value) {
$output .= ' ' . $attr . '="' . esc_attr($value) . '"';
}
}
$output .= '>' . $link_inner . '</a>';
}
/**
* End element.
*/
public function end_el(&$output, $item, $depth = 0, $args = null): void {
$output .= "</li>\n";
}
}