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	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