Bricks 中文文档:bricks/filter_element/filtered_source

标签TAGS: 

📎 原始资料  |  下载原始 JSON 文件 (bricks-filter_element-filtered_source.json) 前言 此筛选器允许你修改 Bricks 加载图标库时的默认设置。 用法 将代码加入子主题的 functions.php: add_filter( ‘bricks/filter_element/filtered_source’, function( $filtered_source, $element ) { // Example: Ensure a specific value is always present with a count…

前言

此筛选器允许你修改 Bricks 加载图标库时的默认设置。

用法

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

add_filter( 'bricks/filter_element/filtered_source', function( $filtered_source, $element ) {
    // Example: Ensure a specific value is always present with a count of 0 if missing
    if ( ! isset( $filtered_source['some_value'] ) ) {
        $filtered_source['some_value'] = 0;
    }


    return $filtered_source;
}, 10, 2 );

参数

  • $filtered_source (array):关联数组,键为筛选值,值为对应的计数(基于当前筛选后的查询)。
  • $element (object):筛选元素实例。

示例代码

筛选返回值

add_filter( 'bricks/filter_element/filtered_source', function( $filtered_source, $element ) {
    // Example: Ensure a specific value is always present with a count of 0 if missing
    if ( ! isset( $filtered_source['some_value'] ) ) {
        $filtered_source['some_value'] = 0;
    }


    return $filtered_source;
}, 10, 2 );

根据条件短路返回原值

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

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

补充说明

更多细节可参考 官方文档