如何在函数内定位WooCommerce产品循环？

我尝试了以下代码且能正常运行，但不确定这种方式是否合理

相关文件路径：loop/price.php

用户代码：

<?php if ( $price_html = $product->get_price_html() ) : ?>
    <?php add_filter( 'woocommerce_format_sale_price', 'test_loop_price', 10, 3 );
    ?>
    <span class="price"><?php echo $price_html; ?></span>
<?php endif; ?>

结论：这种写法不合理，问题出在这几点： #

• 过滤器时机完全错误：你先调用get_price_html()生成了价格HTML，之后才添加过滤器。而get_price_html()内部已经完成了促销价格的格式化流程，这时候加的过滤器根本不会对当前的$price_html生效。你觉得能正常运行，要么是test_loop_price函数本身没修改价格内容，要么是之前已经有其他地方注册过这个过滤器。
• 存在全局污染风险：在模板里直接添加过滤器，这个过滤器会一直生效到页面加载结束。如果页面后续还有其他商品、购物车模块或者侧边栏商品推荐等需要格式化价格的内容，都会被这个过滤器影响，很容易出现意料之外的显示问题。

正确的两种做法： #

1. 全局注册+上下文判断（推荐）

把过滤器写到主题的functions.php或者自定义插件中，在过滤器函数里判断当前是否处于商品循环场景：

add_filter( 'woocommerce_format_sale_price', 'test_loop_price', 10, 3 );
function test_loop_price( $price, $regular_price, $sale_price ) {
    // 仅在商品列表页生效（可根据需求调整判断条件）
    if ( is_shop() || is_product_category() || is_product_tag() ) {
        // 这里写入你的自定义逻辑，比如修改价格显示样式
        $price = sprintf( '<del>原价：%s</del> <ins>促销价：%s</ins>', wc_price( $regular_price ), wc_price( $sale_price ) );
    }
    return $price;
}

2. 模板内临时添加+用完即删

如果一定要在模板文件中控制，必须遵循「先加过滤器→生成价格→移除过滤器」的顺序：

<?php if ( $product ) : ?>
    <?php 
    // 先注册过滤器
    add_filter( 'woocommerce_format_sale_price', 'test_loop_price', 10, 3 );
    // 再生成价格HTML
    $price_html = $product->get_price_html();
    // 立即移除过滤器，避免影响后续内容
    remove_filter( 'woocommerce_format_sale_price', 'test_loop_price', 10 );
    ?>
    <span class="price"><?php echo $price_html; ?></span>
<?php endif; ?>

内容的提问来源于stack exchange，提问作者Amir Vesal