<?php
/**
 * AKSRT Settings Helper
 *
 * 设置获取辅助函数，统一管理所有主题设置选项
 *
 * @package AKSRT
 */

defined('ABSPATH') || exit;

class AKSRT_Settings {

    use AKSRT_Settings_Domain_Groups;
    use AKSRT_Settings_Display_Page_Groups;
    use AKSRT_Settings_Credits_Payment_Groups;
    use AKSRT_Settings_Category_Integration_Groups;
    use AKSRT_Settings_Auth_Reader;
    use AKSRT_Settings_Homepage_Reader;

    private static $instance = null;
    use AKSRT_Settings_Facade_Bulk;


    private function __construct() {}


    public static function get_instance(): self {
        if (null === self::$instance) self::$instance = new self();
        return self::$instance;
    }


    public function init(): void {
        // 注册设置API（可选）
        add_action('customize_register', [$this, 'customizer']);
        add_filter('get_site_icon_url', [self::class, 'filter_site_icon_url'], 10, 3);
        add_action('init', [self::class, 'maybe_sync_native_site_icon'], 20);

        // 搜索结果排除（search_no_page / search_exclude_cats）
        add_action('pre_get_posts', [self::class, 'filter_search_query']);

        // 全局列表默认排序（list_orderby）
        add_action('pre_get_posts', [self::class, 'apply_list_orderby']);

        // 全局列表每页数量（post_list_per_page）
        add_action('pre_get_posts', [self::class, 'apply_list_per_page']);

        // 文章发布/更新/删除时清理分类推荐缓存
        add_action('save_post', [self::class, 'on_post_changed']);
        add_action('delete_post', [self::class, 'on_post_changed']);

        // 设置变更时清理 per-request memo
        add_action('updated_option', [self::class, 'on_option_updated'], 10, 1);
        add_action('added_option', [self::class, 'on_option_updated'], 10, 1);
        add_action('deleted_option', [self::class, 'on_option_updated'], 10, 1);
    }


    /**
     * Option 变更时失效缓存（响应所有主题相关 option key）。
     */
    public static function on_option_updated(string $option_name): void {
        $tracked = array_merge(
            ['aksrt_settings'],
            self::STANDALONE_OPTION_KEYS
        );

        if (in_array($option_name, $tracked, true)) {
            self::$cached_all = null;
        }
    }


    /**
     * 文章变更时清理分类推荐缓存
     */
    public static function on_post_changed(int $post_id): void {
        if (wp_is_post_revision($post_id) || wp_is_post_autosave($post_id)) return;
        $post = get_post($post_id);
        if (!$post || $post->post_type !== 'post') return;
        self::flush_category_recommend_cache();
    }


    // ============================================
    // 设置读取方法
    // ============================================

    /** 获取全部设置（per-request memo） */
    public static function get_all(): array {
        if (self::$cached_all !== null) {
            return self::$cached_all;
        }

        // Canonical theme settings live only in aksrt_settings.
        // Operational configs (captcha/moderation/oauth/footer/etc.) stay standalone.
        $settings = get_option('aksrt_settings', []);
        if (!is_array($settings)) {
            $settings = [];
        }
        self::$cached_all = $settings;
        return $settings;
    }


    /**
     * 显式刷新缓存（外部直接修改 option 后可调用）。
     */
    public static function flush_settings_cache(): void {
        self::$cached_all = null;
    }


    /**
     * 读取指定 domain/section 的配置（委托 Schema Provider）。
     *
     * @param string $domain 域名 (global, page_display, post_list, ...)
     * @param string $section 分区名 (可为空，读取整个 domain)
     * @return array
     */
    public static function read_domain(string $domain, string $section = ''): array {
        $provider = AKSRT_Admin_Schema_Provider::get_instance();
        return $provider->read_settings($domain, $section);
    }


