詩語，作者 Gravity Forms 文件

Where』s that old forum topic?

Gravity Forms Official Help ChannelsAdditional Help ChannelsSome Third Party Gravity Forms ResourcesOther Q&A ChannelsWordPressAdvanced Custom FieldsBuddyPressWooCommerceWPMLCustomizations

In July 2013 we moved from forum based support to a ticket based system, with the forums remaining read-only for reference. Since that time we have released more than dozens updates for Gravity Forms, many new add-ons, and numerous add-on updates.
All these updates do sadly mean that a lot of the information contained in the forums is now extremely dated and, in some cases, can cause more trouble than it』s worth. Also, since the demise of pastie.org many of the code snippets shared in the forums have also been lost.
For these reasons we phased out the forums soon after introducing our customer support ticketing system.
In 2018 though, we did introduce a community hub at the request of our dedicated advocates, our Community Forum. This is not an official support channel, but offers community-to-community conversation with folks who may have solved the problem you are faced with now!
Gravity Forms Official Help Channels

Gravity Forms Support is staffed by our knowledgeable support engineers from around the world, and available to Gravity Forms valid license holders.
Search the Gravity Forms documentation at https://docs.gravityforms.com/
Ask your question on our Community Forum. This is not an official support channel, but offers community-to-community conversation with folks who may have already solved the problem you are faced with now!

Additional Help Channels
These forums and channels are not endorsed or supported by us in any official capacity, but are well established places that may help you on your search.
Some Third Party Gravity Forms Resources

Gravity Wiz for tutorials, code snippets, and add-ons (Gravity Perks)
GravityWP for tutorials, code snippets, add-ons, and add-on reviews
Gravity+ for tutorials and add-ons
Gravity Extend add-on directory and tutorials
The Gravity Forms, GravityView and Gravity Perks Users Facebook Group (unofficial)
The Gravity Forms Development Facebook Group (unofficial)
The Gravity Forms Slack Workspace (unofficial)
Search our library of third party plug-ins, which can be found here

Other Q&A Channels
The following resources are not specific to Gravity Forms but can help with more general topics. Search or ask a question at:

WordPress Development Stack Exchange
Stack Overflow
Quora
WP Help Forum
CSS-Tricks Help Forums

WordPress

Search the WordPress developer documentation at https://developer.wordpress.org/
Search the WordPress support forums or ask a question at https://wordpress.org/support/

Advanced Custom Fields

Search the ACF documentation at https://www.advancedcustomfields.com/resources/
Search the ACF support forums at https://support.advancedcustomfields.com/
The WordPress ACF Users Facebook Group

BuddyPress

Search the BuddyPress documentation at https://codex.buddypress.org/
Search the BuddyPress support forums at https://buddypress.org/support/

WooCommerce

Search the WooCommerce documentation at https://docs.woocommerce.com/
Search the WooCommerce support forums at https://wordpress.org/support/plugin/woocommerce
The Advanced WooCommerce Facebook Group
The WooCommerce Help & Share Facebook Group

WPML

Search the WPML documentation at https://wpml.org/documentation/
Search the WPML forums at https://wpml.org/forums/

Customizations
We are unable to provide customization services as part of our customer support. That is just not what we do. But we have partnered with Codeable to provide Gravity Forms customization services. They can help pair you with a developer based on your needs and budget. You can get started with Codeable here.

Which PayPal Add-On should I use?

IntroductionPayPal CheckoutLegacy PayPal Add-OnsUsing More Than OneOne-time paymentsRecurring payments

