WooCommerce：在单品页自定义显示特定商品属性-php教程-PHP中文网

WooCommerce：在单品页自定义显示特定商品属性

聖光之護

发布： 2025-07-03 21:02:11

原创

537人浏览过

WooCommerce：在单品页自定义显示特定商品属性

本教程旨在指导您如何在WooCommerce单品页面上自定义显示特定的商品属性。通过使用WordPress的add_action钩子和WooCommerce提供的产品数据方法，您可以灵活地选择并展示诸如尺寸、颜色等关键属性，从而提升用户体验和产品信息清晰度。文章将提供详细的代码示例和实现步骤，帮助您轻松扩展WooCommerce的默认功能。

在woocommerce中，商品属性通常会在产品描述下方或“附加信息”选项卡中显示。然而，在某些情况下，您可能希望将特定的、重要的商品属性（例如尺寸、颜色、材质等）直接显示在产品标题或价格附近，以便用户一目了然地获取关键信息。本教程将介绍如何通过自定义代码实现这一需求，并提供灵活的方案来添加任意数量的特定属性。

核心实现：代码示例与解析

要将特定商品属性显示在WooCommerce单品页的指定位置，我们可以利用WordPress的Action Hook机制。woocommerce_single_product_summary 是一个常用的钩子，允许我们在产品摘要区域插入自定义内容。

以下是实现此功能的代码示例：

add_action( 'woocommerce_single_product_summary', 'display_specific_product_attributes', 45 );

/**
 * 在WooCommerce单品页显示特定的商品属性。
 *
 * @return void
 */
function display_specific_product_attributes() {
    global $product; // 获取当前产品对象

    // 定义您希望显示的属性的分类法（taxonomy）名称。
    // 对于全局商品属性，通常以 'pa_' 开头。
    $attribute_taxonomies = array( 'pa_size', 'pa_color', 'pa_material' ); // 在此处添加更多属性

    // 遍历定义的每个属性
    foreach ( $attribute_taxonomies as $taxonomy_slug ) {
        // 获取当前产品的该属性值
        $attribute_value = $product->get_attribute( $taxonomy_slug );

        // 如果属性存在且有值，则进行显示
        if ( $attribute_value ) {
            // 获取属性的显示名称（标签）
            $taxonomy_object = get_taxonomy( $taxonomy_slug );
            $attribute_label = $taxonomy_object ? $taxonomy_object->labels->singular_name : ucwords( str_replace( 'pa_', '', $taxonomy_slug ) );

            // 输出属性名称和值
            echo '<p class="product-attribute-display">';
            echo '<strong>' . esc_html( $attribute_label ) . ':</strong> ' . esc_html( $attribute_value );
            echo '</p>';
        }
    }
}

登录后复制

代码解析：

add_action( 'woocommerce_single_product_summary', 'display_specific_product_attributes', 45 );
- add_action: 这是WordPress核心函数，用于将一个函数挂载到指定的动作钩子上。
- 'woocommerce_single_product_summary': 这是WooCommerce提供的一个动作钩子，它在单品页面的产品摘要部分（通常在产品标题、价格和简短描述之后）触发。
- 'display_specific_product_attributes': 这是我们自定义的函数名称，当钩子触发时，此函数将被执行。
- 45: 这是优先级参数。数字越小，函数执行得越早。默认优先级是10。这里设置为45，意味着它将在默认内容（如加入购物车按钮）之后，但可能在其他一些内容之前显示。您可以根据需要调整此值来改变显示位置。
function display_specific_product_attributes() { ... }
- 这是我们定义的核心功能函数。
global $product;
- 在WooCommerce的模板文件中，$product全局变量包含了当前显示的产品的所有数据。通过global $product;，我们可以在自定义函数中访问这个产品对象。
$attribute_taxonomies = array( 'pa_size', 'pa_color', 'pa_material' );
- 这是本教程最关键的部分。您需要在这里定义一个数组，其中包含您希望在页面上显示的商品属性的“分类法（taxonomy）名称”。
- 对于通过WooCommerce后台创建的“全局商品属性”，其分类法名称通常以pa_作为前缀，例如pa_size、pa_color。
- 如果您有自定义创建的属性，请确保使用其正确的分类法slug。
- 要添加更多属性，只需将它们的分类法slug添加到此数组中即可。
foreach ( $attribute_taxonomies as $taxonomy_slug ) { ... }
- 这段代码会遍历 $attribute_taxonomies 数组中的每一个属性slug。
$attribute_value = $product->get_attribute( $taxonomy_slug );
- $product->get_attribute() 是WooCommerce产品对象的一个方法，用于获取指定属性的当前产品值。它接收属性的分类法slug作为参数。
if ( $attribute_value ) { ... }
- 这是一个条件判断，确保只有当产品实际设置了该属性并且该属性有值时，才进行显示。
$taxonomy_object = get_taxonomy( $taxonomy_slug );
- get_taxonomy() 是WordPress函数，用于获取指定分类法（即属性）的详细信息对象。
$attribute_label = $taxonomy_object ? $taxonomy_object->labels->singular_name : ucwords( str_replace( 'pa_', '', $taxonomy_slug ) );
- 这行代码用于获取属性的“显示名称”（标签），而不是其内部的slug。
- $taxonomy_object->labels->singular_name 通常能获取到在WooCommerce后台设置的属性名称（例如，“尺寸”、“颜色”）。
- 如果某种原因未能获取到标签，则会回退到将pa_前缀移除并将首字母大写作为备用显示名称。
echo '
'; ... echo '
';
- 使用echo语句将属性的标签和值输出到HTML中。
- 这里使用了
  标签包裹，并添加了product-attribute-display CSS类，方便后续进行样式美化。