    /**
     * 写入指定 domain/section 的配置（委托 Schema Provider）。
     *
     * 仅写入当前 section allowlist 中的字段，不会覆盖同 option 中其它 section 的字段。
     * 写入后自动刷新 memo cache 并触发 action。
     *
     * @param string $domain 域名
     * @param string $section 分区名
     * @param array $data 要写入的数据
     * @return bool
     */
    public static function write_domain(string $domain, string $section, array $data): bool {
        $provider = AKSRT_Admin_Schema_Provider::get_instance();
        $result = $provider->write_settings($domain, $data, $section);

        if ($result) {
            self::flush_settings_cache();
            $option_key = $provider->get_option_key($domain, $section);
            do_action('aksrt_settings_domain_saved', $domain, $section, $option_key);
        }

        return $result;
    }


    /**
     * 获取指定 domain/section 的默认值。
     */
    public static function get_domain_defaults(string $domain, string $section = ''): array {
        $provider = AKSRT_Admin_Schema_Provider::get_instance();
        return $provider->get_defaults($domain, $section);
    }


    /**
     * 重置指定 domain/section 到默认值。
     */
    public static function reset_domain(string $domain, string $section = ''): bool {
        $provider = AKSRT_Admin_Schema_Provider::get_instance();
        $result = $provider->reset_to_defaults($domain, $section);

        if ($result) {
            self::flush_settings_cache();
            do_action('aksrt_settings_domain_reset', $domain, $section);
        }

        return $result;
    }


    public static function get_value(string $key, $default = null) {
        $settings = self::get_all();
        return array_key_exists($key, $settings) ? $settings[$key] : $default;
    }


    /** 获取搜索框占位文案 */
    public static function search_placeholder(): string {
        return AKSRT_Settings_Theme_Search::search_placeholder();
    }


    /** 获取搜索模式 */
    public static function search_mode(): string {
        return AKSRT_Settings_Theme_Search::search_mode();
    }


    /** 是否启用搜索历史 */
    public static function search_history_enabled(): bool {
        return AKSRT_Settings_Theme_Search::search_history_enabled();
    }


    /** 是否启用热门搜索 */
    public static function hot_search_enabled(): bool {
        return AKSRT_Settings_Theme_Search::hot_search_enabled();
    }


    /** 获取热门搜索关键词 */
    public static function hot_search_keywords(): array {
        return AKSRT_Settings_Theme_Search::hot_search_keywords();
    }


    /** 热门搜索标题（留空使用默认） */
    public static function search_popular_title(): string {
        return AKSRT_Settings_Theme_Search::search_popular_title();
    }


    /** 置顶搜索词（始终显示在最前面） */
    public static function search_popular_sticky(): array {
        return AKSRT_Settings_Theme_Search::search_popular_sticky();
    }


    /** 是否启用搜索建议 */
    public static function search_suggestions_enabled(): bool {
        return AKSRT_Settings_Theme_Search::search_suggestions_enabled();
    }


    /** 是否在搜索面板显示热门文章 */
    public static function search_posts_enabled(): bool {
        return AKSRT_Settings_Theme_Search::search_posts_enabled();
    }


    /** 搜索结果是否排除页面 */
    public static function search_no_page(): bool {
        return AKSRT_Settings_Theme_Search::search_no_page();
    }


    /** 获取搜索排除分类 ID 列表 */
    public static function search_exclude_cats(): array {
        return AKSRT_Settings_Theme_Search::search_exclude_cats();
    }


    /** 是否启用分类搜索选择器 */
    public static function search_cat_enabled(): bool {
        return AKSRT_Settings_Theme_Search::search_cat_enabled();
    }


    /** 获取默认搜索分类 */
    public static function search_cat_in(): string {
        return AKSRT_Settings_Theme_Search::search_cat_in();
    }


    /** 是否显示更多分类 */
    public static function search_more_cat_obj(): bool {
        return AKSRT_Settings_Theme_Search::search_more_cat_obj();
    }


    /** 是否启用自定义搜索匹配范围 */
    public static function search_custom_key_enabled(): bool {
        return AKSRT_Settings_Theme_Search::search_custom_key_enabled();
    }


    /** 获取自定义搜索匹配字段列表 */
    public static function search_custom_key(): array {
        return AKSRT_Settings_Theme_Search::search_custom_key();
    }


