本教程详细介绍了如何通过WooCommerce的钩子（Hooks）功能，灵活调整结账页面上优惠券表单的显示位置。文章将指导您如何移除默认位置的优惠券表单，并将其重新放置到如订单详情下方等指定区域，确保优惠券功能正常运作的同时优化用户结账体验。
引言：优化结账体验
在woocommerce商店中，优惠券是促进销售和提升用户满意度的重要工具。默认情况下，woocommerce的优惠券输入表单通常显示在结账页面的顶部，位于账单信息之前。然而，为了提供更流畅、更符合用户习惯的结账流程，许多商店所有者希望将优惠券表单移动到结账页面的其他位置，例如订单详情下方或支付区域之前。本教程将介绍一种标准且有效的方法，通过woocommerce的动作钩子（action hooks）来实现这一目标，确保功能完整且兼容性良好。
核心原理：移除与重置
WooCommerce的许多核心功能都是通过动作钩子来挂载的。优惠券表单的显示也不例外。默认情况下，WooCommerce通过woocommerce_checkout_coupon_form函数被挂载到woocommerce_before_checkout_form钩子上，使其在结账表单顶部显示。
要改变优惠券表单的位置，核心思路是：
- 移除默认动作： 使用remove_action函数将woocommerce_checkout_coupon_form函数从其默认的woocommerce_before_checkout_form钩子上移除。
- 添加新动作： 使用add_action函数将woocommerce_checkout_coupon_form函数重新挂载到您希望显示表单的新的动作钩子上。
这种方法的好处是，我们不是创建自定义的优惠券表单，而是复用WooCommerce内置的、经过充分测试的表单功能，从而避免了可能出现的POST请求失败或其他兼容性问题。
操作步骤：代码实现
所有代码都应放置在您主题的functions.php文件或一个自定义插件中。强烈建议使用子主题的functions.php文件，以确保主题更新时您的修改不会丢失。
1. 移除默认位置的优惠券表单
首先，我们需要阻止优惠券表单在结账页面的默认位置（即结账表单顶部）显示。这通过以下代码实现：
<?php /** * 移除WooCommerce结账页默认位置的优惠券表单 */ remove_action('woocommerce_before_checkout_form', 'woocommerce_checkout_coupon_form', 10); ?>
- remove_action(): 这是WordPress和WooCommerce用于移除已注册动作的函数。
- woocommerce_before_checkout_form: 这是优惠券表单默认被挂载到的钩子。
- woocommerce_checkout_coupon_form: 这是WooCommerce用于渲染优惠券表单的函数。
- 10: 这是该动作的优先级。在移除动作时，优先级必须与添加时保持一致。
2. 在指定位置重新添加优惠券表单
接下来，我们将优惠券表单添加到您希望显示的新位置。以将其放置在“订单详情”区域之后为例，我们可以使用woocommerce_checkout_order_review钩子。
<?php /** * 在订单详情之后重新添加WooCommerce优惠券表单 */ add_action('woocommerce_checkout_order_review', 'woocommerce_checkout_coupon_form', 5); ?>
- add_action(): 用于将函数挂载到指定的动作钩子上。
- woocommerce_checkout_order_review: 这是在订单详情（Order Review）部分之后触发的钩子。
- woocommerce_checkout_coupon_form: 同样，我们复用WooCommerce原生的优惠券表单渲染函数。
- 5: 这是新动作的优先级。较低的数字表示较高的优先级，这意味着它会更早执行。在这里，我们将其设置为5，以确保它在订单详情的其他内容之前或之后（取决于具体内容）正确显示。您可以根据需要调整此优先级。
3. 完整代码示例
将上述两段代码合并，并放置到您的子主题的functions.php文件中，即可实现优惠券表单的移动：
<?php /** * WooCommerce结账页优惠券表单位置调整 * 将优惠券表单从结账页顶部移动到订单详情下方 */ // 1. 移除WooCommerce结账页默认位置的优惠券表单 remove_action('woocommerce_before_checkout_form', 'woocommerce_checkout_coupon_form', 10); // 2. 在订单详情之后重新添加WooCommerce优惠券表单 // 您可以根据需要选择其他钩子，例如： // woocommerce_after_checkout_billing_form (账单信息后) // woocommerce_after_checkout_shipping_form (配送信息后) // woocommerce_review_order_after_submit (提交订单按钮前) add_action('woocommerce_checkout_order_review', 'woocommerce_checkout_coupon_form', 5); ?>
注意事项
- 子主题优先： 务必将代码添加到您的子主题的functions.php文件中。直接修改父主题的文件会在主题更新时被覆盖。
- 钩子选择： woocommerce_checkout_order_review只是一个示例钩子。WooCommerce结账页面提供了许多不同的钩子，您可以根据实际需求选择最合适的钩子来放置优惠券表单。常用的结账页钩子包括：
- woocommerce_before_checkout_form
- woocommerce_after_checkout_form
- woocommerce_checkout_before_customer_details
- woocommerce_checkout_after_customer_details
- woocommerce_before_checkout_billing_form
- woocommerce_after_checkout_billing_form
- woocommerce_before_checkout_shipping_form
- woocommerce_after_checkout_shipping_form
- woocommerce_before_order_notes
- woocommerce_after_order_notes
- woocommerce_review_order_before_payment
- woocommerce_review_order_after_payment
- woocommerce_checkout_order_review
- woocommerce_review_order_before_submit
- woocommerce_review_order_after_submit 建议通过WooCommerce的开发者文档或使用wordpress插件（如”Simply Show Hooks”）来查找和测试不同的钩子位置。
- 优先级调整： add_action函数中的第三个参数是优先级。调整此值可以改变表单相对于同一钩子上的其他元素的显示顺序。
- 测试： 修改代码后，务必在不同的浏览器和设备上测试结账流程，确保优惠券功能正常，表单显示无误。
- 避免自定义表单： 如果您遇到自定义表单无法发送POST请求的问题，很可能是因为您尝试自己构建优惠券输入表单，而不是复用WooCommerce内置的woocommerce_checkout_coupon_form函数。WooCommerce的优惠券处理逻辑依赖于其内部函数和特定的html结构，直接构建的表单可能无法正确触发这些逻辑。本文提供的方法正是通过复用原生函数来解决此问题。
总结
通过简单地移除WooCommerce默认的优惠券表单动作并将其重新挂载到新的钩子上，我们可以轻松地调整结账页面上优惠券表单的位置。这种方法既保持了WooCommerce核心功能的完整性，又提供了足够的灵活性来优化用户体验，使您的商店结账流程更加直观和高效。请根据您的具体需求选择合适的钩子，并始终在子主题中进行修改。
