Gravity Forms 文档

How To Install Gravity Forms

Using the WordPress dashboardUsing FTP

Installing Gravity Forms is quite simple and is the same process as installing many other plugins. In this article, we will show you how to quickly install Gravity Forms using the plugin uploader inside your WordPress admin dashboard.

If your site is hosted by WordPress.com you can only install Gravity Forms if you are on their Business plan, with a custom domain configured, and have installed the Hello Dolly plugin. You can then install Gravity Forms from the /wp-admin/ dashboard using the instructions below.

Using the WordPress dashboard

After downloading Gravity Forms go to the plugins page then click Add New.Click Upload Now in the top left corner.Drag and drop the file you downloaded onto the Choose File button.Follow the remaining prompts and Gravity Forms will be succesfully downloaded!

Using FTP

First, download Gravity Forms. To do so, simply access the Gravity Forms download page, log into your account, and download the plugin zip file.As you are installing via FTP, you will need to unpack the zip file that you downloaded.Next, access your WordPress site via FTP and navigate to the wp_content/plugins directory. Inside there, upload the entire 『gravityforms』 folder that you have obtained as result of unzipping the zip file.Once fully uploaded, access your WordPress admin dashboard and click on Plugins. Inside this page, you should now see an entry for Gravity Forms. All you have to do now is activate it by clicking one Activate Plugin.

That』s it! Gravity Forms is now installed and running on your WordPress site. To get started, you may now follow our guide on setting up Gravity Forms.

How To Change Your Language In Gravity Forms

Languages available in Gravity FormsChanging your WordPress installation language

By default Gravity Forms is available in US English. But with users in every continent, island, and corner of the globe, we have built Gravity Forms to support many different languages.
The language of Gravity Forms, all you need to do is change the language of your WordPress installation. In this article, we will show you how to change the language of your WordPress installation, which subsequently changes the language of Gravity Forms.
Languages available in Gravity Forms
A list of all translations included with Gravity Forms, as well as download links for their source files may be found on our Translations page.
Changing your WordPress installation language

First, log into your WordPress admin dashboard.
Once logged in, hover over Settings on the left side menu panel, and click on General.
From within this page, there is a dropdown labeled Site Language. Simply use this dropdown to select your desired language.
Now that your language is selected, simply click the Save Changes button.

The language used by your WordPress installation will now be changed to the language you have selected. This change will also change the language of Gravity Forms as well.
Gravity Forms also supports loading translations from a gravityforms folder in the WP_LANG_DIR directory e.g. /wp-content/languages/gravityforms/

How to Chain Forms Using Shortcodes

This article explains how you can chain two forms together by placing the shortcode for another form inside the confirmation of the first form.

This results in the second form displaying upon submission of the first form. Data from the first form may be carried over to the second using parameters.

Below are the steps to follow:

Create the first form.Edit the Confirmation

Set the Confirmation Type to Text and enter the shortcode for the second form as the Message. [gravityform id="82" title="false" description="false" ajax="true" field_values="param_email={:2}"] It is very important that the ajax attribute is included and set to true for the shortcode to the second form. If not, upon submission of the second form, the first form will load again.If any data is meant to carry over and populate fields on the second form, add the field_values attribute to the shortcode. The parameter names used will be created on the second form so make sure the same names are used. The values listed will also depend on the field ids on the second form. This step could be done after the second form is created if the field ids or parameter names are unknown. For more information about the field_values attribute or how to pass data, see the following documents: Form ShortcodeUsing Dynamic PopulationUsing Confirmation Query Strings To Populate A Form Based On Another Submission. Create a page for the first form.Add the shortcode for the form to the page. The most important part here is that the ajax attribute is set to false, or not included because it defaults to false. If ajax is set to true, then submitting the second form will cause the first form to be loaded again. [gravityform id="7" title="true" description="true" ajax="false"] Create the second form. If there is any data that should carry over from the first form to be displayed in fields on the second form, set the fields on the second form to Allow field to be populated dynamically and enter a Parameter name.

