wpmind/includes/Admin/AdminAssets.php

<?php
/**
 * Admin assets loader.
 *
 * @package WPMind\Admin
 * @since 3.3.0
 */

declare(strict_types=1);

namespace WPMind\Admin;

/**
 * Class AdminAssets
 */
final class AdminAssets {

    /**
     * Singleton instance.
     *
     * @var AdminAssets|null
     */
    private static ?AdminAssets $instance = null;

    /**
     * Get singleton instance.
     *
     * @return AdminAssets
     */
    public static function instance(): AdminAssets {
        if ( null === self::$instance ) {
            self::$instance = new self();
        }
        return self::$instance;
    }

    /**
     * Constructor.
     */
    private function __construct() {}

    /**
     * 加载管理后台资源
     *
     * @param string $hook_suffix 当前页面钩子后缀
     * @since 1.1.0
     */
    public function enqueue_admin_assets( string $hook_suffix ): void {
        // 一级菜单的 hook suffix 是 toplevel_page_{menu_slug}
        if ( 'toplevel_page_wpmind' !== $hook_suffix ) {
            return;
        }

        // Remixicon 图标库（本地打包）
        wp_enqueue_style(
            'remixicon',
            WPMIND_PLUGIN_URL . 'assets/vendor/remixicon/remixicon.css',
            [],
            '4.9.1'
        );

        wp_enqueue_style(
            'wpmind-admin',
            WPMIND_PLUGIN_URL . 'assets/css/admin.css',
            [ 'remixicon' ],
            WPMIND_VERSION
        );

        wp_enqueue_style(
            'wpmind-modules',
            WPMIND_PLUGIN_URL . 'assets/css/modules.css',
            [ 'wpmind-admin' ],
            WPMIND_VERSION
        );

        wp_enqueue_style(
            'wpmind-overview',
            WPMIND_PLUGIN_URL . 'assets/css/overview.css',
            [ 'wpmind-admin' ],
            WPMIND_VERSION
        );

        wp_enqueue_style(
            'wpmind-panels',
            WPMIND_PLUGIN_URL . 'assets/css/panels.css',
            [ 'wpmind-admin' ],
            WPMIND_VERSION
        );

        wp_enqueue_style(
            'wpmind-routing',
            WPMIND_PLUGIN_URL . 'assets/css/pages/routing.css',
            [ 'wpmind-panels' ],
            WPMIND_VERSION
        );

        wp_enqueue_style(
            'wpmind-module-layout',
            WPMIND_PLUGIN_URL . 'assets/css/components/module-layout.css',
            [ 'wpmind-admin' ],
            WPMIND_VERSION
        );

        wp_enqueue_style(
            'wpmind-responsive',
            WPMIND_PLUGIN_URL . 'assets/css/responsive.css',
            [ 'wpmind-panels', 'wpmind-routing' ],
            WPMIND_VERSION
        );

        // Chart.js 图表库（本地打包，无外部 CDN 依赖）
        wp_register_script(
            'chartjs',
            WPMIND_PLUGIN_URL . 'assets/js/vendor/chartjs/chart.umd.min.js',
            [],
            '4.5.0',
            true
        );

        wp_enqueue_script(
            'wpmind-admin-ui',
            WPMIND_PLUGIN_URL . 'assets/js/admin-ui.js',
            [ 'jquery' ],
            WPMIND_VERSION,
            true
        );

        wp_enqueue_script(
            'wpmind-admin-boot',
            WPMIND_PLUGIN_URL . 'assets/js/admin-boot.js',
            [ 'wpmind-admin-ui' ],
            WPMIND_VERSION,
            true
        );

        wp_enqueue_script(
            'wpmind-admin-endpoints',
            WPMIND_PLUGIN_URL . 'assets/js/admin-endpoints.js',
            [ 'wpmind-admin-boot' ],
            WPMIND_VERSION,
            true
        );

        wp_enqueue_script(
            'wpmind-admin-routing',
            WPMIND_PLUGIN_URL . 'assets/js/admin-routing.js',
            [ 'wpmind-admin-boot', 'jquery-ui-sortable' ],
            WPMIND_VERSION,
            true
        );

        wp_enqueue_script(
            'wpmind-admin-analytics',
            WPMIND_PLUGIN_URL . 'assets/js/admin-analytics.js',
            [ 'wpmind-admin-boot', 'chartjs' ],
            WPMIND_VERSION,
            true
        );

        wp_enqueue_script(
            'wpmind-admin-budget',
            WPMIND_PLUGIN_URL . 'assets/js/admin-budget.js',
            [ 'wpmind-admin-boot' ],
            WPMIND_VERSION,
            true
        );

        wp_enqueue_script(
            'wpmind-admin-geo',
            WPMIND_PLUGIN_URL . 'assets/js/admin-geo.js',
            [ 'wpmind-admin-boot' ],
            WPMIND_VERSION,
            true
        );

        wp_enqueue_script(
            'wpmind-admin-modules',
            WPMIND_PLUGIN_URL . 'assets/js/admin-modules.js',
            [ 'wpmind-admin-boot' ],
            WPMIND_VERSION,
            true
        );

        // 完整的国际化字符串
        wp_localize_script( 'wpmind-admin-boot', 'wpmindL10n', [
            'testSuccess'    => __( '连接成功！', 'wpmind' ),
            'testFailed'     => __( '连接失败：', 'wpmind' ),
            'testing'        => __( '测试中...', 'wpmind' ),
            'enabled'        => __( '已启用', 'wpmind' ),
            'apiKeyRequired' => __( '请为已启用的服务填写 API Key', 'wpmind' ),
            'apiKeySet'      => __( '已设置', 'wpmind' ),
            'apiKeyCleared'  => __( 'API Key 将被清除', 'wpmind' ),
        ] );

        // 为 AJAX 添加数据
        wp_localize_script( 'wpmind-admin-boot', 'wpmindData', [
            'nonce'   => wp_create_nonce( 'wpmind_ajax' ),
            'ajaxurl' => admin_url( 'admin-ajax.php' ),
            'version' => WPMIND_VERSION,
            'debug'   => defined( 'WP_DEBUG' ) && WP_DEBUG,
        ] );
    }
}