    /** 是否启用搜索结果 taxonomy 筛选 */
    public static function search_facets_enabled(): bool {
        return AKSRT_Settings_Theme_Search::search_facets_enabled();
    }


    /** 获取搜索结果筛选 taxonomy 排序列表 */
    public static function search_facets_order(): array {
        return AKSRT_Settings_Theme_Search::search_facets_order();
    }


    /**
     * Meilisearch integration configuration.
     *
     * @return array{enabled:bool,api_url:string,api_key:string,index_prefix:string,synonyms:array}
     */
    public static function get_meilisearch_config(): array {
        return AKSRT_Settings_Theme_Search::get_meilisearch_config();
    }


    /**
     * pre_get_posts 过滤：应用搜索排除配置
     * - search_no_page: 排除页面
     * - search_exclude_cats: 排除指定分类
     */
    public static function filter_search_query($query): void {
        AKSRT_Settings_Theme_Search::filter_search_query($query);
    }


    /**
     * pre_get_posts: apply global list_orderby on archive/tag/category/search pages.
     *
     * Only fires when no explicit orderby is set by URL params or other hooks.
     */
    public static function apply_list_orderby($query): void {
        AKSRT_Settings_Post_Display::apply_list_orderby($query);
    }


    /**
     * 获取搜索内容类型配置
     *
     * @return array{types: string[], default: string}
     */
    public static function get_search_content_types(): array {
        return AKSRT_Settings_Theme_Search::get_search_content_types();
    }


    /** 默认主题模式 (white-theme / dark-theme / time-auto) */
    public static function theme_mode(): string {
        return AKSRT_Settings_Theme_Search::theme_mode();
    }


    /** 主题模式 → JS 可消费的简化值 (light / dark / time-auto) */
    public static function theme_mode_js_value(): string {
        return AKSRT_Settings_Theme_Search::theme_mode_js_value();
    }


    /** time-auto：对齐 zibll 早晚 8 点自动切换语义。 */
    public static function time_auto_theme_mode(): string {
        return AKSRT_Settings_Theme_Search::time_auto_theme_mode();
    }


    /** 首屏主题模式：优先消费 zibll 兼容 cookie，回退后台默认值。 */
    public static function initial_theme_mode(): string {
        return AKSRT_Settings_Theme_Search::initial_theme_mode();
    }


    /** 获取主题色 */
    public static function primary_color(): string {
        return AKSRT_Settings_Theme_Search::primary_color();
    }


    /** 获取主题皮肤预设 hex（解析 palette 选项为 #hex 格式） */
    public static function theme_skin(): string {
        return AKSRT_Settings_Theme_Search::theme_skin();
    }


    /** 获取暗色模式独立主题色 */
    public static function dark_primary_color(): string {
        return AKSRT_Settings_Theme_Search::dark_primary_color();
    }


    /** 获取主题切换按钮显示位置列表 */
    public static function get_theme_mode_button_positions(): array {
        return AKSRT_Settings_Theme_Search::get_theme_mode_button_positions();
    }


    /** 获取最终生效的主题色（skin 优先于 custom primary_color） */
    public static function resolved_primary_color(): string {
        return AKSRT_Settings_Theme_Search::resolved_primary_color();
    }


    /** 获取全局圆角 */
    public static function border_radius(): int {
        return AKSRT_Settings_Theme_Search::border_radius();
    }


    /** 获取卡片圆角值（独立设置优先，否则 border_radius + 4） */
    public static function card_radius(): int {
        return AKSRT_Settings_Theme_Search::card_radius();
    }


    /** 全站加载动画开关 */
    public static function is_qj_loading_enabled(): bool {
        return AKSRT_Settings_Theme_Search::is_qj_loading_enabled();
    }


    /** 加载动画样式 (no1–no10) */
    public static function get_qj_loading_style(): string {
        return AKSRT_Settings_Theme_Search::get_qj_loading_style();
    }


    /** 获取内容最大宽度 */
    public static function container_max_width(): int {
        return AKSRT_Settings_Theme_Search::container_max_width();
    }