After following the steps above, load the page of the first form and submit. The second form displays with any chosen data populated. Submit the second form and its confirmation page displays.

Bonus: When the second form is submitted, the header from the first form still displays. This can be removed by doing the following:

Add an HTML field to the second form.Add the following code to the Content. This jQuery code simply finds the HTML 「h1」 tag and replaces the text with nothing. The page header is inside the 「h1」 tag so it is removed. The script can be modified to target a specific element in the page as needed.

<script type="text/javascript">
var $ = jQuery.noConflict();
$("h1").text('');
</script>

「How To」 Blog Posts

List of Blog 「How To」 ArticlesList of Blog Starter Guides

Blog
The official Gravity Forms Blog is a fantastic resource for keeping up to date on new releases, promotions, product updates, partner releases, tips and tricks and more! Below we have collected a small sample of the How To articles posted there.
The best way to keep up to date? Sign up for the Gravity Forms newsletter and be notified when new articles get posted!
List of Blog 「How To」 Articles
How to… Take Subscriptions on your WordPress Website with Stripe
How to… Accept File Submissions Through a Form
How to… Add Images to a Form
How to… Collect and Store Consent with the Gravity Forms Consent Field
How to… Create a Multi-Page Form
How to… Customize the Text on a Form』s Submit Button
How to… Redirect Users to a New Page or URL After Form Submission
How to… Send Form Entries to Google Sheets Using Zapier
How to… Capture Signatures Online (with the Gravity Forms Signature Add-On)
How to… Configure a Custom Confirmation Message
How to… Add a Poll to Your WordPress Website
How to… Configure Custom Notifications
How to… Take Payments on Your WordPress Website with Gravity Forms and Mollie
How to Take Payments with Apple Pay and Google Pay in WordPress
How to… Embed Forms using Code
How to… Import and Export Forms with Gravity Forms
How to… Export Form Entries
How to… Prevent Spam Form Entries
How to… Capture Partial Form Entries
How to… Create a Quiz for Your WordPress Website
How to… Use Conditional Logic to Create Smarter Forms
How to… Create WordPress Forms with Save and Continue
How to… Add Google reCAPTCHA v2 and v3 to Your Forms
How to… Filter Spam Form Entries with Akismet
How to… Embed a Form in WordPress
How to… Create a Mailchimp Signup Form
How to… Send Form File Uploads to Dropbox
How to… Create a Form in WordPress
How to… Reliably Deliver WordPress Form Notifications with a Transactional Email ServiceNew!
How to… Create a HubSpot Contact FormNew!
List of Blog Starter Guides
Starter Guide: Just Bought a Gravity Forms License? Let』s get you set up…
Starter Guide: How to Import and Customize a Basic Contact Form
Starter Guide: How to Create a Survey with Gravity Forms
Starter Guide: How to Set Up User Registration on Your WordPress Website
Starter Guide: How to Create a Donation Form with Gravity Forms
Starter Guide: How to Create a Request a Quote Form
Starter Guide: How to Create a Webinar Registration Form
Starter Guide: How to Sell Gift Certificates on your WordPress Website
Starter Guide: How to Add an Appointment Booking Form to Your WordPress Website
Starter Guide: How to Create an Event Registration Form with Gravity Forms
Starter Guide: How to Create a Job Application Form in WordPress
Starter Guide: How to Create a Newsletter Signup Form (and collect leads!)
Starter Guide: How to Sell Products on your WordPress Website
Starter Guide: How to Create a Membership Site with Gravity Forms
Starter Guide: How to Create a Subscription Form for Your BusinessNew!
Starter Guide: How to Create a Course Registration FormNew!

How to add Gravity Forms Blocks

IntroductionInsert using the Add Block buttonInsert using the quick select slash 「/」Insert using the content area 「recent blocks」 shortcut.Insert using the Shortcode blockTailoring Your Block

