Use the frm_show_clickable_field_errors filter to turn off the clickable list of field errors on one form or on every form. When a submission fails validation, Formidable shows the incorrect field message at the top of the form. A list of the fields that failed follows it, and each item links to its field.

Return false to show the incorrect field message on its own, without the list.

Requirements

• Formidable Forms 7.0 or later.
• The filter is in Formidable Forms Lite, so it works with or without Formidable Forms Pro.

Usage

add_filter( 'frm_show_clickable_field_errors', 'my_show_clickable_field_errors', 10, 2 );

Parameters

• $show_summary (bool): Whether to list each field that failed validation. Default true.
• $args (array): Information about the form being shown.
  • 'form' (object): The form. It can be missing, so check it with isset() before you use it.
  • 'errors' (array): The validation errors, keyed by field (for example, 'field25'). This array is empty when Formidable only checks whether the list is on for a form, such as while the form loads.

How the error list affects focus

The filter also changes where the browser's focus goes after a failed submission. While the list is on, the error message at the top of the form receives focus. The individual field errors don't get role="alert", which stops screen readers from announcing the same errors twice.

To keep the list but stop it from taking focus, use the frm_focus_error_summary filter, also added in 7.0.

When you return false, Formidable uses the behavior from before 7.0. Focus moves to the first field with an error, and each field error gets role="alert".

Examples

add_filter( 'frm_show_clickable_field_errors', '__return_false' );

add_filter( 'frm_show_clickable_field_errors', 'my_hide_error_list_for_form', 10, 2 );
function my_hide_error_list_for_form( $show_summary, $args ) {
	$form_id = 123; // Change 123 to the ID of your form.

	if ( isset( $args['form'] ) && is_object( $args['form'] ) && (int) $args['form']->id === $form_id ) {
		return false;
	}

	return $show_summary;
}

Limitations

• The filter only controls the list of field errors. It doesn't change the incorrect field message above it.
• Errors that don't belong to a field, such as a spam error, never appear in the list.
• A field error on another page of a multi-page form, or on a Hidden or User ID field, is listed as plain text instead of a link.

Related developer hooks

• Change the message shown above the error list with the frm_invalid_error_message hook.
• Stop the error list from taking focus with the frm_focus_error_summary hook.
• Choose whether the first field with an error receives focus with the frm_focus_first_error hook.
• Choose whether field errors include role="alert" with the frm_include_alert_role_on_field_errors hook.

Related articles

• Global Settings Overview