WordPress下基于ACF Post Object标题自动生成标签的实现问题

核心问题排查（代码不生效的常见原因） #

• 字段名未替换：原代码中读取关系字段用的是get_field('employees')，你实际的字段名为teamleden，未修改的话无法读取到关联的员工数据
• 自定义文章类型标识错误：原代码判断的是projects类型，需要替换为你自己的项目自定义文章类型的slug
• 分类法配置错误：原代码使用的分类法是team_members，需要确认你已经提前创建了对应存储员工标签的自定义分类法，且该分类法已经绑定到项目的自定义文章类型上，slug要对应修改
• 语法错误：原代码获取分类法ID时错误调用了ID属性，WordPress分类项的唯一标识属性是term_id，属性调用错误会导致已有标签判断完全失效
• 字段返回格式不匹配：需要确认你的ACF teamleden Post Object字段的返回格式设置为Post Object，且开启了允许多选，和代码逻辑匹配
• 代码放置位置错误：不要将代码放在自定义文章类型的配置文件中，建议放置在子主题的functions.php文件或者独立的自定义功能插件中，避免主题更新覆盖，且需要确保ACF插件处于激活状态

修正后可用代码 #

<?php
// 绑定ACF保存文章钩子，优先级20确保在ACF字段保存完成后执行
add_action('acf/save_post', 'set_employee_tags_on_save_update', 20);

/**
 * 保存项目时自动同步关联员工为标签
 * @param $post_id int|string 文章ID
 */
function set_employee_tags_on_save_update($post_id) {
    $post = get_post($post_id);
    if(!is_object($post)) return;

    // 请把下面的projects替换为你自己的项目自定义文章类型slug
    if($post->post_type !== 'projects' || !in_array($post->post_status, ['publish', 'draft'])) {
        return;
    }

    // 获取关联的员工数据，你的字段名为teamleden，这里已经替换
    $employees = get_field('teamleden', $post_id);
    $team_member_tags_to_set = [];
    if(empty($employees)) {
        // 没有关联员工时清空对应标签
        wp_set_object_terms($post_id, [], 'team_members', false);
        return;
    }

    // 获取所有已有的员工标签，请把team_members替换为你自己的员工标签分类法slug
    $team_member_tags = get_terms([
        'taxonomy' => 'team_members',
        'orderby' => 'name',
        'order' => 'ASC',
        'hide_empty' => false // 包含没有被使用的标签，避免重复创建
    ]);

    $existing_team_member_tags = [];
    if(!is_wp_error($team_member_tags) && !empty($team_member_tags)) {
        foreach($team_member_tags as $team_member_tag) {
            // 修复原代码的属性错误，用term_id而非ID
            $existing_team_member_tags[$team_member_tag->term_id] = $team_member_tag->name;
        }
    }

    foreach($employees as $employee) {
        $emp_name = get_the_title($employee->ID);
        $existing_tag_id = array_search($emp_name, $existing_team_member_tags);
        if($existing_tag_id) {
            $team_member_tags_to_set[] = (int)$existing_tag_id;
        } else {
            $team_member_tags_to_set[] = (string)$emp_name;
        }
    }

    // 移除钩子避免循环触发
    remove_action('acf/save_post', 'acf_save_post');
    // 同步标签，false参数表示覆盖原有标签而非追加
    wp_set_object_terms($post_id, $team_member_tags_to_set, 'team_members', false);
    // 恢复钩子
    add_action('acf/save_post', 'acf_save_post');
    return;
}

使用注意事项 #

• 替换代码中注释标注的3处自定义标识：项目自定义文章类型slug、员工标签分类法slug
• 代码部署完成后，重新保存任意一个关联了员工的项目，即可触发自动打标签操作

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