website·Indexed 30 days ago
https://advancedforms.github.io/Documentation for Advanced Forms Pro, featuring a comprehensive library of PHP actions and filters (such as af/form/args and af/form/success_message), the advanced_form() function, and guides on creating forms, calculated fields, and integrations with Mailchimp and Zapier.
AF() function returns a singleton object containing metadata about the current submission. This object is accessible from all actions and filters and provides access to form arguments, created post IDs, and registered user IDs.// Get the form arguments
$args = AF()->submission['args'];
// Get the ID for a recently created post
$postId = AF()->submission['post'];
// Get the ID for a recently registered user
$userId = AF()->submission['user'];Connect your forms to Mailchimp to automatically subscribe visitors to your mailing lists. This requires a Mailchimp API key.
Step 1: Generate an API Key
Step 2: Global Plugin Configuration
Step 3: Form-Specific Configuration
To process form data after a submission, use the af/form/submission action hook. Use the helper function af_get_field( 'field_name' ) to retrieve processed field values. This function returns values in the same format as ACF's get_field.
Note: The $fields parameter passed to the hook is deprecated; use af_get_field instead.
<?php
function handle_form_submission( $form, $fields, $args ) {
// Retrieve the value of the field named 'email'
$email = af_get_field( 'email' );
}
add_action( 'af/form/submission', 'handle_form_submission', 10, 3 );Use the af/form/hidden_fields action to inject hidden HTML input elements into a form. These fields are useful for passing metadata (e.g., the current post title) along with the form submission.
Data from these hidden fields is accessible via the $_POST object in submission hooks, such as af/form/submission.
Important: Hidden inputs added via this action are not ACF fields and will not be automatically saved to entries or posts; you must handle the data manually in your submission logic.
<?php
function hidden_field( $form, $args ) {
// The title can later be retrieved using $_POST['post_title'].
$title = get_the_title();
echo sprintf( '<input type="hidden" name="post_title" value="%s">', $title );
}
// Apply to a specific form key
add_action( 'af/form/hidden_fields/key=FORM_KEY', 'hidden_field', 10, 2 );Set up instant Slack notifications whenever a visitor submits a form using an Incoming Webhook.
Step 1: Create a Slack Webhook
Step 2: Configure the Form
acf/validate_value filter provided by ACF.af/form/validate action. This action is triggered before form submission. Use af_get_field() to retrieve submitted data and af_add_error() to attach an error message to a specific field (by name or key).<?php
function validate_name() {
// Retrieve submitted field values
$first_name = af_get_field( 'first_name' );
$last_name = af_get_field( 'last_name' );
// Perform custom validation logic
if ( 'Fabian Lindfors' != $first_name . ' ' . $last_name ) {
// af_add_error( field_name_or_key, error_message )
af_add_error( 'first_name', 'Full name must be Fabian Lindfors!' );
}
}
// Hook into a specific form using its key: af/form/validate/key=FORM_KEY
add_action( 'af/form/validate/key=FORM_KEY', 'validate_name' );