插件自动发布文章时如何同步保存ACF自定义字段？

问题描述 #

我开发了一个从外部网站抓取数据的插件，预先创建了两个ACF自定义字段存储抓取结果。目前功能正常，但必须手动刷新后台文章页面，ACF字段的数据才会写入postmeta表——当前字段显示的是占位符/默认值，刷新后才会真正存入数据库。需要实现：新创建的文章和已有文章的数据都能自动存入数据库。

原代码 #

<?php

add_filter('acf/load_field/name=application_email', function ($field) {
    $howtoapply = get_field('howtoapply');
    if (get_post_meta($post->ID, 'application_email', true) == '') {

        $apply_link = get_field('howtoapply');

        $link = $apply_link;
        libxml_use_internal_errors(true);
        $dom = new DOMDocument();
        @$dom->loadHTML($link);
        $dom->loadHTML($link);
        foreach ($dom->getElementsByTagName("a") as $a) {
        }

        function cfDecodeEmail($encodedString)
        {
            $k = hexdec(substr($encodedString, 0, 2));
            for ($i = 2, $email = ''; $i < strlen($encodedString) - 1; $i += 2) {
                $email .= chr(hexdec(substr($encodedString, $i, 2)) ^ $k);
            }
            return $email;
        }

        if (!is_null($a) && is_object($a)) {

            $field['value'] = cfDecodeEmail($a->getAttribute('data-cfemail'));
            $GLOBALS[$field['value']] = cfDecodeEmail($a->getAttribute('data-cfemail'));

            if (!add_post_meta(get_the_ID(), 'application_email', $field['value'])) {
                update_post_meta(get_the_ID(), 'application_email', $field['value']);
            }
        } else {
            echo '';
        }
    }

    return $field;
});

问题原因分析 #

原代码依赖acf/load_field钩子，该钩子仅在字段被加载渲染时触发（比如打开后台文章编辑页），因此必须手动刷新页面才会执行数据抓取和存储逻辑。此外代码存在多处隐患：

• 未声明全局$post变量，$post->ID会触发报错
• cfDecodeEmail函数定义在回调内部，多次触发会导致函数重复定义错误
• 重复调用$dom->loadHTML($link)，冗余无意义
• foreach循环为空，仅能获取最后一个<a>标签，逻辑不严谨
• get_the_ID()在acf/load_field上下文可能无法正确获取当前文章ID

解决方案 #

方案1：新文章自动存储数据（save_post钩子实现）

替换原有acf/load_field钩子，改用save_post钩子，在文章保存时自动抓取并存储数据，无需手动刷新页面：

<?php

// 提前定义Cloudflare加密邮箱解密函数，避免重复定义问题
function cfDecodeEmail($encodedString) {
    if(empty($encodedString)) return '';
    $k = hexdec(substr($encodedString, 0, 2));
    $email = '';
    for ($i = 2; $i < strlen($encodedString); $i += 2) {
        $email .= chr(hexdec(substr($encodedString, $i, 2)) ^ $k);
    }
    return $email;
}

// 文章保存时自动抓取并存储数据
add_action('save_post', 'auto_save_application_email', 10, 3);
function auto_save_application_email($post_id, $post, $update) {
    // 跳过自动保存、修订版和非目标文章类型（按需修改文章类型）
    if (wp_is_post_autosave($post_id) || wp_is_post_revision($post_id) || $post->post_type !== 'post') {
        return;
    }

    // 检查操作权限（按需调整权限）
    if (!current_user_can('edit_post', $post_id)) {
        return;
    }

    // 获取howtoapply字段值
    $howtoapply = get_field('howtoapply', $post_id);
    if(empty($howtoapply)) return;

    // 检查application_email是否已存在，避免重复处理
    $existing_email = get_post_meta($post_id, 'application_email', true);
    if(!empty($existing_email)) return;

    // 解析HTML提取加密邮箱
    libxml_use_internal_errors(true);
    $dom = new DOMDocument();
    @$dom->loadHTML($howtoapply);
    $a_tags = $dom->getElementsByTagName('a');
    $decoded_email = '';

    foreach ($a_tags as $a) {
        $cf_email = $a->getAttribute('data-cfemail');
        if(!empty($cf_email)) {
            $decoded_email = cfDecodeEmail($cf_email);
            break; // 取第一个带data-cfemail的a标签，按需调整逻辑
        }
    }

    // 存储到application_email字段
    if(!empty($decoded_email)) {
        update_field('application_email', $decoded_email, $post_id);
    }
}

方案2：批量处理已有文章

如果需要给所有已有文章自动填充数据，可添加批量处理函数，执行一次即可（建议通过临时链接触发，执行后删除相关代码）：

<?php

// 批量处理已有文章的函数
function batch_update_application_email() {
    // 查询所有未填充application_email的文章（按需修改文章类型和参数）
    $args = array(
        'post_type' => 'post',
        'post_status' => 'publish',
        'posts_per_page' => -1,
        'meta_query' => array(
            array(
                'key' => 'application_email',
                'compare' => 'NOT EXISTS'
            )
        )
    );

    $posts = get_posts($args);
    foreach ($posts as $post) {
        auto_save_application_email($post->ID, $post, true);
    }

    echo '批量处理完成，共处理' . count($posts) . '篇文章';
}

// 临时触发方式：访问网站域名/?batch_update=1 执行（仅管理员可操作）
if(isset($_GET['batch_update']) && $_GET['batch_update'] == 1 && current_user_can('manage_options')) {
    batch_update_application_email();
    exit;
}

方案3：优化字段显示逻辑（可选）

若需保留字段加载时的 fallback 逻辑（防止数据丢失时临时显示抓取结果），可优化原有acf/load_field钩子，避免重复存储：

<?php

add_filter('acf/load_field/name=application_email', function ($field) {
    $post_id = $field['post_id'];
    $existing_email = get_post_meta($post_id, 'application_email', true);

    // 已有数据直接返回
    if(!empty($existing_email)) {
        $field['value'] = $existing_email;
        return $field;
    }

    // 无数据时临时抓取显示（不存储，避免依赖页面刷新）
    $howtoapply = get_field('howtoapply', $post_id);
    if(empty($howtoapply)) return $field;

    libxml_use_internal_errors(true);
    $dom = new DOMDocument();
    @$dom->loadHTML($howtoapply);
    $a_tags = $dom->getElementsByTagName('a');
    $decoded_email = '';

    foreach ($a_tags as $a) {
        $cf_email = $a->getAttribute('data-cfemail');
        if(!empty($cf_email)) {
            $decoded_email = cfDecodeEmail($cf_email);
            break;
        }
    }

    if(!empty($decoded_email)) {
        $field['value'] = $decoded_email;
    }

    return $field;
});

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