- esc_html() 用于对输出内容进行HTML实体转义，防止跨站脚本攻击（XSS），这是良好的安全实践。

如何应用代码

将上述代码添加到您的WordPress网站有几种常见方法：

子主题的 functions.php 文件（推荐） 这是最常见和推荐的方法。如果您正在使用子主题，请将代码添加到子主题的 functions.php 文件中。这样可以确保在主题更新时，您的自定义代码不会被覆盖。

自定义插件 对于更复杂的自定义或希望在不同主题之间重用代码的情况，创建一个简单的自定义插件是更好的选择。创建一个新的PHP文件（例如 my-custom-woocommerce-attributes.php），在文件顶部添加插件头注释，然后将代码粘贴进去，并激活该插件。

<?php
/**
 * Plugin Name: My Custom WooCommerce Attributes Display
 * Description: Displays specific product attributes on the single product page.
 * Version: 1.0
 * Author: Your Name
 */

// 上述代码从 add_action 到 function display_specific_product_attributes() 的所有内容粘贴到这里
add_action( 'woocommerce_single_product_summary', 'display_specific_product_attributes', 45 );

function display_specific_product_attributes() {
    global $product; 

    $attribute_taxonomies = array( 'pa_size', 'pa_color', 'pa_material' ); 

    foreach ( $attribute_taxonomies as $taxonomy_slug ) {
        $attribute_value = $product->get_attribute( $taxonomy_slug );

        if ( $attribute_value ) {
            $taxonomy_object = get_taxonomy( $taxonomy_slug );
            $attribute_label = $taxonomy_object ? $taxonomy_object->labels->singular_name : ucwords( str_replace( 'pa_', '', $taxonomy_slug ) );

            echo '<p class="product-attribute-display">';
            echo '<strong>' . esc_html( $attribute_label ) . ':</strong> ' . esc_html( $attribute_value );
            echo '</p>';
        }
    }
}

登录后复制

注意事项

属性Slug的准确性： 确保在 $attribute_taxonomies 数组中使用的属性slug是准确的。您可以在WooCommerce后台的“产品” -> “属性”页面查看每个属性的slug。
钩子位置的选择： woocommerce_single_product_summary 只是一个示例钩子。WooCommerce提供了许多钩子，您可以根据需要选择更合适的钩子来控制属性的显示位置。例如：
- woocommerce_before_single_product_summary：在产品摘要之前。
- woocommerce_after_single_product_summary：在产品摘要之后。
- woocommerce_single_product_meta：在产品元信息（SKU、分类、标签）附近。
- 调整 add_action 中的优先级参数也能微调显示顺序。

样式美化： 默认输出的HTML可能比较朴素。您可以使用CSS对 .product-attribute-display 类进行样式定义，以使其与您的网站设计更好地融合。例如：

/* 添加到您的主题自定义CSS或子主题的style.css */
.product-attribute-display {
    font-size: 1em;
    margin-bottom: 5px;
    color: #333;
}
.product-attribute-display strong {
    color: #000;
    margin-right: 5px;
}

登录后复制

性能考量： 对于大多数网站，这种方法对性能影响微乎其微。但如果您有数万个产品且每个产品都有大量属性需要显示，请确保您的服务器配置良好。

总结

通过上述代码和详细说明，您现在应该能够灵活地在WooCommerce单品页面上自定义显示您选择的任何商品属性。这种方法不仅提供了高度的灵活性，而且易于实现和维护，能够有效提升用户对产品关键信息的获取效率，从而优化整体购物体验。记住，始终在子主题或自定义插件中进行代码修改，以确保网站的稳定性和可维护性。

以上就是WooCommerce：在单品页自定义显示特定商品属性的详细内容，更多请关注php中文网其它相关文章！