kate522/wordpress-theme-aksrt
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor: flatten src/AKSRT → src (drop theme-identifier dir)

Browse Source 
Move all domain folders from src/AKSRT/{Domain} to src/{Domain}; remap
Composer PSR-4 "AKSRT\\": "src/"; update audit script + README + ADR
paths; remove dead tools/build-psr4-map.php (scanned deleted inc/classes).
This commit is contained in:
kate522
2026-08-02 22:06:06 +08:00
parent 56f1a8175f
commit 8c5b1555c9
285 changed files with 26 additions and 3600 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/Admin/Admin.php
+367
View File
@@ -0,0 +1,367 @@
<?php
/**
* @package AKSRT
*/
namespace AKSRT\Admin;
defined('ABSPATH') || exit;
class Admin {
private static $instance = null;
private const PAGE_SLUG = 'aksrt-settings';
private const API_NAMESPACE = 'aksrt/v1';
public static function get_instance(): self {
if (null === self::$instance) {
self::$instance = new self();
}
return self::$instance;
}
private function __construct() {}
public function init(): void {
add_action('admin_menu', [$this, 'add_admin_menu']);
add_action('admin_enqueue_scripts', [$this, 'enqueue_admin_assets']);
add_filter('script_loader_tag', [$this, 'add_module_type_attribute'], 10, 2);
add_action('rest_api_init', [$this, 'register_rest_routes']);
add_action('wp_ajax_aksrt_load_more_posts', [$this, 'ajax_load_more_posts']);
add_action('wp_ajax_nopriv_aksrt_load_more_posts', [$this, 'ajax_load_more_posts']);
add_action('wp_ajax_aksrt_load_more_comments', [$this, 'ajax_load_more_comments']);
add_action('wp_ajax_nopriv_aksrt_load_more_comments', [$this, 'ajax_load_more_comments']);
}
public function add_admin_menu(): void {
add_menu_page(
'AKSRT 主题设置',
'AKSRT',
'manage_options',
self::PAGE_SLUG,
[$this, 'render_admin_page'],
'dashicons-admin-generic',
58
);
}
public function render_admin_page(): void {
echo '<div class="wrap aksrt-admin-wrap">';
echo '<div id="aksrt-admin-app"></div>';
echo '</div>';
}
public function enqueue_admin_assets($hook): void {
$screen = function_exists('get_current_screen') ? get_current_screen() : null;
if (!$screen || $screen->base !== 'toplevel_page_' . self::PAGE_SLUG) {
return;
}
$build_dir = trailingslashit(AKSRT_DIR) . 'assets/admin/build/';
$build_uri = trailingslashit(AKSRT_URI) . 'assets/admin/build/';
$entry = $build_dir . 'index.js';
if (!is_file($entry)) {
add_action('admin_notices', static function (): void {
if (!current_user_can('manage_options')) {
return;
}
echo '<div class="notice notice-error"><p>';
echo esc_html__('AKSRT 管理后台构建缺失：请在 assets/admin 执行 npm run build，并完整部署 build/ 目录。', 'aksrt');
echo '</p></div>';
});
return;
}
$missing_chunks = self::find_missing_admin_chunks($build_dir, $entry);
if ($missing_chunks !== []) {
add_action('admin_notices', static function () use ($missing_chunks): void {
if (!current_user_can('manage_options')) {
return;
}
echo '<div class="notice notice-error"><p>';
echo esc_html__('AKSRT 管理后台构建不完整（动态模块缺失），请重新完整部署 assets/admin/build/，不要只覆盖 index.js。缺失：', 'aksrt');
echo ' ' . esc_html(implode(', ', array_slice($missing_chunks, 0, 8)));
if (count($missing_chunks) > 8) {
echo '…';
}
echo '</p></div>';
});
// Still enqueue entry so console shows the real import error if an admin insists;
// notice makes the deploy mistake explicit.
}
$css_files = [
'naive-ui.css',
'index.css',
'index2.css',
];
foreach ($css_files as $css_file) {
$path = $build_dir . $css_file;
if (file_exists($path)) {
wp_enqueue_style(
'aksrt-admin-' . sanitize_key(str_replace(['.', '/'], '-', $css_file)),
$build_uri . $css_file,
[],
(string) filemtime($path)
);
}
}
// Match frontend FA5 pack so FaIcon / menu glyphs render in the SPA.
wp_enqueue_style(
'aksrt-font-awesome-5',
'https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.4/css/all.min.css',
[],
'5.15.4'
);
wp_enqueue_script(
'aksrt-admin-app',
$build_uri . 'index.js',
[],
(string) filemtime($entry),
true
);
wp_localize_script('aksrt-admin-app', 'aksrtAdminData', [
'apiUrl' => esc_url_raw(rest_url(self::API_NAMESPACE)),
'nonce' => wp_create_nonce('wp_rest'),
'siteUrl' => home_url('/'),
'adminUrl' => admin_url('/'),
'themeVersion' => wp_get_theme()->get('Version') ?: '3.4.0-dev',
'themeUri' => defined('AKSRT_URI') ? AKSRT_URI : get_template_directory_uri(),
'buildOk' => $missing_chunks === [],
]);
wp_enqueue_media();
}
/**
* Parse index.js dynamic imports and report missing chunk files.
*
* @return string[]
*/
private static function find_missing_admin_chunks(string $build_dir, string $entry_file): array {
$src = file_get_contents($entry_file);
if (!is_string($src) || $src === '') {
return ['index.js unreadable'];
}
if (!preg_match_all('/\.\/([A-Za-z0-9_.-]+\.js)/', $src, $matches)) {
return [];
}
$missing = [];
foreach (array_unique($matches[1]) as $chunk) {
if (!is_file($build_dir . $chunk)) {
$missing[] = $chunk;
}
}
return $missing;
}
public function add_module_type_attribute(string $tag, string $handle): string {
if ('aksrt-admin-app' === $handle) {
return str_replace('<script ', '<script type="module" ', $tag);
}
return $tag;
}
public function register_rest_routes(): void {
// FQCN required after PSR-4 move into AKSRT\Admin (unqualified class_exists skips all routes).
$controllers = [
GlobalController::class,
PageDisplayController::class,
PostListController::class,
PermissionsController::class,
UserController::class,
PaymentController::class,
ToolsController::class,
ImportExportController::class,
ExtensionController::class,
CommentController::class,
MessageController::class,
AIController::class,
];
foreach ($controllers as $class_name) {
if (!class_exists($class_name) || !method_exists($class_name, 'get_instance')) {
continue;
}
$controller = $class_name::get_instance();
if (method_exists($controller, 'register_routes')) {
$controller->register_routes();
}
}
}
public static function sanitize_public_query_vars(array $vars): array {
$allowed = [
'post_type', 'post_status', 'posts_per_page', 'paged', 'orderby', 'order',
'cat', 'tag', 'tag_id', 'category_name', 's', 'post__not_in', 'category__not_in',
];
$clean = [];
foreach ($allowed as $key) {
if (!array_key_exists($key, $vars)) {
continue;
}
$value = $vars[$key];
if (is_array($value)) {
$clean[$key] = array_map('sanitize_text_field', $value);
} else {
$clean[$key] = sanitize_text_field((string) $value);
}
}
if (isset($clean['posts_per_page'])) {
$clean['posts_per_page'] = max(1, min(50, (int) $clean['posts_per_page']));
}
if (isset($clean['paged'])) {
$clean['paged'] = max(1, (int) $clean['paged']);
}
return $clean;
}
public static function sanitize_public_render_config(array $config): array {
$clean = [];
if (isset($config['mode'])) {
$mode = sanitize_key((string) $config['mode']);
if (in_array($mode, ['list', 'card', 'mini', 'grid-cms'], true)) {
$clean['mode'] = $mode;
}
}
if (isset($config['context'])) {
$clean['context'] = sanitize_key((string) $config['context']);
}
if (isset($config['query_context'])) {
$clean['query_context'] = sanitize_key((string) $config['query_context']);
}
if (isset($config['style'])) {
$style = sanitize_key((string) $config['style']);
if (in_array($style, ['', 'style2', 'style3'], true)) {
$clean['style'] = $style;
}
}
if (isset($config['card_style'])) {
$card_style = sanitize_key((string) $config['card_style']);
$allowed = ['thumb', 'text', 'thumb_if_has', 'card', 'compact', 'large_thumb', 'multi_thumb', 'standard'];
if (in_array($card_style, $allowed, true)) {
$clean['card_style'] = $card_style;
}
}
if (isset($config['list_show_type'])) {
$v = sanitize_key((string) $config['list_show_type']);
if (in_array($v, ['separate', 'no_margin'], true)) {
$clean['list_show_type'] = $v;
}
}
if (isset($config['list_img_position'])) {
$v = sanitize_key((string) $config['list_img_position']);
if (in_array($v, ['left', 'right'], true)) {
$clean['list_img_position'] = $v;
}
}
foreach (['thumb_if_has', 'show_thumb', 'show_author', 'show_date', 'show_views', 'show_comments', 'show_likes', 'show_excerpt', 'heading_bold', 'target_blank', 'badge_show', 'multi_thumb_enabled', 'skip_wrapper'] as $bool_key) {
if (array_key_exists($bool_key, $config)) {
$clean[$bool_key] = !empty($config[$bool_key]);
}
}
if (isset($config['multi_thumb_limit'])) {
$clean['multi_thumb_limit'] = max(1, min(6, (int) $config['multi_thumb_limit']));
}
if (isset($config['multi_thumb_min'])) {
$clean['multi_thumb_min'] = max(1, min(6, (int) $config['multi_thumb_min']));
}
if (isset($config['excerpt_words'])) {
$clean['excerpt_words'] = max(0, min(200, (int) $config['excerpt_words']));
}
return $clean;
}
public function ajax_load_more_posts(): void {
$nonce = isset($_POST['nonce']) ? (string) wp_unslash($_POST['nonce']) : '';
if ($nonce === '' || !wp_verify_nonce($nonce, 'aksrt_public_nonce')) {
wp_send_json_error(['message' => __('安全验证失败', 'aksrt')], 403);
}
$page = max(1, (int) ($_POST['page'] ?? 1));
$query_vars = json_decode(wp_unslash((string) ($_POST['query_vars'] ?? '{}')), true);
$render_config = json_decode(wp_unslash((string) ($_POST['render_config'] ?? '{}')), true);
$query_vars = is_array($query_vars) ? self::sanitize_public_query_vars($query_vars) : [];
$render_config = is_array($render_config) ? self::sanitize_public_render_config($render_config) : [];
// Prefer server-side resolution so AJAX matches SSR styles even if client config is slim.
if (function_exists('aksrt_resolve_post_list_render_config')) {
$context = sanitize_key((string) ($render_config['context'] ?? 'archive'));
if ($context === '') {
$context = 'archive';
}
$resolved = aksrt_resolve_post_list_render_config([
'context' => $context,
'overrides' => $render_config,
]);
$render_config = array_merge($resolved, $render_config);
}
$query_vars['paged'] = $page;
if (empty($query_vars['post_status'])) {
$query_vars['post_status'] = 'publish';
}
if (empty($query_vars['post_type'])) {
$query_vars['post_type'] = 'post';
}
$query = new \WP_Query($query_vars);
ob_start();
if (function_exists('aksrt_render_post_list')) {
aksrt_render_post_list($query, $render_config, true);
}
$html = (string) ob_get_clean();
wp_send_json_success([
'html' => $html,
'has_more' => $page < (int) $query->max_num_pages,
'page' => $page,
]);
}
public function ajax_load_more_comments(): void {
$nonce = isset($_POST['nonce']) ? (string) wp_unslash($_POST['nonce']) : '';
if ($nonce === '' || !wp_verify_nonce($nonce, 'aksrt_public_nonce')) {
wp_send_json_error(['message' => __('安全验证失败', 'aksrt')], 403);
}
$post_id = absint($_POST['post_id'] ?? 0);
$page = max(1, (int) ($_POST['page'] ?? 1));
if ($post_id <= 0) {
wp_send_json_error(['message' => __('无效的文章 ID', 'aksrt')], 400);
}
$order = sanitize_key((string) ($_POST['comment_order'] ?? $_POST['order'] ?? 'newest'));
$author_only = !empty($_POST['author_only']) || (isset($_POST['aksrt_author_only']) && (int) $_POST['aksrt_author_only'] === 1);
if (!function_exists('aksrt_comments_query_for_post') || !function_exists('aksrt_comments_render_items_html')) {
wp_send_json_error(['message' => __('评论加载不可用', 'aksrt')]);
}
$result = aksrt_comments_query_for_post($post_id, [
'page' => $page,
'order' => $order,
'author_only' => $author_only,
]);
$html = aksrt_comments_render_items_html($result['comments'], $result['settings'], $result['order']);
wp_send_json_success([
'html' => $html,
'has_more' => $page < (int) $result['max_pages'],
'page' => $page,
'order' => $result['order'],
'total' => (int) $result['total'],
'max_pages'=> (int) $result['max_pages'],
]);
}
}