Author 诗语

Checkboxes Field CSS Selectors

ListItemsLabelsInputs

List
Unordered list used to structure all of the individual list choices

example: standard checkbox list (ul) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gfield .gfield_checkbox {border: 1px solid red}

example: standard checkbox list (ul) – applies just to form ID #1
1body #gform_wrapper_1 .gform_body .gform_fields .gfield .gfield_checkbox {border: 1px solid red}

example: standard checkbox list (ul) – applies just to specific checkbox list (based on the unique parent element ID – replace 「XX_X」 with your actual element ID)
1body .gform_wrapper .gform_body .gform_fields #field_XX_X.gfield .gfield_checkbox {border: 1px solid red}

Items
Individual list choices

example: standard checkbox list item (li) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gfield .gfield_checkbox li {border: 1px solid red}

example: standard checkbox list item (li) – applies just to form ID #1
1body #gform_wrapper_1 .gform_body .gform_fields .gfield .gfield_checkbox li {border: 1px solid red}

example: standard checkbox list item (li) – applies just to specific checkbox list item (based on the unique parent element ID – replace 「XX_X」 with your actual element ID)
1body .gform_wrapper .gform_body .gform_fields #field_XX_X.gfield .gfield_checkbox li {border: 1px solid red}

Labels

example: standard checkbox choice label – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gfield .gfield_checkbox li label {border: 1px solid red}

example: standard checkbox choice label – applies just to form ID #1
1body #gform_wrapper_1 .gform_body .gform_fields .gfield .gfield_checkbox li label {border: 1px solid red}

example: standard checkbox choice label – applies just to specific checkbox label (based on the unique parent element ID – replace 「XX_X」 with your actual element ID)
1body .gform_wrapper .gform_body .gform_fields #field_XX_X.gfield .gfield_checkbox li label {border: 1px solid red}

Inputs

example: standard checkbox input (checkbox) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gfield .gfield_checkbox li input[type=checkbox] {border: 1px solid red}

example: standard checkbox input (checkbox) – applies just to form ID #1
1body #gform_wrapper_1 .gform_body .gform_fields .gfield .gfield_checkbox li input[type=checkbox] {border: 1px solid red}

example: standard checkbox input (checkbox) – applies just to specific checkbox list inputs (based on the unique parent element ID – replace 「XX_X」 with your actual element ID)
1body .gform_wrapper .gform_body .gform_fields #field_XX_X.gfield .gfield_checkbox li input[type=checkbox] {border: 1px solid red}

Configuring Subscriptions in PayPal Checkout

IntroductionConfigurationSetup FeeTrialEntry DetailsNotifications

Introduction

PayPal Subscriptions allow you to create recurring payments according to a flexible schedule. Subscription support was added in version 2.0 of the official Gravity Forms PayPal Checkout Add-On (previously named 「PayPal Commerce Platform Add-On」).

Note: If you get a notice indicating that credit cards are not supported for subscriptions and will not display on the form itself, you will need to adjust the field settings. This field is not supported in all markets and accounts by PayPal. You can uncheck the Credit Card option under Supported Payment Methods in the PayPal Field settings to disable this notice.

Configuration

Before continuing, note that if your form uses AJAX submission, you need to turn it off. PayPal Checkout subscriptions are not compatible with AJAX submission.

For your PayPal compatible form, choose Form → Settings → PayPal Checkout. Create new, or edit an existing feed.

Change the Transaction Type to Subscription This will load the Subscription Settings options

Select the Recurring Amount. This can be either a specific product field from your form, or the Form Total to use the total of all pricing fields as the recurring amount.Subscription Product Type: Indicate the type of product that this subscription is for, either Digital, Physical or ServiceBilling Cycle: The billing cycle determines how often the recurring payment should occur. You can choose a numeric interval of days, weeks, months or years.Recurring Retry: Select this option to retry the charge again after a failed attempt.Recurring Times: Select how many times the recurring payment should be made. The default is to bill the customer until the subscription is canceled.

