DescriptionUsageParametersExamples1. Require a settingSinceSource Code
This filter was removed in Gravity Forms v2.5 and is no longer supported. From Gravity Forms 2.5, notification settings and their validation callbacks are now defined via the gform_notification_settings_fields filter.
Description
The gform_notification_validation filter can be used to validate custom notification settings added using the gform_notification_ui_settings and gform_pre_notification_save filters and override the default validation result.
Usage
The following would apply to all forms.
add_filter( 'gform_notification_validation', 'your_function_name', 10, 3 );
To limit the scope of your function to a specific form, append the form id to the end of the hook name. (format: gform_notification_validation_FORMID)
add_filter( 'gform_notification_validation_5', 'your_function_name', 10, 3 );
Parameters
$is_valid boolean
The result of the default notification validation which checks if the emails for the to, bcc, and replyTo settings are valid.
$notification array
An array of properties which make up the notification object to be saved. See Notifications Object for default properties.
$form Form Object
The current form object to which the notification being saved belongs.
Examples
1. Require a setting
This example shows how the new setting added by the gform_notification_ui_settings and gform_pre_notification_save filters can be required.
add_filter( 'gform_notification_validation', 'notification_validation', 10, 3 );
function notification_validation( $is_valid, $notification, $form ) {
if ( rgempty( 'my_custom_setting', $notification ) ) {
$is_valid = false;
GFCommon::add_error_message( esc_html( 'Please enter a value for the My Custom Label setting.' ) );
}
return $is_valid;
}
Since
This filter was added in Gravity Forms 1.9.16.
Source Code
This filter is located in GFNotification::notification_edit_page() in notification.php