本教程详细介绍了如何在 wordpress/woocommerce 中获取所有产品标签，并构建一个自定义 循环 以展示这些标签，从而实现产品筛选功能。文章通过 get_terms 函数获取标签数据，并利用 foreach 循环生成可点击的标签链接。此外，还提供了从生成的标签列表中排除特定标签的方法，帮助开发者灵活定制产品标签展示。
在wordPress 和 WooCommerce 环境中，为产品创建自定义标签筛选器是提升用户体验的常见需求。通过展示所有产品标签并允许用户点击筛选，可以帮助用户快速定位感兴趣的产品。本教程将指导您如何获取 WooCommerce 中的所有产品标签，并构建一个可用于筛选的自定义循环，同时提供排除特定标签的灵活方法。
核心功能：获取与展示 WooCommerce 产品标签
WooCommerce 的产品标签本质上是 wordpress 的自定义分类法（Custom Taxonomy）。要获取所有产品标签，我们可以使用 WordPress 提供的 get_terms()函数。这个函数能够检索指定分类法的所有术语（terms），对于产品标签，其分类法名为 product_tag。
<?php /** * 获取所有 WooCommerce 产品标签并生成可点击的 HTML 链接 * * @return string 返回包含标签链接的 HTML 字符串 */ function generate_product_tag_Filter_html() { // 获取所有 WooCommerce 产品标签 $product_tags = get_terms( Array('taxonomy' => 'product_tag', 'hide_empty' => true, // 只获取有产品的标签） ); // 如果没有标签或发生错误，则直接返回空字符串 if (empty( $product_tags) || is_wp_error($product_tags) ) {return '';} $html ='<div class="filter-bar__tags-filter">'; foreach ($product_tags as $tag) {// 获取标签的链接 $tag_link = get_term_link( $tag->term_id,'product_tag'); // 检查链接是否有效 if (! is_wp_error( $tag_link) ) {$html .= "<a href='{$tag_link}'title='{$tag->name} Tag'class='tag-item tag-{$tag->slug}'>{$tag->name}</a>"; } } $html .='</div>'; return $html; } // 在需要显示标签的地方调用此函数 // echo generate_product_tag_filter_html(); ?>代码解析：
- get_terms(array(‘taxonomy’ =youjiankuohaophpcn ‘product_tag’, ‘hide_empty’ => true) ): 这是获取产品标签的核心函数。taxonomy 参数指定了要获取的分类法为 product_tag，hide_empty => true 则确保只获取那些至少关联了一个产品的标签，避免显示空标签。
- foreach ($product_tags as $tag): 遍历获取到的每一个标签 对象。每个 $tag 对象包含了标签的各种信息，例如 $tag->term_id（标签 ID）、$tag->name（标签名称）和 $tag->slug（标签的 URL 别名）。
- get_term_link($tag->term_id, ‘product_tag’): 根据标签 ID 和分类法名称生成该标签的归档页链接。
- <a href='{$tag_link}’ …>{$tag->name}</a>: 构建 HTML 超链接，用户点击后将跳转到该标签的产品归档页面，从而实现产品筛选。
- class=’tag-item tag-{$tag->slug}’: 为每个标签链接添加 css 类，便于后续样式定制和javaScript 交互。
进阶定制：排除特定产品标签
在某些情况下，您可能不希望某些特定的产品标签出现在筛选器中。这可以通过在 foreach 循环内部添加条件判断来实现。您可以根据标签的 ID 或其 slug 来排除它们。
以下示例演示了如何排除一个或多个特定标签（例如，ID 为 10 和 slug 为 ’special-offer’ 的标签）：
<?php /** * 获取 WooCommerce 产品标签并生成 HTML 链接，同时排除特定标签 * * @param array $exclude_tag_ids 要排除的标签 ID 数组 * @param array $exclude_tag_slugs 要排除的标签 slug 数组 * @return string 返回包含标签链接的 HTML 字符串 */ function generate_product_tag_filter_html_with_exclusion($exclude_tag_ids = array(), $exclude_tag_slugs = array()) {$product_tags = get_terms( array( 'taxonomy' => 'product_tag', 'hide_empty' => true,) ); if (empty( $product_tags) || is_wp_error($product_tags) ) {return '';} $html ='<div class="filter-bar__tags-filter">'; foreach ($product_tags as $tag) {// 检查是否需要排除当前标签 if ( in_array( $tag->term_id, $exclude_tag_ids) || in_array($tag->slug, $exclude_tag_slugs) ) {continue; // 跳过当前标签，不将其添加到 HTML 中 } $tag_link = get_term_link($tag->term_id,'product_tag'); if (! is_wp_error( $tag_link) ) {$html .= "<a href='{$tag_link}'title='{$tag->name} Tag'class='tag-item tag-{$tag->slug}'>{$tag->name}</a>"; } } $html .='</div>'; return $html; } // 示例：排除 ID 为 10 和 slug 为'special-offer'的标签 // echo generate_product_tag_filter_html_with_exclusion(array( 10), array('special-offer') ); // 如果只想排除一个标签，可以这样调用 // echo generate_product_tag_filter_html_with_exclusion(array( 10) ); // echo generate_product_tag_filter_html_with_exclusion(array(), array('special-offer') ); ?>代码解析：
- $exclude_tag_ids 和 $exclude_tag_slugs：作为函数的参数传入，分别用于指定要排除的标签 ID 和 slug 列表。
- if (in_array( $tag->term_id, $exclude_tag_ids) || in_array($tag->slug, $exclude_tag_slugs) ): 在循环内部，这个条件判断检查当前标签的 ID 是否在 $exclude_tag_ids 数组中，或者其 slug 是否在 $exclude_tag_slugs 数组中。
- continue;: 如果条件为真（即当前标签需要被排除），continue 语句会立即跳过当前循环的剩余部分，进入下一次循环，从而不将该标签添加到 HTML 输出中。
注意事项与最佳实践
- 样式美化： 生成的 HTML 只包含基本的结构。您需要通过 CSS 为。filter-bar__tags-filter 和。tag-item 等类添加样式，以使其在 前端 美观显示。例如，可以设置flex 布局、调整边距、字体大小和颜色等。
- 集成位置： 您可以将上述 PHP 代码放置在主题的 functions.php 文件中，或者创建一个自定义插件。然后在您希望显示标签筛选器的模板文件（如 archive-product.php、sidebar.php 或任何自定义页面模板）中调用 generate_product_tag_filter_html()或 generate_product_tag_filter_html_with_exclusion()函数。
- 性能优化 ： 如果您的产品标签数量非常庞大，每次页面加载都执行 get_terms 可能会影响性能。考虑使用 WordPress 的转瞬缓存（Transients API）来缓存标签列表，以减少 数据库 查询次数。
- 用户体验： 考虑为当前激活的标签添加一个特殊的 CSS 类，以便用户清楚地知道当前正在按哪个标签进行筛选。这可以通过检查当前页面的 URL 参数或使用 WordPress 的条件标签（如 is_tax(‘product_tag’, $tag->slug)）来实现。
总结
通过 get_terms()函数和简单的 foreach 循环，您可以轻松地在 WooCommerce 中构建一个功能完善的产品标签筛选器。无论是展示所有标签还是根据特定需求排除部分标签，上述方法都提供了灵活且高效的解决方案。结合适当的 css 样式 和性能优化，您可以为您的 WooCommerce 商店提供一个直观且用户友好的产品导航体验。
以上就是 WooCommerce 产品标签筛选器开发：获取、展示与排除特定标签的详细内容，更多请关注 php 中文网其它相关文章！