    /** 获取全局字体方案 */
    public static function font_family(): string {
        return AKSRT_Settings_Theme_Search::font_family();
    }


    /**
     * 获取代码高亮配置
     *
     * @return array
     */
    public static function get_code_highlight_config(): array {
        return AKSRT_Settings_Theme_Search::get_code_highlight_config();
    }


    /**
     * 获取系统公告配置
     *
     * @return array
     */
    public static function get_system_notice_config(): array {
        return AKSRT_Settings_Theme_Search::get_system_notice_config();
    }


    /**
     * 获取侧边栏配置
     *
     * @return array
     */
    public static function get_sidebar_config(): array {
        return AKSRT_Settings_Theme_Search::get_sidebar_config();
    }


    /**
     * 获取多语言翻译配置
     *
     * @return array
     */
    public static function get_i18n_config(): array {
        return AKSRT_Settings_Theme_Search::get_i18n_config();
    }


    /**
     * Public user-home display settings.
     *
     * @return array
     */
    public static function get_user_home_settings(): array {
        return AKSRT_Settings_User_Runtime::get_user_home_settings();
    }


    /**
     * Private user-center display settings.
     *
     * @return array{tabs:string[],avatar_upload:bool,cover_upload:bool,social_links:bool}
     */
    public static function get_user_center_settings(): array {
        return AKSRT_Settings_User_Runtime::get_user_center_settings();
    }


    /**
     * User identity, level, badge, and report governance settings.
     *
     * @return array{
     *   verify:array{enabled:bool,public_display:bool,badge_text:string,accept_email_verified:bool,require_manual_review:bool},
     *   level:array{enabled:bool,public_display:bool,source:string,label_prefix:string,thresholds:array<int,int>},
     *   badge:array{enabled:bool,public_display:bool,limit:int,dictionary:array<int,array{slug:string,label:string,tone:string}>},
     *   report:array{enabled:bool,public_entry:bool,public_notice:bool,ban_notice_text:string,categories:array<int,array{slug:string,label:string}>}
     * }
     */
    public static function get_user_identity_settings(): array {
        return AKSRT_Settings_User_Runtime::get_user_identity_settings();
    }


    /**
     * Post-list card style and meta display settings.
     *
     * @return array{card_style:string,render_mode:string,show_author:bool,show_date:bool,show_views:bool,show_category:bool,show_comments:bool,show_likes:bool,excerpt_length:int}
     */
    public static function get_post_list_style_settings(): array {
        return AKSRT_Settings_Post_Display::get_post_list_style_settings();
    }


    /**
     * Post-list thumbnail policy settings.
     *
     * @return array{priority:string[],fallback:string,aspect_ratio:string,multi_enabled:bool,multi_count:int,lazy:bool}
     */
    public static function get_post_thumb_settings(): array {
        return AKSRT_Settings_Post_Display::get_post_thumb_settings();
    }


    /**
     * Post-list filter toolbar settings.
     *
     * @return array{enabled:bool,categories:bool,tags:bool,sort:bool}
     */
    public static function get_post_filter_settings(): array {
        return AKSRT_Settings_Post_Display::get_post_filter_settings();
    }


    /**
     * Get custom filter definitions for a specific category.
     * Finds the matching cat_custom_filter binding, falls back to global custom_filter.
     *
     * @param int $cat_id Category term ID.
     * @return array{dimensions: array, show_cat: bool, show_tag: bool, show_topics: bool, show_orderby: bool}
     */
    public static function get_filter_config_for_category(int $cat_id): array {
        return AKSRT_Settings_Post_Display::get_filter_config_for_category($cat_id);
    }


    /**
     * Front submit settings.
     *
     * @return array{enabled:bool,btn_text:string,title_min:int,title_max:int}
     */
    public static function get_submit_settings(): array {
        return AKSRT_Settings_Post_Display::get_submit_settings();
    }


    /**
     * Comment display and behavior settings.
     *
     * @return array{order:string,pagination_mode:string,nested_depth:int,require_login:bool,allow_reply:bool,avatar_size:int,empty_text:string}
     */
    public static function get_comment_display_settings(): array {
        return AKSRT_Settings_Post_Display::get_comment_display_settings();
    }


