如何通过Gravity Forms复选框填充ACF Relationship字段？

你的需求是通过Gravity Forms复选框（存储文章标题），在表单提交创建新文章时，自动填充新文章的ACF Relationship字段。原代码存在几处逻辑和语法问题，以下是修正方案：

原代码的核心问题 #

1. 钩子注册的函数名不匹配：add_action中指定的函数是apc_serialize_checkboxes，但实际定义的函数是gform_relation，导致钩子无法触发。
2. get_value_export返回的是逗号分隔的字符串，直接遍历会报错，且未正确收集转换后的文章ID。
3. 直接使用update_post_meta更新ACF字段，未遵循ACF的字段处理逻辑，可能导致显示异常。

修正后的完整代码 #

// 绑定表单ID=6的高级文章创建完成钩子
add_action( 'gform_advancedpostcreation_post_after_creation_6', 'gform_fill_acf_relationship', 10, 4 );

function gform_fill_acf_relationship( $post_id, $feed, $entry, $form ) {
    // 表单中复选框字段的ID
    $checkbox_field_id = 21;
    // ACF Relationship字段的键名
    $acf_relation_key = 'parcours_thematiques_choisies';

    // 获取复选框字段对象，校验字段类型
    $checkbox_field = GFAPI::get_field( $form, $checkbox_field_id );
    if ( empty( $checkbox_field ) || $checkbox_field->type !== 'checkbox' ) {
        return;
    }

    // 获取选中的文章标题（逗号分隔字符串）
    $selected_titles_str = $checkbox_field->get_value_export( $entry );
    if ( empty( $selected_titles_str ) ) {
        return;
    }

    // 分割字符串为标题数组，转换为文章ID
    $selected_titles = explode( ', ', $selected_titles_str );
    $target_post_ids = [];

    foreach ( $selected_titles as $title ) {
        // 根据标题获取对应文章，可修改第三个参数指定文章类型
        $target_post = get_page_by_title( trim( $title ), OBJECT, 'post' );
        if ( $target_post instanceof WP_Post ) {
            $target_post_ids[] = $target_post->ID;
        }
    }

    // 若有有效ID，更新ACF Relationship字段
    if ( ! empty( $target_post_ids ) ) {
        // 使用ACF官方函数处理字段，自动维护格式与缓存
        update_field( $acf_relation_key, $target_post_ids, $post_id );
    }
}

关键说明 #

• 确保钩子与函数名完全匹配，保证代码能在文章创建后触发。
• 增加空值校验和字段类型校验，避免无意义的错误执行。
• 对标题做trim处理，防止空格导致文章标题匹配失败。
• 使用ACF官方的update_field函数，而非直接操作post_meta，ACF会自动处理字段序列化、缓存更新等逻辑，避免字段显示异常。

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