Notice: The Gravity Forms PayPal Commerce Platform Add-On has been renamed PayPal Checkout as of version 2.0.
Introduction
With multiple APIs evolutions and various service interactions, PayPal add-ons have had to evolve, and fork, over the last 10 years of Gravity Forms. This makes the question of 「which should I use?」 a little trickier than most add-ons. We have put together this guide to try and help you with that question.
PayPal Checkout
In most cases, the PayPal Checkout Add-On is what you should use. It is the most up to date, uses the most current PayPal service API, and is the future home of most new functionality as we roll all previous add-on functions into this add-on.
Eventually, this will be the recommended add-on for all use cases, but at this time, PayPal』s Checkout service (previously known as PayPal Commerce Platform) is not available in all markets, so the legacy add-ons do still have a few specific use-cases, as described below.
Legacy PayPal Add-Ons
We classify our PayPal Standard, PayPal Pro, and PayPal Payments Pro Add-Ons as 「legacy」, meaning they have been retired but are not end of life yet. The API』s they rely on have been deprecated by PayPal, so future operation is not guaranteed, though PayPal have not specified any termination dates for these services yet.
We still support these add-ons for now, but no new functionality is expected. Any future releases will purely be for required security or bug fix updates. We will eventually stop all support and development for all the retired add-ons, but at this time there is no official date for when this retirement process will begin. Keep an our on our blog for announcements.
Using More Than One
Multiple add-ons can be used with the same form as long as the PayPal/Credit Card fields and payment add-on feeds have conditional logic configured on them. See the Setting Up Conditional Payments in Gravity Forms article for an example.
One-time payments
One-time payments include products, services, and donations.

Feature
Recommended Add-On

Credit Card Field1 (PayPal Field)
PayPal Checkout Add-On

Credit Card Field (legacy)
PayPal Payments Pro Add-On

PayPal Checkout (PayPal Field)
PayPal Checkout Add-On

PayPal Checkout (legacy)
PayPal Standard Add-On

Venmo (PayPal Field)
PayPal Checkout Add-On

SEPA-Lastschrift (PayPal Field)
PayPal Checkout Add-On

Bancontact (PayPal Field)
PayPal Checkout Add-On

eps (PayPal Field)
PayPal Checkout Add-On

giropay (PayPal Field)
PayPal Checkout Add-On

iDEAL (PayPal Field)
PayPal Checkout Add-On

MyBank (PayPal Field)
PayPal Checkout Add-On

Przelewy24 (PayPal Field)
PayPal Checkout Add-On

Simple PCI Compliance
PayPal Checkout Add-On

Strong Customer Authentication (SCA/PSD2)
PayPal Checkout Add-On

Recurring payments
Recurring payments include subscriptions and donations.

Feature
Recommended Add-On

Credit Card Field (deprecated)
PayPal Payments Pro Add-On

PayPal Checkout (PayPal Field)
PayPal Checkout Add-On

PayPal Checkout (legacy)
PayPal Standard Add-On

Simple PCI Compliance
PayPal Checkout Add-On

Strong Customer Authentication (SCA/PSD2)
PayPal Checkout Add-On

Credit Card Field support is currently in limited release on the PayPal Checkout (aka PayPal Commerce) platform.

Why did the Stripe Feed Subscription Name Change?

With Gravity Forms Stripe Add-On version 3.7.2 and greater you may occasionally notice the value of the Subscription Name setting on your Stripe feed changes to include additional numbers and underscores.
This can happen when the add-on finds a plan already exists in Stripe with an ID that matches the current feed configuration and one of the following scenarios is encountered:

The plan amount does not match the submission amount
The plan currency code does not match the submission currency code
The plan billing cycle does not match the feed billing cycle

When the add-on determines the existing plan is not suitable for the submission being processed it appends the current date and time formatted with underscores (e.g. _2020_07_29_10_27_39) to the feed Subscription Name and updates the feed in the database. It then creates a new plan in Stripe based on the updated feed configuration. This change ensures that the customer is billed correctly.

WordPress, Gravity Forms, and GDPR Compliance

