如何在WooCommerce中正确显示产品价格（含货币符号）-php教程-PHP中文网

如何在WooCommerce中正确显示产品价格（含货币符号）

DDD

发布： 2025-07-18 20:26:11

原创

1025人浏览过

如何在WooCommerce中正确显示产品价格（含货币符号）

本教程详细介绍了在WooCommerce中安全、高效地显示产品价格（包含货币符号）的方法。核心在于利用wc_get_product()获取产品对象，并调用其get_price_html()方法。这种方式不仅能自动处理货币符号、销售价格和价格范围，还能确保代码与未来WooCommerce更新的兼容性，避免直接获取价格后手动拼接的繁琐和潜在问题。

在woocommerce开发中，我们经常需要在网站的特定位置（如自定义模板、页面内容或短代码输出）显示产品的价格，并且要求价格包含正确的货币符号、考虑销售价格、甚至显示价格范围。直接获取原始价格数据（如get_regular_price()或get_sale_price()）并手动拼接货币符号，不仅繁琐，而且可能无法正确处理销售价格的显示逻辑，也缺乏对未来woocommerce更新的兼容性。

核心方法：使用 get_price_html()

WooCommerce提供了一个专门用于显示格式化产品价格的函数：get_price_html()。这个方法是产品对象的一个成员函数，它返回一个包含完整HTML标记的价格字符串，该字符串已自动包含货币符号、处理了销售价格（显示原价和折扣价）、以及复杂产品类型的价格范围（如可变产品）。

使用get_price_html()的优势在于：

自动化处理货币符号： 无需手动添加。
智能处理销售价格： 当产品处于销售状态时，它会自动显示原价和销售价，并以WooCommerce默认的样式呈现。
兼容性强： 它是WooCommerce官方推荐的显示价格方式，能够很好地适应未来的更新和扩展。
简化开发： 开发者无需关心价格的格式化细节。

获取产品对象

在调用get_price_html()之前，我们首先需要获取一个WooCommerce产品对象。这通常通过wc_get_product()函数实现，该函数接受产品ID作为参数。

$product = wc_get_product( $product_id );

登录后复制

这里的$product_id是您想要显示价格的产品的唯一ID。在不同的上下文中，获取$product_id的方式可能不同：

在WooCommerce产品循环中： 如果您在WooCommerce的产品归档页面、商店页面或自定义产品列表模板中，$product_id通常可以通过get_the_ID()或global $post来获取当前循环中的产品ID。
已知产品ID： 如果您知道具体的产品ID（例如，在自定义短代码或特定页面中硬编码），可以直接使用该ID。

完整示例代码

以下是几种常见场景下如何使用get_price_html()显示产品价格的示例：

示例一：显示特定产品ID的价格

如果您知道一个产品的ID，并希望在网站的任何位置显示其价格，可以使用以下代码：

TapNow

新一代AI视觉创作引擎

115

查看详情

<?php
// 替换为您要显示价格的实际产品ID
$product_id = 123; // 例如，ID为123的产品

// 获取产品对象
$product = wc_get_product( $product_id );

// 检查产品是否存在
if ( $product ) {
    // 输出格式化的产品价格（包含货币符号和HTML）
    echo $product->get_price_html();
} else {
    echo '产品未找到。';
}
?>

登录后复制

示例二：在WooCommerce产品循环中显示价格

当您在WooCommerce的循环中（例如，在自定义的content-product.php模板或自定义查询结果中）时，可以直接获取当前产品对象并显示其价格：

<?php
// 确保您处于WooCommerce产品循环中
// 例如，在 loop-start.php 和 loop-end.php 之间
// 或者在自定义 WP_Query 循环中
global $product; // 获取当前循环中的产品全局变量

// 检查 $product 是否有效
if ( $product ) {
    // 输出当前产品的格式化价格
    echo $product->get_price_html();
}
?>

登录后复制

示例三：通过短代码在文章或页面中显示价格

如果您想在WordPress的文章或页面内容中通过短代码显示产品价格，可以在主题的functions.php文件中添加以下代码：

<?php
function display_product_price_shortcode( $atts ) {
    // 定义短代码属性，允许用户指定产品ID
    $atts = shortcode_atts( array(
        'id' => 0, // 默认产品ID为0
    ), $atts, 'product_price' );

    $product_id = intval( $atts['id'] );

    if ( $product_id > 0 ) {
        $product = wc_get_product( $product_id );

        if ( $product ) {
            return $product->get_price_html();
        }
    }
    return '产品ID无效或未找到。';
}
add_shortcode( 'product_price', 'display_product_price_shortcode' );
?>

登录后复制

然后，您可以在文章或页面中使用[product_price id="123"]这样的短代码来显示ID为123的产品的价格。

注意事项与最佳实践

代码放置位置： 上述PHP代码通常放置在WordPress主题的functions.php文件、自定义插件中，或直接在自定义的WooCommerce模板文件中。避免直接修改WooCommerce核心文件，以确保更新兼容性。
安全性： 在接收用户输入（如短代码中的ID）时，务必进行数据验证和清理（如intval()），以防止潜在的安全问题。
性能考量： 如果您需要在同一页面上多次显示同一个产品的价格，建议只获取一次产品对象，然后重复使用该对象调用get_price_html()，以优化性能。
输出类型： get_price_html()返回的是包含HTML标签的字符串，因此在输出时通常直接使用echo。WooCommerce会为这些HTML元素添加特定的CSS类，您可以利用这些类来进一步自定义价格的显示样式。
上下文感知： get_price_html()会根据WooCommerce的设置（如是否含税、价格显示格式等）自动调整输出，确保价格显示的准确性。

总结

在WooCommerce中显示产品价格时，强烈推荐使用wc_get_product()获取产品对象，并调用其get_price_html()方法。这种方法是WooCommerce官方推荐且最健壮的方式，它不仅能自动处理货币符号、销售价格和价格范围的复杂逻辑，还能确保您的代码与WooCommerce未来的更新保持兼容性，从而大大简化开发工作并提升用户体验。通过遵循本教程中的指导和示例，您可以轻松地在网站的任何位置准确且专业地显示产品价格。

以上就是如何在WooCommerce中正确显示产品价格（含货币符号）的详细内容，更多请关注php中文网其它相关文章！