ACF选项页更新时如何批量编程更新所有自定义文章的ACF字段

• 触发时机完全错误：绑定的admin_head钩子是后台页面输出HTML头部时触发，此时ACF还未完成选项字段的写入流程，既拿不到可靠的表单提交值，也无法保证后续操作的执行顺序
• 触发判断永久失效：用array_key_exists('post',$_POST)判断提交动作，ACF选项页提交时根本不会携带post参数，这个分支永远不会被执行
• 缺失需求核心逻辑：没有对比全局字段的新旧值，不管内容有没有改动，只要提交选项页就会触发全量更新，完全不符合“仅当全局字段值变化时才同步”的要求
• ACF函数使用不规范：update_field调用时没有显式指定文章ID，仅依赖循环中的全局$post对象，存在字段写入位置错误的风险；直接读取$_POST取值也没有经过ACF的字段格式校验，容易拿到非预期的原始值
• 代码写法冗余：在函数内部嵌套定义函数、无操作防护，批量更新全量文章时没有资源保护，容易引发请求异常

整套逻辑全部基于ACF原生钩子开发，不需要依赖后台页面判断、全局$_POST取值这类不可靠的逻辑：

1. 改用ACF原生保存钩子acf/pre_save_post和acf/save_post，这两个钩子会在ACF完成字段校验、数据库写入的全流程前后触发，时机完全匹配需求
2. 增加新旧值对比逻辑：在字段正式更新前读取旧值，等更新完成后对比新旧值，仅当两者内容不一致时才执行批量同步
3. 增加触发范围判断：仅当操作的是ACF选项页（标识为options）时才执行同步逻辑，完全避免和普通文章的保存流程冲突
4. 批量同步时显式指定每篇自定义文章的ID，保证字段写入位置正确；通过fields => ids的查询参数减少数据库开销，提升执行效率

修正后完整可运行代码 #

// 1. 在选项页正式更新前，读取全局字段的旧值
add_action('acf/pre_save_post', function($post_id) {
    // 跳过非选项页的保存动作
    if ($post_id !== 'options') return;
    
    // 把旧值存在全局变量，供后续保存完成后对比
    global $global_flash_old_val;
    $global_flash_old_val = get_field('global_servicing_offer_text', 'options');
});

// 2. 选项页保存完成后，执行值对比和批量同步
add_action('acf/save_post', function($post_id) {
    // 跳过非选项页的保存动作
    if ($post_id !== 'options') return;

    global $global_flash_old_val;
    // 读取更新后的全局字段新值
    $new_val = get_field('global_servicing_offer_text', 'options');

    // 值未发生变化，直接退出不执行同步
    if ($new_val === $global_flash_old_val) {
        return;
    }

    // 拉取所有需要同步的自定义文章ID
    $target_posts = get_posts([
        'post_type' => 'custom', // 替换为你实际的自定义文章类型slug
        'posts_per_page' => -1,
        'post_status' => 'any', // 按需求调整需要同步的文章状态
        'fields' => 'ids' // 仅查询文章ID，降低数据库查询负载
    ]);

    // 逐篇写入对应的同步字段值
    foreach ($target_posts as $pid) {
        update_field(
            'servicing_flash_text', // 自定义文章上对应的目标ACF字段名
            $new_val, // 从全局选项页同步的最新值
            $pid // 显式指定写入目标文章ID，避免写入错位
        );
    }

    // 销毁临时全局变量，避免内存残留
    unset($global_flash_old_val);
});

落地注意事项 #

• 代码中所有字段名、自定义文章类型slug需要和你实际配置的内容完全一致，否则会出现读写失败的问题
• 如果需要同步的自定义文章总量超过1000篇，建议增加分批处理逻辑，避免单次请求超时
• 这套逻辑自带ACF的原生权限校验，只有拥有选项页编辑权限的管理员才能触发同步动作，不需要额外增加权限判断

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