Introduction

WordPress 5 introduced the block based page/post editor, a replacement for the venerable classic editing environment. Gravity Forms includes its own blocks for use in the new editor. The following article gives instructions on how to add a block to your page or post.

Note that as of WordPress 5.8, the Gravity Forms Block will no longer work properly if you are on Gravity Forms 2.4.x or earlier. You will need to upgrade to the latest Gravity Forms release.

Insert using the Add Block button

Open the page or post you wish to add a block to.Click the plus sign button (+) to add a new block into the content area where your cursor focus is.

In the search bar, type enough text to identify the block you want. Alternatively, look under the Embeds area.Click the block to insert it.

This will place the block on your page/post, and you can now begin specifying the options and settings for the particular block you have selected.

Example: inserting the Poll block using the Add Block button. Click to view animation.

Insert using the quick select slash 「/」

Typing forward slash / anywhere within your content area will bring up an 「insert shortcode」 dialog, which then allows you to search and insert as per above.

Example: inserting the Poll block using the shortcode short cut. Click to view animation.

Insert using the content area 「recent blocks」 shortcut.

When you are in the content area, the appearing contextual controls will include shortcut icons to the right side that show recently used blocks. Check there to see if the Gravity Forms block you want is shown. Hover over the icon to see the block name. (Delelte This section?)

Insert using the Shortcode block

The WordPress 5 editor comes with a Shortcode block (under the Widgets category), which once added will accept a standard Gravity Forms shortcode. Insert that block using any of the methods above, and then you can manually tailor your Gravity Forms shortcode as needed.

Tailoring Your Block

Refer to the documents for each block type to see the types of settings and options specific to that block.

Form block (included with Gravity Forms core).Poll block (included with Poll add-on)Gutenberg Gravity Forms block (included with the Gutenberg Block experimental add-on)

How to Add a New Field to an Existing Form Using the GFAPI

Get the existing form.Determine the new field』s ID.Create a new field object.Set new field』s properties.Add the new field to the form object.Save the modified form object.

Get the existing form.
12// Replace "123" with your existing form ID.$form = GFAPI::get_form( 123 );
Determine the new field』s ID.
If only one new field is being added AND the Gravity Forms version being used is at least 2.4.7, the easiest way to get the next field ID is as follows:
123//works if only one field being added//must have at least Gravity Forms version 2.4.7$new_field_id = GFFormsModel::get_next_field_id( $form['fields'] );
Otherwise, use this method:
Loop through the existing form fields to get the highest existing field ID. Increase that number by one to get the next available field ID.
1234567$new_field_id = 0;foreach( $form['fields'] as $field ) {    if( $field->id > $new_field_id ) {        $new_field_id = $field->id;    }}$new_field_id++;
Create a new field object.
12345//create an array of field properties, this example creates a text field//pass array to the create method$properties['type'] = 'text'; $field = GF_Fields::create( $properties );
Set new field』s properties.
If only adding one new field, the properties may be set along with the type property set when calling GF_Fields::create() in the step above:
12$properties['id'] = $new_field_id;$properties['label'] = 'My Field';
Othewise, follow this step.
Set the field』s id property to the $new_field_id variable. Set the field』s label property as desired. Set any other desired field properties here.
12$field->id = $new_field_id;$field->label = 'My New Field';
Add the new field to the form object.
1$form['fields'][] = $field;
Save the modified form object.
1GFAPI::update_form( $form );

Holding Notifications until after Payment

Payment Completed Event NotificationSupported Add-OnsOther Gravity Forms Notification Events

This article explains how to send notifications after the payment has been completed when using payment add-ons.

Payment Completed Event Notification

The Payment Completed notification event will send the notification when a payment has successfully been completed. This is not to be confused with the Subscription Created event which will occur when a new subscription is created.

In order to enable this notification event, perform the steps below. This article assumes you have already created a form and the associated feed to the payment service.

