创建WooCommerce属性后更新ACF字段的问题与解决

场景说明 #

我有一批依赖日历的课程产品，日历通过名为date的自定义文章类型生成，该类型包含两个ACF字段：

• date_start：存储课程的起始日期
• associated_product：关联对应的课程产品

需求逻辑：用户创建date类型文章时，自动为关联产品的pa_dates属性添加一个与文章标题一致的术语，同时把date_start的日期值同步到该术语的ACF字段term_date_start中（用于后续对产品的日期术语排序）。

当前问题：save_post钩子已成功实现术语添加，但无法将日期字段值写入术语的ACF字段；且钩子内用fwrite调试变量无效果。

修正后的完整代码 #

// 保存Date类型文章时自动添加属性术语并同步日期字段
function add_terms_to_date($post_ID)  {
    // 只处理date类型的自定义文章
    if ('date' !== get_post_type($post_ID)) {
        return;
    }

    // 获取关联产品ID和术语名称
    $product_id = get_field('associated_product', $post_ID);
    $term_name = get_the_title($post_ID); 
    $taxonomy = 'pa_dates';

    // 为产品添加属性术语（true表示追加而非覆盖）
    $term_set = wp_set_post_terms($product_id, $term_name, $taxonomy, true);

    // 同步date_start字段到术语的ACF字段
    $selector = "term_date_start"; // 术语上的ACF字段名
    $date_start = get_field('date_start', $post_ID); // 来源日期字段值

    // 错误写法：直接传入$term_set（术语ID）无法被ACF识别
    // update_field($selector, $date_start, $term_set); 
    // 正确写法：ACF更新术语字段需要用「分类法名_术语ID」的格式
    update_field($selector, $date_start, $taxonomy . "_" . $term_set);
}
add_action('save_post', 'add_terms_to_date');

关键错误说明 #

ACF的update_field()函数更新术语字段时，第三个参数的格式必须是**[分类法标识]_[术语ID]**，而不能直接传入术语ID。这是因为ACF需要明确区分字段是属于文章、用户还是术语，通过前缀来识别数据存储的上下文。

钩子内调试技巧 #

如果fwrite无法输出调试内容，推荐使用WordPress自带的error_log()函数，将变量内容写入调试日志：

1. 先在wp-config.php中开启调试：

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

2. 在钩子函数中添加调试代码：

// 输出$term_set的内容到wp-content/debug.log
error_log(print_r($term_set, true));
// 输出$date_start的内容
error_log('Date Start Value: ' . $date_start);

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