Bricks 中文文档：bricks/builder/dynamic_wrapper

前言

筛选 Bricks 构建器中可用的动态包装器。动态包装器用于在构建器画布的特定钩子（例如 WooCommerce 钩子）之前或之后注入内容。

用法

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

add_filter( 'bricks/builder/dynamic_wrapper', function( $dynamic_wrapper ) {
    // Add a custom dynamic wrapper
    $dynamic_wrapper[] = [
        'name' => 'my_custom_wrapper',
        'title' => esc_html__( 'My Custom Wrapper', 'my-plugin' ),
        'hooks' => [
            'before' => 'my_custom_action_before',
            'after'  => 'my_custom_action_after',
        ],
    ];


    return $dynamic_wrapper;
} );

参数

• $dynamic_wrapper (array)：动态包装器数组。

示例代码

筛选返回值

add_filter( 'bricks/builder/dynamic_wrapper', function( $dynamic_wrapper ) {
    // Add a custom dynamic wrapper
    $dynamic_wrapper[] = [
        'name' => 'my_custom_wrapper',
        'title' => esc_html__( 'My Custom Wrapper', 'my-plugin' ),
        'hooks' => [
            'before' => 'my_custom_action_before',
            'after'  => 'my_custom_action_after',
        ],
    ];


    return $dynamic_wrapper;
} );

根据条件短路返回原值

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

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

补充说明

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