- 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_donation Filter Hook
Overview
The suredonation_show_review_notice_donation filter controls whether the Leave a 5-Star Review admin notice is displayed after a site receives its first live donation.
By default, the notice is enabled. Developers can use this filter to suppress the notice when it is not required for a specific website or admin workflow.
Returning false acts as a programmatic kill switch and prevents the notice from being registered.
When to Use This Filter
Use this filter when you need to control the visibility of the donation review notice.
For example, you can use it to:
- Disable the review notice.
- Suppress review requests on specific websites.
- Prevent the notice from appearing for certain admin workflows.
- Apply custom conditions before showing the notice.
Filter Signature
apply_filters( 'suredonation_show_review_notice_donation', true );Parameters
| Parameter | Type | Description |
| $value | bool | Determines whether the donation 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 donation review notice to be displayed. |
| false | Suppresses the notice and prevents it from being registered. |
Basic Usage
Use add_filter() to register a custom callback.
add_filter( 'suredonation_show_review_notice_donation', 'your_custom_function', 10, 1);
function your_custom_function( $show ) {
    return $show;
}Example: Disable the Review Notice
The following example permanently disables the donation review notice.
// Never show the donation review notice.
add_filter( 'suredonation_show_review_notice_donation', '__return_false');Example: Conditionally Disable the Notice
You can also use custom logic to determine whether the notice should be displayed.
add_filter( 'suredonation_show_review_notice_donation', 'mysite_hide_donation_review_notice', 10, 1);
function mysite_hide_donation_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_donation()
The filter determines whether SureDonation should register the donation review notice.
If the filter returns false, the notice is not registered and therefore cannot be displayed.
Additional Display Conditions
Returning true does not force the notice to appear. SureDonation also checks additional conditions before displaying it.
The donation review notice is displayed only when:
- At least three days have elapsed since the plugin installation.
- At least one live donation has been received.
- The filter allows the notice to be displayed.
Related Hooks
- suredonation_show_review_notice_gateway
- 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