From the left hand navigation menu, hover over Forms and then click on Forms.Select your form from the Forms list.Hover over Settings and click on Notifications.

From the Notifications list page, click Edit to edit the existing admin notification, or click Add New to create a new notification.

On the Notification page, select Payment Completed from the Event drop down. This will send the notification when a payment has successfully been completed.

Click the Update Notification button to save your changes.

Supported Add-Ons

The Payment Completed notification event is available in the following add-ons:

PayPal Standard Add-OnPayPal Payments Pro Add-OnStripe Add-OnAuthorize.Net Add-On

Other Gravity Forms Notification Events

For more information on the different notification events that are available within Gravity Forms as well as additional add-ons, please refer to this article.

HipChat Feed Meta

IntroductionUsageProperties

Introduction
The Feed Object meta for the HipChat add-on is an associative array containing the properties which determine how the add-on should process the form submission.
12345678910$feed['meta'] = array(    'feed_name'                               => 'Your Feed Name',    'color'                                   => 'yellow',    'notify'                                  => false,    'message'                                 => 'Entry #{entry_id} has been added.',    'feed_condition_conditional_logic'        => true,    'feed_condition_conditional_logic_object' => array(        'conditionalLogic' => array(),    ),);
Usage
We recommend accessing the $feed meta using the rgar() or rgars() functions, e.g.:
1$conditional_logic_enabled = rgars( $feed, 'meta/feed_condition_conditional_logic' );

Properties

feed_name string
The feed name which appears on the add-ons feeds tab.

room string
The HipChat ID for the Room this feed will post a notification to.

color string
The color the notification will be displayed as. Possible values: yellow, green, red, purple, grey or random.

notify boolean
Should users in the room be notified (change the tab color, play a sound, etc) when the message is posted. Default is false.

message string
The message that will be posted to HipChat. Can contain merge tags.

feed_condition_conditional_logic boolean
Is the feed condition (conditional logic) setting enabled. Default is false.

feed_condition_conditional_logic_object array
An associative array containing the conditional logic rules. See the Conditional Logic Object for more details.

HipChat Change Log

1.2 | 2018-03-281.1 | 2016-08-311.0 | 2015-03-04

The HipChat service was discontinued in 2019 after acquisition by Atlassian.The Gravity Forms add-on is no longer available for download. These documents have been left for posterity only, and will be removed in time.
1.2 | 2018-03-28

Added security enhancements.
Added GPL to plugin header.
Updated Plugin URI and Author URI to use https.
Fixed strings for translations.

1.1 | 2016-08-31

Added feed duplication support.
Added default feed name for new feeds.
Added support for delaying feed processing until payment by PayPal Standard is successfully completed.
Added gf_hipchat() for easily getting an HipChat instance.
Added Spanish (es_ES) translation.
Added filter gform_hipchat_verify_ssl to disable SSL certificate verification during API requests.
Updated HipChat API library to use WordPress API functions.
Updated feed processing so that empty messages are not posted to room.

1.0 | 2015-03-04

It's all new!

Setting Up the HipChat Add-On

Pre-RequisitesSetup

The HipChat service was discontinued in 2019 after acquisition by Atlassian.The Gravity Forms add-on is no longer available for download. These documents have been left for posterity only, and will be removed in time.
Pre-Requisites

Download and install the add-on
A HipChat account

Setup

Log into your WordPress admin dashboard.
On the left side navigation menu, hover over Forms and click on Settings.
From this page, click the HipChat tab.
Enter your Authentication Token. Your HipChat API Authentication Token can be generated via the Group Admin area of your HipChat account. Click on the Group Admin link in the HipChat toolbar, select API from the Group Admin navigation, and generate an authentication token. You must configure the authentication token as an admin token and not a notification token.
Click Update Settings. If you』ve entered your account information correctly, you will be notified by a green check mark beside the box. If you do not see a green check mark, please double check this information and try again.

Once you have entered your authentication token, you』re ready to begin creating a feed for the HipChat Add-On.