WooCommerce 产品标签高级用法：自定义循环与特定标签排除-php教程-PHP中文网

WooCommerce 产品标签高级用法：自定义循环与特定标签排除

聖光之護

发布： 2025-10-29 12:15:05

原创

346人浏览过

WooCommerce 产品标签高级用法：自定义循环与特定标签排除

本文详细讲解如何在wordpress中为woocommerce产品创建自定义标签过滤循环。我们将利用`get_terms`函数获取所有产品标签，并通过`foreach`循环生成可点击的标签链接，从而实现产品按标签筛选的功能。此外，文章还将探讨如何从生成的标签列表中排除特定的标签，以满足更精细化的展示需求。

在WordPress中为WooCommerce产品构建一个自定义的标签过滤循环，是提升用户体验和网站导航能力的重要方式。通过这种方式，用户可以根据产品标签快速筛选商品，从而更高效地找到所需产品。本教程将指导您如何获取所有WooCommerce产品标签，构建一个可点击的标签列表，并进一步讲解如何从该列表中排除特定的标签。

获取所有 WooCommerce 产品标签

要获取WooCommerce中所有已使用的产品标签，我们应该使用WordPress的get_terms()函数。这个函数是专门用来获取分类法（taxonomy）中的术语（terms）的，而WooCommerce的产品标签（product_tag）正是WordPress分类法的一种。

以下是获取所有产品标签的基本代码：

<?php
// 获取所有 WooCommerce 产品标签
$product_tags = get_terms( 'product_tag', array(
    'hide_empty' => true // 只获取有产品关联的标签
) );

// 检查是否获取到标签
if ( ! empty( $product_tags ) && ! is_wp_error( $product_tags ) ) {
    // 标签数据已成功获取，可以在这里处理 $product_tags 数组
    // 例如，打印标签名称进行调试
    // foreach ( $product_tags as $tag ) {
    //     echo $tag->name . '<br>';
    // }
} else {
    echo '没有找到产品标签。';
}
?>

登录后复制

在上述代码中：

'product_tag' 是WooCommerce产品标签的分类法名称。
'hide_empty' =youjiankuohaophpcn true 是一个重要的参数，它确保我们只获取那些至少关联了一个产品的标签，避免显示空标签。

get_terms()函数会返回一个包含WP_Term对象数组，每个对象都代表一个产品标签，其中包含term_id、name、slug等属性。

构建自定义标签过滤循环

获取到产品标签数据后，下一步是遍历这些标签，并为每个标签生成一个可点击的链接，形成一个自定义的过滤条。

<?php
$product_tags = get_terms( 'product_tag', array(
    'hide_empty' => true
) );

$html = ''; // 初始化HTML字符串

if ( ! empty( $product_tags ) && ! is_wp_error( $product_tags ) ) {
    $html .= '<div class="filter-bar__tags-filter">'; // 容器开始

    foreach ( $product_tags as $tag ) {
        $tag_link = get_tag_link( $tag->term_id ); // 获取标签的链接

        // 构建标签链接的HTML
        // 使用 esc_url() 确保链接安全
        // 使用 esc_attr() 和 esc_html() 确保属性和内容安全
        $html .= "<a href='" . esc_url( $tag_link ) . "' title='" . esc_attr( $tag->name ) . " Tag' class='" . esc_attr( $tag->slug ) . "'>" . esc_html( $tag->name ) . "</a>";
    }

    $html .= '</div>'; // 容器结束
} else {
    $html .= '<p>目前没有可供筛选的产品标签。</p>';
}

echo $html; // 输出生成的HTML
?>

登录后复制

这段代码将生成一个包含所有产品标签链接的HTML结构。每个链接的href属性指向该标签的产品存档页，title属性提供了标签名称的提示，class属性则使用了标签的slug，方便进行CSS样式定制。

标小兔AI写标书

一款专业的标书AI代写平台，提供专业AI标书代写服务，安全、稳定、速度快，可满足各类招投标需求，标小兔，写标书，快如兔。

查看详情

从标签循环中排除特定标签

在某些情况下，您可能希望从生成的标签列表中排除一个或多个特定的标签。例如，您可能有一个内部使用的标签，或者某个标签不适合作为用户过滤的选项。这里提供两种实现方式：

方法一：使用 get_terms() 的 exclude 参数

get_terms()函数允许您通过exclude参数直接排除特定标签的ID。这是最推荐的方法，因为它在获取数据时就排除了，效率最高。