Setup Fee

You can either enable a Setup Fee or a Trial Fee. Click Enabled to enable and you can choose a product field from your form to be used as the setup fee.

Trial

Use the Trial to establish a trial period for your subscription. You can either enable a Setup Fee or a Trial Fee. Click Enabled to enable the Trial Fee and you』ll be given additional options to complete.1. Select a Trial Price: You can select either a Free Trial, enter an amount for the trial price or choose from the product field from your form as the trial price.1. Configure the Trial Period: This is the duration for the trial subscription until the regular price is charged. You can choose a numeric interval of days, weeks, months or years.

Entry Details

The entry detail screen will show Subscription Details box including status, start date, subscription ID, and recurring amount.

Notifications

You can set up notifications for the subscription related events of:

– Subscription payment completion– Subscription payment failure– Subscription cancellation– Subscription expiration

Each of these events can initiate a notification that you can configure normally.

Example: Changing Font Sizes

IntroductionEntire Form ExampleField Headers ExampleField Inputs ExampleSpecific Field ExampleMore Info

Introduction
By default, Gravity Forms will utilize your current theme』s stying, but in some cases, you may need to change your font size that your theme defines. This article shows a few simple techniques you can try using CSS.
Refer to the article linked here for advice on where you can add this snippet.
Entire Form Example
This example would change the font size for all text in the form:
body .gform_wrapper .gform_body {
font-size: 18px;
}

Field Headers Example
The following will change the font size on all field labels on the form:
body .gform_wrapper .gform_body .gfield_label {
font-size: 18px;
}

Field Inputs Example
The following will change the font size on all inputs on the form:
body .gform_wrapper .gform_body input {
font-size: 18px;
}

Specific Field Example
The following will change the font size on the input of the specific field #1 on the form #6:
#field_6_1.gfield input {
font-size: 18px;
}

Alternately, you can target the input directly by it』s ID #input_6_1 in the example above.
More Info
See this article for dozens more examples of using CSS to target your form elements.

Constant Contact Change Log

1.5 | 2020-09-161.4 | 2020-07-201.3 | 2020-03-161.2 | 2019-11-271.1 | 2019-08-061.0 | 2019-03-11

1.5 | 2020-09-16

Fixed a PHP fatal error which can occur during form submission if the contact exists request fails.

1.4 | 2020-07-20

Added security enhancements.
Added a mapping for mobile phone number on the feed settings page.
Added partner code.
Added support for Gravity Forms 2.5.

1.3 | 2020-03-16

Added translations for Hebrew, Hindi, Japanese, and Turkish.
Fixed an issue with the position in the Form Settings menu when multiple add-ons are installed.
Fixed a PHP 7.4 notice which occurs when the API is initializing and the access and refresh tokens are not available.
Fixed a PHP 7.4 notice which occurs when processing the feed for a new contact.

1.2 | 2019-11-27

Fixed an issue where submissions may fail to be sent to Constant Contact because of an authentication error.

1.1 | 2019-08-06

Fixed a PHP fatal error which could occur on the feed settings page if a WP_Error was returned when getting the custom fields.
Fixed a PHP error which could occur when using the http_request_timeout filter with WP 5.1+.

1.0 | 2019-03-11

It's all new!

Common Form Issues

Why is 『display:none』 being added and my form isn』t showing up?Why do I see paragraph tags or line breaks after each element in my form?Why do I have extra space above and below my form?

Why is 『display:none』 being added and my form isn』t showing up?
This is because you have conditional logic being used on your form. Anytime conditional logic is present the entire form is set to display: none; and then JavaScript is used to only show the fields that should be shown.
However, this requires Gravity Forms being able to output the necessary JavaScript using the WordPress built in enqueue function which outputs the JavaScript in your footer.
This is due to one of two likely issues:
1.) Your theme probably does not have this function call in your theme』s footer.php file:

