WooCommerce产品价格显示教程：正确获取与展示带货币符号的价格

2025-07-18

WooCommerce产品价格显示教程：正确获取与展示带货币符号的价格

本教程旨在指导用户如何在WooCommerce中正确、高效地显示产品价格，包括货币符号。我们将重点介绍使用wc_get_product获取产品对象后，通过get_price_html()方法来输出完整且兼容的价格信息，确保其能自动处理销售价、价格范围及未来更新。

在woocommerce开发中，经常需要将产品的价格信息展示在网站的各个位置，而不仅仅是产品详情页。对于非开发者而言，这似乎有些复杂，但实际上，woocommerce提供了一个非常简便且推荐的方法来完成此任务，即使用get_price_html()方法。

核心方法：使用 get_price_html() 显示产品价格

WooCommerce推荐使用WC_Product对象上的get_price_html()方法来获取并显示产品的价格信息。这个方法不仅会返回带有货币符号的价格，还会智能地处理销售价格、价格范围（针对可变产品）以及其他WooCommerce内置的价格显示逻辑。

获取产品对象：
首先，您需要通过产品的ID来获取对应的WC_Product对象。这可以通过wc_get_product()函数实现。

<?php
// 获取产品ID
// 如果您在产品循环中（例如在archive-product.php或single-product.php模板文件内），
// 可以使用WordPress的get_the_ID()函数获取当前产品的ID。
$product_id = get_the_ID();

// 如果您想显示特定ID的产品价格，可以直接指定ID，例如：
// $product_id = 123; // 替换为您的产品ID

// 通过产品ID获取产品对象
$_product = wc_get_product( $product_id );
?>

登录后复制

显示价格：
获取到产品对象$_product后，即可调用其get_price_html()方法来输出格式化的价格。

<?php
if ( $_product ) {
    echo '<span class="product-price">' . $_product->get_price_html() . '</span>';
} else {
    echo '产品未找到或ID无效。';
}
?>

登录后复制

将上述两部分代码结合起来，一个完整的显示产品价格的示例如下：

<?php
// 假设您想在某个自定义模板文件或函数中显示产品价格
// 请根据您的上下文确定如何获取 $product_id

// 示例1：在产品循环或产品详情页中获取当前产品ID
$product_id = get_the_ID(); 

// 示例2：如果您知道特定的产品ID
// $product_id = 456; // 替换为您要显示价格的实际产品ID

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

// 检查产品对象是否存在，以避免错误
if ( $_product ) {
    echo '<p>产品价格：' . $_product->get_price_html() . '</p>';
} else {
    echo '<p>无法获取产品信息，请检查产品ID是否正确。</p>';
}
?>

登录后复制

为什么推荐 get_price_html()？

完整性与格式化： get_price_html()方法会自动处理货币符号、千位分隔符、小数点等所有价格格式化细节，确保价格以用户熟悉的本地化格式显示。
智能处理销售价： 如果产品有销售价格，该方法会自动显示销售价格，并可能包含原价的划线显示（取决于主题和WooCommerce设置）。
兼容性与未来更新： 这是WooCommerce官方推荐的显示价格的方式，它确保了您的代码与WooCommerce未来的版本更新以及各种扩展插件的兼容性。
处理价格范围： 对于可变产品，get_price_html()能够智能地显示价格范围（例如“$10 – $50”），而无需您手动编写复杂的逻辑。

注意事项与最佳实践

避免直接使用 get_price() 等方法进行显示：$_product->get_price()、$_product->get_regular_price()、$_product->get_sale_price()等方法返回的是纯数字价格（不含货币符号和格式），它们主要用于后端计算或特定逻辑判断。直接在前端使用它们来显示价格会导致缺少货币符号和正确的格式。

错误示例（不推荐用于显示）：
```
// 这将只显示数字，没有货币符号和格式
echo $_product->get_price();
```
登录后复制
代码放置位置：
- 主题模板文件： 您可以将上述PHP代码片段插入到您的WordPress主题文件（例如functions.php，或WooCommerce的模板文件如single-product.php、archive-product.php等）中。
- 自定义插件或Shortcode： 为了更好的模块化和可维护性，建议将这类功能封装在一个自定义插件中，或者创建一个Shortcode，允许您在任何文章、页面或小工具中使用[your_shortcode_name id=”product_id”]的形式来显示价格。
Shortcode 示例：
在您的主题的functions.php文件或自定义插件中添加：
```
<?php
function custom_woocommerce_product_price_shortcode( $atts ) {
    $atts = shortcode_atts( array(
        'id' => 0, // 默认产品ID为0
    ), $atts, 'product_price' );

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

    if ( $product_id <= 0 ) {
        return '请提供有效的产品ID。';
    }

    $_product = wc_get_product( $product_id );

    if ( $_product ) {
        return '<span class="custom-product-price">' . $_product->get_price_html() . '</span>';
    } else {
        return '指定ID的产品未找到。';
    }
}
add_shortcode( 'product_price', 'custom_woocommerce_product_price_shortcode' );
?>
```
登录后复制
然后，您可以在WordPress编辑器中插入：[product_price id=”123″]来显示ID为123的产品的价格。
错误处理：
在调用$_product->get_price_html()之前，务必检查$_product是否成功获取到产品对象（即不为null或false），以防止因产品ID无效而导致的PHP错误。

总结

在WooCommerce中正确且兼容地显示带货币符号的产品价格，最推荐的方法是：首先使用wc_get_product()函数获取产品的WC_Product对象，然后调用该对象的get_price_html()方法。这种方法不仅能够自动处理价格格式、销售价和价格范围，还能确保代码的未来兼容性和可维护性，是实现WooCommerce产品价格显示功能的最佳实践。

以上就是WooCommerce产品价格显示教程：正确获取与展示带货币符号的价格的详细内容，更多请关注php中文网其它相关文章！

https://www.php.cn/faq/1415198.html