如何在插件文件中添加Gravity Forms的gform_pre_render动作

可能的原因及对应解决方案 #

1. 钩子注册时机不对（核心问题） #

主题的functions.php加载顺序晚于多数插件，你的自定义插件可能在Gravity Forms完成初始化前就执行了代码，导致gform_pre_render钩子还未被注册，回调函数根本没被触发。

解决方法：借助Gravity Forms自带的gform_loaded钩子，确保在Gravity Forms完全加载后再注册你的回调：

add_action( 'gform_loaded', 'setup_gform_api_populate' );
function setup_gform_api_populate() {
    // 双重确认Gravity Forms核心类已加载
    if ( class_exists( 'GFCommon' ) ) {
        // 提高优先级（比如99），确保你的代码在其他同钩子逻辑之后执行
        add_action( 'gform_pre_render', 'populate_form_options_via_api', 99 );
        // 可选：如果需要在后台编辑表单时也显示填充的选项，加上这个钩子
        add_action( 'gform_admin_pre_render', 'populate_form_options_via_api', 99 );
    }
}

2. 回调函数逻辑调整（复用原有代码） #

把你之前在functions.php里的API填充逻辑放到populate_form_options_via_api函数里，注意针对性处理表单和字段：

function populate_form_options_via_api( $form ) {
    // 替换为你的目标表单ID
    $target_form_id = 1;
    // 替换为你的目标选项字段ID（比如下拉框、单选框）
    $target_field_id = 3;

    // 非目标表单直接返回，避免影响其他表单
    if ( $form['id'] !== $target_form_id ) {
        return $form;
    }

    // 执行API调用（这里替换为你的实际API请求逻辑）
    $api_response = wp_remote_get( 'https://your-api-endpoint.com/options' );
    if ( is_wp_error( $api_response ) ) {
        error_log( 'GForm API请求失败: ' . $api_response->get_error_message() );
        return $form;
    }

    $raw_options = json_decode( wp_remote_retrieve_body( $api_response ), true );
    if ( ! is_array( $raw_options ) ) {
        error_log( 'GForm API返回格式错误' );
        return $form;
    }

    // 遍历字段，替换目标字段的选项
    foreach ( $form['fields'] as &$field ) {
        if ( $field['id'] === $target_field_id && in_array( $field['type'], [ 'select', 'radio', 'checkbox' ] ) ) {
            $field['choices'] = [];
            foreach ( $raw_options as $opt ) {
                $field['choices'][] = [
                    'text'  => sanitize_text_field( $opt['display_name'] ), // 替换为API返回的文本字段
                    'value' => sanitize_text_field( $opt['value_id'] )    // 替换为API返回的值字段
                ];
            }
        }
    }

    return $form;
}

3. 辅助排查步骤 #

• 开启WordPress调试模式：在wp-config.php中添加define('WP_DEBUG', true);，查看是否有PHP语法错误或API请求报错
• 确认插件已激活：在后台「插件」页面检查你的自定义插件状态
• 验证API返回：可以用var_dump($raw_options); exit;临时输出API返回内容，确认数据格式正确

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