This function call, which all themes should have, but many people forget to include, enables plugins to output code in the footer of a theme dynamically. If it isn』t present, the theme can』t output the necessary code.
2.) Your theme has a JavaScript error or conflict causing Gravity Forms』 JavaScript not to function correctly. Please go through the theme and plugin conflict testing steps to isolate the issue.
Between these two important pieces of information, you』ll likely find the source of why your form is not displaying properly.
Why do I see paragraph tags or line breaks after each element in my form?
You』ll see these when another plugin or theme causes them. They aren』t added by Gravity Forms. To fix it, you』ll want to go through our theme and plugin conflict testing
Why do I have extra space above and below my form?
Usually this happens when you copy the form shortcode directly from the help page and paste it into the visual editor. Often it pastes the tags in the markup which then causes the formatting issues.Edit the page the form resides on, view the content in the editor using the HTML tab and if you see the tags around your form shortcode, simply remove them.
Complete information on embedding forms can be found in the documentation by clicking the link below:
https://docs.gravityforms.com/embedding-a-form/

Chained Selects Change Log

1.5 | 2020-09-241.4 | 2020-05-111.3 | 2019-08-071.2 | 2019-05-151.11.0

1.5 | 2020-09-24

Added support for Gravity Forms 2.5
Fixed an issue with cache expiration when using the gform_chainedselects_import_file filter.

1.4 | 2020-05-11

Added translations for Hebrew, Hindi, Japanese, and Turkish.
Fixed an issue where the import stalls with the spinner displayed if the uploaded csv contains malformed UTF-8 characters.
Fixed an issue with Gravity Forms 2.4.15.5+ where the placeholder choice is replaced with a duplicate first choice when the select is populated by the Ajax request.
Fixed an issue where dynamic population parameter names are lost when re-importing the csv file.
Fixed choices being imported from the csv file with leading and trailing spaces which could prevent the selected choice being saved on submission.

1.3 | 2019-08-07

Added security enhancements.

1.2 | 2019-05-15

Updated the entry list page field filters to include a choice for each select instead of one choice for the entire field.
Fixed an issue where Chained Selects conditional logic is evaluated for any field with the matching ID when multiple forms are on the page.
Fixed a PHP notice which can occur when using the gform_chained_selects_input_choices filter and the choice isSelected property is not defined.
Fixed an issue where pre-selected choice in first dropdown does not correctly populate choices in second dropdown.
Fixed a PHP warning on form display when the {all_fields} merge tag is used in the review page content.
Fixed calculations and conditional logic not being triggered when the isSelected property is enabled for a choice using the gform_chained_selects_input_choices filter.
Fixes issue where input names are overwritten when import file is re-imported.

1.1

Added index parameter to gform_chained_selects_input_choices filter.
Added gform_chainedselects_column_unique_values_limit filter to bring the gravityformschainedselects_column_unique_values_limit filter inline with RG naming conventions.
Added support for better error messages when uploading a CSV for a Chained Selects field.
Added support for honoring isSelected field on chained select choices (can only be set programmatically).
Added GPL to plugin header.
Updated file import filter feature to not cache empty files (preserving existing choices).
Updated Plugin URI and Author URI to use https.
Fixed issue where a chained select with no choices used the first select's choices.
Fixed an issue where the wrong choice could be selected when the field is redisplayed post paging.
Fixed a PHP fatal error which could occur when conditional logic evaluation is triggered by GravityView.
Fixed an issue where choice values of 0 were not imported resulting in some choices appearing in the wrong drop downs.
Fixed issue with chunking file uploads (introduced in GF 2.3).
Fixed issue where choice values were not properly sanitized when populating the next select's choices.

1.0

