OneNav主题修改日志-3：首页布局-侧边导航栏菜单 添加 多语言功能

一、修改的文件列表

二、配置文件修改

2.1 添加多语言字段

/**
 * 获取自定义模块配置
 * @param string $loc 模块位置 home:首页，sub:子页面
 * @return array
 */
function io_get_custom_module_config($loc = 'home') {
    return array(
        'id'                     => 'page_module',
        'type'                   => 'repeater',
        'fields'                 => array(
            array(
                'id'      => 'type',
                'type'    => 'button_set',
                'title'   => '模块类型',
                'options' => 'io_custom_module_list',
                'default' => 'content',
            ),
            array(
                'id'      => 'language_filter',
                'type'    => 'select',
                'title'   => '此模块只显示于',
                'options' => 'io_get_language_options', // 自定义语言选项回调
                'default' => 'all', // 默认显示所有语言
                'class'   => 'compact min',
            ),
            io_get_search_config(),
            io_get_content_config(),
            io_get_tools_config($loc),
            io_get_custom_config(),
        ),
        'default'                => array(
            array(
                'type' => 'search',
                'search_config' => array(
                    'search_id' => '',
                    'aside_name' => '',
                )
            )
        ),
        'class'                  => 'fieldset-0 add-custom',
        'sanitize'               => false,
        'button_title'           => '添加模块',
        'accordion_title_number' => true,
    );
}

/**
 * 获取语言选项
 * @return array
 */
function io_get_language_options() {
    $languages = array(
        'all' => '所有',
    );
    if (function_exists('pll_languages_list')) {
        $lang_list = pll_languages_list();
        foreach ($lang_list as $lang) {
            $languages[$lang] = pll__(ucfirst($lang)); // 获取语言名称
        }
    }
    return $languages;
}

说明：

• 添加了 language_filter 字段，类型为 select，位置在模块类型选择之后。
• io_get_language_options 动态生成选项，包含“所有”以及 Polylang 启用的语言（需安装 Polylang 插件）。
• default 设置为 all，表示默认显示所有语言。

2.2 修改每个模块的配置字段

• 确保 search_config、content_config、tools_config 和 custom_config 继承 language_filter 的逻辑。
• 当前这些字段已在 repeater 内，language_filter 将自动应用于每个模块实例。

示例：检查 io_get_content_config

• 现有 io_get_content_config 无需额外修改，因为 language_filter 已作为 repeater 的公共字段。

三、输出函数修改

function io_home_content($config) {
    if (empty($config['page_module'])) {
        return;
    }

    // 初始化 $current_lang，确保始终有值
    $current_lang = 'all';
    if (function_exists('pll_current_language')) {
        $current_lang = pll_current_language() ?: 'all';
    }

    if ($config['aside_show']) {
        // 应用语言过滤
        $modules_to_show = array_filter($config['page_module'], function($module) use ($current_lang) {
            $lang_filter = $module['language_filter'] ?? 'all';
            return $lang_filter === 'all' || $lang_filter === $current_lang;
        });
        io_show_layout_aside($modules_to_show);
    }

    // 显示页面内容模块，应用语言过滤
    $modules_to_show = array_filter($config['page_module'], function($module) use ($current_lang) {
        $lang_filter = $module['language_filter'] ?? 'all';
        return $lang_filter === 'all' || $lang_filter === $current_lang;
    });
    io_show_page_module($modules_to_show);
}

四、功能特点

• 多语言分类：每个语言版本可以选择不同的分类组合
• 自动匹配：根据当前语言自动显示对应的分类筛选
• 分类多选：每个语言版本可以同时选择多个分类

五、使用方法

1. 进入 WordPress 后台 → 首页布局 → 显示边栏菜单
2. 在类型模块栏中 添加了 此模块只显示于（多语言选项）
3. 选择语言缩写（如：zh、en）
4. 选择该语言要显示的分类

六、文件修改清单