The frm_invalid_error_message hook allows the modification of the message shown at the top of a form when there is an invalid field entry. The default invalid field message says "There was a problem with your submission. Errors are marked below."

Since Formidable Forms 7.0, the value passed to this hook also includes a clickable list of the fields that failed validation. The message is wrapped in a <span>, and the list follows it in a <ul>. If your function returns new text in place of $invalid_msg, the list is removed too. To change only the message, keep the <ul> part, as in the second example below.

Usage

add_filter( 'frm_invalid_error_message', 'change_frm_form_error_message', 10, 2 );

Parameters

• $invalid_msg (string): The HTML shown at the top of the form. Since 7.0, this is the message in a <span>, followed by the list of field errors in a <ul> when the list is turned on.
• $args (array):
  • 'form' (object): The form being submitted.
  • 'errors' (array): The validation errors, keyed by field (for example, 'field25').
  These 2 keys are always set. When the form isn't submitted with AJAX, $args also includes 'fields' and 'img'.

Examples

add_filter( 'frm_invalid_error_message', 'change_frm_form_error_message', 10, 2 );
function change_frm_form_error_message( $invalid_msg, $args ) {
    if ( isset( $args['form'] ) && (int) $args['form']->id === 123 ) {
        $invalid_msg = 'My custom error message';
    }
    return $invalid_msg;
}

add_filter( 'frm_invalid_error_message', 'change_frm_form_error_message_keep_list', 10, 2 );
function change_frm_form_error_message_keep_list( $invalid_msg, $args ) {
    if ( ! isset( $args['form'] ) || (int) $args['form']->id !== 123 ) {
        return $invalid_msg;
    }

    // Keep the list of field errors (the <ul> part), if there is one.
    $error_list = strstr( $invalid_msg, '<ul>' );

    return '<span>My custom error message</span>' . ( $error_list ? $error_list : '' );
}

Change Log

• Added in version 2.02.07.
• Version 7.0: $invalid_msg includes the clickable list of field errors.

Related developer hooks

• Turn off the clickable list of field errors on one form or every form with the frm_show_clickable_field_errors hook.