WooCommerce分类存档页基于ACF字段为产品加类失败问题排查

1. 主题未调用原生post_class()函数 #

如果你的产品列表模板（比如archive-product.php或主题自定义的产品循环模板）没有使用WordPress原生的post_class()函数输出产品容器的class，post_class钩子根本不会触发。

修复：检查主题模板中产品元素的代码，确保使用post_class()，示例如下：

<div id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
    <!-- 产品内容 -->
</div>

2. is_product_category()的上下文限制 #

在post_class钩子触发时，若当前循环不是产品分类页的主循环（比如侧边栏产品小部件、相关产品模块），is_product_category()判断会不成立。如果需要所有产品循环都生效，可直接去掉该条件；若仅需分类页生效，确认当前循环为分类页主循环即可。

调整后的代码：

add_filter('post_class', function($classes, $class, $product_id) {
    // 按需保留或删除is_product_category()判断
    // if(is_product_category()) {
        if(get_field('product_new', $product_id)) {
            $classes[] = 'product_new_class'; // 直接追加比array_merge更简洁
        }
    // }
    return $classes;
}, 10, 3);

3. ACF字段配置或取值异常 #

• 检查ACF字段slug是否完全匹配：确保后台创建的字段slug确实是product_new（ACF字段slug为小写加下划线，区分大小写）。
• 确认目标产品的字段已设为True：进入产品编辑页，检查product_new选项是否勾选并更新产品。
• 用原生函数验证取值：替换get_field为get_post_meta()，排除ACF自身问题：

if(get_post_meta($product_id, 'product_new', true)) {
    $classes[] = 'product_new_class';
}

4. 缓存导致旧值生效 #

WordPress缓存、ACF缓存或服务器缓存可能让get_field返回旧的字段值。

解决：

• 清空缓存插件的缓存（如果使用了）。
• 在ACF设置（自定义字段 > 设置）中临时关闭“字段组缓存”，测试后再按需开启。
• 重启服务器端缓存（若有配置）。

5. 钩子优先级冲突 #

如果其他插件或主题的代码也使用了post_class钩子，且优先级数值比你的代码小（优先级更高），可能会覆盖你的修改。

修复：提高钩子优先级，比如把10改成99：

add_filter('post_class', function($classes, $class, $product_id) {
    // ... 你的代码逻辑
}, 99, 3);

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