首先，您需要知道要排除标签的ID。您可以在WordPress后台的“产品” -> “标签”页面中，将鼠标悬停在标签名称上，浏览器左下角会显示链接，其中包含tag_ID=X，这里的X就是标签ID。

<?php
// 假设要排除的标签ID是 10 和 25
$exclude_tag_ids = array( 10, 25 ); 

$product_tags = get_terms( 'product_tag', array(
    'hide_empty' => true,
    'exclude'    => $exclude_tag_ids // 排除指定ID的标签
) );

$html = '';

if ( ! empty( $product_tags ) && ! is_wp_error( $product_tags ) ) {
    $html .= '<div class="filter-bar__tags-filter">';
    foreach ( $product_tags as $tag ) {
        $tag_link = get_tag_link( $tag->term_id );
        $html .= "<a href='" . esc_url( $tag_link ) . "' title='" . esc_attr( $tag->name ) . " Tag' class='" . esc_attr( $tag->slug ) . "'>" . esc_html( $tag->name ) . "</a>";
    }
    $html .= '</div>';
} else {
    $html .= '<p>目前没有可供筛选的产品标签。</p>';
}

echo $html;
?>

登录后复制

方法二：在 foreach 循环中进行条件判断

如果您无法或不希望在get_terms()阶段就排除标签（例如，您可能需要完整标签列表用于其他目的，只是在显示时排除），可以在foreach循环内部添加条件判断。这种方法可以基于标签ID、slug或名称进行排除。

<?php
$product_tags = get_terms( 'product_tag', array(
    'hide_empty' => true
) );

// 假设要排除的标签slug是 'internal-tag' 和 'deprecated-tag'
$exclude_tag_slugs = array( 'internal-tag', 'deprecated-tag' ); 
// 或者基于ID排除：$exclude_tag_ids = array( 10, 25 );

$html = '';

if ( ! empty( $product_tags ) && ! is_wp_error( $product_tags ) ) {
    $html .= '<div class="filter-bar__tags-filter">';
    foreach ( $product_tags as $tag ) {
        // 基于 slug 排除
        if ( in_array( $tag->slug, $exclude_tag_slugs ) ) {
            continue; // 跳过当前循环的剩余部分，进入下一个标签
        }

        // 如果是基于ID排除，可以使用：
        // if ( in_array( $tag->term_id, $exclude_tag_ids ) ) {
        //     continue;
        // }

        $tag_link = get_tag_link( $tag->term_id );
        $html .= "<a href='" . esc_url( $tag_link ) . "' title='" . esc_attr( $tag->name ) . " Tag' class='" . esc_attr( $tag->slug ) . "'>" . esc_html( $tag->name ) . "</a>";
    }
    $html .= '</div>';
} else {
    $html .= '<p>目前没有可供筛选的产品标签。</p>';
}

echo $html;
?>

登录后复制

这种方法提供了更大的灵活性，但如果标签数量非常大，可能会比方法一略微降低效率，因为所有标签都会先被获取。

注意事项

代码放置位置： 这些代码通常放置在您的主题文件（如functions.php、archive-product.php、sidebar.php或任何自定义模板文件）中。如果您希望在古腾堡编辑器中通过短代码使用，可以将其封装成一个短代码函数。
CSS 样式： 生成的HTML（<div class="filter-bar__tags-filter"> 和 <a> 标签）需要您通过CSS进行样式设计，以适应您的网站外观。
性能优化： 如果您的网站有成千上万个产品标签，并且此功能在每个页面都加载，考虑使用WordPress的Transients API来缓存get_terms的结果，以减少数据库查询次数，提升性能。
安全性： 在输出任何动态内容时，始终使用WordPress提供的安全函数（如esc_url()、esc_attr()、esc_html()）来防止XSS（跨站脚本攻击）等安全漏洞。本教程中的代码已遵循此最佳实践。

总结

通过本教程，您应该已经掌握了如何在WordPress和WooCommerce中获取所有产品标签，并构建一个自定义的、可用于产品过滤的标签列表。无论是简单的标签展示，还是需要排除特定标签的复杂场景，get_terms()函数结合适当的循环和条件判断，都能满足您的需求。合理利用这些技术，将有效提升您网站的用户体验和功能性。

以上就是WooCommerce 产品标签高级用法：自定义循环与特定标签排除的详细内容，更多请关注php中文网其它相关文章！