What Is GDPR?What Tools Can Help Me With Gravity Forms and GDPR Compliance?Collecting ConsentData RequestsGDPR PluginsFurther Questions and Answers Related To Personal DataCan I prevent the IP address being saved in the entry?Can I encrypt the field values before they are saved to the entry?Can I prevent Gravity Forms saving the entries to the database?Can the user view or edit their own submissions?Are the entries sent to gravityforms.com or other related domains?Does Gravity Forms set any cookies?

What Is GDPR?

On May 25, 2018, new regulations went into place within the European Union (EU) regarding treatment of customer data, known as General Data Protection Regulations (GDPR). There are many references available online, you can find one such overview here. We are not going to try and explain the implications or the interpretation of what is required, that is the realm of lawyers and consultants, but we do want to highlight some WordPress and Gravity Forms related tools that may be of interest here.

What Tools Can Help Me With Gravity Forms and GDPR Compliance?

Once again, we』re not lawyers so you』ll want to confirm this with a legal counsel or a subject matter expert as to what compliance means for you, but some of the following tools may prove useful.

Collecting Consent

Gravity Forms 2.4 introduced a Consent field amongst the Advanced Field types. You can review the field here.

If you are also using a feed based add-on with your form, such as MailChimp, you can configure conditional logic on the feed so it will only be processed if the user has checked a consent field. See the MailChimp Conditional List Subscriptions article for more details.

Data Requests

WordPress has added the Export Personal Data and Erase Personal Data tools. As of Gravity Forms 2.4, a new Personal Data tab has been added to the Form Settings to provide integration with these tools. See the article Personal Data Settings for more details.

GDPR Plugins

The following third-party plugins can help with GDPR compliance, and they have integrations for Gravity Forms:

WP GDPR Compliance by Van OnsThe GDPR Framework by Data443 Risk Mitigation, Inc. They also maintain an additional plugin for CCPA (California Consumer Privacy Act), CCPA FrameworkDouble Opt In for Gravity Forms by Albert Brückmann

Further Questions and Answers Related To Personal Data

Can I prevent the IP address being saved in the entry?

Yes. As of Gravity Forms 2.4, the new Personal Data tab on the Form Settings provides several settings to control which data is saved. Preventing the storage of IP Addresses is a checkbox option there. See the article Personal Data Settings for more details.

Can I encrypt the field values before they are saved to the entry?

We recommend the using the Encrypted Fields add-on by PluginOwl to configure encryption of the field values.

Can I prevent Gravity Forms saving the entries to the database?

It』s important to note that GDPR does not prohibit saving of personal data to the database, it just requires that you to gain consent before doing so.

While you can』t currently prevent Gravity Forms saving the entries you can use custom code or a third-party add-on to delete them during submission, after the notifications and add-on feeds are processed.

With Gravity Forms 2.4, you can set a Retention Policy to Retain, Trash, or Delete entries for a set number of days. This is available in the Personal Data tab in the Form Settings. On the Personal Data tab, you may also integrate with the WordPress Erase Personal Data tool and control what data is erased from the entry. See the article Personal Data Settings for more details.

Can the user view or edit their own submissions?

Allowing the user to view or edit their own submissions is not a built-in feature of Gravity Forms but is made possible by third-party add-ons such as GravityView by Katz Web Services, Inc..

As of Gravity Forms 2.4, the Personal Data tab of Form Settings allows you to integrate with the WordPress Export Personal Data tool and export chosen entry data to the customer.

Are the entries sent to gravityforms.com or other related domains?

No. Form submissions (entries) are saved to your sites WordPress database. The data would only leave your site if you configure a notification email or another add-on yourself to send it elsewhere.

Does Gravity Forms set any cookies?

Gravity Forms does not set any cookies on the front-end of the site. It does set a cookie on the entry detail page in the admin when an admin views the entry and checks the show empty fields checkbox, that cookie is named gf_display_empty_fields.

Creating Columns in the Form Editor

IntroductionDrag And dropDrag and Drop Not Working?Column Drop ZonesRow Drop ZonesDragging Fields to Create ColumnsResize Columns using Column HandlesKnown Issues or Limitations

