在WordPress项目开发中，我们经常会遇到需要筛选启用了特定ACF字段的分类术语，并且将这些术语的ID整理成逗号分隔字符串的需求，比如用于自定义查询的文章分类过滤、前端筛选组件的参数传递等场景。下面的方案可以直接复用实现这个功能。
实现核心思路
实现这个需求主要分为三个步骤：首先通过get_terms函数获取所有分类术语，然后通过ACF提供的get_field函数判断每个术语是否启用了目标ACF字段，最后将符合条件的术语ID收集起来拼接成逗号分隔的字符串。其中需要注意get_terms的查询参数设置，避免获取不需要的术语数据。
完整实现代码
下面是实现批量获取并拼接ID的完整代码，你可以根据实际的ACF字段名和分类法名称调整参数：
<?php
/**
* 批量获取启用特定ACF字段的分类术语ID并以逗号分隔字符串返回
* @param string $taxonomy 分类法名称，默认是category
* @param string $acf_field_name 目标ACF字段名称
* @return string 逗号分隔的术语ID字符串，没有符合条件的返回空字符串
*/
function get_enabled_acf_term_ids($taxonomy = 'category', $acf_field_name = 'enable_custom_field') {
// 第一步：获取所有指定分类法的术语，不隐藏空术语
$terms_args = array(
'taxonomy' => $taxonomy,
'hide_empty' => false,
'fields' => 'all'
);
$all_terms = get_terms($terms_args);
// 如果获取术语失败，直接返回空字符串
if (is_wp_error($all_terms) || empty($all_terms)) {
return '';
}
$enabled_term_ids = array();
// 第二步：遍历所有术语，判断ACF字段是否启用
foreach ($all_terms as $term) {
// 获取术语的ACF字段值，ACF存储术语字段的前缀是term_加术语ID
$field_value = get_field($acf_field_name, 'term_' . $term->term_id);
// 假设字段是开关类型，值为1表示启用，你可以根据实际字段类型调整判断条件
if ($field_value == 1) {
$enabled_term_ids[] = $term->term_id;
}
}
// 第三步：将ID数组拼接成逗号分隔的字符串
if (!empty($enabled_term_ids)) {
return implode(',', $enabled_term_ids);
}
return '';
}
// 调用示例：获取分类法category下启用了enable_custom_field字段的分类术语ID
$term_ids_str = get_enabled_acf_term_ids('category', 'enable_custom_field');
echo $term_ids_str;
?>
代码关键说明
get_terms函数的fields参数设置为all，确保能获取术语的完整信息，包括term_id。- ACF存储分类术语字段的格式是
term_{术语ID}，所以在调用get_field时第二个参数要拼接这个格式，否则无法正确获取字段值。 - 判断ACF字段是否启用的逻辑需要根据你实际使用的ACF字段类型调整，比如如果是布尔类型，判断条件可以改成
if ($field_value === true)。 - 如果分类法下有大量术语，建议给
get_terms添加number参数限制查询数量，避免性能问题。
常见问题处理
如果获取不到正确的ACF字段值，首先检查ACF字段是否确实添加到了对应的分类法上，其次检查get_field的第二个参数是否正确拼接了term_前缀。如果返回的是空字符串，可以打印$field_value查看实际的字段返回值，调整判断条件即可。