Updated output of field value in entry detail and all fields merge tag.
Fixed conditional logic support; miscellaneous bugs.
Added support for Chained Selects conditional logic on Notifications and Confirmations.
Fixed issue with poorly formatted import file.
Fixed a timing issue with the inclusion of the GF_Chained_Field_Select class.
Fixed issue where unsaved changes warning showed even after clicking update.
Updated choice UI to include left and right facing arrows to better indicate navigational direction between drop downs.
Update drop down preview to be clickable; navigates to the select drop down edit view.
Added warning if deleting choice with children.
Updated "Choices" field setting label to match new styling in GF2.0.
Added confirmation prompt if modal is closed with unsaved changes.
Added "Update" button in Manage Choices modal; data is only saved when Update button is clicked.
Added support for resizing vertically-aligned chained selects based on largest select.
Updated "Add Choices" label to "Manage Choices".
Updated modal styles and resizing behavior when new choices and drop downs are added.
Fixed issue where chained selects with "Hide Inactive Drop Downs" setting disabled would still hide inactive drop downs after first selection.
Everything is awesome!

Configuring PayPal Standard IPN Settings

Notice: As of September 2016, the PayPal IPN will require SSL/HTTPS on all IPN callbacks. If you are using the PayPal IPN, you will need to obtain an SSL certificate.
When using the PayPal Payments Standard Add-On from Gravity Forms, PayPal talks to the add-on using IPN which simply lets Gravity Forms know that the payment has been processed by PayPal. In this article, we will show you how to set up your PayPal IPN to communicate with the Gravity Forms PayPal Payments Standard Add-On.

Log into your PayPal account.
To access your PayPal IPN settings, you may either:

Access the IPN settings page directly. Or:
From within your PayPal account, click on the account icon (looks like a gear) at the top right of the page, then click on Profile and Settings. Click the My selling tools menu item to the left of the page. Click on Update to the right of Instant payment notifications.

Click on the Choose IPN Settings button.
You will be prompted with a field labeled Notification URL. Enter the following, replacing example.com with the domain that the Gravity Forms PayPal Payments Standard Add-On is installed.
https://example.com/?callback=gravityformspaypal (version 3.3.1+)
https://example.com/?page=gf_paypal_ipn (version 3.3 and older)

Select the radio button labeled Receive IPN messages (Enabled).

Save your changes.

PayPal Standard IPN is now enabled. When a purchase is made, it will send a notification to the PayPal Payments Standard Add-On, letting it know that the payment was successful. If you need further information on using the PayPal Payments Standard Add-On within Gravity Forms, review our article on setting up the PayPal Payments Standard Gravity Forms Add-On.

Checkboxes

SummaryCommon SettingsGeneral SettingsNotesMerge TagsUsageModifiersCalculations

Summary

The Checkboxes field allows you to present one or many checkboxes which allow multiple selections. It is available under the Standard Fields section within the form editor.

Checkboxes field as displayed in the Field Library

Checkboxes field as displayed in the Form Editor.

Important: If your choice labels contain any HTML or special characters such as ampersands, commas, hyphens or brackets of any type, you MUST enable the show values feature and give each choice a simple and unique value which does not contain any special characters. Failure to configure values could cause issues for features such as calculations, conditional logic, dynamic population, and validation.

Important: Once the form has entries the choices should not be changed. Adding, removing, re-ordering, or renaming checkbox choices will result in the input ids associated with the choices changing which could break the connection to the choices already stored in the existing entries and prevent them being exported.

Common Settings

This field uses only common field settings for the Appearance and Advanced settings. For a description of each of the common field settings, refer to this article. Below you will find a description of specialty settings that are particular to this field.

General Settings

