本文讲解如何在 wordpress 中为“上一个/下一个分类”链接动态获取并显示各自独立的 acf（advanced custom fields）自定义字段（如品牌色），避免错误复用当前页面分类的字段值。
本文讲解如何在 wordpress 中为“上一个/下一个分类”链接动态获取并显示各自独立的 acf（advanced custom fields）自定义字段（如品牌色），避免错误复用当前页面分类的字段值。
在使用 ACF 为分类法（如 category 或 tag）添加自定义字段（例如 brand_colour 颜色选择器）时，一个常见误区是：在生成「上一个/下一个分类」导航链接时，直接调用 the_field() 或 get_field() 但传入了错误的 $post_id / $term_id 参数（如误用当前循环变量 $tax 而非目标分类对象），导致所有链接都渲染出当前分类的字段值。
核心问题在于：原代码中 <a style="border:1px solid <?php the_field('brand_colour', $tax); ?>"> 的 $tax 始终指向当前循环中匹配到的当前分类，而非 $taxonomies[$prev_tax] 或 $taxonomies[$next_tax] 所代表的目标分类。因此，必须提前为每个分类预取其 ACF 字段，并按 term_id 缓存，再在输出时精准引用。
以下是优化后的完整函数实现，已修复逻辑漏洞并增强健壮性：
function next_prev_cat() {
$this_taxonomy = get_queried_object();
if ( ! $this_taxonomy || ! is_object( $this_taxonomy ) || ! isset( $this_taxonomy->term_id ) ) {
return;
}
// 获取当前上下文的分类法列表（支持 category / tag）
$taxonomies = is_category() ? get_categories( array( 'hide_empty' => false ) )
: ( is_tag() ? get_tags( array( 'hide_empty' => false ) ) : array() );
if ( empty( $taxonomies ) ) {
return;
}
// 预加载所有分类的 brand_colour 字段，以 term_id 为键缓存
$colors = array();
foreach ( $taxonomies as $tax ) {
$colors[ $tax->term_id ] = get_field( 'brand_colour', 'term_' . $tax->term_id ) ?: '#cccccc';
}
// 查找当前分类在列表中的位置
$current_position = -1;
foreach ( $taxonomies as $position => $tax ) {
if ( $tax->term_id == $this_taxonomy->term_id ) {
$current_position = $position;
break;
}
}
if ( $current_position === -1 ) {
return;
}
// 计算上一个/下一个索引（环形循环：首尾相连）
$count = count( $taxonomies );
$prev_index = ( $current_position - 1 + $count ) % $count;
$next_index = ( $current_position + 1 ) % $count;
$prev_term = $taxonomies[ $prev_index ];
$next_term = $taxonomies[ $next_index ];
$prev_link = get_term_link( $prev_term );
$next_link = get_term_link( $next_term );
// 安全输出（避免空链接或无效颜色）
$prev_color = esc_attr( $colors[ $prev_term->term_id ] );
$next_color = esc_attr( $colors[ $next_term->term_id ] );
$prev_name = esc_html( $prev_term->name );
$next_name = esc_html( $next_term->name );
?>
<div class="area-links">
<a href="<?php echo esc_url( $prev_link ); ?>"
style="border: 1px solid <?php echo $prev_color; ?>;">
<?php echo $prev_name; ?>
</a>
<a href="<?php echo esc_url( $next_link ); ?>"
style="border: 1px solid <?php echo $next_color; ?>;">
<?php echo $next_name; ?>
</a>
</div>
<?php
}✅ 关键改进说明：
- 预加载字段：遍历 $taxonomies 一次性获取全部 brand_colour 值并存入 $colors 关联数组，避免在输出时重复查询；
- 精准 ID 绑定：ACF 字段调用严格使用 'term_' . $term_id 语法（推荐）或直接传入 $term_id（需确保 ACF 版本 ≥ 6.1+ 支持）；
- 环形索引计算：采用 (pos ± 1 + count) % count 实现无缝首尾循环，逻辑更简洁可靠；
- 安全防护：增加空值校验、esc_*() 转义、hide_empty => false 确保隐藏分类也被纳入排序；
- 可扩展性：若需支持更多分类法（如自定义 taxonomy），只需扩展条件判断即可。
⚠️ 注意事项：
- 确保 ACF 字段 brand_colour 的「Return Format」设为 Hex（默认），否则需适配返回值类型（如 RGB 数组需转换）；
- 若分类数量极大（>1000），建议结合 WP Object Cache 或 transient 缓存 $colors 数据；
- 模板中调用该函数时，请确保处于分类归档页（is_category() / is_tag()），否则可能无输出。
通过以上重构，每个导航链接将准确应用对应分类独有的品牌色，真正实现个性化视觉导航体验。
