woof_regulate_by_only_show
当使用 'by_only' 短代码属性时,过滤单个筛选项的 'show' 值,主要用于价格筛选器,其视图依赖于该值(1-5)。
参数
$val (mixed) — 默认值(对于大多数筛选器通常为1,或价格筛选器的 'show' 设置的 intval 值)
$by_only_key (string) — 被调节的筛选项的关键标识符(例如 'by_price'、'by_featured')
源文件
index.php:3039
代码示例
add_filter('woof_regulate_by_only_show', function($val, $key) {
if ('by_price' === $key) {
return 2; // Show price as a select dropdown
}
return $val;
}, 10, 2);
使用说明
- 仅当设置了 'by_only' 短代码属性且不为空时触发。
- 价格筛选器('by_price')具有视图类型1-5(滑块、下拉选择、文本、单选等),使得此钩子特别适用于它。
- 属于 woof.php 短代码渲染流程的一部分。