Introduction

In this article, we』ll demonstrate how to work with columns in the Form Editor in the Gravity Forms 2.5. With this new streamlined release of the form editor, you create rows and columns of fields simply by dragging and dropping fields into the form editor:

Drag And drop

Fields can be placed on your form using drag and drop actions. Where you drag and drop determines how the columns will be created. We call the destination area that you release at the end of a drag action a 「drop zone」.

Drag and Drop Not Working?

Drag and drop column control is only available to forms using Gravity Forms 2.5 standard markup. If you are using legacy markup, or using an older Gravity Forms version, then features like drag and drop will not be available.

If you wish to change to using the standard markup, you will need to disabling the Enable legacy markup toggle, found within the Form Settings → Form Options

Column Drop Zones

To create multiple columns of fields, drag fields into the Column Drop Zones to the left or right of existing fields in the editor.

Row Drop Zones

To create multiple rows of fields, drag fields into the Row Drop Zones to the top and bottom of an existing row of fields in the editor.

Dragging Fields to Create Columns

To create columns in the editor, drag and drop fields directly into a column drop zone and the editor will automatically add the column and re-size existing fields.

Select the Field in the editorGrab the Field HandleDrag the Field over the Column Drop ZoneDrop the Field and the Columns will automatically adjust

Resize Columns using Column Handles

To resize existing columns in the editor, use Column Handles to shrink or enlarge the width of a column.

Select the Field in the editorGrab the Column Handle to the right of the field, the Active Column HandleDrag left to shrink the column widthDrag right to enlarge the column width

Known Issues or Limitations

There is a maximum of 4 resizable columns. You cannot create a fifth.Columns are not supported on forms with legacy markup enabled.The field types of Page Break, Section Break, & Hidden cannot be placed in columns.

wp_rg_form_view

「wp_rg_form_view」 refers to the form view database table used by Gravity Forms. The table is named using your site』s database prefix (「wp」 is the default) plus 「rg_form_view」.
Note: Once Gravity Forms version 2.3 is released, the table will have the new name 「wp_gf_form_view」.
Further details for this table can be found viewing the Database Storage Structure Reference document for Gravity Forms version 2.3.

WP-CLI Tools

Clearing TransientsExamplesEmptying TrashExamplesParametersVerifying ChecksumsExamplesParametersGetting the System ReportExamplesRunning the database setup

This article includes a few extra commands which are available with the CLI Add-On for Gravity Forms.
Clearing Transients
wp gf tool clear_transients
wp gf tool clear-transients
Clears the Gravity Forms transients.
Examples
123# Successful clearing of the transients.$ wp gf tool clear-transientsSuccess: Gravity Forms transients cleared successfully.
123# Failed clearing of the transients.$ wp gf tool clear_transientsError: There was a problem clearing the Gravity Forms transients.
Emptying Trash
wp gf tool empty_trash
wp gf tool empty-trash
Delete the trashed entries.
Examples
123# Successful deletion of trashed entries for all forms.$ wp gf tool empty-trashSuccess: Trash emptied successfully for all forms.
123# Successful deletion of trashed entries for a specific form.$ wp gf tool empty-trash 2Success: Trash emptied successfully for form ID 2
Parameters

Argument
Description

[]
The ID of the form to delete the entries from. Default: all forms.

Verifying Checksums
wp gf tool verify_checksums
wp gf tool verify-checksums
Verify the Gravity Forms plugin files against the checksums.
Examples
123# Successful verification of the plugin checksums.$ wp gf tool verify-checksumsSuccess: Gravity Forms install verifies against checksums.
1234# Failed checksum verification.$ wp gf tool verify-checksumsWarning: File doesn't exist: css/admin.min.cssError: Gravity Forms install doesn't verify against checksums.
Parameters

Argument
Description

[--version=]
The version number the checksums should be validated against.

