WooCommerce结账支付钩子问题：如何在结账页面支付方式区域上方添加<h3>payment</h3>标记并避免重复显示

嘿，我来帮你搞定这个重复显示的问题！你遇到的核心问题是：你修改的payment-method.php会为每个可用的支付方式单独渲染一次，所以你加的标题会跟着每个支付方式重复出现；而如果在checkout.php里的错误位置添加，也可能因为页面渲染逻辑导致重复。

下面给你两种靠谱的解决方式，优先推荐第一种（避免模板被主题更新覆盖）：

方法1：使用WooCommerce动作钩子（推荐） #

WooCommerce提供了专门的钩子，能让你在支付区域的最上方只渲染一次标题，完全不用修改模板文件。你只需要把这段代码添加到你的主题（子主题更稳妥）的functions.php文件里，或者自定义插件中：

add_action( 'woocommerce_checkout_before_payment', 'add_custom_payment_heading' );
function add_custom_payment_heading() {
    // 输出你想要的标题
    echo '<h3>payment</h3>';
}

为什么这个方法不会重复？ #

woocommerce_checkout_before_payment这个钩子只会在整个支付模块的最上方触发一次，不会随着支付方式的循环重复执行，完美解决重复问题。

方法2：修改模板文件（需注意主题更新） #

如果你一定要修改模板，那得找对正确的位置：

1. 把WooCommerce默认的woocommerce/checkout/payment.php文件复制到你的子主题对应目录（避免主题更新覆盖修改）
2. 打开这个文件，找到代码开头的这段：

<div id="payment" class="woocommerce-checkout-payment">
    <?php if ( WC()->cart->needs_payment() ) : ?>

3. 在<div id="payment"...>的下一行、<?php if ( WC()->cart->needs_payment() ) : ?>之前，添加你的标题：

<div id="payment" class="woocommerce-checkout-payment">
    <h3>payment</h3>
    <?php if ( WC()->cart->needs_payment() ) : ?>

为什么这个位置不会重复？ #

payment.php是整个支付区域的容器模板，这段代码在支付方式循环的外面，只会渲染一次，不会跟着每个支付方式重复输出。

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