Bricks 中文文档:bricks/filter_element/count_source_{filter_source}

📎 原始资料  |  下载原始 JSON 文件 (bricks-filter_element-count_source_filter_source.json) 前言 在 Bricks 渲染页头模板时触发。用于在 Bricks 自己的页头渲染流程开始前输出标记或运行逻辑。 用法 将代码加入子主题的 functions.php: add_filter( ‘bricks/filter_element/count_source_wcField’, function( $count_source, $element ) { foreach ( $count_source as &$r…

前言

在 Bricks 渲染页头模板时触发。用于在 Bricks 自己的页头渲染流程开始前输出标记或运行逻辑。

用法

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

add_filter( 'bricks/filter_element/count_source_wcField', function( $count_source, $element ) {
    foreach ( $count_source as &$row ) {
        if ( isset( $row['filter_value'] ) && $row['filter_value'] === 'featured' ) {
            $row['count'] = 999;
        }
    }
    unset( $row );


    return $count_source;
}, 10, 2 );

参数

  • $count_source (array):已索引的计数行。每行可以包含 filter_value、filter_value_display、filter_value_id、filter_value_parent 和 count。
  • $element (object):筛选元素实例。

示例代码

筛选返回值

add_filter( 'bricks/filter_element/count_source_wcField', function( $count_source, $element ) {
    foreach ( $count_source as &$row ) {
        if ( isset( $row['filter_value'] ) && $row['filter_value'] === 'featured' ) {
            $row['count'] = 999;
        }
    }
    unset( $row );


    return $count_source;
}, 10, 2 );

根据条件短路返回原值

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

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

补充说明

更多细节可参考 官方文档