SettingDescriptionChoicesAdd Choices to this field. You can mark each choice as checked by default by using the checkbox that appears to the left of each choice. Add a new choice by clicking the PLUS icon and delete a choice by clicking the DELETE icon.Show ValuesChecking this option will allow you to specify a value for each choice. Choice values are not displayed to the user viewing the form, but are accessible to administrators when viewing the entry.Bulk Add / Predefined ChoicesClicking the Bulk Add / Predefined Choices allows you to select a category and customize the predefined choices or paste your own list to bulk add choices. See note 1.Enable 「Select All」 choiceChecking this adds a Select All option to the top of the checkboxes list which allows the user to select all of the available list items.

Notes

1. See this article for more information.

Merge Tags

For more information on the use of merge tags, refer to these articles.

Usage

{Field Name:2.1:modifier1}

Notes:

The field name is optional.The second parameter is the field ID. If a single number, it can be used to get the value of the field ID. If multiple numbers separated by a period, it will get a specific selection within that field. For example, 2 will return the result of field ID 2, while 2.1 will return the first checkbox within field ID 2.The third, and any subsequent parameters are used for modifiers. These are separated by a colon, and may contain multiple modifiers if applicable.

Modifiers

ModifierDescription:valueDisplays the actual value of the checkbox rather than the value label.:currencyDisplays the value as currency.:priceSame as :currency.

Calculations

If you』re going to use this field type in a calculation formula, please check Number Formatting Rules in the Calculations doc page.

Configure Quiz Settings

IntroductionHow to access the Form specific Quiz SettingsQuiz SettingsGrading SettingsPass/Fail Grading OptionsLetter Grading Options

Introduction

When you add a Quiz Field to your form, a new section will automatically be added to the Form Settings that introduces Quiz specific settings that will affect all Quiz fields on your form.

How to access the Form specific Quiz Settings

From within your form, hover over Settings and click on Quiz. This will take you to a panel of Quiz related settings.

If you do not see the Quiz settings panel, double check that you have the Quiz Add-On properly installed and that you have at least one quiz field on the form in question.

Quiz Settings

SettingDerscriptionShuffle quiz fieldsRandomize the order of the quiz fields on this form each time the form is loaded.Instant FeedbackDisplay correct or incorrect indicator (✔︎ or ) and explanation (if any) immediately after answer selection. Once an answer has been selected it can』t be changed unless the form is reloaded. This setting only applies to radio button quiz fields and it is intended for training applications and trivial quizzes. It should not be considered a secure option for critical testing requirements.

Grading Settings

By default Grading is set to None, but if you would like to add the calculation of an overall grade to your quiz, you can select either Pass/Fail or Letter grading options.

Choosing a grading type will open up an additional set of options.

Pass/Fail Grading Options

Grading OptionsDescriptionPass PercentageIdentify the percentage score the user must equal or exceed to be considered to have 「passed.」Display Quiz ConfirmationPresent the user to either a pass or fail confirmation message upon submission of the quiz form. You can specify the exact text of either message in the applicable boxes using the rich text editor.Disable Auto-formattingWordPress will sometimes automatically add paragraph spacing to your text to help readability. If you』ve carefully crafted your layout (e.g. using HTML), select the Disable Auto Formatting checkbox to disable that function.

Letter Grading Options

This option lets you assign a letter grade based on the percentage score achieved. Click the + sign to add more letter grades, and set the letter identifier and the minimum percentage for each.

Display quiz confirmation and Disable Auto-formatting are described in the table above.

Example: Changing Your Form』s Background Color

Where To Put Your CSS SnippetExample modifying all FormsExample modifying one Form.More Info

Where To Put Your CSS Snippet
Refer to the article linked here for advice on where you can add this snippet](https://docs.gravityforms.com/where-to-put-your-custom-css/).
Example modifying all Forms
This will change the background color for all forms by using the form wrapper element
123body .gform_wrapper {    background-color: yellow;}
Example modifying one Form.
This will target a specific form, in this case, form ID 1, as indicated by the extended element name. Refer to this article for the structure of element names.
123body #gform_wrapper_1 {    background-color: yellow;}
More Info
See this article for dozens more examples of using CSS to target your form elements.