首页 FAQ Codex 文档 文章 视频 下载 Demo 支持 更多 购买前咨询 翻译 请求兼容性 更新日志 新闻 网站地图 更多工具
HUSKY - Product Filter for WooCommerce
CODEX

Shortcodes, Hooks & Extensions

HUSKY – WooCommerce商品筛选器的完整参考

  1. SC [[woof]] HUSKY 产品筛选的主短代码。可在页面任意位置输出搜索表单；每页仅限一个筛选表单。可接受控制筛选元素显示的属性。 →
  2. SC [[woof_author_filter]] 添加作者筛选器，前端显示为下拉菜单，访客可按作者筛选商店产品。需要“按作者搜索”扩展。 →
  3. SC [[woof_btn]] 输出一个按钮，用于显示或隐藏筛选表单（autohide 属性）——适用于产品筛选默认保持折叠状态，需要时才展开的场景。 →
  4. SC [[woof_found_count]] 显示当前筛选找到的产品数量。可在文本小工具中或通过 woof_print_content_before_search_form 钩子使用。自 v.2.1.6 起可用。 →
  5. SC [[woof_front_builder]] 在网站前端使用可视化编辑器直接构建筛选表单——无需设置页面即可组装自定义的产品筛选布局。自 v.2.3.4/1.3.4 起可用。 →
  6. SC [[woof_mobile]] 添加移动端筛选按钮容器：在手机和平板上，点击按钮可在滑出面板中打开隐藏的筛选表单。 →
  7. SC [[woof_price_filter]] 独立的價格筛选器，支持范围滑块、下拉菜单或文本输入框。三个可选属性：type、additional_taxes 和 placeholder。 →
  8. SC [[woof_products]] 第二个主要短代码：在任何页面输出产品网格，该网格会响应当前的筛选状态。属性控制每页数量、列数、模板和分类条件。 →
  9. SC [[woof_products_messenger]] 输出 Products Messenger 订阅小工具，已登录客户可通过邮件关注筛选结果。无属性。 →
  10. SC [[woof_quick_search]] 输出快速搜索表单，用于目录模式下的即时产品搜索。preload 属性决定搜索数据是在页面加载时加载还是首次使用时加载。需要“快速搜索”扩展。 →
  11. SC [[woof_quick_search_results]] 输出快速搜索结果，包含 per_page 和 template_result 属性——内置五个预定义结果模板。需要“快速搜索”扩展。 →
  12. SC [[woof_save_query]] 显示已保存搜索小工具：已登录用户可存储当前的筛选选择，一键返回。 →
  13. SC [[woof_search_options]] 在筛选搜索激活时，输出搜索导航按钮（红色按钮）。无选项。 →
  14. SC [[woof_sku_filter]] 输出用于 SKU 搜索的文本输入框。一个可选属性；搜索条件在扩展设置页面中配置。 →
  15. SC [[woof_step]] 创建分步筛选向导：客户逐步缩小产品范围。by_step 属性定义步骤的键和顺序。 →
  16. SC [[woof_text_filter]] 在商店页面上打印一个文本输入框用于产品搜索——按标题、内容、摘要、元字段和分类法的任意组合搜索WooCommerce产品。 →
  17. SC [[woof_slideout]] 创建一个从屏幕边缘滑出的筛选面板——保持筛选器隐藏，直到访客打开它，从而节省页面空间。 →
  18. SC [[woof_products_ids_prediction]] 围绕 [woof_products] 的包装器，预测哪些产品ID与当前筛选状态匹配——用于使页面构建器和自定义模板支持筛选。 →
