求助：通过插件在WooCommerce结账页添加自定义按钮失败

你提供的代码逻辑本身是成立的，但按钮无法显示通常是以下几个原因导致，逐一排查即可：

1. 主题覆盖了结账模板 #

很多自定义主题会重写WooCommerce的结账模板文件（review-order.php），如果主题内的该文件没有保留woocommerce_review_order_before_submit钩子，你的代码就无法触发：

• 检查主题目录下的woocommerce/checkout/review-order.php文件，确认存在do_action( 'woocommerce_review_order_before_submit' );这行代码。
• 如果没有，要么修改主题模板添加该钩子，要么替换成主题支持的钩子，比如woocommerce_checkout_before_order_review（该钩子在订单预览区块前，也能实现类似位置效果）。

2. 缓存导致页面未更新 #

浏览器或网站缓存插件会让页面停留在旧版本：

• 按Ctrl+Shift+R（Chrome/Firefox）强制刷新页面。
• 暂时禁用网站的缓存插件（如WP Rocket、W3 Total Cache）后再刷新查看。

3. 插件冲突 #

其他WooCommerce相关插件可能修改了结账页面结构：

• 暂时禁用所有非WooCommerce的插件，仅保留WooCommerce，查看按钮是否显示。
• 若显示正常，再逐个启用插件，定位出冲突的插件后针对性处理。

4. 代码放置位置错误 #

确保代码放在正确的位置：

• 主题的functions.php文件末尾（注意不要破坏原有代码结构）。
• 或自定义插件的主文件内（如果是开发独立插件）。
• 不要直接放在模板文件里，否则钩子无法触发。

优化代码（避免JS绑定失效） #

你的JS代码可能存在DOM未加载完成就执行的问题，导致点击事件绑定失败，建议修改为以下方式：

原生JS版 #

function add_custom_button_before_place_order() {
    ?>
    <div style="margin-bottom: 20px;">
        <button type="button" class="button alt" id="customButton">My Custom Button</button>
    </div>
    <script type="text/javascript">
        document.addEventListener('DOMContentLoaded', function() {
            const customBtn = document.getElementById("customButton");
            if(customBtn) {
                customBtn.addEventListener('click', function() {
                    alert("Button clicked!");
                });
            }
        });
    </script>
    <?php
}
add_action('woocommerce_review_order_before_submit', 'add_custom_button_before_place_order');

jQuery版（WooCommerce默认加载jQuery） #

function add_custom_button_before_place_order() {
    ?>
    <div style="margin-bottom: 20px;">
        <button type="button" class="button alt" id="customButton">My Custom Button</button>
    </div>
    <script type="text/javascript">
        jQuery(document).ready(function($) {
            $('#customButton').on('click', function() {
                alert("Button clicked!");
            });
        });
    </script>
    <?php
}
add_action('woocommerce_review_order_before_submit', 'add_custom_button_before_place_order');

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