Gravity Forms 文档

Post Title CSS Selectors

ContainerInput

Container
example: post title container (div) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gfield .ginput_container_post_title {border: 1px solid red;}
example: post title container (div) – applies just to form ID #1
1body .gform_wrapper_1 .gform_body .gform_fields .gfield .ginput_container_post_title {border: 1px solid red;}
example: post title container (div) – applies just to specific container (based on the unique parent element ID – replace 「XX_X」 with your actual element ID)
1body .gform_wrapper_1 .gform_body .gform_fields #field_XX_X.gfield .ginput_container_post_title {border: 1px solid red;}
Input
example: post title input (input) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gfield .ginput_container_post_title input {color: red;}
example: post title input (input) – applies just to form ID #1
1body .gform_wrapper_1 .gform_body .gform_fields .gfield .ginput_container_post_title input {color: red;}
example: post title input (input) – applies just to specific container (based on the unique parent element ID – replace 「XX_X」 with your actual element ID)
1body .gform_wrapper_1 .gform_body .gform_fields #field_XX_X.gfield .ginput_container_post_title input {color: red;}

Post Tags

SummaryCommon SettingsGeneral SettingsNotesMerge TagsUsageModifiers

Note: This field cannot be used with the Advanced Post Creation Add-On. If utilizing that plugin for post creation, use a standard field type instead.

Summary

The Post Tags field allows users to submit data that is then used to populate the tags for a post. This field works in tandem with the other Post fields to allow you to create a form that can generate post data from a user submission. It is available under the Post Fields section within the form editor.

Post Tags field as displayed in the Field Library

Post Tags field as displayed in the Form Editor.

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 description of specialty settings that are particular to this field.

General Settings

SettingDescriptionField TypeSelect the type of field that should be used to allow users completing the form to specify post tags. See note 1.

Notes

1. By default the Single Line Text field type is selected. This allows users to enter a comma delimited list to specify post tags. The Drop Down, Multi Select, Checkboxes, and Radio Buttons options allow you to specify a predefined list of tags for selection.

Merge Tags

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

Usage

{Field Name:2}

Modifiers

This merge tag does not have any modifiers.

Post Tags CSS Selectors

ContainerInput

Container
example: post tags container (div) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gfield .ginput_container_post_tags {border: 1px solid red;}
example: post tags container (div) – applies just to form ID #1
1body .gform_wrapper_1 .gform_body .gform_fields .gfield .ginput_container_post_tags {border: 1px solid red;}
example: post tags container (div) – applies just to specific container (based on the unique parent element ID – replace 「XX_X」 with your actual element ID)
1body .gform_wrapper_1 .gform_body .gform_fields #field_XX_X.gfield .ginput_container_post_tags {border: 1px solid red;}
Input
example: post tags input (input) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gfield .ginput_container_post_tags input {border: 1px solid red;}
example: post tags input (input) – applies just to form ID #1
1body .gform_wrapper_1 .gform_body .gform_fields .gfield .ginput_container_post_tags input {border: 1px solid red;}
example: post tags input (input) – applies just to specific container (based on the unique parent element ID – replace 「XX_X」 with your actual element ID)
1body .gform_wrapper_1 .gform_body .gform_fields #field_XX_X.gfield .ginput_container_post_tags input {border: 1px solid red;}

Post Image

SummaryCommon SettingsGeneral SettingsMerge TagsUsageModifiers

Note: This field cannot be used with the Advanced Post Creation Add-On. If utilizing that plugin for post creation, use a File Upload field instead.

Summary

The Post Image field allows users to upload an image that is added to the Media Library and Gallery for the post that is created. It is available under the Post Fields section within the form editor. This field works in tandem with the other Post fields to allow you to create a form that can generate post data from a user submission. The Post Image allows users to upload the following filetypes: GIF, JPG, and PNG.

Unlike regular file uploads, files uploaded with this field type are not deleted from the WordPress Media Library when Gravity Forms entries are deleted.

Post Image field as displayed in the Field Library

Post Image field as displayed in the Form Editor.

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 description of specialty settings that are particular to this field.

General Settings

SettingDescriptionImage MetadataSelect one or more image metadata fields to be displayed along with the image upload field. They enable users to enter additional information about the uploaded image.Set as Featured ImageCheck this option to set the image uploaded as the Featured Image for the generated post.

Merge Tags

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

Usage

{Field Name:2:modifier}

Modifiers

By default, the tag outputs the URL of the image.

ModifierDescription:titleDisplays the image title.:captionDisplays the image caption.:descriptionDisplays the image description.:altDisplays the alternative text.

Post Image Merge Tags

ResultUsageNotesModifiers That Affect Image DisplayModifiers That Display Image Meta

Result

Will display either the uploaded post image, or metadata about the image.

Usage

{[Post Image Field Name]:[field_id]:[modifier]}

[Post Image Field Name] is a descriptive text for the field you are targeting, and can be anything you require. This is included for readability, and is not mandatory.[field_id] is the id of the post image field you are targeting, and is required. [modifier] options are noted below.

Notes

This merge tag is available for the Post Title and Post Body field』s Create Content Template setting.

Special drop downs will appear when a Post Image field is selected from the content template merge tag drop down. This special drop down will provide a variety of pre-built merge tags for displaying the post image at all size and alignment combinations. For example, {My Post Image:5:thumbnail:left}

Modifiers That Affect Image Display

These two modifiers affect the display of the post image.They can be combined. For example {Post Image:5:medium:left}