可以覆盖扩展的模板。文件夹应放置在当前WordPress主题文件夹中,并且必须具有与原始扩展相同的文件结构。示例: wp-content/themes/my_child_theme/woof/ext/image/views/woof.php
1.
ACF — 按ACF字段筛选
View info →
2.
Advanced Search by Text — 产品文本搜索
View info →
3.
By Rating — 评分筛选
View info →
4.
Color — 颜色样本
View info →
5.
Conditionals — 条件筛选元素
View info →
6.
Essential Grid Connector
View info →
7.
Exclude Backordered Products — 排除缺货待补产品
View info →
8.
Featured Products Checkbox — 精选产品复选框
View info →
9.
Filter Form Front Builder — 筛选表单前端构建器
View info →
10.
Hierarchy Drop-Down — 分类链筛选
View info →
11.
Image — 图像样本
View info →
12.
Import/Export of Settings — 设置导入/导出
View info →
13.
In Stock Checkbox — 有货复选框
View info →
14.
Labels — 术语标签筛选
View info →
15.
Meta Fields — 按自定义字段筛选
View info →
16.
On Sale Checkbox — 促销复选框
View info →
17.
Products Messenger — 筛选订阅
View info →
18.
Quick Search — 即时产品搜索
View info →
19.
Radio or Checkbox in Drop-Down — 下拉单选或复选框
View info →
20.
Saver of Search Query — 已保存筛选
View info →
21.
Searching by Author — 作者筛选
View info →
22.
Searching by SKU — SKU搜索
View info →
23.
Sections — 可折叠筛选块
View info →
24.
SEO URL Request — SEO友好的筛选链接
View info →
25.
Slideout — 滑出式筛选面板
View info →
26.
Slider — 属性范围滑块
View info →
27.
Smart Designer — 自定义筛选元素
View info →
28.
Statistic — 搜索分析
View info →
29.
Step by Step Filter — 筛选向导
View info →
30.
Stock Quantity Slider — 库存数量滑块
View info →
31.
Template 1 — 产品HTML模板
View info →
32.
Turbo Mode — 索引筛选缓存
View info →
33.
WooCommerce Product Table Connectors — WooCommerce产品表连接器
View info →
  1. do_action woof_after_draw_filter 在筛选表单中每个筛选元素输出后触发的动作（Action）。接收元素键和短代码属性。自v.2.2.5/1.2.5起。 →
  2. do_action woof_before_draw_filter 在筛选表单中每个筛选元素输出前触发的动作（Action）。接收元素键和短代码属性。自v.2.2.5/1.2.5起。 →
  3. do_action woof_exclude_existing_variations 改进有货搜索：从搜索结果中排除产品变体，避免过多请求。自v.2.2.6起。 →
  4. do_action woof_image_allow_term_desc 关闭默认添加到筛选图片中的术语描述。默认：true。从 v.2.2.6 起。 →
  5. do_action woof_meta_options_separator 替换元选项中的逗号分隔符——当元值包含逗号时很有用。从 v.2.2.6 起。 →
  6. do_action woof_mobile_btn_place_container 覆盖移动端筛选按钮出现的选择器。默认：'.woocommerce-products-header'。从 v.2.2.6 起。 →
  7. do_action woof_override_seo_request_uri 用于 SEO URL 请求扩展：传递当前 URL，以便适应不同的服务器配置。从 v.2.2.6/1.2.6 起。 →
  8. do_action woof_print_design_additional_options 扩展程序使用，用于向设置页面的“设计”选项卡添加额外选项。 →
  9. do_action woof_print_html_type_options_{type} 所有扩展程序使用此钩子在插件设置页面的“设置”选项卡中绘制其设置块。 →
  10. do_action woof_print_html_type_{type} 扩展程序使用此钩子在前端渲染自身：在扩展初始化中调用 woof_print_html_type_{html_type} 钩子。 →
  11. do_action woof_print_tax_additional_options_{type} 扩展程序使用此钩子在“附加选项”按钮下打印额外选项，如 Color 扩展中的用法。 →
  12. do_action woof_seo_request_literals 用于 SEO URL Request 扩展：添加可用于 SEO 规则字段的字面变量。自 v.2.2.6/1.2.6 版本起。 →
  13. do_action woof_seo_rules_langs 用于 SEO URL Request 扩展：为多语言插件（如 Polylang）添加额外语言。自 v.2.2.6/1.2.6 版本起。 →
  14. do_action woof_wp_load_js 在前端网站中添加自定义 JavaScript 变量。 →
  15. do_action woof_after_inline_js 在内联JavaScript已添加到'woof_front'脚本之后、wp_localize_script调用之前触发，允许添加额外的内联JS或修改脚本。 →
  16. do_action woof_freemius_loaded 在Freemius SDK完全加载并初始化后触发，提供一个钩子点用于Freemius相关的自定义。 →
  17. do_action woof_print_applications_tabs_anvanced 在插件选项页面的Advanced标签导航内触发，允许扩展向Advanced部分添加额外的标签导航项。 →
  18. do_action woof_print_applications_tabs_content_advanced 在插件选项页面Advanced标签内容区域的末尾触发，允许扩展向Advanced标签添加自定义内容部分。 →
  19. do_action woof_print_option_advanced 在高级设置选项区域内、force_ext_disable选项字段之后触发，允许扩展添加额外的选项字段。 →
  1. apply_filters woof_add_html_types 用于分类法类扩展，在系统中注册其键并使扩展可见。过滤器签名：woof_add_html_types($types)。 →
  2. apply_filters woof_add_items_keys 用于'by_'类扩展，在系统中注册其键并使扩展可见。过滤器签名：woof_add_items_keys($keys)。 →
  3. apply_filters woof_before_term_name 用于单选、复选框、下拉和多选HTML类型，在术语标签前显示符号或图标。 →
  4. apply_filters woof_block_toggle_state 控制分类法块的切换状态——例如，通过wp_is_mobile()在移动设备上将其渲染为关闭状态。 →
  5. apply_filters woof_clear_all_text 更改搜索导航面板中“清除所有”按钮的文本。自v.2.2.5/1.2.5起。 →
  6. apply_filters woof_counter_method 开发人员钩子，用于在动态重新计数中试验内存使用情况。在WP_QueryWoofCounter构造函数的classes/counter.php中使用。 →
  7. apply_filters woof_custom_filter_items_order 更改筛选元素的顺序：该钩子传递一个筛选区域键的数组，你可以重新排列。 →
  8. apply_filters woof_delete_img_url 更改筛选器中删除图标的图片URL。自v.2.2.5.6起。 →
  9. apply_filters woof_disable_filter 在特定页面、文章类型或自定义条件下完全禁用该插件。 →
  10. apply_filters woof_ext_custom_title_by_instock 为筛选表单中的“有货”复选框设置自定义标题；该标题也可以使用Loco Translate进行翻译。 →
  11. apply_filters woof_ext_custom_title_XXX 更改三个扩展的复选框标签：有货（In Stock）、精选产品（Featured Products）和促销（On Sale）。将'XXX'替换为by_instock、by_featured或by_onsales。自v.1.1.8/2.1.8起。 →
  12. apply_filters woof_filter_shortcode_args 根据你的业务条件动态更改[woof]短代码参数。 →
  13. apply_filters woof_filter_title 所有分类法和元过滤器的标题都经过此过滤器——您可以自行翻译或重写过滤器标题。自v.3.3.6起。 →
  14. apply_filters woof_get_filtered_price_query 为与其他插件兼容而添加。用于classes/helper.php中的get_filtered_price()。自v.2.2.4/1.2.4起。 →
  15. apply_filters woof_get_meta_query 在搜索查询执行前操作其中的meta查询。自v.2.2.1/1.2.1起。 →
  16. apply_filters woof_get_more_less_button_XXXX 更改网站前端“未切换术语计数”功能的“更多/更少”按钮的视图。 →
  17. apply_filters woof_get_request_data 在插件的数据入口中运行——index.php中的get_request_data()，这是接收搜索请求的第一个函数。可用于读取或预设过滤器值。 →
  18. apply_filters woof_get_tax_query 操作搜索查询中的分类法关系——例如，将关系从OR改为AND。不能与动态重新计数同时使用。 →
  19. apply_filters woof_get_terms_args 为与其他插件兼容而添加。用于classes/helper.php中的get_terms()。自v.2.2.4/1.2.4起。 →
  20. apply_filters woof_get_terms_order 对搜索表单中的术语进行排序（每个分类法的ASC/DESC）。与woof_get_terms_orderby配合使用。 →
  21. apply_filters woof_get_terms_orderby 设置搜索表单中术语排序所依据的字段，按分类法。与woof_get_terms_order配合使用。 →
  22. apply_filters woof_html_types_view_checkbox 使用您自己的文件重写视图模板views/html_types/checkbox.php。自v.2.2.4/1.2.4起。 →
  23. apply_filters woof_html_types_view_mselect 使用您自己的文件重写视图模板views/html_types/mselect.php。自v.2.2.4/1.2.4起。 →
  24. apply_filters woof_html_types_view_radio 使用您自己的文件重写视图模板views/html_types/radio.php。自v.2.2.4/1.2.4起。 →
  25. apply_filters woof_html_types_view_select 使用您自己的文件重写视图模板views/html_types/select.php。自v.2.2.4/1.2.4起。 →
  26. apply_filters woof_husky_query_post__in 在两种过滤器查询模式之间切换：post__in（默认，更可靠）和SQL JOIN。自v.2.2.9/1.2.9起。 →
  27. apply_filters woof_husky_query_post__in 通过帖子ID操作文本过滤——根据支持请求添加，用于分别过滤标题、描述和SKU。 →
  28. apply_filters woof_image_add_term_desc 对于图片筛选（高级版）：在工具提示中显示或隐藏术语描述。默认：true。 →
  29. apply_filters woof_init_archive_by_default 以编程方式动态禁用产品属性的“启用存档”选项。 →
  30. apply_filters woof_main_query_tax_relations 为搜索请求中的所有分类法设置 AND 逻辑。将筛选器添加到主题的 functions.php 中。 →
  31. apply_filters woof_max_price_filter 通过在 functions.php 中自定义逻辑设置价格筛选器的最高价格。 →
  32. apply_filters woof_min_price_filter 通过在 functions.php 中自定义逻辑设置价格筛选器的最低价格。 →
  33. apply_filters woof_not_sort_checked_terms 从“让已选术语始终置顶”选项中排除 HTML 类型。在 index.php 中的 woof_sort_terms_is_checked() 中使用。 →
  34. apply_filters woof_order_catalog 为产品目录添加自定义排序顺序。从 v.2.2.4/1.2.4 起。 →
  35. apply_filters woof_price_slider_html 替换搜索表单中原生的 Woo 价格滑块标记。在 classes/helper.php 的 price_filter() 中使用。 →
  36. apply_filters woof_print_content_before_redraw_zone 在产品上方放置任何不被 AJAX 重绘的 HTML 消息。从 v.2.2.4/1.2.4 起。 →
  37. apply_filters woof_print_content_before_search_form 在搜索表单项目之前输出任何内容——例如，当筛选搜索处于活动状态时显示通知。 →
  38. apply_filters woof_print_label_attributes 为复选框和单选框的标签添加自定义属性，例如用于无障碍访问的 ARIA 属性。 →
  39. apply_filters woof_products_query 在 [woof_products] 短代码中执行一次，用于自定义查询操作。 →
  40. apply_filters woof_products_top_panel_content 在筛选结果顶部显示任何业务内容。自 v.2.2.4/1.2.4 版本起。 →
  41. apply_filters woof_qs_get_template_structure 用于快速搜索扩展：更改结果表的列标题。 →
  42. apply_filters woof_qs_shortcode_data 用于快速搜索扩展：在页面加载前更改模板参数，例如按设备区分。 →
  43. apply_filters woof_qs_sort_select_data 用于快速搜索扩展：当排序显示为下拉菜单时，更改表格的排序标题。 →
  44. apply_filters woof_quick_search_products_limit 将快速搜索的产品限制扩展到默认的 10,000 以上——注意大数值时的服务器资源。 →
  45. apply_filters woof_redraw_elements_after_ajax 在访客以 AJAX 模式进行筛选时，根据当前查询添加自定义消息或元素。 →
  46. apply_filters woof_seo_do_index 用于 SEO URL 扩展：灵活的索引控制——例如，从索引中排除选定的筛选页面。 →
  47. apply_filters woof_seo_meta_description 修改带有活动筛选搜索的页面的 meta description 标签。 →
  48. apply_filters woof_set_shortcode_taxonomyattr_behaviour 操作 'additional_taxes' 属性的行为。在 index.php 的 woof_shortcode() 中生效。 →
  49. apply_filters woof_slider_meta_query_type 设置元数据滑块查询的值类型——例如 DECIMAL 用于十进制值。 →
  50. apply_filters woof_sort_terms_before_out 用于复选框和单选按钮 HTML 类型，在输出前对术语数组进行任何操作。 →
  51. apply_filters woof_start_filtering_btn_txt 更改由 [woof start_filtering_btn=1] 生成的“显示产品筛选表单”按钮的文字。自 v.2.1.6 起。 →
  52. apply_filters woof_step_filter_img_size 调整步骤筛选中的图像大小：thumbnail、medium、large、full 或自定义尺寸数组。自 v.2.2.4/1.2.4 起。 →
  53. apply_filters woof_taxonomy_image 根据当前情况动态重新定义图像筛选术语的图像。 →
  54. apply_filters woof_template_part 动态更改 [woof_products] 短代码的模板。 →
  55. apply_filters woof_terms_where_hidden_childs 在复选框、单选按钮、下拉选择、多选和标签中隐藏所选父术语的子术语。 →
  56. apply_filters woof_term_count_format 更改术语计数格式——默认为 '(%d)'。 →
  57. apply_filters woof_text_autocomplete_items 设置文本输入自动补全返回的文章数量。 →
  58. apply_filters woof_text_search_like_option 调节文本搜索行为：默认返回 FALSE；返回 TRUE 以搜索时不考虑特殊字符。 →
  59. apply_filters woof_text_search_query 动态重新定义文本搜索 SQL 请求——例如，将结果限制为特定的文章 ID。 →
  60. apply_filters woof_title_tag 将每个分类区块的 H4 标题标签重新定义为任何其他 HTML 标签。 →
  61. apply_filters woof_turbo_mode_schedules 为 Turbo Mode 中的产品数据添加自定义更新周期。自 v.3.3.6 起。 →
  62. apply_filters woof_use_wp_cache 为筛选器启用 WordPress 对象缓存——在测试中表现出良好效果；需要安装持久对象缓存。 →
  63. apply_filters woof_widget_title_tag 将筛选小部件的 H3 标题标签重新定义为任何其他 HTML 标签。 →
  64. apply_filters woof_button_css_classes 筛选应用于“Start filtering”按钮的 CSS 类字符串，允许自定义样式或 JavaScript 定位。 →
  65. apply_filters woof_draw_products_get_args 筛选用于 AJAX 产品请求的合并 GET 参数，允许在产品重新绘制前修改查询数据。 →
  66. apply_filters woof_draw_products_html 筛选产品短代码的最终 HTML 输出，在其被返回为 AJAX 响应之前，实现自定义后处理。 →
  67. apply_filters woof_dynamic_count_attr 筛选用于计算动态产品数量的 WP_Query 参数，允许为重新计数徽章设置自定义条件。 →
  68. apply_filters woof_ext_custom_title_by_backorder 筛选“By Backorder”筛选复选框的显示标签，允许自定义翻译或重命名。 →
  69. apply_filters woof_ext_custom_title_by_featured 允许自定义前端视图和 JavaScript 本地化数组中“Featured products”筛选复选框显示的标签文本。 →
  70. apply_filters woof_ext_custom_title_by_onsales 允许自定义前端视图和 JavaScript 本地化数组中“On sale”筛选复选框显示的标签文本。 →
  71. apply_filters woof_ext_custom_title_stock_quantity 允许自定义管理筛选标题列表和前端视图模板中“Stock quantity slider”筛选显示的标签文本。 →
  72. apply_filters woof_extensions_type_index 筛选包含在 JavaScript woof_accept_array 中的扩展类型索引的逗号分隔列表，定义前端 JavaScript 将处理哪些筛选键。 →
  73. apply_filters woof_filter_search_slug 筛选用于查询字符串中 WOOF 筛选参数的 URL slug，允许自定义搜索 slug（默认通常为 'swoof'）。 →
  74. apply_filters woof_filter_taxonomies 筛选从 WordPress 检索的产品分类数组，允许删除或修改筛选器使用的分类。 →
  75. apply_filters woof_front_builder_option 筛选从数据库加载后的单个前端构建器选项的值，允许运行时修改选项值。 →
  76. apply_filters woof_front_builder_options_after_update 在前端构建器选项更新后、保存到数据库之前，筛选整个选项数组。 →
  77. apply_filters woof_generate_container_css_classes 筛选用于筛选区域容器的CSS类名，允许根据每个筛选区域键自定义容器样式。 →
  78. apply_filters woof_get_all_filter_titles 在将所有筛选标题本地化到JavaScript之前筛选关联数组，允许自定义显示的筛选名称。 →
  79. apply_filters woof_get_front_css_file_link 筛选主前端CSS文件的URL，允许用自定义样式表替换默认样式表。 →
  80. apply_filters woof_get_max_price 筛选用于价格范围滑块的最大价格值，允许修改价格上限。 →
  81. apply_filters woof_get_min_price 筛选用于价格范围滑块的最小价格值，允许修改价格下限。 →
  82. apply_filters woof_husky_txt_option 筛选Husky文本搜索自动完成下拉菜单中每个渲染的HTML选项，允许自定义单个搜索结果项。 →
  83. apply_filters woof_husky_txt_templates 当插件内默认模板文件不存在时，筛选Husky文本搜索结果模板的文件路径，允许自定义模板位置。 →
  84. apply_filters woof_meta_data_datapicker 筛选为日期选择器元筛选生成的元查询数组，允许在将日期范围查询参数应用于产品查询前进行修改... →
  85. apply_filters woof_meta_filter_add_types 筛选可用元筛选HTML类型的数组，允许向插件添加自定义元筛选类型。 →
  86. apply_filters woof_meta_use_acf_dateformat 控制是否对日期选择器元筛选使用ACF（高级自定义字段）日期格式；若为true，日期将格式化为Ymd而非Unix时间戳。 →
  87. apply_filters woof_modify_settings_before_action 在筛选短代码渲染前筛选整个插件设置数组，允许动态地对每个实例修改所有筛选设置。 →
  88. apply_filters woof_regulate_by_only_show 当使用'by_only'短代码属性时，筛选单个筛选项的'show'值，主要针对视图依赖于该值的价格筛选... →
  89. apply_filters woof_seo_canonical 筛选在激活筛选搜索时输出到页面头部区域的规范URL链接标签，允许自定义规范URL。 →
  90. apply_filters woof_seo_h1 筛选激活筛选搜索时的H1页面标题文本，允许自定义搜索结果页面上显示的主标题。 →
  91. apply_filters woof_seo_meta_title 筛选激活筛选搜索时的HTML <title>元标签内容，允许自定义SEO筛选页面上的浏览器/文档标题。 →
  92. apply_filters woof_seo_text 过滤在产品筛选搜索页面上商店循环之后显示的SEO文本块，允许自定义展示在已筛选产品下方的描述内容。 →
  93. apply_filters woof_subscribe_lang 过滤Products Messenger扩展的订阅语言文本，允许自定义每个产品提醒订阅中存储的语言/区域设置字符串... →
  94. apply_filters woof_taxonomy_type_objects_front_render 过滤某个分类法类型对象是否应渲染为当前筛选类型，并允许传递修改后的参数，支持自定义分类法渲染扩展。 →
  95. apply_filters woof_text_filter_labels 过滤在Husky文本搜索中分配给产品的标签别名数组，允许自定义每个搜索结果中显示哪些标签。 →
  96. apply_filters woof_text_search_ids 允许外部搜索引擎（例如SearchWP）覆盖文本搜索返回的产品ID，完全替换默认的WooCommerce搜索结果。 →
  97. apply_filters woof_text_urlencode 控制URL查询字符串中的筛选值是否应进行URL编码，以便在搜索参数中处理特殊字符。 →
  98. apply_filters woof_turbo_mode_products_limit 过滤在turbo mode缓存生成期间要处理的最大产品数，设置一个限制以防止内存或超时问题。 →
  99. apply_filters woof_url_parser_all_data 过滤传递给JavaScript URL解析器的整个数据数组，允许修改筛选键映射以实现SEO友好的URL解析。 →
  100. apply_filters woof_use_chosen 控制是否使用Chosen jQuery插件来增强选择下拉元素，允许强制启用/禁用增强的选择UI。 →