Getting the System Report
wp gf tool system_report
wp gf tool system-report
wp gf tool status
Outputs the system report from the Forms > System Status page.
Examples
12345# Successfully using the "system-report" command to output the system report.$ wp gf tool system-reportSuccess:### Gravity Forms ###...
123# Using the "status" alias with an older Gravity Forms version.$ wp gf tool statusError: The system report is only available with Gravity Forms 2.2 or greater.
Running the database setup
See the Managing Gravity Forms and Add-Ons with WP-CLI article.

WP Config Options

General OptionsGF_THEME_IMPORT_FILEGF_LICENSE_KEYMulti-Site Specific OptionsGF_RECAPTCHA_PRIVATE_KEYGF_RECAPTCHA_PUBLIC_KEYGF_IMPORT_FILECreating a Form Import JSON File

General Options
The following options are available for general use.
GF_THEME_IMPORT_FILE
Setting this option allows you to specify a Form JSON file from which a set of default forms can be pre-generated when a theme containing this option is activated. This option should be specified in your theme』s functions.php file. Follow these steps to create a Form JSON file for use with this option.
1define( 'GF_THEME_IMPORT_FILE', 'path/to/gf_import.json' );
Note: The path is relative to your theme root.
GF_LICENSE_KEY
Setting this option before installing Gravity Forms on a single site WP installation or before creating new sites on a multisite install will automatically pre-populate your Gravity Forms license key for those new installations.
1define( 'GF_LICENSE_KEY', 'YOUR-LICENSE-KEY-HERE' );
Multi-Site Specific Options
The following options are available when using WordPress Multi-Site. All of the options below should be defined in your wp-config.php.
GF_RECAPTCHA_PRIVATE_KEY
GF_RECAPTCHA_PUBLIC_KEY
Setting these options will automatically pre-populate your ReCAPTCHA public and private keys when a new site is created on your Multi-Site install.
12define( 'GF_RECAPTCHA_PUBLIC_KEY', 'YOUR-KEY-HERE' );define( 'GF_RECAPTCHA_PRIVATE_KEY', 'YOUR-KEY-HERE' );
GF_IMPORT_FILE
Setting this option allows you to specify a Form JSON file from which a set of default forms can be pre-generated when a new site is created on your Multi-Site install. Follow these steps to create a Form JSON file for use with this option.
1define( 'GF_IMPORT_FILE', 'http://www.domain.com/path/to/gf_import.json' );
Creating a Form Import JSON File
The following steps explain how to create a Form JSON file from which a set of default forms can be pre-generated when used with the GF_IMPORT_FILE or GF_THEME_IMPORT_FILE option.

Create the initial set of forms you want to replicate.
Navigate to the Import/Export tool and select 「Export Forms」.
Select the forms you want to auto-replicate when a new site is created.
Click 「Export」 to export them to an JSON file.
Place the JSON file somewhere on your web server, such as your wp-content/uploads/ folder, or somewhere easily accessible.
Replace the URL in the example code above with the URL to your Form JSON file.

Zapier Add-On Related Articles and Tutorials

SummaryGravityForms.comZapier.comOther Sites

Summary
This document contains a quick reference list of articles and tutorials from websites external to our documentation site which may help you get the most out of the Gravity Forms Zapier Add-On.
Make sure you peruse the Zapier section of our documentation site also.
GravityForms.com

What is possible with Gravity Forms and Zapier?
Supercharge your WordPress Forms with 1,000+ Apps and Services
Sending Form Entries to Google Sheets
Updating Spreadsheets from Form Entries in WordPress
Sending Form Entries to Google Calendar
Uploading Files to Google Drive from WordPress
Sending Product Information to Google Sheets using Zapier
Sending List Field and Product Data As Arrays to Zapier

Zapier.com

Gravity Forms Integrations
Gravity Forms Integration Help & Support

Other Sites

