Bricks 中文文档：bricks/form/response

前言

Bricks 1.4 引入了 bricks/indexer/source/settings/controls_data 钩子，允许你修改自定义索引器数据源设置中控件的数据。

用法

将代码加入子主题的 functions.php：

add_filter( 'bricks/form/response', function( $response, $form ) {
    // Example: Append a "Thank you" note to the success message
    if ( isset( $response['type'] ) && $response['type'] === 'success' ) {
        $response['message'] .= ' ' . esc_html__( 'Thank you for contacting us!', 'my-domain' );
    }


    return $response;
}, 10, 2 );

参数

• $response (array)：响应数据数组（例如 [‘type’ => ‘success’, ‘message’ => ‘…’, ‘redirectUrl’ => ‘…’]）。
• $form (object)：Form 集成实例。

示例代码

筛选返回值

add_filter( 'bricks/form/response', function( $response, $form ) {
    // Example: Append a "Thank you" note to the success message
    if ( isset( $response['type'] ) && $response['type'] === 'success' ) {
        $response['message'] .= ' ' . esc_html__( 'Thank you for contacting us!', 'my-domain' );
    }


    return $response;
}, 10, 2 );

根据条件短路返回原值

根据条件跳过或修改返回值：

add_filter( 'bricks/form/response', function( $value, $response ) {
    if ( is_admin() ) { return $value; }
    // TODO: custom logic here
    return $value;
} );

补充说明

更多细节可参考 官方文档。