    public static function get_withdrawal_settings(): array {
        return AKSRT_Settings_Payment_Runtime::get_withdrawal_settings();
    }


    /**
     * pre_get_posts: apply post_list_per_page on archive/tag/category/search/home pages.
     *
     * Overrides WP Settings > Reading "posts per page" for list views.
     */
    public static function apply_list_per_page($query): void {
        AKSRT_Settings_Post_Display::apply_list_per_page($query);
    }


    /** 获取Banner列表 */
    public static function get_banners(string $position = ''): array {
        return AKSRT_Settings_Display_Runtime::get_banners($position);
    }


    /** 保存Banner */
    public static function save_banner(array $data): int {
        return AKSRT_Settings_Display_Runtime::save_banner($data);
    }


    /** 删除Banner */
    public static function delete_banner(string $id): void {
        AKSRT_Settings_Display_Runtime::delete_banner($id);
    }


    /** 获取友链列表 */
    public static function get_friend_links(): array {
        return AKSRT_Settings_Display_Runtime::get_friend_links();
    }


    /** 保存友链 */
    public static function save_friend_links(array $links): void {
        AKSRT_Settings_Display_Runtime::save_friend_links($links);
    }


    /** 私信邮件接收组限制 (all/vip/vip2/admin) */
    public static function get_email_private_receive_limit(): string {
        return AKSRT_Settings_Integration::get_email_private_receive_limit();
    }


    /** 获取OAuth配置 */
    public static function get_oauth(): array {
        return AKSRT_Settings_Integration::get_oauth();
    }


    /** 检查OAuth平台是否已配置 */
    public static function oauth_configured(string $provider): bool {
        return AKSRT_Settings_Integration::oauth_configured($provider);
    }


    // ============================================
    // OAuth 代理登录 & 自动创建用户
    // ============================================

    /** OAuth 代理登录模式: 'off' | 'server' | 'client' (schema 存 'close'→映射为 'off') */
    public static function oauth_proxy_mode(): string {
        return AKSRT_Settings_Integration::oauth_proxy_mode();
    }


    /** OAuth 代理登录 HMAC 密钥 */
    public static function oauth_proxy_secret(): string {
        return AKSRT_Settings_Integration::oauth_proxy_secret();
    }


    /** OAuth 代理登录服务端地址（客户端模式使用） */
    public static function oauth_proxy_server_url(): string {
        return AKSRT_Settings_Integration::oauth_proxy_server_url();
    }


    /** OAuth 代理登录允许的平台列表（服务端模式使用） */
    public static function oauth_proxy_allowed_providers(): array {
        return AKSRT_Settings_Integration::oauth_proxy_allowed_providers();
    }


    /** OAuth 代理登录启用的平台列表（客户端模式使用） */
    public static function oauth_proxy_client_providers(): array {
        return AKSRT_Settings_Integration::oauth_proxy_client_providers();
    }


    /**
     * 获取微信公众号登录完整配置
     *
     * @return array{gzh_type:string,token:string,token_nocheck:bool,encoding_aes_key:string,appid:string,appsecret:string,code_qrcode:string,code_keyword:string,code_reply:string,code_subscribe_reply:string,subscribe_msg:string,new_subscribe_msg:string,scan_msg:string,auto_reply_text:string,auto_reply_search:string,auto_reply_image:string,auto_reply_voice:string,auto_reply_default:string,gzh_menu:string,priority:bool,auto:bool,auto_expires:int}
     */
    public static function get_weixingzh_settings(): array {
        return AKSRT_Settings_Integration::get_weixingzh_settings();
    }


    /**
     * 获取 OAuth 代理登录完整配置（aksrt_settings 优先，BC fallback aksrt_oauth）
     *
     * @return array{mode:string,secret:string,server_url:string,server_providers:array,client_providers:array,gzh_type:string}
     */
    public static function get_oauth_proxy_settings(): array {
        return AKSRT_Settings_Integration::get_oauth_proxy_settings();
    }


