此选项由网络管理员统一控制，无法在子站点修改。
'; + } + return ''; + } + + /** + * 检查是否为网络强制模式 + */ + public function is_network_enforced() { + return $this->is_network_enforced; + } } diff --git a/includes/blocks/blocks-init.php b/includes/blocks/blocks-init.php index 9924ce9..29db599 100644 --- a/includes/blocks/blocks-init.php +++ b/includes/blocks/blocks-init.php @@ -8,10 +8,28 @@ class WPCC_Blocks { public function __construct() { add_action( 'init', array( $this, 'register_blocks' ) ); + add_action( 'init', array( $this, 'register_block_styles' ) ); add_action( 'enqueue_block_editor_assets', array( $this, 'enqueue_block_editor_assets' ) ); add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_frontend_assets' ) ); } + public function register_block_styles() { + // 在 init 阶段注册样式句柄，供 block.json 中的 editorStyle 和 style 字段使用 + wp_register_style( + 'wpcc-blocks-editor', + plugins_url( 'assets/css/blocks-editor.css', dirname( dirname( __FILE__ ) ) ), + array(), + wpcc_VERSION + ); + + wp_register_style( + 'wpcc-blocks-frontend', + plugins_url( 'assets/css/blocks-frontend.css', dirname( dirname( __FILE__ ) ) ), + array(), + wpcc_VERSION + ); + } + public function register_blocks() { $blocks = array( 'language-switcher', @@ -36,22 +54,18 @@ class WPCC_Blocks { public function enqueue_block_editor_assets() { // 确保wpcc-variant脚本已加载 if ( ! wp_script_is( 'wpcc-variant', 'registered' ) ) { - wp_register_script( 'wpcc-variant', plugins_url( 'assets/dist/wpcc-variant.umd.js', dirname( dirname( __FILE__ ) ) ), array(), '1.1.0' ); + wp_register_script( 'wpcc-variant', plugins_url( 'assets/dist/wpcc-variant.umd.js', dirname( dirname( __FILE__ ) ) ), array(), wpcc_VERSION ); } - wp_enqueue_style( - 'wpcc-blocks-editor', - plugins_url( 'assets/css/blocks-editor.css', dirname( dirname( __FILE__ ) ) ), - array(), - '1.0.0' - ); + // 样式已在 init 阶段注册，这里只需要加载即可 + wp_enqueue_style( 'wpcc-blocks-editor' ); // 兼容层：为编辑器注册旧占位文本的 deprecated 版本，避免校验失败 wp_enqueue_script( 'wpcc-block-compat', plugins_url( 'assets/js/wpcc-block-compat.js', dirname( dirname( __FILE__ ) ) ), array( 'wp-blocks', 'wp-element', 'wp-block-editor', 'wp-hooks' ), - '1.0.0', +wpcc_VERSION, true ); @@ -59,7 +73,7 @@ class WPCC_Blocks { $enabled_languages = $wpcc_options['wpcc_used_langs'] ?? array(); wp_localize_script( - 'wp-blocks', + 'wpcc-block-compat', 'wpccBlockSettings', array( 'enabledLanguages' => $enabled_languages, @@ -85,24 +99,23 @@ class WPCC_Blocks { public function enqueue_frontend_assets() { // 确保wpcc-variant脚本已加载 if ( ! wp_script_is( 'wpcc-variant', 'registered' ) ) { - wp_register_script( 'wpcc-variant', plugins_url( 'assets/dist/wpcc-variant.umd.js', dirname( dirname( __FILE__ ) ) ), array(), '1.1.0' ); + wp_register_script( 'wpcc-variant', plugins_url( 'assets/dist/wpcc-variant.umd.js', dirname( dirname( __FILE__ ) ) ), array(), wpcc_VERSION ); } // 为前端状态指示器的 dashicons 图标提供样式支持 wp_enqueue_style( 'dashicons' ); - wp_enqueue_style( - 'wpcc-blocks-frontend', - plugins_url( 'assets/css/blocks-frontend.css', dirname( dirname( __FILE__ ) ) ), - array(), - '1.0.0' - ); + // 样式已在 init 阶段注册，这里只需要加载即可 + wp_enqueue_style( 'wpcc-blocks-frontend' ); + // 使用文件修改时间作为版本号，避免浏览器缓存导致逻辑不更新 + $blocks_front_js = plugin_dir_path( dirname( __FILE__ ) ) . 'assets/js/blocks-frontend.js'; + $blocks_front_ver = file_exists( $blocks_front_js ) ? filemtime( $blocks_front_js ) : wpcc_VERSION; wp_enqueue_script( 'wpcc-blocks-frontend', plugins_url( 'assets/js/blocks-frontend.js', dirname( dirname( __FILE__ ) ) ), array( 'wpcc-variant' ), - '1.0.0', + $blocks_front_ver, true ); diff --git a/includes/core/class-mediawiki-converter.php b/includes/core/class-mediawiki-converter.php deleted file mode 100644 index 65dee37..0000000 --- a/includes/core/class-mediawiki-converter.php +++ /dev/null @@ -1,284 +0,0 @@ -ensure_conversion_tables_loaded( $target_variant ); - - $result = $text; - switch ( $target_variant ) { - case 'zh-hans': - $result = $this->convert_to_hans( $text ); - break; - case 'zh-hant': - $result = $this->convert_to_hant( $text ); - break; - case 'zh-cn': - $result = $this->convert_to_cn( $text ); - break; - case 'zh-tw': - $result = $this->convert_to_tw( $text ); - break; - case 'zh-hk': - $result = $this->convert_to_hk( $text ); - break; - case 'zh-sg': - $result = $this->convert_to_sg( $text ); - break; - } - - // 缓存转换结果 - if ( $result !== $text ) { - WPCC_Conversion_Cache::set_cached_conversion( $text, $target_variant, $result ); - } - - return $result; - } - - public function get_supported_variants() { - return array( 'zh-hans', 'zh-hant', 'zh-cn', 'zh-tw', 'zh-hk', 'zh-sg' ); - } - - public function get_engine_name() { - return 'mediawiki'; - } - - public function get_engine_info() { - $memory_usage = $this->get_memory_usage_info(); - - return array( - 'name' => 'MediaWiki', - 'version' => '1.23.5', - 'description' => '基于MediaWiki的字符映射转换引擎', - 'features' => array( - '字符级精确映射', - '快速转换速度', - '良好的兼容性', - '支持多地区变体', - '按需加载优化' - ), - 'memory_usage' => $memory_usage, - 'conversion_type' => 'character_mapping', - 'lazy_load_enabled' => $this->lazy_load_enabled, - 'loaded_tables' => array_keys( array_filter( self::$loaded_tables ) ) - ); - } - - public function get_memory_usage_info() { - $loaded_count = count( array_filter( self::$loaded_tables ) ); - $total_count = count( $this->get_supported_variants() ); - - if ( $this->lazy_load_enabled ) { - $estimated_usage = $loaded_count * 0.25; // MB per table approximately - return sprintf( '约 %.1fMB (%d/%d 表已加载, 按需加载开启)', $estimated_usage, $loaded_count, $total_count ); - } else { - return '约 1.5MB (所有转换表已加载)'; - } - } - - public function enable_lazy_loading( $enable = true ) { - $this->lazy_load_enabled = $enable; - } - - public function is_lazy_loading_enabled() { - return $this->lazy_load_enabled; - } - - public static function get_loaded_tables_status() { - return self::$loaded_tables; - } - - public static function unload_table( $variant ) { - if ( isset( self::$loaded_tables[ $variant ] ) ) { - unset( self::$loaded_tables[ $variant ] ); - - // 清理对应的全局变量（这里只能标记，PHP不能真正释放全局变量内存） - return true; - } - return false; - } - - public function is_available() { - $conversion_file = dirname( dirname( __FILE__ ) ) . '/core/ZhConversion.php'; - return file_exists( $conversion_file ); - } - - private function ensure_conversion_tables_loaded( $target_variant = null ) { - if ( $this->lazy_load_enabled && $target_variant ) { - // 按需加载特定语言变体的转换表 - $this->ensure_specific_table_loaded( $target_variant ); - } else { - // 传统方式：加载所有转换表 - $this->load_all_conversion_tables(); - } - } - - private function ensure_specific_table_loaded( $target_variant ) { - if ( isset( self::$loaded_tables[ $target_variant ] ) ) { - return; // 已经加载 - } - - $conversion_file = dirname( dirname( __FILE__ ) ) . '/core/ZhConversion.php'; - if ( ! file_exists( $conversion_file ) ) { - return; - } - - // 只加载需要的转换表 - global $zh2Hans, $zh2Hant, $zh2CN, $zh2TW, $zh2HK, $zh2SG; - - switch ( $target_variant ) { - case 'zh-hans': - if ( ! isset( $zh2Hans ) ) { - $this->load_conversion_table_partial( 'zh2Hans' ); - } - self::$loaded_tables['zh-hans'] = true; - break; - - case 'zh-hant': - if ( ! isset( $zh2Hant ) ) { - $this->load_conversion_table_partial( 'zh2Hant' ); - } - self::$loaded_tables['zh-hant'] = true; - break; - - case 'zh-cn': - if ( ! isset( $zh2CN ) || ! isset( $zh2Hans ) ) { - $this->load_conversion_table_partial( array( 'zh2CN', 'zh2Hans' ) ); - } - self::$loaded_tables['zh-cn'] = true; - break; - - case 'zh-tw': - if ( ! isset( $zh2TW ) || ! isset( $zh2Hant ) ) { - $this->load_conversion_table_partial( array( 'zh2TW', 'zh2Hant' ) ); - } - self::$loaded_tables['zh-tw'] = true; - break; - - case 'zh-hk': - if ( ! isset( $zh2HK ) || ! isset( $zh2Hant ) ) { - $this->load_conversion_table_partial( array( 'zh2HK', 'zh2Hant' ) ); - } - self::$loaded_tables['zh-hk'] = true; - break; - - case 'zh-sg': - if ( ! isset( $zh2SG ) || ! isset( $zh2Hans ) ) { - $this->load_conversion_table_partial( array( 'zh2SG', 'zh2Hans' ) ); - } - self::$loaded_tables['zh-sg'] = true; - break; - - default: - $this->load_all_conversion_tables(); - break; - } - } - - private function load_conversion_table_partial( $table_names ) { - $conversion_file = dirname( dirname( __FILE__ ) ) . '/core/ZhConversion.php'; - - if ( ! is_array( $table_names ) ) { - $table_names = array( $table_names ); - } - - // 读取文件内容并解析指定的转换表 - $file_content = file_get_contents( $conversion_file ); - - foreach ( $table_names as $table_name ) { - $pattern = '/\$' . preg_quote( $table_name, '/' ) . '\s*=\s*array\s*\((.*?)\);/s'; - if ( preg_match( $pattern, $file_content, $matches ) ) { - $table_code = '$' . $table_name . ' = array(' . $matches[1] . ');'; - eval( $table_code ); - - // 将变量设置为全局 - $GLOBALS[ $table_name ] = ${$table_name}; - } - } - - // 加载额外转换文件 - $extra_conversion_file = WP_CONTENT_DIR . '/extra_zhconversion.php'; - if ( file_exists( $extra_conversion_file ) ) { - require_once $extra_conversion_file; - } - } - - private function load_all_conversion_tables() { - if ( $this->conversion_tables_loaded ) { - return; - } - - global $zh2Hans, $zh2Hant, $zh2CN, $zh2TW, $zh2HK, $zh2SG; - - if ( ! isset( $zh2Hans ) ) { - require_once dirname( dirname( __FILE__ ) ) . '/core/ZhConversion.php'; - - $extra_conversion_file = WP_CONTENT_DIR . '/extra_zhconversion.php'; - if ( file_exists( $extra_conversion_file ) ) { - require_once $extra_conversion_file; - } - } - - // 标记所有表为已加载 - self::$loaded_tables = array( - 'zh-hans' => true, - 'zh-hant' => true, - 'zh-cn' => true, - 'zh-tw' => true, - 'zh-hk' => true, - 'zh-sg' => true - ); - - $this->conversion_tables_loaded = true; - } - - private function convert_to_hans( $text ) { - global $zh2Hans; - return strtr( $text, $zh2Hans ); - } - - private function convert_to_hant( $text ) { - global $zh2Hant; - return strtr( $text, $zh2Hant ); - } - - private function convert_to_cn( $text ) { - global $zh2Hans, $zh2CN; - return strtr( strtr( $text, $zh2CN ), $zh2Hans ); - } - - private function convert_to_tw( $text ) { - global $zh2Hant, $zh2TW; - return strtr( strtr( $text, $zh2TW ), $zh2Hant ); - } - - private function convert_to_hk( $text ) { - global $zh2Hant, $zh2HK; - return strtr( strtr( $text, $zh2HK ), $zh2Hant ); - } - - private function convert_to_sg( $text ) { - global $zh2Hans, $zh2SG; - return strtr( strtr( $text, $zh2SG ), $zh2Hans ); - } -} \ No newline at end of file diff --git a/includes/core/class-opencc-converter.php b/includes/core/class-opencc-converter.php deleted file mode 100644 index 8842971..0000000 --- a/includes/core/class-opencc-converter.php +++ /dev/null @@ -1,159 +0,0 @@ - Strategy::TRADITIONAL_TO_SIMPLIFIED, - 'zh-hant' => Strategy::SIMPLIFIED_TO_TRADITIONAL, - 'zh-cn' => Strategy::TRADITIONAL_TO_SIMPLIFIED, - 'zh-tw' => Strategy::SIMPLIFIED_TO_TAIWAN_WITH_PHRASE, - 'zh-hk' => Strategy::SIMPLIFIED_TO_HONGKONG, - 'zh-sg' => Strategy::TRADITIONAL_TO_SIMPLIFIED, - 'zh-jp' => Strategy::SIMPLIFIED_TO_JAPANESE, - ); - - public function convert( $text, $target_variant ) { - if ( empty( $text ) ) { - return $text; - } - - if ( ! $this->is_available() ) { - throw new Exception( 'OpenCC library is not available' ); - } - - if ( ! isset( $this->strategy_map[ $target_variant ] ) ) { - return $text; - } - - try { - return OpenCC::convert( $text, $this->strategy_map[ $target_variant ] ); - } catch ( Exception $e ) { - error_log( 'WPCC OpenCC Conversion Error: ' . $e->getMessage() ); - return $text; - } - } - - public function get_supported_variants() { - return array_keys( $this->strategy_map ); - } - - public function get_engine_name() { - return 'opencc'; - } - - public function get_engine_info() { - return array( - 'name' => 'OpenCC', - 'version' => '1.2.1', - 'description' => '基于 OpenCC 的智能词汇级转换引擎', - 'features' => array( - '词汇级别转换', - '异体字转换', - '地区习惯用词转换', - '智能语境分析', - '支持批量转换' - ), - 'memory_usage' => '按需加载，内存占用较低', - 'conversion_type' => 'vocabulary_based' - ); - } - - public function is_available() { - return class_exists( 'Overtrue\PHPOpenCC\OpenCC' ); - } - - public function batch_convert( $texts, $target_variant ) { - if ( ! $this->is_available() ) { - return $texts; - } - - if ( ! isset( $this->strategy_map[ $target_variant ] ) ) { - return $texts; - } - - if ( ! is_array( $texts ) ) { - return $texts; - } - - // 检查缓存 - $cached_results = array(); - $uncached_texts = array(); - $uncached_indices = array(); - - foreach ( $texts as $index => $text ) { - $cached_result = WPCC_Conversion_Cache::get_cached_conversion( $text, $target_variant ); - if ( $cached_result !== null ) { - $cached_results[ $index ] = $cached_result; - } else { - $uncached_texts[] = $text; - $uncached_indices[] = $index; - } - } - - // 如果所有内容都在缓存中，直接返回 - if ( empty( $uncached_texts ) ) { - $results = array(); - foreach ( $texts as $index => $text ) { - $results[] = $cached_results[ $index ]; - } - return $results; - } - - try { - // 转换未缓存的内容 - $converted_texts = OpenCC::convert( $uncached_texts, $this->strategy_map[ $target_variant ] ); - - // 合并结果并缓存新转换的内容 - $results = array(); - $uncached_index = 0; - - foreach ( $texts as $index => $original_text ) { - if ( isset( $cached_results[ $index ] ) ) { - $results[] = $cached_results[ $index ]; - } else { - $converted_text = is_array( $converted_texts ) ? $converted_texts[ $uncached_index ] : $converted_texts; - $results[] = $converted_text; - - // 缓存转换结果 - if ( $converted_text !== $original_text ) { - WPCC_Conversion_Cache::set_cached_conversion( $original_text, $target_variant, $converted_text ); - } - - $uncached_index++; - } - } - - return $results; - - } catch ( Exception $e ) { - error_log( 'WPCC OpenCC Batch Conversion Error: ' . $e->getMessage() ); - return $texts; - } - } - - public function get_available_strategies() { - return $this->strategy_map; - } - - public function convert_with_strategy( $text, $strategy ) { - if ( empty( $text ) || ! $this->is_available() ) { - return $text; - } - - try { - return OpenCC::convert( $text, $strategy ); - } catch ( Exception $e ) { - error_log( 'WPCC OpenCC Strategy Conversion Error: ' . $e->getMessage() ); - return $text; - } - } -} \ No newline at end of file diff --git a/includes/core/class-wpcc-config.php b/includes/core/class-wpcc-config.php index 8620371..e4a106e 100644 --- a/includes/core/class-wpcc-config.php +++ b/includes/core/class-wpcc-config.php @@ -1,6 +1,6 @@ load_options(); $this->init_languages(); } - - public static function get_instance(): self { - if ( null === self::$instance ) { + + public static function get_instance(): self + { + if (null === self::$instance) { self::$instance = new self(); } return self::$instance; } - + /** * 加载插件选项 */ - private function load_options(): void { - $this->options = get_wpcc_option( 'wpcc_options' ); - if ( empty( $this->options ) ) { + private function load_options(): void + { + $options = $this->get_wpcc_options(); + + // 确保返回值是数组类型 + if (! is_array($options) || empty($options)) { $this->options = $this->get_default_options(); + } else { + $this->options = $options; } } - + + /** + * 获取WPCC选项，考虑网络控制 + */ + private function get_wpcc_options(): array + { + // 获取本地选项 + $local_options = get_option('wpcc_options', []); + + // 如果不是多站点环境，直接返回本地选项 + if (! is_multisite() || is_network_admin()) { + return $local_options; + } + + // 检查网络控制 + if (! class_exists('WPCC_Network_Settings')) { + return $local_options; + } + + // 获取网络控制的选项列表 + $controlled_options = get_site_option('wpcc_network_controlled_options', []); + if (! is_array($controlled_options)) { + $controlled_options = explode(',', $controlled_options); + } + + // 如果没有网络控制选项，返回本地选项 + if (empty($controlled_options)) { + return $local_options; + } + + // 合并网络控制的选项 + $network_options = []; + + // 映射网络默认选项到本地选项名 + $option_mapping = [ + 'wpcc_default_used_langs' => 'wpcc_used_langs', + 'wpcc_default_cntip' => 'cntip', + 'wpcc_default_twtip' => 'twtip', + 'wpcc_default_hktip' => 'hktip', + 'wpcc_default_hanstip' => 'hanstip', + 'wpcc_default_hanttip' => 'hanttip', + 'wpcc_default_sgtip' => 'sgtip', + 'wpcc_default_jptip' => 'jptip', + 'wpcc_default_nctip' => 'nctip', + 'wpcc_default_flag_option' => 'wpcc_flag_option', + // Harmonize with single-site option key used in UI + 'wpcc_default_enable_extended_langs' => 'wpcc_show_more_langs', + 'wpcc_default_engine' => 'wpcc_engine', + 'wpcc_default_search_conversion' => 'wpcc_search_conversion', + 'wpcc_default_use_fullpage_conversion' => 'wpcc_use_fullpage_conversion', + // Quicktags uses wpcc_no_conversion_qtag in single-site + 'wpcc_default_no_conversion_qtag' => 'wpcc_no_conversion_qtag', + 'wpcc_default_enable_post_conversion' => 'wpcc_enable_post_conversion', + 'wpcc_default_post_conversion_target' => 'wpcc_post_conversion_target', + 'wpcc_default_use_permalink' => 'wpcc_use_permalink', + 'wpcc_default_sitemap_post_type' => 'wpcco_sitemap_post_type', + 'wpcc_default_use_sitemap' => 'wpcco_use_sitemap', + 'wpcc_default_browser_redirect' => 'wpcc_browser_redirect', + 'wpcc_default_auto_language_recong' => 'wpcc_auto_language_recong', + 'wpcc_default_use_cookie_variant' => 'wpcc_use_cookie_variant', + 'wpcc_default_no_conversion_tag' => 'wpcc_no_conversion_tag', + 'wpcc_default_no_conversion_ja' => 'wpcc_no_conversion_ja', + 'wpcc_default_hreflang_x_default' => 'wpcc_hreflang_x_default', + 'wpcc_default_enable_hreflang_tags' => 'wpcc_enable_hreflang_tags', + 'wpcc_default_enable_hreflang_x_default' => 'wpcc_enable_hreflang_x_default', + 'wpcc_default_enable_schema_conversion' => 'wpcc_enable_schema_conversion', + 'wpcc_default_enable_meta_conversion' => 'wpcc_enable_meta_conversion', + 'wpcc_default_enable_cache_addon' => 'wpcc_enable_cache_addon' + ]; + + // 对于每个被控制的选项，使用网络设置 + foreach ($controlled_options as $option_name) { + // 使用映射表查找对应的网络选项名 + $network_option_name = null; + + // 查找映射表中的对应关系 + foreach ($option_mapping as $network_key => $local_key) { + if ($local_key === $option_name) { + $network_option_name = $network_key; + break; + } + } + + // 如果映射表中没有找到，使用默认规则 + if (!$network_option_name) { + $network_option_name = 'wpcc_default_' . str_replace('wpcc_', '', $option_name); + } + + // 获取网络设置值 + $network_value = get_site_option($network_option_name); + if ($network_value !== false) { + $network_options[$option_name] = $network_value; + } + } + + // 合并选项：网络控制的选项覆盖本地选项 + return array_merge($local_options, $network_options); + } + /** * 获取默认配置 */ - private function get_default_options(): array { + private function get_default_options(): array + { return [ // 语言与标签 - 'wpcc_used_langs' => ['zh-cn','zh-tw'], + 'wpcc_used_langs' => ['zh-cn', 'zh-tw'], 'cntip' => '简体', 'twtip' => '繁体', 'hktip' => '港澳', @@ -69,7 +176,7 @@ class WPCC_Config { 'wpcc_use_cookie_variant' => 1, // 不转换 -'wpcc_no_conversion_tag' => 'pre,code,pre.wp-block-code,pre.wp-block-preformatted,script,noscript,style,kbd,samp', + 'wpcc_no_conversion_tag' => '', 'wpcc_no_conversion_ja' => 0, 'wpcc_no_conversion_qtag' => 0, @@ -84,10 +191,12 @@ class WPCC_Config { // SEO 'wpcc_enable_hreflang_tags' => 1, + 'wpcc_enable_hreflang_x_default' => 1, 'wpcc_hreflang_x_default' => 'zh-cn', 'wpcc_enable_schema_conversion' => 1, 'wpcc_enable_meta_conversion' => 1, + // 其他 'wpcc_flag_option' => 1, 'wpcc_trackback_plugin_author' => 0, @@ -98,193 +207,210 @@ class WPCC_Config { 'wpcc_enable_network_module' => 0, ]; } - + /** * 初始化语言配置 */ - private function init_languages(): void { - $this->languages = [ - 'zh-cn' => [ 'zhconversion_cn', 'cntip', __( '简体中文', 'wp-chinese-converter' ), 'zh-CN' ], - 'zh-tw' => [ 'zhconversion_tw', 'twtip', __( '台灣正體', 'wp-chinese-converter' ), 'zh-TW' ], - 'zh-hk' => [ 'zhconversion_hk', 'hktip', __( '港澳繁體', 'wp-chinese-converter' ), 'zh-HK' ], - 'zh-hans' => [ 'zhconversion_hans', 'hanstip', __( '简体中文', 'wp-chinese-converter' ), 'zh-Hans' ], - 'zh-hant' => [ 'zhconversion_hant', 'hanttip', __( '繁体中文', 'wp-chinese-converter' ), 'zh-Hant' ], - 'zh-sg' => [ 'zhconversion_sg', 'sgtip', __( '马新简体', 'wp-chinese-converter' ), 'zh-SG' ], - 'zh-jp' => [ 'zhconversion_jp', 'jptip', __( '日式汉字', 'wp-chinese-converter' ), 'zh-JP' ], - ]; + private function init_languages(): void + { + // 使用中心化的语言配置 + $this->languages = WPCC_Language_Config::get_all_languages(); } - + /** * 获取配置选项 */ - public function get_option( string $key, $default = null ) { + public function get_option(string $key, $default = null) + { return $this->options[$key] ?? $default; } - + /** * 设置配置选项 */ - public function set_option( string $key, $value ): void { + public function set_option(string $key, $value): void + { $this->options[$key] = $value; } - + /** * 更新配置选项到数据库 */ - public function save_options(): bool { - return update_wpcc_option( 'wpcc_options', $this->options ); + public function save_options(): bool + { + return update_option('wpcc_options', $this->options); } - + /** * 获取所有配置选项 */ - public function get_all_options(): array { + public function get_all_options(): array + { return $this->options; } - + /** * 获取语言配置 */ - public function get_languages(): array { + public function get_languages(): array + { return $this->languages; } - + /** * 获取特定语言配置 */ - public function get_language( string $lang_code ): ?array { + public function get_language(string $lang_code): ?array + { return $this->languages[$lang_code] ?? null; } - + /** * 设置目标语言 */ - public function set_target_lang( string $lang ): void { + public function set_target_lang(string $lang): void + { $this->target_lang = $lang; } - + /** * 获取目标语言 */ - public function get_target_lang(): string { + public function get_target_lang(): string + { return $this->target_lang; } - + /** * 设置无转换URL */ - public function set_noconversion_url( string $url ): void { + public function set_noconversion_url(string $url): void + { $this->noconversion_url = $url; } - + /** * 获取无转换URL */ - public function get_noconversion_url(): string { + public function get_noconversion_url(): string + { return $this->noconversion_url; } - + /** * 设置语言URL映射 */ - public function set_langs_urls( array $urls ): void { + public function set_langs_urls(array $urls): void + { $this->langs_urls = $urls; } - + /** * 获取语言URL映射 */ - public function get_langs_urls(): array { + public function get_langs_urls(): array + { return $this->langs_urls; } - + /** * 设置重定向标志 */ - public function set_redirect_to( bool $redirect ): void { + public function set_redirect_to(bool $redirect): void + { $this->redirect_to = $redirect; } - + /** * 获取重定向标志 */ - public function get_redirect_to(): bool { + public function get_redirect_to(): bool + { return $this->redirect_to; } - + /** * 设置直接转换标志 */ - public function set_direct_conversion_flag( bool $flag ): void { + public function set_direct_conversion_flag(bool $flag): void + { $this->direct_conversion_flag = $flag; } - + /** * 获取直接转换标志 */ - public function get_direct_conversion_flag(): bool { + public function get_direct_conversion_flag(): bool + { return $this->direct_conversion_flag; } - + /** * 添加调试数据 */ - public function add_debug_data( string $key, $data ): void { - if ( defined( 'wpcc_DEBUG' ) && wpcc_DEBUG ) { + public function add_debug_data(string $key, $data): void + { + if (defined('wpcc_DEBUG') && wpcc_DEBUG) { $this->debug_data[$key] = $data; } } - + /** * 获取调试数据 */ - public function get_debug_data(): array { + public function get_debug_data(): array + { return $this->debug_data; } - + /** * 检查是否启用了指定功能 */ - public function is_feature_enabled( string $feature ): bool { - return (bool) $this->get_option( $feature, false ); + public function is_feature_enabled(string $feature): bool + { + return (bool) $this->get_option($feature, false); } - + /** * 获取启用的语言列表 */ - public function get_enabled_languages(): array { - return $this->get_option( 'wpcc_used_langs', [] ); + public function get_enabled_languages(): array + { + return $this->get_option('wpcc_used_langs', []); } - + /** * 检查语言是否启用 */ - public function is_language_enabled( string $lang_code ): bool { - return in_array( $lang_code, $this->get_enabled_languages(), true ); + public function is_language_enabled(string $lang_code): bool + { + return in_array($lang_code, $this->get_enabled_languages(), true); } - + /** * 获取转换引擎 */ - public function get_conversion_engine(): string { - return $this->get_option( 'wpcc_engine', 'opencc' ); + public function get_conversion_engine(): string + { + return $this->get_option('wpcc_engine', 'opencc'); } - + /** * 验证配置完整性 */ - public function validate_config(): array { + public function validate_config(): array + { $errors = []; - - if ( empty( $this->get_enabled_languages() ) ) { + + if (empty($this->get_enabled_languages())) { $errors[] = 'No languages enabled'; } - + $engine = $this->get_conversion_engine(); - if ( ! in_array( $engine, ['opencc', 'mediawiki'] ) ) { + if (! in_array($engine, ['opencc', 'mediawiki'])) { $errors[] = 'Invalid conversion engine: ' . $engine; } - + return $errors; } -} \ No newline at end of file +} diff --git a/includes/core/class-conversion-cache.php b/includes/core/class-wpcc-conversion-cache.php similarity index 100% rename from includes/core/class-conversion-cache.php rename to includes/core/class-wpcc-conversion-cache.php diff --git a/includes/core/class-converter-factory.php b/includes/core/class-wpcc-converter-factory.php similarity index 79% rename from includes/core/class-converter-factory.php rename to includes/core/class-wpcc-converter-factory.php index 9f73b43..7e15e60 100644 --- a/includes/core/class-converter-factory.php +++ b/includes/core/class-wpcc-converter-factory.php @@ -25,16 +25,16 @@ class WPCC_Converter_Factory { } private static function create_converter( $engine ) { - switch ( $engine ) { - case 'opencc': - require_once dirname( __FILE__ ) . '/class-opencc-converter.php'; - return new WPCC_OpenCC_Converter(); - - case 'mediawiki': - default: - require_once dirname( __FILE__ ) . '/class-mediawiki-converter.php'; - return new WPCC_MediaWiki_Converter(); - } + switch ( $engine ) { + case 'opencc': + require_once dirname( __FILE__ ) . '/class-wpcc-opencc-converter.php'; + return new WPCC_OpenCC_Converter(); + + case 'mediawiki': + default: + require_once dirname( __FILE__ ) . '/class-wpcc-mediawiki-converter.php'; + return new WPCC_MediaWiki_Converter(); + } } public static function get_available_engines() { diff --git a/includes/core/class-wpcc-exception-handler.php b/includes/core/class-wpcc-exception-handler.php index cfb681a..07b7b10 100644 --- a/includes/core/class-wpcc-exception-handler.php +++ b/includes/core/class-wpcc-exception-handler.php @@ -194,8 +194,14 @@ final class WPCC_Exception_Handler { return; } - $error_key = get_class( $exception ); - self::$error_counts[ $error_key ] = ( self::$error_counts[ $error_key ] ?? 0 ) + 1; + // 统一异常计数键，保证与 should_suppress_error 使用的键一致 + if ( $exception instanceof WPCC_Exception ) { + $ekey = 'wpcc_error_' . $exception->get_error_code(); + self::$error_counts[ $ekey ] = ( self::$error_counts[ $ekey ] ?? 0 ) + 1; + } else { + $ekey = get_class( $exception ); + self::$error_counts[ $ekey ] = ( self::$error_counts[ $ekey ] ?? 0 ) + 1; + } $log_message = sprintf( 'WPCC Error in %s: %s [%s:%d] Context: %s', diff --git a/includes/core/class-wpcc-extension.php b/includes/core/class-wpcc-extension.php index 52497ec..b471551 100644 --- a/includes/core/class-wpcc-extension.php +++ b/includes/core/class-wpcc-extension.php @@ -18,7 +18,7 @@ abstract class WPCC_Extension extends WPCC_Abstract_Module { protected $update_server_url; protected $extension_slug; protected $is_premium = true; - protected $required_core_version = '1.3.0'; +protected $required_core_version = '1.5'; protected $pricing_tier = 'pro'; // free, pro, enterprise, ultimate public function __construct() { diff --git a/includes/core/class-wpcc-language-config.php b/includes/core/class-wpcc-language-config.php new file mode 100644 index 0000000..979b3a6 --- /dev/null +++ b/includes/core/class-wpcc-language-config.php @@ -0,0 +1,165 @@ + [转换函数名, 选项键名, 默认显示名, BCP47代码]] + */ + private static array $languages = []; + + /** + * 默认语言显示名称 + */ + private static array $default_names = [ + 'zh-cn' => '简体中文', + 'zh-tw' => '台灣正體', + 'zh-hk' => '港澳繁體', + 'zh-hans' => '简体中文', + 'zh-hant' => '繁体中文', + 'zh-sg' => '马新简体', + 'zh-jp' => '日式汉字', + ]; + + /** + * 初始化语言配置 + */ + public static function init(): void { + if ( ! empty( self::$languages ) ) { + return; + } + + self::$languages = [ + 'zh-cn' => [ 'zhconversion_cn', 'cntip', self::get_translated_name( 'zh-cn' ), 'zh-CN' ], + 'zh-tw' => [ 'zhconversion_tw', 'twtip', self::get_translated_name( 'zh-tw' ), 'zh-TW' ], + 'zh-hk' => [ 'zhconversion_hk', 'hktip', self::get_translated_name( 'zh-hk' ), 'zh-HK' ], + 'zh-hans' => [ 'zhconversion_hans', 'hanstip', self::get_translated_name( 'zh-hans' ), 'zh-Hans' ], + 'zh-hant' => [ 'zhconversion_hant', 'hanttip', self::get_translated_name( 'zh-hant' ), 'zh-Hant' ], + 'zh-sg' => [ 'zhconversion_sg', 'sgtip', self::get_translated_name( 'zh-sg' ), 'zh-SG' ], + 'zh-jp' => [ 'zhconversion_jp', 'jptip', self::get_translated_name( 'zh-jp' ), 'zh-JP' ], + ]; + } + + /** + * 获取翻译后的语言名称 + */ + private static function get_translated_name( string $lang_code ): string { + // 只在WordPress完全初始化后才使用翻译函数 + if ( function_exists( 'did_action' ) && did_action( 'init' ) && function_exists( '__' ) ) { + return __( self::$default_names[ $lang_code ] ?? $lang_code, 'wp-chinese-converter' ); + } + return self::$default_names[ $lang_code ] ?? $lang_code; + } + + /** + * 获取所有语言配置 + */ + public static function get_all_languages(): array { + self::init(); + return self::$languages; + } + + /** + * 获取特定语言配置 + */ + public static function get_language( string $lang_code ): ?array { + self::init(); + return self::$languages[ $lang_code ] ?? null; + } + + /** + * 获取语言显示名称 + */ + public static function get_language_name( string $lang_code, ?array $custom_names = null ): string { + self::init(); + + // 优先使用自定义名称 + if ( $custom_names && isset( $custom_names[ $lang_code ] ) ) { + return $custom_names[ $lang_code ]; + } + + // 使用配置中的名称 + if ( isset( self::$languages[ $lang_code ][2] ) ) { + return self::$languages[ $lang_code ][2]; + } + + // 降级到默认名称 + return self::$default_names[ $lang_code ] ?? $lang_code; + } + + /** + * 获取语言的BCP47代码 + */ + public static function get_bcp47_code( string $lang_code ): string { + self::init(); + return self::$languages[ $lang_code ][3] ?? $lang_code; + } + + /** + * 获取语言的转换函数名 + */ + public static function get_conversion_function( string $lang_code ): ?string { + self::init(); + return self::$languages[ $lang_code ][0] ?? null; + } + + /** + * 获取语言的选项键名 + */ + public static function get_option_key( string $lang_code ): ?string { + self::init(); + return self::$languages[ $lang_code ][1] ?? null; + } + + /** + * 检查语言代码是否有效 + */ + public static function is_valid_language( string $lang_code ): bool { + self::init(); + return isset( self::$languages[ $lang_code ] ); + } + + /** + * 获取所有有效的语言代码 + */ + public static function get_valid_language_codes(): array { + self::init(); + return array_keys( self::$languages ); + } + + /** + * 获取自定义语言名称配置 + * + * @param array $options 插件选项数组 + * @return array 自定义名称数组 + */ + public static function get_custom_names( array $options ): array { + self::init(); + + $custom_names = []; + foreach ( self::$languages as $code => $config ) { + $option_key = $config[1]; + $default_name = self::$default_names[ $code ]; + $custom_names[ $code ] = $options[ $option_key ] ?? $default_name; + } + + return $custom_names; + } + + /** + * 获取默认语言名称 + */ + public static function get_default_names(): array { + return self::$default_names; + } +} diff --git a/includes/core/class-wpcc-main.php b/includes/core/class-wpcc-main.php index 89ec156..2dfa84d 100644 --- a/includes/core/class-wpcc-main.php +++ b/includes/core/class-wpcc-main.php @@ -40,9 +40,14 @@ class WPCC_Main { add_action( 'init', [ $this, 'init' ], 1 ); add_action( 'wp_enqueue_scripts', [ $this, 'enqueue_scripts' ] ); add_filter( 'query_vars', [ $this, 'add_query_vars' ] ); + // 在 WordPress 基于重写规则生成 query_vars 之后，优先级0先行修正 pagename=zh-xx 的场景 + add_filter( 'request', [ $this, 'filter_request_vars' ], 0 ); add_action( 'parse_request', [ $this, 'parse_request' ] ); add_action( 'template_redirect', [ $this, 'template_redirect' ], -100 ); + // 进一步兜底：在主查询生成前修正“纯语言前缀”为首页查询 + add_action( 'pre_get_posts', [ $this, 'pre_get_posts_fix' ], 0 ); + // 调试模式钩子 if ( WP_DEBUG || ( defined( 'wpcc_DEBUG' ) && wpcc_DEBUG ) ) { add_action( 'init', [ $this, 'flush_rewrite_rules' ] ); @@ -60,6 +65,12 @@ class WPCC_Main { $this->handle_config_errors( $config_errors ); return; } + + // 标记 AJAX/REST/wc-ajax 请求为"直接输出"，跳过页面级转换 + $is_ajax = function_exists('wp_doing_ajax') ? wp_doing_ajax() : ( defined('DOING_AJAX') && DOING_AJAX ); + $is_rest = defined('REST_REQUEST') && REST_REQUEST; + $is_wc_ajax = isset($_REQUEST['wc-ajax']) && is_string($_REQUEST['wc-ajax']) && $_REQUEST['wc-ajax'] !== ''; + $this->config->set_direct_conversion_flag( (bool) ( $is_ajax || $is_rest || $is_wc_ajax ) ); // 初始化模块 $this->init_modules(); @@ -67,6 +78,8 @@ class WPCC_Main { // 设置重写规则 if ( $this->config->is_feature_enabled( 'wpcc_use_permalink' ) ) { $this->setup_rewrite_rules(); + // 自愈：在启用固定链接模式但尚未生成 WPCC 语言规则时，尝试一次性刷新重写规则，避免 /zh-xx/ 访问 404 + $this->maybe_autoflush_rewrite_rules(); } // 处理评论提交 @@ -108,7 +121,7 @@ class WPCC_Main { // 注册核心模块 $this->module_manager->register_module( 'WPCC_Cache_Addon', $modules_dir . 'wpcc-cache-addon.php' ); - $this->module_manager->register_module( 'WPCC_Network', $modules_dir . 'wpcc-network.php' ); + // $this->module_manager->register_module( 'WPCC_Network', $modules_dir . 'wpcc-network.php' ); // 已被新的网络设置模块替代 $this->module_manager->register_module( 'WPCC_Rest_Api', $modules_dir . 'wpcc-rest-api.php' ); $this->module_manager->register_module( 'WPCC_Modern_Cache', $modules_dir . 'wpcc-modern-cache.php' ); $this->module_manager->register_module( 'WPCC_SEO_Enhancement', $modules_dir . 'wpcc-seo-enhancement.php' ); @@ -161,6 +174,19 @@ class WPCC_Main { if ( is_robots() ) { return; } + + // 兜底：若 rewrite 未捕获到 variant，但路径以语言前缀开头，则从路径中注入 variant + $path = isset( $wp->request ) ? trim( (string) $wp->request, "\r\n\t " ) : ''; + if ( empty( $wp->query_vars['variant'] ) && is_string( $path ) && $path !== '' ) { + $enabled = $this->config->get_enabled_languages(); + if ( ! empty( $enabled ) && is_array( $enabled ) ) { + $reg = implode( '|', array_map( 'preg_quote', $enabled ) ); + if ( preg_match( '/^(' . $reg . '|zh|zh-reset)(?:\/)?$/i', $path, $m ) ) { + // 仅当是“纯前缀”（如 zh-tw/ 或 zh/）时兜底注入； + $wp->query_vars['variant'] = strtolower( $m[1] ); + } + } + } if ( is_404() ) { $this->config->set_noconversion_url( home_url( '/' ) ); @@ -171,11 +197,30 @@ class WPCC_Main { // 设置无转换URL $noconversion_url = $this->get_noconversion_url(); $this->config->set_noconversion_url( $noconversion_url ); + // 向后兼容：同步全局变量 + $GLOBALS['wpcc_noconversion_url'] = $noconversion_url; // 获取目标语言 $target_lang = $this->determine_target_language( $wp ); $this->config->set_target_lang( $target_lang ); + // 向后兼容：同步全局变量 + $GLOBALS['wpcc_target_lang'] = $target_lang; + // 若首页为静态页面且请求为根级变体路径，则直接映射到首页，避免 404 + if ( get_option( 'show_on_front' ) === 'page' && get_option( 'page_on_front' ) ) { + $req_path = isset( $wp->request ) ? trim( (string) $wp->request, '/' ) : ''; + if ( $req_path !== '' ) { + $enabled = $this->config->get_enabled_languages(); + if ( ! empty( $enabled ) ) { + $pattern = '/^(?:' . implode( '|', array_map( 'preg_quote', $enabled ) ) . '|zh|zh-reset)$/i'; + if ( preg_match( $pattern, $req_path ) ) { + $wp->query_vars['page_id'] = (int) get_option( 'page_on_front' ); + unset( $wp->query_vars['pagename'], $wp->query_vars['name'] ); + } + } + } + } + // 处理搜索转换 $this->handle_search_conversion(); @@ -187,20 +232,25 @@ class WPCC_Main { * 确定目标语言 */ private function determine_target_language( $wp ): string { - $request_lang = $wp->query_vars['variant'] ?? ''; - $cookie_lang = $_COOKIE[ 'wpcc_variant_' . COOKIEHASH ] ?? ''; + $request_lang = isset( $wp->query_vars['variant'] ) ? sanitize_text_field( $wp->query_vars['variant'] ) : ''; + $cookie_lang = isset( $_COOKIE[ 'wpcc_variant_' . COOKIEHASH ] ) ? sanitize_text_field( wp_unslash( $_COOKIE[ 'wpcc_variant_' . COOKIEHASH ] ) ) : ''; // 检查URL参数中的语言 if ( $request_lang && $this->config->is_language_enabled( $request_lang ) ) { return $request_lang; } - // 处理特殊的'zh'重定向 + // 处理特殊的'zh'重定向（用户明确选择“原始/不转换”） if ( $request_lang === 'zh' && ! is_admin() ) { $this->handle_zh_redirect(); return ''; } + // 如果Cookie中记录了'zh'哨兵，则优先恢复为“不转换” + if ( $cookie_lang === 'zh' ) { + return ''; + } + // 浏览器语言检测 if ( $this->config->is_feature_enabled( 'wpcc_browser_redirect' ) ) { $browser_lang = $this->detect_browser_language(); @@ -226,9 +276,23 @@ class WPCC_Main { $cookie_key = 'wpcc_variant_' . COOKIEHASH; if ( $this->config->is_feature_enabled( 'wpcc_use_cookie_variant' ) ) { - setcookie( $cookie_key, 'zh', time() + 30000000, COOKIEPATH, COOKIE_DOMAIN ); + setcookie( $cookie_key, 'zh', [ + 'expires' => time() + 30000000, + 'path' => COOKIEPATH, + 'domain' => COOKIE_DOMAIN, + 'secure' => is_ssl(), + 'httponly' => true, + 'samesite' => 'Lax', + ] ); } else { - setcookie( 'wpcc_is_redirect_' . COOKIEHASH, '1', 0, COOKIEPATH, COOKIE_DOMAIN ); + setcookie( 'wpcc_is_redirect_' . COOKIEHASH, '1', [ + 'expires' => 0, + 'path' => COOKIEPATH, + 'domain' => COOKIE_DOMAIN, + 'secure' => is_ssl(), + 'httponly' => true, + 'samesite' => 'Lax', + ] ); } wp_redirect( $this->config->get_noconversion_url() ); @@ -239,7 +303,7 @@ class WPCC_Main { * 检测浏览器语言 */ private function detect_browser_language(): string { - $accept_language = $_SERVER['HTTP_ACCEPT_LANGUAGE'] ?? ''; + $accept_language = isset( $_SERVER['HTTP_ACCEPT_LANGUAGE'] ) ? sanitize_text_field( wp_unslash( $_SERVER['HTTP_ACCEPT_LANGUAGE'] ) ) : ''; if ( empty( $accept_language ) ) { return ''; } @@ -263,7 +327,14 @@ class WPCC_Main { $current_cookie = $_COOKIE[$cookie_key] ?? ''; if ( $current_cookie !== $target_lang ) { - setcookie( $cookie_key, $target_lang, time() + 30000000, COOKIEPATH, COOKIE_DOMAIN ); + setcookie( $cookie_key, $target_lang, [ + 'expires' => time() + 30000000, + 'path' => COOKIEPATH, + 'domain' => COOKIE_DOMAIN, + 'secure' => is_ssl(), + 'httponly' => true, + 'samesite' => 'Lax', + ] ); } } @@ -284,18 +355,65 @@ class WPCC_Main { * 模板重定向处理 */ public function template_redirect(): void { + // 排除 WooCommerce 关键页面（结算、购物车、我的账户等），避免转换影响功能 + if ( function_exists( 'is_checkout' ) && is_checkout() ) { + return; + } + if ( function_exists( 'is_cart' ) && is_cart() ) { + return; + } + if ( function_exists( 'is_account_page' ) && is_account_page() ) { + return; + } + $this->set_language_urls(); + // 处理“根级语言前缀”访问：/zh-xx/ 或 /zh/ + if ( ! is_admin() ) { + global $wp; + $req = isset( $wp->request ) ? trim( (string) $wp->request, "/" ) : ''; + if ( $req !== '' ) { + $enabled = $this->config->get_enabled_languages(); + $pattern = '/^(?:' . implode( '|', array_map( 'preg_quote', $enabled ) ) . '|zh|zh-reset)$/i'; + if ( preg_match( $pattern, $req ) ) { + // 禁用本次自动重定向（避免将根级变体再次重定向到其它 URL） + if ( method_exists( $this->config, 'set_redirect_to' ) ) { + $this->config->set_redirect_to( false ); + } + $v = strtolower( $req ); + + // 仅 zh/zh-reset 使用哨兵重定向到不转换首页；其它根级变体在当前 URL 下渲染（避免缓存都命中 /） + if ( $v === 'zh' || $v === 'zh-reset' ) { + $this->handle_zh_redirect(); + return; + } + + // 在根级变体 URL 下渲染首页：由下游 pre_get_posts/filter_request_vars 修正查询为首页 + // 注入头部脚本供前端使用 + add_action( 'wp_head', [ $this, 'output_header' ] ); + } + } + } + // 处理重定向 if ( ! is_404() && $this->config->get_redirect_to() && ! is_admin() ) { $redirect_url = $this->config->get_langs_urls()[ $this->config->get_redirect_to() ]; - setcookie( 'wpcc_is_redirect_' . COOKIEHASH, '1', 0, COOKIEPATH, COOKIE_DOMAIN ); + setcookie( 'wpcc_is_redirect_' . COOKIEHASH, '1', [ + 'expires' => 0, + 'path' => COOKIEPATH, + 'domain' => COOKIE_DOMAIN, + 'secure' => is_ssl(), + 'httponly' => true, + 'samesite' => 'Lax', + ] ); wp_redirect( $redirect_url, 302 ); exit; } $target_lang = $this->config->get_target_lang(); if ( ! $target_lang ) { + // 即使是“未选择语言（不转换）”也输出头部数据，供前端开关生成漂亮链接 + add_action( 'wp_head', [ $this, 'output_header' ] ); return; } @@ -312,23 +430,36 @@ class WPCC_Main { private function set_language_urls(): void { $langs_urls = []; $noconversion_url = $this->config->get_noconversion_url(); - $use_permalink = $this->config->is_feature_enabled( 'wpcc_use_permalink' ); + $style = (int) $this->config->get_option( 'wpcc_use_permalink', 0 ); + $style_effective = $this->is_permalinks_enabled() ? $style : 0; + // 语言映射 foreach ( $this->config->get_enabled_languages() as $lang ) { - if ( $noconversion_url === home_url( '/' ) && $use_permalink ) { + if ( $style_effective !== 0 && $noconversion_url === home_url( '/' ) ) { $langs_urls[$lang] = $noconversion_url . $lang . '/'; } else { $langs_urls[$lang] = $this->convert_link( $noconversion_url, $lang ); } } + // 增加 zh 哨兵映射，便于前端/菜单快速回到“不转换”状态 + // 在前缀/后缀模式下输出漂亮链接；在查询参数模式下回退为 ?variant=zh + $langs_urls['zh'] = $this->convert_link( $noconversion_url, 'zh' ); + $this->config->set_langs_urls( $langs_urls ); + // 向后兼容：同步全局变量 + $GLOBALS['wpcc_langs_urls'] = $langs_urls; } /** * 执行转换 */ private function do_conversion(): void { + // 若是 AJAX/REST/wc-ajax 等非 HTML 响应，直接跳过所有转换，避免破坏 JSON/片段 + if ( $this->config->get_direct_conversion_flag() ) { + return; + } + // 加载转换表 $this->load_conversion_table(); @@ -342,6 +473,14 @@ class WPCC_Main { // 添加链接转换过滤器 $this->add_link_conversion_filters(); + + // 导航与 Logo 链接也加入变体（兼容经典菜单与站点 Logo） + // 注意：不在 home_url 上挂钩，避免 convert_link 内部调用 home_url 时产生递归 + add_filter( 'get_custom_logo', [ $this, 'filter_custom_logo' ], 10, 1 ); + add_filter( 'wp_nav_menu', [ $this, 'filter_wp_nav_menu' ], 20, 2 ); + + // 取消错误的 canonical 跳转，避免语言前缀被 WP 错误重定向 + add_filter( 'redirect_canonical', [ $this, 'cancel_incorrect_redirect' ], 10, 2 ); } // 内容转换过滤器 @@ -410,16 +549,24 @@ class WPCC_Main { // 这里添加其他必要的私有方法... + /** + * 检查 WordPress 是否启用了固定链接 + */ + private function is_permalinks_enabled(): bool { + $structure = get_option( 'permalink_structure' ); + return is_string( $structure ) && $structure !== ''; + } + /** * 获取无转换URL */ private function get_noconversion_url(): string { $enabled_langs = $this->config->get_enabled_languages(); - $reg = implode( '|', $enabled_langs ); + $reg = implode( '|', array_map( 'preg_quote', $enabled_langs ) ); $protocol = is_ssl() ? 'https://' : 'http://'; - $host = $_SERVER['HTTP_HOST'] ?? ''; - $uri = $_SERVER['REQUEST_URI'] ?? ''; + $host = isset( $_SERVER['HTTP_HOST'] ) ? sanitize_text_field( wp_unslash( $_SERVER['HTTP_HOST'] ) ) : ''; + $uri = isset( $_SERVER['REQUEST_URI'] ) ? esc_url_raw( wp_unslash( $_SERVER['REQUEST_URI'] ) ) : ''; $tmp = trim( strtolower( remove_query_arg( 'variant', $protocol . $host . $uri ) ) ); @@ -437,7 +584,80 @@ class WPCC_Main { * 设置重写规则 */ private function setup_rewrite_rules(): void { + // 仅在 WP 启用了固定链接 且 插件启用了固定链接格式时设置重写规则 + if ( ! $this->is_permalinks_enabled() || ! $this->config->is_feature_enabled( 'wpcc_use_permalink' ) ) { + return; + } add_filter( 'rewrite_rules_array', [ $this, 'modify_rewrite_rules' ] ); + + // 显式在规则顶端加入"根级变体"规则，确保 /zh-xx/ 能优先匹配到首页 + $enabled = $this->config->get_enabled_languages(); + if ( ! empty( $enabled ) && function_exists( 'add_rewrite_rule' ) ) { + $reg = implode( '|', array_map( 'preg_quote', $enabled ) ); + add_rewrite_rule( '^(' . $reg . '|zh|zh-reset)/?$', 'index.php?variant=$matches[1]', 'top' ); + + // 强制在init钩子中添加根级规则，确保优先级 + add_action( 'init', function() use ( $reg ) { + add_rewrite_rule( '^(' . $reg . '|zh|zh-reset)/?$', 'index.php?variant=$matches[1]', 'top' ); + }, 5 ); // 优先级5，早于大部分其他规则 + } + } + + /** + * 如有必要，自动刷新一次重写规则，避免未刷新导致的 404 + */ + private function maybe_autoflush_rewrite_rules(): void { + // 仅在启用了固定链接模式且 WP 启用了固定链接时尝试 + if ( ! $this->config->is_feature_enabled( 'wpcc_use_permalink' ) || ! $this->is_permalinks_enabled() ) { + return; + } + + // 延迟执行，确保所有规则都已加载 + add_action( 'wp_loaded', [ $this, 'check_and_flush_rules' ], 10 ); + } + + /** + * 检查并刷新规则 + */ + public function check_and_flush_rules(): void { + // 6 小时内最多尝试一次 + $last = (int) get_option( 'wpcc_rewrite_autoflush_ts', 0 ); + if ( $last && ( time() - $last ) < 6 * 3600 ) { + return; + } + + // 检查当前规则中是否已经包含根级的语言捕获规则 + $rules = get_option( 'rewrite_rules' ); + if ( ! is_array( $rules ) ) { + $rules = []; + } + + $enabled_langs = $this->config->get_enabled_languages(); + if ( empty( $enabled_langs ) ) { + return; + } + + $reg = implode( '|', $enabled_langs ); + $expected = '^(' . $reg . '|zh|zh-reset)/?$'; + $has_expected = false; + + foreach ( $rules as $regex => $query ) { + if ( $regex === $expected && strpos( $query, 'variant=' ) !== false ) { + $has_expected = true; + break; + } + } + + if ( ! $has_expected && function_exists( 'flush_rewrite_rules' ) ) { + // 刷新一次规则 + flush_rewrite_rules( false ); + update_option( 'wpcc_rewrite_autoflush_ts', time() ); + + // 记录日志 + if ( defined( 'WP_DEBUG_LOG' ) && WP_DEBUG_LOG ) { + error_log( 'WPCC: Auto-flushed rewrite rules for language variants' ); + } + } } /** @@ -450,6 +670,10 @@ class WPCC_Main { $use_permalink = $this->config->get_option( 'wpcc_use_permalink', 0 ); + // 首先添加根级语言规则，确保最高优先级 + $root_rule_key = '^(' . $reg . '|zh|zh-reset)/?$'; + $rules2[ $root_rule_key ] = 'index.php?variant=$matches[1]'; + if ( $use_permalink == 1 ) { foreach ( $rules as $key => $value ) { if ( strpos( $key, 'trackback' ) !== false || strpos( $key, 'print' ) !== false || strpos( $value, 'lang=' ) !== false ) { @@ -474,7 +698,6 @@ class WPCC_Main { } } - $rules2[ '^(' . $reg . '|zh|zh-reset)/?$' ] = 'index.php?variant=$matches[1]'; return array_merge( $rules2, $rules ); } @@ -489,15 +712,21 @@ class WPCC_Main { * 处理评论提交 */ private function handle_comment_submission(): void { - if ( ( isset( $_SERVER['PHP_SELF'] ) && ( strpos( $_SERVER['PHP_SELF'], 'wp-comments-post.php' ) !== false - || strpos( $_SERVER['PHP_SELF'], 'ajax-comments.php' ) !== false - || strpos( $_SERVER['PHP_SELF'], 'comments-ajax.php' ) !== false ) + $php_self = isset( $_SERVER['PHP_SELF'] ) ? sanitize_text_field( wp_unslash( $_SERVER['PHP_SELF'] ) ) : ''; + $request_method = isset( $_SERVER['REQUEST_METHOD'] ) ? sanitize_text_field( wp_unslash( $_SERVER['REQUEST_METHOD'] ) ) : ''; + + if ( ( $php_self && ( strpos( $php_self, 'wp-comments-post.php' ) !== false + || strpos( $php_self, 'ajax-comments.php' ) !== false + || strpos( $php_self, 'comments-ajax.php' ) !== false ) ) && - isset( $_SERVER["REQUEST_METHOD"] ) && $_SERVER["REQUEST_METHOD"] == "POST" && - isset( $_POST['variant'] ) && ! empty( $_POST['variant'] ) && $this->config->is_language_enabled( $_POST['variant'] ) + $request_method === 'POST' && + isset( $_POST['variant'] ) && ! empty( $_POST['variant'] ) ) { - $this->config->set_target_lang( sanitize_text_field( $_POST['variant'] ) ); - $this->do_conversion(); + $variant = sanitize_text_field( wp_unslash( $_POST['variant'] ) ); + if ( $this->config->is_language_enabled( $variant ) ) { + $this->config->set_target_lang( $variant ); + $this->do_conversion(); + } } } @@ -534,17 +763,8 @@ class WPCC_Main { public function render_no_conversion_block( string $block_content, array $block ): string { if ( isset( $block['blockName'] ) && $block['blockName'] === 'wpcc/no-conversion' ) { $unique_id = uniqid(); - - $pattern = '/' . + "WP Chinese Converter 插件正由网络管理员强制管理。所有设置将使用网络级别配置，任何更改将被忽略。如有疑问请联系网络管理员。" . + "
' . + sprintf( + "WP Chinese Converter 插件的 %d 项设置由网络管理员控制。这些设置的更改将不会生效。", + $controlled_count, + ) . + "
网络设置已更新。
设置导入成功。
网络设置已重置为默认值。
已成功重置 ' . + $reset_count . + " 个站点的设置。
+ +
| + + ">↗ + | +
+ 0,
+ "opencc" => 0,
+ "other" => 0,
+ ];
+ $language_stats = [];
+
+ foreach ($sites as $site) {
+ switch_to_blog($site->blog_id);
+ $options = get_option("wpcc_options", []);
+
+ if (!empty($options)) {
+ $active_sites++;
+
+ // 统计引擎使用情况
+ $engine =
+ $options["wpcc_engine"] ??
+ "mediawiki";
+ if (isset($engine_stats[$engine])) {
+ $engine_stats[$engine]++;
+ } else {
+ $engine_stats["other"]++;
+ }
+
+ // 统计语言使用情况
+ $used_langs =
+ $options["wpcc_used_langs"] ?? [];
+ foreach ($used_langs as $lang) {
+ if (
+ !isset($language_stats[$lang])
+ ) {
+ $language_stats[$lang] = 0;
+ }
+ $language_stats[$lang]++;
+ }
+ }
+
+ restore_current_blog();
+ }
+ ?>
+
+
+
+
+ 0): ?>
+
+
+
+ 总站点数
+
+
+
+ 已激活站点
+
+
+
+ 未激活站点
+
+
+
+ 转换引擎分布+
+ $count
+ ): ?>
+ 0): ?>
+
+ :
+
+
+
+
+
+
+ 语言模块使用情况+
+ "简体中文",
+ "zh-tw" => "台湾正体",
+ "zh-hk" => "港澳繁体",
+ "zh-hans" => "简体中文(国际)",
+ "zh-hant" => "繁体中文(国际)",
+ "zh-sg" => "马新简体",
+ "zh-jp" => "日式汉字",
+ ];
+ foreach (
+ $language_stats
+ as $lang => $count
+ ):
+ $lang_name = isset(
+ $lang_names[$lang],
+ )
+ ? $lang_names[$lang]
+ : $lang; ?>
+
+ :
+
+
+
+
+ |
+
|---|
| + + ">↗ + | +
+
+
+
+ + + |
+
|---|
| + + ">↗ + | +
+ [
+ "name" => "WP Super Cache",
+ "check" =>
+ function_exists(
+ "wp_cache_is_enabled",
+ ) ||
+ function_exists(
+ "wp_super_cache_init",
+ ),
+ ],
+ "wp_rocket" => [
+ "name" => "WP Rocket",
+ "check" => function_exists(
+ "rocket_clean_domain",
+ ),
+ ],
+ "litespeed_cache" => [
+ "name" => "LiteSpeed Cache",
+ "check" => class_exists(
+ "LiteSpeed\Core",
+ ),
+ ],
+ "w3_total_cache" => [
+ "name" => "W3 Total Cache",
+ "check" => function_exists(
+ "w3tc_flush_all",
+ ),
+ ],
+ "wp_fastest_cache" => [
+ "name" => "WP Fastest Cache",
+ "check" => class_exists(
+ "WpFastestCache",
+ ),
+ ],
+ "autoptimize" => [
+ "name" => "Autoptimize",
+ "check" =>
+ class_exists("autoptimizeMain") ||
+ function_exists(
+ "autoptimize_autoload",
+ ),
+ ],
+ "jetpack_boost" => [
+ "name" => "Jetpack Boost",
+ "check" =>
+ defined("JETPACK_BOOST_VERSION") ||
+ class_exists(
+ "Automattic\Jetpack_Boost\Jetpack_Boost",
+ ),
+ ],
+ ];
+
+ $active_cache_plugins = [];
+ foreach ($cache_plugins as $key => $plugin) {
+ if ($plugin["check"]) {
+ $active_cache_plugins[$key] =
+ $plugin["name"];
+ }
+ }
+
+ if (!empty($active_cache_plugins)) {
+ echo ' ';
+ echo ' ";
+
+ // 检查缓存兼容设置
+ $cache_controlled = in_array(
+ "wpcc_enable_cache_addon",
+ get_site_option(
+ "wpcc_network_controlled_options",
+ [],
+ ),
+ );
+ if ($cache_controlled) {
+ $cache_enabled = get_site_option(
+ "wpcc_default_enable_cache_addon",
+ 1,
+ );
+ if ($cache_enabled) {
+ echo '检测到的缓存插件: ';
+ echo '';
+ foreach (
+ $active_cache_plugins
+ as $plugin_name
+ ) {
+ echo '' .
+ esc_html($plugin_name) .
+ "";
+ }
+ echo " ";
+ echo "';
+ echo '网络级缓存兼容已启用 ";
+ } else {
+ echo ''; + echo '所有子站点将自动使用缓存兼容功能'; + echo " ';
+ echo '网络级缓存兼容已禁用 ";
+ }
+ } else {
+ echo ''; + echo '子站点的缓存兼容功能将不可用'; + echo " ';
+ echo '缓存兼容选项未被网络控制 ";
+ }
+ } else {
+ echo ''; + echo '各子站点可自行配置缓存兼容功能'; + echo " ';
+ echo "未检测到活跃的缓存插件";
+ echo " ";
+ }
+ ?>
+ |
+
|---|
| + + ">↗ + | +
+
+
+
+
+ 危险操作警告
+
+ 此操作将重置网络中所有站点的 WP Chinese Converter 设置为默认值。
+ + 此操作不可逆，请谨慎使用！ + |
+
|---|
没有找到站点。
"; + return; + } + + echo '| 站点 | 转换引擎 | 启用语言 | 状态 |
|---|---|---|---|
| ' . + esc_html(get_bloginfo("name")) . + " | "; + echo "" . esc_html($engine) . " | "; + echo "" . esc_html(implode(", ", $languages)) . " | "; + echo "" . ($active ? "✅ 激活" : "❌ 未激活") . " | "; + echo "
WP Chinese Converter: 检测到语言重写规则可能未正确配置，这可能导致语言主页404错误。 '; + echo '刷新重写规则
'; + echo '' . + esc_html($label) . + " 由网络管理员控制
"; + } else { + $notice .= + '以下 ' . + count($controlled_options) . + " 项设置由网络管理员控制：
"; + foreach ($controlled_options as $option) { + $label = $option_labels[$option] ?? $option; + $notice .= + '' . + esc_html($label) . + "
"; + } + } + + $notice .= + '以上选项由网络管理员控制，您的更改将不会生效。
'; + $notice .= "