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

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

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

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

1. 获取产品对象： 首先，您需要通过产品的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 ); ?>

   登录后复制

2. 显示价格： 获取到产品对象$_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”），而无需您手动编写复杂的逻辑。

注意事项与最佳实践

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

   错误示例（不推荐用于显示）：

   // 这将只显示数字，没有货币符号和格式 echo $_product->get_price();

   登录后复制

2. 代码放置位置：

   • 主题模板文件： 您可以将上述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的产品的价格。

3. 错误处理： 在调用$_product->get_price_html()之前，务必检查$_product是否成功获取到产品对象（即不为null或false），以防止因产品ID无效而导致的PHP错误。

总结

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

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