    // ============================================
    // 底部信息配置
    // ============================================

    /**
     * 获取底部信息完整配置（统一 aksrt_footer_settings + aksrt_settings page-display footer 字段）
     * @return array
     */
    public static function get_footer_settings(): array {
        return AKSRT_Settings_Home_Cms::get_footer_settings();
    }


    /** 获取联系图标列表（仅返回启用的） */
    public static function get_footer_contacts(): array {
        return AKSRT_Settings_Home_Cms::get_footer_contacts();
    }


    /** 获取快速链接列表（仅返回启用的，按排序） */
    public static function get_quick_links(): array {
        return AKSRT_Settings_Home_Cms::get_quick_links();
    }


    /** 获取更多链接列表（仅返回启用的，按排序） */
    public static function get_more_links(): array {
        return AKSRT_Settings_Home_Cms::get_more_links();
    }


    /** 获取热门分类显示数量 */
    public static function get_hot_categories_count(): int {
        return AKSRT_Settings_Home_Cms::get_hot_categories_count();
    }


    /** 获取版权文字 */
    public static function get_copyright_text(): string {
        return AKSRT_Settings_Home_Cms::get_copyright_text();
    }


    /**
     * 获取页脚品牌列（第一列）配置
     * @return array {m_s, img, img_dark, title, custom_code}
     */
    public static function get_footer_brand_settings(): array {
        return AKSRT_Settings_Home_Cms::get_footer_brand_settings();
    }


    /**
     * 获取页脚扩展联系方式配置
     * @return array {m_s, wechat_img, qq, weibo, email, more, code_1, code_2}
     */
    public static function get_footer_contact_extended_settings(): array {
        return AKSRT_Settings_Home_Cms::get_footer_contact_extended_settings();
    }


    /**
     * 获取页脚二维码图片组（第三列）
     * @return array {m_s, items: [{text, img}]}
     */
    public static function get_footer_mini_img_settings(): array {
        return AKSRT_Settings_Home_Cms::get_footer_mini_img_settings();
    }


    /**
     * 获取页脚底部自定义代码
     */
    public static function get_footer_customize_code(): string {
        return AKSRT_Settings_Home_Cms::get_footer_customize_code();
    }


    /** 获取审核配置 */
    public static function get_moderation(): array {
        return AKSRT_Settings_Extension_Runtime::get_moderation();
    }


    // ============================================
    // 文章布局配置
    // ============================================

    /**
     * 获取归档布局模式。
     *
     * 从 post_list.list schema 的 render_mode 字段读取。
     * 后台可在 /post-list/list 页面配置。
     *
     * @return string grid-cms|list|compact
     */
    public static function get_archive_layout(): string {
        return AKSRT_Settings_Post_Display::get_archive_layout();
    }


    /**
     * 获取文章列表分页模式
     * @return string numbered|load_more|infinite
     */
    public static function get_post_pagination_mode(): string {
        return AKSRT_Settings_Post_Display::get_post_pagination_mode();
    }


    /**
     * 获取评论列表分页模式
     * @return string numbered|load_more|infinite
     */
    public static function get_comment_pagination_mode(): string {
        return AKSRT_Settings_Post_Display::get_comment_pagination_mode();
    }


    // ============================================
    // CMS 配置
    // ============================================

    /**
     * 获取站点全局风格。
     *
     * v4 起主题统一为 CMS / 资源站形态，恒返回 'cms'。
     * 保留方法签名以兼容旧调用。
     *
     * @return string 始终为 'cms'
     */
    public static function get_site_profile(): string {
        return AKSRT_Settings_Home_Cms::get_site_profile();
    }


    /**
     * CMS 功能开关（合并默认值）。
     * @return array
     */
    public static function get_cms_features(): array {
        return AKSRT_Settings_Home_Cms::get_cms_features();
    }


    /**
     * 单项 CMS 功能开关读取。
     */
    public static function cms_feature(string $key, $default = null) {
        return AKSRT_Settings_Home_Cms::cms_feature($key, $default);
    }

}