前言
此筛选器允许你修改 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;
} );
补充说明
更多细节可参考 官方文档。