Adding a Form¶
Warning
Before creating any form, make sure you have used Advanced Custom Fields to create fields
Using Visual Composer¶
Use Visual Composer or manually add shortcode [acf_front_form]
where you want your form to be displayed
The ACF Front Form Settings is displayed
For more information about Visual Composer settings, see attributes.
Using Shortcode¶
To add a form in a page or a post, add the fellowing shortcode where you want the form be rendered
[acf_front_form]
Examples¶
- Creating and publishing a new post
[acf_front_form post_id="new_post" np_title="Yay" np_type="post" np_status"=publish"]
Or
[acf_front_form post_id="new_post" new_post="post_title=Yay,post_type=post,post_status=publish"]
- Load title, content and all fields of a specific post into a form
[acf_front_form post_id="31" post_title="Yes" post_content="Yes"]
- Create a form using a specific Field Groups
[acf_front_form field_groups="group_5a6ce38c5d036"]
Or
[acf_front_form field_groups="949"]
Attributes¶
ACF Front Form create [acf_front_form]
shortcode whith attributes. this shortcode call the acf_form()
function which renders the form, most of this attributes corresponds to a parameter of the acf_form()
function, for more information about acf_form()
function, read this documentation
Note
The attributes explained here are used by ACF Front Form shortcode
Post Settings¶
Defines the $post
values, they are all mapped to acf_form()
function. You can find here all variables of the WP_Post
class
Shortcode attributes¶
Attribute | Type/Values | Default | Description |
---|---|---|---|
post_id | int, string | Current post ID | The post ID to load data from and save data to. Can also be set to “new_post” to create a new post on submit |
np_title | string | The title of the new post | |
np_status | string | The status of the new post | |
np_type | string | The post type of the new post | |
new_post | array | A list of post data separated with commas used to create a post. See wp_insert_post for available parameters. The above post_id setting must contain a value of “new_post” |
Form Settings¶
Defines the settings of the rendered form, they are all mapped to acf_form()
function
Shortcode attributes¶
Attribute | Type/Values | Default | Description |
---|---|---|---|
form | checkbox | Yes | Whether or not to create a form element. Useful when adding to an existing form |
id | string | acf-form | The id of the form element |
form_attributes | string | A list of HTML attributes for the form element | |
return | string | current url | The URL to be redirected to after the form is submit, more details here |
submit_value | string | Update | The text displayed on the submit button |
updated_message | string | Post updated | A message displayed above the form after being redirected. Empty for no message |
Fields Settings¶
Defines settings related to the fields, they are all mapped to acf_form()
function
Shortcode attributes¶
Attribute | Type/Values | Default | Description |
---|---|---|---|
post_title | checkbox | Whether or not to show the post title text field | |
post_content | checkbox | Whether or not to show the post content editor field | |
field_groups | array | A list of group IDs/keys separated with commas to override the fields displayed in this form | |
fields | array | A list of field IDs/keys separated with commas to override the fields displayed in this form | |
label_placement | top, left | top | Determines where field labels are places in relation to fields |
instruction_placement | label, field | label | Determines where field instructions are places in relation to fields |
field_el | div, tr, td, ul, ol, dl | div | Element used to wrap the fields |
uploader | wp, basic | wp | Whether to use the WP uploader or a basic input for image and file fields |
honeypot | checkbox | Yes | Whether to include a hidden input field to capture non human form submission |
HTML Settings¶
Defines settings related to HTML, they are all mapped to acf_form()
function
Shortcode attributes¶
Attribute | Type/Values | Default | Description |
---|---|---|---|
html_before_field | string | Extra HTML to add before the fields | |
html_after_fields | string | Extra HTML to add after the fields | |
html_updated_message | string | <div id=”message” class=”updated”><p>%s</p></div> | HTML used to render the updated message |
html_submit_button | string | <input type=”submit” class=”acf-button button button-primary button-large” value=”%s” /> | HTML used to render the submit button |
html_submit_spinner | string | <span class=”acf-spinner”></span> | HTML used to render the submit button loading spinner |
kses | checkbox | Yes | Whether or not to sanitize all $_POST data with the wp_kses_post() function. Defaults to true |
Table Settings¶
When the field_el
is set to td
or tr
, the acf_form()
function will not add the table tags ( read more )
ACF Front Form will do the job for you if you want, to do so, Check the * Add the table tags *
.. note:: These attributes are not part of the acf_form()
function
Shortcode attributes¶
Attribute | Type/Values | Default | Description |
---|---|---|---|
table_el | checkbox | Whether or not to add table tags before and after the fields, field_el should be set to td or tr | |
thead | string | Text (one per line) added into td tags of the thead tag if the table_el is checked | |
tfoot | string | Text (one per line) added into td tags of the tfoot tag if the table_el is checked |