Zapier – Creating Pipedrive Deals via Gravity Forms
Send Gravity Forms Submissions to GoToWebinar
Automatically Create Base CRM Leads from Gravity Forms
Sending New Emails via SendGrid for New Gravity Forms Submissions
Asking for signatures from HelloSign for new Gravity Forms submissions

Using the Zapier Add-On

IntroductionPre-RequisitesQuick Getting StartedSetting up the Zapier Add-OnZapier Actions and TriggersZapsZapier HelpWhat Can You Do with Zapier and Gravity Forms?

Introduction
The Gravity Forms Zapier Add-On allows you to integrate Gravity Forms with over 200+ (and counting) online services. Zapier enables you to automate tasks between other online services such as Salesforce, Basecamp, GMail, and over 200 more.
Capture data via a Gravity Form that automatically creates a lead in Salesforce, a new row in a Google Spreadsheet, and a new calendar event in Google Calendar. All from the same single form submission.
The Gravity Forms Zapier Add-On does not replace our existing add-ons such as MailChimp, Campaign Monitor, etc. but does provide you with a way to integrate with services that we may not already support via official Add-Ons. Just as we consider Gravity Forms a swiss army knife for WordPress, Zapier is a swiss army knife for Gravity Forms.
In order to use the Gravity Forms Zapier Add-On you must have a Zapier account. Zapier is a paid service and pricing is based on volume and usage. You can find more about Zapier pricing here.
Unlike most Gravity Forms Add-Ons, the majority of the setup involved in integrating with Zapier will occur on the Zapier side via their customer dashboard. This does mean if you are having an issue with a Zap you have created in Zapier not behaving the way you expected, you may need to contact Zapier support for assistance for issues that occur within their Zapier Dashboard, Zap setup, and behavior.
Pre-Requisites

Download and install the add-on
A Zapier account
Signing up can be done quickly and easily and includes a 14-day free trial which gives you access to every regular and premium app. After the free trial, you can continue to use the free plan or select one of the available premium plans.
SSL Certificate Installed and Configured
Website Accessible to the Internet. The new authentication from Zapier to Gravity Forms uses REST API so your website must be accessible to Zapier.

Quick Getting Started

Create a Zapier REST API Connection under Forms, Settings, REST API. Save the Consumer Key and Consumer Secret for step 2.
Create a Zapier App Connection to Gravity Forms in MyApps. You will use the Consumer Key and Consumer Secret from step 1
Create a Gravity Form to send information to Zapier.
Create a Zap under your Zapier account to connect to the form you created. You』ll use the Gravity Forms connection created in Step 2.

Setting up the Zapier Add-On
Use this reference to configure your Zapier Application Connection to Gravity Forms
Zapier Actions and Triggers
You can use your Gravity Forms as both a Zapier trigger and as a Zapier action.
In both cases, the set-up process is done completely from within your Zapier account.
Zaps
To start sending data between Zapier and your forms, create a Zap as normal from within your Zapier account. You』ll be using the Gravity Forms connection.

Zapier Help
Most of your configuration with Gravity Forms and Zapier will take place within your Zapier account. If you run into issues, and you』ve confirmed that Zapier is communicating with the REST API connection in Gravity Forms, you can reach out to Zapier for assistance. You can check out their help documentation here.
What Can You Do with Zapier and Gravity Forms?
Zapier has 2000+ of Web Applications that can potentially integrate with Gravity Forms. Check out some of the most popular Zaps that you can use to work with Gravity Forms and these applications.

Create rows in Google Sheets for new Gravity Forms submissions
Use this Zap
Add contacts to Hubspot from new Gravity Forms entries
Use this Zap
Create HubSpot contacts from new Gravity Forms submissions
Use this Zap
Create Salesforce leads with new Gravity Forms submissions
Use this Zap
Create Google Calendar events from new Gravity Forms submission
Use this Zap

Gravity Forms

integrations