ACF Options For Polylang 使用教程

1. 项目介绍

ACF Options For Polylang 是一款WordPress插件，旨在解决使用Advanced Custom Fields（ACF）创建选项页面时，与多语言插件Polylang的兼容性问题。在默认情况下，Polylang无法处理ACF的选项页面，这会导致所有语言的选项值相同。本插件能够为每种语言存储不同的选项值，如果没有为特定语言设置值，则会使用“所有语言”的默认值。

2. 项目快速启动

安装

• WordPress安装方式：

  1. 使用WordPress内置的插件安装器下载并安装ACF Options For Polylang插件。
  2. 在后台插件列表中激活该插件。

• Composer安装方式：

  1. 运行命令 composer require wpackagist-plugin/acf-options-for-polylang 安装插件。
  2. 插件安装完毕后，无需进一步操作，直接使用。

配置

• 确保已经激活并配置了Polylang插件。
• 确保已经激活了ACF插件并创建了至少一个选项页面。

使用

• 在ACF选项页面中设置字段值时，可以使用Polylang的语言管理员界面标志来指定不同语言的值。
• 使用ACF的 get_field() 或 the_field() 函数来获取或显示字段，无需对字段名进行任何修改。

get_field('footer_disclaimer', 'options');

排除选项页面

如果你不希望在某些选项页面上使用此功能，可以通过以下代码添加 post_id 到排除列表中：

add_filter('bea.aofp.excluded_post_ids', function($ids) {
    $ids[] = 'custom_options_page_post_id';
    return $ids;
}, 10, 1);

默认值设置

如果不想使用默认值（即“所有语言”的值），可以通过以下代码禁用此行为：

• 对于所有ACF选项页面：

add_filter('bea.aofp.get_default', '__return_false');

• 对于单个ACF选项页面：

add_filter('bea.aofp.get_default', function($show_default, $post_id) {
    if ('my_custom_acf_option_post_id' === $post_id) {
        // 自定义条件
        return false;
    }
    return $show_default;
}, 10, 2);

3. 应用案例和最佳实践

• 在创建多语言网站时，为不同的语言设置不同的选项值，以保持一致的用户体验。
• 使用条件逻辑来显示或隐藏特定语言的选项字段，以更好地控制内容展示。

4. 典型生态项目

• Advanced Custom Fields: 提供强大的自定义字段功能，用于扩展WordPress的内容类型。
• Polylang: 一个用于WordPress的多语言插件，支持完整的本地化和翻译功能。

通过整合ACF Options For Polylang，可以在多语言环境中更灵活地管理选项页面，从而提升网站的多语言支持能力。