The Donation Field has been deprecated as of GF v1.6. Existing donation fields will continue to function correct; however, it will no longer be possible to add new donation fields. Use the Product Field instead. The type of transaction is now solely determined by the PayPal feed setup for the form.
The Donation Field is a product-independent pricing field that allows the user to specify or select a donation amount. Donation Fields integrate with the Shipping and Total fields; however, Donation Fields do not integrate with Product, Option, and Quantity fields.
Properties
- Field Label
- Enter the label of the form field. This is the field title the user will see when filling out the form.
- Field Type
- Select the type of field from the available form fields.
- Drop Down
- The Drop Down field type will display as a drop down field on your form. When this option is selected, the Properties tab will refresh with options to specify multiple donation options/prices (example).
- User Defined Price
- The User Defined Price field type will display as a single line input on your form.
- Multiple Choice
- The Multiple Choice field type will display as a field of radio buttons on your form. When this field type is selected, the Properties tab will refresh with options to specify multiple donation options/prices (example).
- Description
- Enter the description for the form field. This will be displayed to the user and provide some direction on how the field should be filled out or selected.
- Rules
- These properties set rules for how the data should be handled.
- Required
- A required field will prevent the form from being submitted if it is not filled out or selected.
- No Duplicates
- A field set to allow no duplicates will require that a value entered in a field does not currently exist in the entry database for that field.
- Note: This option is only available when the Drop Down or Multiple Choice field type is selected.
Advanced
- Admin Label
- Enter the admin label of the form field. Entering a value in this field will override the Field Label when displayed in the Gravity Forms administration tool.
- Field Size
- Select a form field size from the available options.
- Note: This will set the width of the field. This option is only available when the Drop Down field type is selected.
- Validation Message
- If you would like to override the default error validation for a field, enter it here. This message will be displayed if there is an error with this field when the user submits the form.
- Note: This option is only available when the Drop Down or Multiple Choice field type is selected.
- CSS Class Name
- Enter the CSS class name you would like to use in order to override the default styles for this field.
- Visibility
- Select the visibility for this field. Field visibility set to Everyone will be visible by the user submitting the form. Form field visibility set to Admin Only will only be visible within the Gravity Forms administration tool. Setting a field to Admin Only is useful for creating fields that can be used to set a status or priority level on submitted entries.
- Allow field to be populated dynamically
- Check this option to enable data to be passed to the form and pre-populate this field dynamically. Data can be passed via Query Strings, Shortcode and/or Hooks.
- Enable Conditional Logic
- Create rules to dynamically display or hide this field based on values from another field. Remember, to use conditional logic, you will need to create a drop down, checkbox or multiple choice field.