Primary

Gravity Forms

GRAVITYThis plugin integrates Gravity Forms with the Affiliates Enterprise plugin. Both  of them should be  installed and activated on your WordPress site. See the requirements and features based on Gravity Forms Add-Ons below for more details.

This extension allows to record referrals for form submissions and to create affiliate accounts for new users based on Gravity Forms.

Affiliates Registration

Sign up new users as affiliates when they register through a user registration form handled by Gravity Forms’ User Registration Add-On.

Form Settings - Affiliate Registration

With the User Registration Add-On enabled, forms that are enabled for user registration, can also be used to sign up new users as affiliates while they register.

Setup

After the extension has been activated, a new Affiliates section is available in the Form Settings tab of each form.

Affiliates Gravity Forms - Form Settings

User Registration and Affiliate Accounts

This section explains how to automatically create an affiliate account for a new user who registers via a form controlled by Gravity Forms.

You must have the User Registration Add-On for Gravity Forms installed and activated.

Form Settings - Affiliate Registration

Go to Forms > New Form to create a new form, add a Name and an Email field to the form. While editing the form, go to Form Settings > Affiliates and in the Affiliates Registration section, check Enabled for the Register an Affiliate Account setting and hit the Save button.

Go to Forms > User Registration to add the form. Now you can use the form on your site and when a new user registers, an affiliate account is created and associated with the user account.

Existing forms can have affiliate registration enabled as well, as long as they are enabled for user registration and the appropriate adjustments are made as explained above.

Referrals – Crediting Affiliates with Form Submissions

Affiliates who refer visitors to your site can be credited with referrals that are recorded when the visitor submits a form that is managed by Gravity Forms on your site. Referrals can also be recorded through Coupons if Gravity Forms Coupons Add-on is installed and activated. Referrals will be recorded on form submissions where a valid coupon is used. The referral will be granted to the affiliate who has this coupon code as attribute.

Such referrals can simply be recorded so that you know who was referred by whom, or you can also grant a commission (referral amount) to the affiliate. Such referral amounts can be fixed or based on payment or order amounts related to a form.

To enable referral recording for a form, go to Forms and edit the desired form, under Form Settings > Affiliates > Referral Settings check Enabled and hit the Save button.

Form Settings - Referral Settings

Review the settings and indications related to the Referral AmountReferral Rate and the Referral Base Amount. Make appropriate adjustments and test your forms after visiting a test affiliate’s link.

A form that provides a payment or order amount will result in a referral amount calculated based on the referral rate. This is overridden if an amount is set explicitly here. Form submissions without payment or order amounts can still create referrals with an amount if the amount has been specified here.

Form Settings - Referral Rate

The referral rate is used to calculate the referral amount based on the form’s payment or order amount. For example, if you want to grant 20% commissions on payments made through your form, indicate 0.2 as the referral rate. The referral rate will also apply if an amount has been set here.

Form Settings - Referral Base Amount

If you are using Affiliates Enterprise, the Base Amount option can be enabled to apply the general rate or specific rates for affiliates.

A note on taxes

Gravity Forms requires a specific way to include taxes. To exclude these taxes from the commission calculation, please install the free Affiliates Gravity Forms Tax Example plugin which allows to deduct a tax product field. Example usage for a tax field:

  • Add a product field to your form, we will assume that this field has Field ID 1, it’s Field Type is Single Product, it has a price and the quantity field is enabled.
  • Optionally add a Shipping field.
  • Add a Total field.
  • Add another product field to your form and name it Tax, use Field Type “Calculation”, disable its quantity field and use the following Formula to compute a 20% tax rate based on the product price and quantity: {Product Name (Quantity):1.3}*{Product Name (Price):1.2}*0.2

Referral Status

It is recommended to set the default referral status to Pending (under Affiliates > Settings). The referral status will be updated automatically depending on the payment Add-On that is used with the form.

Gravity Forms Add-On Integration Features
User Registration Create affiliate accounts for new users.
PayPal / Stripe Mark referrals as accepted after payment. Update referral status according to payment status, payment refunds mark referrals as rejected.
PayPal Pro Mark referrals as accepted after payment. Update referral status according to payment status, payment refunds mark referrals as rejected.
Authorize.net Mark referrals as accepted after payment.
  • Referral status updates for the PayPal Pro Add-On are supported, this is not supported for the PayPal Payments Pro Add-On.
  • Subscriptions are supported to a limited extent. No referrals are recorded for recurring payments.

Notification Tokens

With Affiliates Enterprise, notification tokens can be used to include submitted form data in the notification emails.

Each field in Gravity Forms has an integer ID (1, 2, 3 …) which is used to insert the field’s value or values submitted through the form.

To include a field’s value, indicate the field ID enclosed in angular brackets, for example, to include the value(s) of the field with ID 1, use : [1]

Example administrator notification message which includes tokens for values of several form fields – these settings are available with Affiliates Enterprise under Affiliates > Notifications:

Notification Tokens with Affiliates Gravity Forms