Improved Confirmation Messages Coming Soon in Give 1.7

Improved Confirmation Messages Coming Soon in Give 1.7

Over the next weeks, we’ll be writing articles about the upcoming release of Give version 1.7. This will be the final release of this calendar year and there’s some important changes, particularly for developers and third-party Give themes and/or Add-ons that we want you to be informed of in advance.

Improved Confirmation Messages

Relevant Github Issue

The Donation Confirmation page should give your donor a good feeling. Sometimes though, the payment fails. Either way, your confirmation page is the place to inform your Donors that their donation is done and what their next steps are. Our Senior Support Tech, Ben Meredith, just wrote an article on this very subject.

The Donation Confirmation should give your donor a good feeling. Sometimes though, the payment fails. Either way, your confirmation page is the place to inform your Donors that their donation is done and what their next steps are.
The Current Donation Confirmation Page.

Previously, when a donor finalized their donation, they would be greeted by a “Thank you for your donation!” message regardless of whether that donation went through successfully or not.

Coming soon in Give 1.7 you’ll see a new alert on your Donation Confirmation messages:

Coming soon in Give 1.7 you’ll see a new alert on your Donation Confirmation messages.
Coming soon in Give 1.7 you’ll see a new alert on your Donation Confirmation messages.

That’s much better. Now the donor is immediately notified of what happened and what they need to do.

Navigate to Donation History

You’ll also notice the “Return to All Donations” message. That link appears when you navigate from the Donation History page, to the specific receipt. That is available to any donor who has previously donated to your website. Clicking on that will take them back to the Donation History page.

Options and Customizations

But don’t fret. If you prefer to have the Donation Status appear in your receipt table, you can still do that. We created additional shortcode attributes for that purpose.

[[give_receipt]] shortcode has two new attributes:

  • payment_status determines whether status row within receipt is displayed. Default false.
  • status_notice determines whether notice above receipt is displayed. Default true.
  • For developers, we’ve also added in filters so you can customize each status message. For example, rather than just asking donors to contact you in the Failed status, use the give_receipt_status_notice to customize the Failed message and point them to the contact page with a link. Here’s an example:
function prefix_custom_failed_notice( $notice, $id, $status, $meta ) {
    if ( 'failed' === $status ) {
        return give_output_error( __( 'Whoops! Something went wrong with your donation. Please contact us to finalize your donation.' ), false, 'failed' );
    }

    return $notice;
 }

add_filter( 'give_receipt_status_notice', 'prefix_custom_failed_notice', 10, 4 );

It’s the Little Things in Life

Who knew that such small changes could be so important? As we continue to improve Give, its code-base, and your Admin experience, we always have your donor forefront in our minds.

Give 1.7 is progressing fine and should roll out before the U.S. Thanksgiving holiday. Subscribe to our newsletter to get updates on this and more.

About the Author

Share this post

Join Our Newsletter

Get fundraising insights directly in your inbox. Plus a 15% discount off all plans.

  • This field is for validation purposes and should be left unchanged.

Copyright © 2024 Liquid Web, L.L.C.

GiveWP™ is a trademark of Liquid Web, L.L.C.

A Liquid Web Brand

© 2024 All Rights Reserved.