使用 Gravity Forms 提交后自动生成 WooCommerce 优惠券

本教程旨在指导开发者如何配置 Gravity Forms，使其在用户提交表单后自动生成 WooCommerce 优惠券。我们将详细介绍如何使用 `WC_Coupon` 类创建优惠券，并设置有效期、折扣类型和金额等参数，从而实现优惠券的自动化生成与发放，提升用户体验。

前提条件

• 已安装并激活 Gravity Forms 插件。
• 已安装并激活 WooCommerce 插件。
• 具备一定的 PHP 编程基础。

核心步骤

1. 确定 Gravity Forms 表单 ID 和字段 ID

   首先，你需要确定用于收集用户信息的 Gravity Forms 表单的 ID，以及用于存储优惠券代码的字段的 ID。这些 ID 将在后续代码中使用。

2. 编写代码

   将以下代码添加到你的 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();
}

3. 代码解释

   • 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();：保存优惠券到数据库。

高级配置

• 自定义优惠券代码生成

  

  Cursor

  一个新的IDE，使用AI来帮助您重构、理解、调试和编写代码。

  下载

  你可以使用自定义函数生成唯一的优惠券代码，而不是从 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 优惠券。你可以根据自己的需求自定义优惠券的属性和生成逻辑，从而实现更灵活的优惠券管理。记住，安全性、错误处理和测试是确保代码质量的关键。