自定义主题开发：ACF分类字段在archive.php调用失败问题

问题场景 #

开发自定义WordPress主题时，需要在分类归档页（archive.php）的侧边栏展示当前分类关联的其他分类（比如打开News分类页，侧边栏显示Sports、Politics等）。已经通过ACF给分类添加了可多选的分类法字段，但直接调用get_field('field_name')时返回null，无法获取设置的分类数据。

解决方案 #

问题出在ACF调用时的参数格式错误，需要给术语ID添加category_前缀作为第二个参数传入get_field()函数，以此指定当前分类的上下文。

代码示例 #

<?php
// 获取当前归档页的分类对象
$current_term = get_queried_object();
// 构造ACF需要的参数格式：分类前缀 + 术语ID
$acf_term_param = 'category_' . $current_term->term_id;
// 获取ACF自定义字段值
$related_categories = get_field('your_field_name', $acf_term_param);

// 遍历输出分类列表（示例）
if ($related_categories) {
    echo '<ul class="sidebar-related-cats">';
    foreach ($related_categories as $cat) {
        echo '<li><a href="' . get_category_link($cat->term_id) . '">' . $cat->name . '</a></li>';
    }
    echo '</ul>';
}
?>

补充说明 #

• get_queried_object()用于稳定获取当前归档页的分类术语对象，替代原代码中的$taxonomy，提升兼容性
• 如果使用的是自定义分类法，需将category_前缀替换为对应分类法的别名（例如自定义分类法为product_cat，则前缀为product_cat_）
• 将your_field_name替换为你在ACF中创建的字段名称

内容的提问来源于stack exchange，提问作者wplover