本教程旨在指导开发者如何配置 Gravity Forms，使其在用户提交表单后自动生成 WooCommerce 优惠券。我们将详细介绍如何使用 `WC_Coupon` 类创建优惠券，并设置有效期、折扣类型和金额等参数，从而实现优惠券的自动化生成与发放，提升用户体验。
前提条件
- 已安装并激活 Gravity Forms 插件。
- 已安装并激活 WooCommerce 插件。
- 具备一定的 PHP 编程基础。
核心步骤
-
确定 Gravity Forms 表单 ID 和字段 ID
首先，你需要确定用于收集用户信息的 Gravity Forms 表单的 ID，以及用于存储优惠券代码的字段的 ID。这些 ID 将在后续代码中使用。
-
编写代码
将以下代码添加到你的 WordPress 主题的 functions.php 文件中，或者使用 Code Snippets 插件添加：
add_action( 'gform_after_submission', 'create_woocommerce_coupon', 10, 2 );
/**
* 在 Gravity Forms 提交后创建 WooCommerce 优惠券
*
* @param array $entry Gravity Forms 条目数据
* @param array $form Gravity Forms 表单数据
*/
function create_woocommerce_coupon( $entry, $form ) {
// 获取表单中优惠券代码字段的值
$coupon_code = rgar( $entry, 'coupon_code_field_id' ); // 将 'coupon_code_field_id' 替换为你的优惠券代码字段 ID
// 设置优惠券过期时间 (例如 14 天后)
$date_expires = date( 'Y-m-d', strtotime( '+14 days' ) );
// 设置优惠券折扣类型 (fixed_cart, percent, fixed_product)
$discount_type = 'fixed_cart';
// 设置优惠券折扣金额
$amount = 10; // 例如 10
// 创建 WC_Coupon 对象
$coupon = new WC_Coupon();
// 设置优惠券代码
$coupon->set_code( $coupon_code );
// 设置折扣类型
$coupon->set_discount_type( $discount_type );
// 设置折扣金额
$coupon->set_amount( $amount );
// 设置过期日期
$coupon->set_date_expires( $date_expires );
// 保存优惠券
$coupon->save();
}-
代码解释
- add_action( 'gform_after_submission', 'create_woocommerce_coupon', 10, 2 );：此行代码将 create_woocommerce_coupon 函数挂载到 gform_after_submission 动作钩子上，该钩子在 Gravity Forms 表单提交后触发。
- rgar( $entry, 'coupon_code_field_id' )：此函数从 Gravity Forms 条目数据中获取指定字段的值。请务必将 'coupon_code_field_id' 替换为你的表单中优惠券代码字段的实际 ID。
- date( 'Y-m-d', strtotime( '+14 days' ) )：此函数计算 14 天后的日期，并将其格式化为 Y-m-d 格式，以便 WooCommerce 能够正确解析。
- $coupon = new WC_Coupon();：此行代码创建了一个新的 WC_Coupon 对象，该对象用于创建和管理 WooCommerce 优惠券。
- $coupon->set_code( $coupon_code );：设置优惠券代码。
- $coupon->set_discount_type( $discount_type );：设置折扣类型，可以是 fixed_cart（固定购物车折扣）、percent（百分比折扣）或 fixed_product（固定产品折扣）。
- $coupon->set_amount( $amount );：设置折扣金额。
- $coupon->set_date_expires( $date_expires );：设置优惠券过期日期。
- $coupon->save();：保存优惠券到数据库。
高级配置
-
自定义优惠券代码生成
你可以使用自定义函数生成唯一的优惠券代码，而不是从 Gravity Forms 表单中获取。例如，你可以使用 uniqid() 函数生成一个唯一的 ID，并将其作为优惠券代码。
function generate_unique_coupon_code() { return 'UNIQUE-' . uniqid(); }然后，在 create_woocommerce_coupon 函数中使用该函数：
$coupon_code = generate_unique_coupon_code();
-
添加其他优惠券属性
WC_Coupon 类提供了许多其他方法来设置优惠券的属性，例如：
- set_usage_limit( $limit )：设置优惠券的使用次数限制。
- set_individual_use( $individual_use )：设置优惠券是否只能单独使用。
- set_product_ids( $product_ids )：设置优惠券可以应用于哪些产品。
- set_exclude_product_ids( $exclude_product_ids )：设置优惠券不能应用于哪些产品。
你可以根据需要使用这些方法来配置你的优惠券。
注意事项
- 安全性：确保你的优惠券代码生成逻辑是安全的，避免生成容易被猜测的优惠券代码。
- 错误处理：添加适当的错误处理机制，以便在创建优惠券失败时能够及时发现并处理。
- 测试：在生产环境中使用之前，务必进行充分的测试，确保代码能够正常工作。
总结
通过本教程，你已经学会了如何使用 Gravity Forms 提交后自动生成 WooCommerce 优惠券。你可以根据自己的需求自定义优惠券的属性和生成逻辑，从而实现更灵活的优惠券管理。记住，安全性、错误处理和测试是确保代码质量的关键。
