- Handle Custom Stripe Webhook Events
- suredonation_export_secret_option_keys Filter Hook
- suredonation_import_batch_complete Action Hook
- suredonation_import_complete Action Hook
- suredonation_import_donation_inserted Action Hook
- suredonation_import_donor_inserted Action Hook
- suredonation_import_session_created Action Hook
- suredonation_import_givewp_batch_complete Action Hook
- suredonation_import_givewp_session_created Action Hook
- suredonation_privacy_data_exported Action Hook
- Validate Field Filter Hook
- Validatable Blocks Filter Hook
- Update donation data, Filter Hook
- OttoKit Integration: suredonation_suretriggers_integration_data_filter Filter Hook
- suredonation_show_setup_gateway_notice Filter Hook
- suredonation_show_review_notice_gateway Filter Hook
- suredonation_show_review_notice_donation Filter Hook
- suredonation_registered_payment_methods Filter Hook
- suredonation_register_additional_blocks Filter Hook
- suredonation_receipt_html Filter Hook
- suredonation_phone_geo_enabled Filter Hook
- suredonation_phone_geo_api_hourly_cap Filter Hook
- suredonation_paypal_webhook_handle_event Filter Hook
- suredonation_paypal_sdk_args Filter Hook
- suredonation_output_campaign_meta_tags Filter Hook
- suredonation_new_donor_user_data Filter Hook
- suredonation_integration_payload Filter Hook
- suredonation_import_phase_mappers Filter Hook
- suredonation_import_givewp_phases Filter Hook
- suredonation_import_givewp_phase_mappers Filter Hook
- suredonation_import_donation_row Filter Hook
- suredonation_import_campaigns_limit Filter Hook
- suredonation_field_block_config Filter Hook
- suredonation_export_one_time_only Filter Hook
- suredonation_export_campaigns_limit Filter Hook
- suredonation_email_smart_tags Filter Hook
- suredonation_email_smart_tag_groups Filter Hook
- suredonation_email_field_char_limits Filter Hook
- suredonation_disable_default_styles Filter Hook
- suredonation_default_validation_messages Filter Hook
- suredonation_default_email_notifications Filter Hook
- suredonation_create_donation_data Filter Hook
- suredonation_config_abilities Filter Hook
- suredonation_available_payment_methods Filter Hook
- suredonation_allowed_form_html Filter Hook
- suredonation_allowed_form_blocks Filter Hook
- Validatable Blocks Filter Hook
- Update donation data, Filter Hook
- OttoKit Integration: suredonation_suretriggers_integration_data_filter Filter Hook
- suredonation_show_setup_gateway_notice Filter Hook
- suredonation_show_review_notice_gateway Filter Hook
- suredonation_show_review_notice_donation Filter Hook
- suredonation_registered_payment_methods Filter Hook
- suredonation_register_additional_blocks Filter Hook
- suredonation_receipt_html Filter Hook
- suredonation_phone_geo_enabled Filter Hook
- suredonation_phone_geo_api_hourly_cap Filter Hook
- suredonation_paypal_webhook_handle_event Filter Hook
- suredonation_paypal_sdk_args Filter Hook
- suredonation_output_campaign_meta_tags Filter Hook
- suredonation_new_donor_user_data Filter Hook
- suredonation_integration_payload Filter Hook
- suredonation_import_phase_mappers Filter Hook
- suredonation_import_givewp_phases Filter Hook
- suredonation_import_givewp_phase_mappers Filter Hook
- suredonation_import_donation_row Filter Hook
- suredonation_import_campaigns_limit Filter Hook
- suredonation_field_block_config Filter Hook
- suredonation_export_secret_option_keys Filter Hook
- suredonation_export_one_time_only Filter Hook
- suredonation_export_campaigns_limit Filter Hook
- suredonation_email_smart_tags Filter Hook
- suredonation_email_smart_tag_groups Filter Hook
- suredonation_email_field_char_limits Filter Hook
- suredonation_disable_default_styles Filter Hook
- suredonation_default_validation_messages Filter Hook
- suredonation_default_email_notifications Filter Hook
- suredonation_create_donation_data Filter Hook
- suredonation_config_abilities Filter Hook
- suredonation_available_payment_methods Filter Hook
- suredonation_allowed_form_html Filter Hook
- suredonation_allowed_form_blocks Filter Hook
- suredonation_import_batch_complete Action Hook
- suredonation_import_complete Action Hook
- suredonation_import_donation_inserted Action Hook
- suredonation_import_donor_inserted Action Hook
- suredonation_import_session_created Action Hook
- suredonation_import_givewp_batch_complete Action Hook
- suredonation_import_givewp_session_created Action Hook
- suredonation_privacy_data_exported Action Hook
- suredonation_enqueue_form_frontend_scripts Action Hook
- suredonation_after_form_duplicated Action Hook
- suredonation_email_sent Action Hook
- suredonation_donor_user_created Action Hook
- suredonation_donation_refunded Action Hook
- suredonation_donation_status_changed Action Hook
- suredonation_donation_completed Action Hook
- suredonation_new_donation Action Hook
- suredonation_donation_created Action Hook
suredonation_show_review_notice_gateway Filter Hook
Overview
The suredonation_show_review_notice_gateway filter controls whether the Leave a Review admin notice is displayed when a payment gateway has been configured but the site has not received any live donations yet.
By default, the notice is enabled. Developers can use this filter to suppress the notice when it is not appropriate for a specific website or admin workflow.
When to Use This Filter
Use this filter when you need to control the visibility of the gateway review notice.
For example, you can use it to:
- Hide the review notice.
- Suppress review requests for specific websites.
- Disable the notice for custom admin workflows.
- Control the notice based on custom conditions.
Filter Signature
apply_filters( 'suredonation_show_review_notice_gateway', true );Parameters
| Parameter | Type | Description |
| $value | bool | Determines whether the gateway review notice should be displayed. |
Default Value
The default value is: true
This means the review notice is enabled by default.
Return Value
Return a boolean value:
| Return Value | Result |
| true | Allows the review notice to be displayed. |
| false | Suppresses the review notice. |
Basic Usage
Use add_filter() to register a custom callback.
add_filter('suredonation_show_review_notice_gateway', 'your_custom_function', 10, 1 );
function your_custom_function( $show ) {
    return $show;
}Example: Disable the Review Notice
The following example permanently disables the gateway review notice.
// Never show the gateway review notice.
add_filter( 'suredonation_show_review_notice_gateway', Â '__return_false');Example: Conditionally Disable the Notice
You can also use custom conditions to determine whether the notice should be displayed.
add_filter( 'suredonation_show_review_notice_gateway', 'mysite_hide_gateway_review_notice', 10, 1);
function mysite_hide_gateway_review_notice( $show ) {
    if ( current_user_can( 'manage_options' ) ) {
        return false;
    }
    return $show;
}How It Works
The filter is applied inside:
Notices::display_review_notice_gateway()
The filter determines whether SureDonation is allowed to display the review notice.
Returning false prevents the notice from being displayed.
Additional Display Conditions
Returning true does not force the notice to appear. SureDonation also checks additional conditions before displaying it.
The gateway review notice is displayed only when:
- At least three days have elapsed.
- No live donation has been received yet.
- A payment gateway has been configured.
- The filter allows the notice to be displayed.
Related Hooks
- suredonation_show_review_notice_donation
- suredonation_show_setup_gateway_notice
Was this doc helpful?
What went wrong?
We don't respond to the article feedback, we use it to improve our support content.
Table of Contents