wpmind/modules/analytics/AnalyticsModule.php

<?php
/**
 * Analytics Module - 分析面板模块
 *
 * @package WPMind\Modules\Analytics
 * @since 3.3.0
 */

declare(strict_types=1);

namespace WPMind\Modules\Analytics;

use WPMind\Core\ModuleInterface;

class AnalyticsModule implements ModuleInterface
{
    /**
     * 模块配置
     */
    private array $config = [];

    /**
     * 构造函数
     */
    public function __construct()
    {
        $config_file = __DIR__ . '/module.json';
        if (file_exists($config_file)) {
            $this->config = json_decode(file_get_contents($config_file), true) ?: [];
        }
    }

    /**
     * 获取模块 ID
     */
    public function get_id(): string
    {
        return 'analytics';
    }

    /**
     * 获取模块名称
     */
    public function get_name(): string
    {
        return $this->config['name'] ?? 'Analytics';
    }

    /**
     * 获取模块描述
     */
    public function get_description(): string
    {
        return $this->config['description'] ?? '分析仪表板';
    }

    /**
     * 获取模块版本
     */
    public function get_version(): string
    {
        return $this->config['version'] ?? '1.0.0';
    }

    /**
     * 获取模块依赖
     */
    public function get_dependencies(): array
    {
        return $this->config['requires'] ?? [];
    }

    /**
     * 检查模块依赖是否满足
     */
    public function check_dependencies(): bool
    {
        $requires = $this->get_dependencies();

        if (empty($requires)) {
            return true;
        }

        $module_loader = \WPMind\Core\ModuleLoader::instance();

        foreach ($requires as $required_module) {
            if (!$module_loader->is_module_enabled($required_module)) {
                return false;
            }
        }

        return true;
    }

    /**
     * 获取设置标签页
     */
    public function get_settings_tab(): ?string
    {
        return $this->config['settings_tab'] ?? 'analytics';
    }

    /**
     * 初始化模块
     */
    public function init(): void
    {
        // 加载模块类
        $this->load_classes();

        // 注册设置标签页
        add_filter('wpmind_settings_tabs', [$this, 'register_settings_tab'], 10);

        // 注册 AJAX 处理器
        add_action('wp_ajax_wpmind_get_analytics', [$this, 'ajax_get_analytics']);

        // 注册资源加载
        add_action('admin_enqueue_scripts', [$this, 'enqueue_assets']);
    }

    /**
     * 加载模块类
     */
    private function load_classes(): void
    {
        require_once __DIR__ . '/includes/AnalyticsManager.php';
    }

    /**
     * 注册设置标签页
     */
    public function register_settings_tab(array $tabs): array
    {
        $tab_config = $this->config['settings_tab'] ?? [];

        $tabs['analytics'] = [
            'label'    => $tab_config['label'] ?? __('数据分析', 'wpmind'),
            'icon'     => $tab_config['icon'] ?? 'dashicons-chart-area',
            'priority' => $tab_config['priority'] ?? 10,
            'template' => __DIR__ . '/templates/dashboard.php',
        ];

        return $tabs;
    }

    /**
     * AJAX: 获取分析数据
     */
    public function ajax_get_analytics(): void
    {
        check_ajax_referer('wpmind_ajax', 'nonce');

        if (!current_user_can('manage_options')) {
            wp_send_json_error(['message' => __('权限不足', 'wpmind')]);
        }

        $range = isset($_POST['range']) ? sanitize_text_field($_POST['range']) : '7d';

        $analytics = AnalyticsManager::instance();
        $data = $analytics->get_analytics_data($range);

        wp_send_json_success($data);
    }

    /**
     * 加载模块资源
     */
    public function enqueue_assets(string $hook): void
    {
        // 只在 WPMind 设置页面加载
        if (strpos($hook, 'wpmind') === false) {
            return;
        }

        // Chart.js 已在主插件加载，这里只需确保依赖
    }

    /**
     * 激活模块
     */
    public function activate(): void
    {
        // 模块激活时的初始化操作
    }

    /**
     * 停用模块
     */
    public function deactivate(): void
    {
        // 模块停用时的清理操作
    }

    /**
     * 卸载模块
     */
    public function uninstall(): void
    {
        // 模块卸载时删除数据（可选）
    }
}