Bricks 中文文档：bricks/filter_element/data_source_{filter_source}

前言

此筛选器允许你修改 Bricks 页脚的最终 HTML 输出。

用法

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

// Populate options for a custom source 'my_source'
add_filter( 'bricks/filter_element/data_source_my_source', function( $data_source, $element ) {
    $data_source[] = [
        'value' => 'option_1',
        'text'  => 'Option 1',
    ];


    $data_source[] = [
        'value' => 'option_2',
        'text'  => 'Option 2',
    ];


    return $data_source;
}, 10, 2 );

参数

• $data_source (array)：筛选选项数组。每个选项应为包含 value、text、class 等键的关联数组。
• $element (object)：筛选元素实例。

示例代码

筛选返回值

// Populate options for a custom source 'my_source'
add_filter( 'bricks/filter_element/data_source_my_source', function( $data_source, $element ) {
    $data_source[] = [
        'value' => 'option_1',
        'text'  => 'Option 1',
    ];


    $data_source[] = [
        'value' => 'option_2',
        'text'  => 'Option 2',
    ];


    return $data_source;
}, 10, 2 );

根据条件短路返回原值

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

add_filter( 'bricks/filter_element/data_source_{filter_source}', function( $value, $data_source ) {
    if ( is_admin() ) { return $value; }
    // TODO: custom logic here
    return $value;
} );

补充说明

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