ModifierDescription:sizeAccepts all standard WordPress sizes: 「thumbnail」, 「medium」, 「large」 and 「full」. Additionally, any registered custom size is supported as well. For more information on adding custom image sizes, read this article.Example: {Post Image:5:medium}:alignmentSpecify how the post image should be aligned with its adjacent content. Support values are 「left」, 「right」 and 「centered」.Example: {Post Image:5:medium:left}

Modifiers That Display Image Meta

These modifiers will display meta about the post image, rather than the post image itself.

ModifierDescription:urlDisplay the URL to the specified size of the post image. This option nullifies the [alignment] option. {Post Image:5:url}:titleDisplay the title of the image from image metadata. {Post Image:5:title}:descriptionDisplay the description of the image from image metadata. {Post Image:5:description}:captionDisplay the caption of the image from image metadata. {Post Image:5:caption}

Post Image CSS Selectors

ContainerInput

Container
example: post image container (div) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gfield .ginput_container_post_image {border: 1px solid red;}
example: post image container (div) – applies just to form ID #1
1body .gform_wrapper_1 .gform_body .gform_fields .gfield .ginput_container_post_image {border: 1px solid red;}
example: post image container (div) – applies just to specific container (based on the unique parent element ID – replace 「XX_X」 with your actual element ID)
1body .gform_wrapper_1 .gform_body .gform_fields #field_XX_X.gfield .ginput_container_post_image {border: 1px solid red;}
Input
example: post image input (input) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gfield .ginput_container_post_image input {border: 1px solid red;}
example: post image input (input) – applies just to form ID #1
1body .gform_wrapper_1 .gform_body .gform_fields .gfield .ginput_container_post_image input {border: 1px solid red;}
example: post image input (input) – applies just to specific container (based on the unique parent element ID – replace 「XX_X」 with your actual element ID)
1body .gform_wrapper_1 .gform_body .gform_fields #field_XX_X.gfield .ginput_container_post_image input {border: 1px solid red;}

{post_id} Merge Tag

SummaryUsageNotesSee Also

Summary
Displays the ID of the post which was created during submission.
Usage
{post_id}
Notes
Only relevant when the form uses fields from Post Fields panel.
This merge tag can be used in areas such as notifications and confirmations after the entry has been saved. Because of this timing, they cannot be used as a field』s default value.
See Also
The {entry} merge tag.

Post Excerpt

SummaryCommon SettingsGeneral SettingsMerge TagsUsageModifiers

Note: This field cannot be used with the Advanced Post Creation Add-On. If utilizing that plugin for post creation, use a standard field type instead.

Summary

The Post Excerpt field allows users to submit data that is then used to populate the excerpt of a post. This field works in tandem with the other Post fields to allow you to create a form that can generate post data from a user submission. It is available under the Post Fields section within the form editor.

Post Excerpt field as displayed in the Field Library

Post Excerpt field as displayed in the Form Editor.

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 description of specialty settings that are particular to this field.

General Settings

SettingDescriptionPost StatusSelect the post status that will be used for the post that is created by the form entry. Available options are Draft, Pending Review, and Published.Default Post AuthorSelect the author that will be used for the post that is created by the form entry.Use logged in user as authorSets the post author to the WordPress user that submitted the form.Post CategorySelect the category that will be used for the post that is created by the form entry.

Merge Tags

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

Usage

{Field Name:2}

Modifiers

This merge tag does not have any modifiers.

Post Excerpt CSS Selectors

ContainerInput

Container
example: post excerpt container (div) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gfield .ginput_container_post_excerpt {border: 1px solid red;}
example: post excerpt container (div) – applies just to form ID #1
1body .gform_wrapper_1 .gform_body .gform_fields .gfield .ginput_container_post_excerpt {border: 1px solid red;}
example: post excerpt container (div) – applies just to specific container (based on the unique parent element ID – replace 「XX_X」 with your actual element ID)
1body .gform_wrapper_1 .gform_body .gform_fields #field_XX_X.gfield .ginput_container_post_excerpt {border: 1px solid red;}
Input
example: post excerpt input (input) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gfield .ginput_container_post_excerpt input {border: 1px solid red;}
example: post excerpt input (input) – applies just to form ID #1
1body .gform_wrapper_1 .gform_body .gform_fields .gfield .ginput_container_post_excerpt input {border: 1px solid red;}
example: post excerpt input (input) – applies just to specific container (based on the unique parent element ID – replace 「XX_X」 with your actual element ID)
1body .gform_wrapper_1 .gform_body .gform_fields #field_XX_X.gfield .ginput_container_post_excerpt input {border: 1px solid red;}

Post Custom Field

SummaryCommon SettingsGeneral SettingsNotesInput MaskMerge TagsUsageModifiers

Note: This field cannot be used with the Advanced Post Creation Add-On. If utilizing that plugin for post creation, use a standard field type instead.

Summary

The Post Custom Field allows users to submit data that is then used to populate a custom field value for a post. This field works in tandem with the other Post fields to allow you to create a form that can generate post data from a user submission. It is available under the Post Fields section within the form editor.

Post Custom field as displayed in the Field Library

Post Custom field as displayed in the Form Editor.

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 description of specialty settings that are particular to this field.

General Settings

SettingDescriptionField TypeSelect the field type you wish for this Post Custom Field to behave as. See note 1.Custom Field NameChoose from available existing custom fields, or enter a new custom field name.Create Content TemplateUse merge tags to define the content of this field. See this article for more information.

Notes

1. The Post Custom Field will assume the properties and options of the selected field type. For example, if Single Line Text is selected, the Maximum Characters and Enable Password Input options would become available for this field.

Input Mask

Single Line Text and Post Custom Field are the only fields that have the Input Mask setting. You can learn more about input masks in this article.

Merge Tags

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

Usage

{Field Name:2}

Modifiers

This merge tag does not have any modifiers.