PDF Receipts allows you to automate the creation of PDFs for your donor’s personal financial records. This can be made available to them through the donation confirmation email and on you website’s donation history page. This documentation walks you through how to configure the plugin to make PDF receipts available to your donors.

Installation and Activation

The first step to implementing PDF Receipts with Give is to download and install the PDF Receipts Add-on. You’ll also need to activate your PDF Receipts license in order to get one-click updates and access to our Priority Support.

PDF Receipts Settings

Now that you have the plugin installed and activated it’s time to configure it. To access the main Add-on settings you will navigate to WP-Admin > Donations > Settings > PDF Receipts:

The PDF Receipts Settings Page
The PDF Receipts Settings Page

PDF Generation Methods

There are two ways to generate PDFs within the Add-on.The first method is the Custom PDF Builder which provides more flexibility to customize the PDF contents and look and feel. The second method is called Set PDF Templates generates the PDFs using preconfigured templates and the data you input in the settings screen. Note: the Custom PDF Builder generation method is included in version 2.0+

Custom PDF Builder Overview

The custom PDF builder generates receipts on the fly using your HTML markup and content within the “PDF Builder” tinyMCE editor. There are several templates provided out of the box that you can customize and save. The editor allows you to customize the images, contents, and markup with flexibility.

To enable Custom PDFs:

  1. Set the Generation Method to Custom PDF Builder – you should now see different fields appear below the dropdown.
  2. Choose the Receipt Template that is to your liking and provide it a custom Template Name so your changes will be saved.
  3. Customize the template to your liking by customizing the text within the PDF Builder TinyMCE WYSIWYG:
Building a Custom PDF Receipt
Building a Custom PDF Receipt

Available Templates to Customize

There are several templates available for you to customize. If you’re savvy with HTML+CSS you can also create or add your own templates.

Available Template Tags

Similar to Give’s email tags, the PDF template tags allow you to insert donation data within your PDFs. Simply add the tag where you need it to display. Here are the tags available:

Included template tags:

{donation_name}: The name of completed donation form
{first_name}: The donor’s first name
{full_name}: The donor’s full name, first and last
{username}: The donor’s user name on the site, if they registered an account
{user_email}: The donor’s email address
{billing_address}: The donor’s billing address
{date}: The date of the donation
{price}: The total price of the donation
{payment_id}: The unique ID number for this donation
{receipt_id}: The unique ID number for this donation receipt
{payment_method}: The method of payment used for this donation
{sitename}: Your site name
{receipt_link}: Adds a link so users can view their receipt directly on your website if they are unable to view it in the browser correctly
{transaction_id}: The donation transaction ID
{transaction_key}: The donation transaction key
{payment_status}: Status of the donation

Working with TinyMCE

TinyMCE is the name of the editor included within WordPress that is used to customize the contents of the Custom PDF templates. When working with the TinyMCE editor and PDF Receipts:

  1. Be careful highlighting large amounts of text and deleting them. This can cause markup to unintentionally be removed. It’s easier to select just the word you need or use the delete/backspace key to remove unwanted characters.
  2. Switching between the “Text” and “Visual” editor may strip content/html/css as well unintentionally
  3. Remember to save your changes regularly
  4. If you make a mistake you can reset your template using the template selection dropdown above the editor

Custom PDF Creation

With the “Blank Template” option found in the “Receipt Template” you have the ability to create custom HTML templates to suit your organization or brand needs.

blank template
blank template

When you are creating “Custom” PDFs from your own HTML we highly recommend:

  1. Avoid using highly complex table layouts found in many custom newsletter layouts. This can cause the PDF generation to take a long time or not render at all. This is a known limitation of DOMPDF, the PDF generation library using in Give PDF Receipts.
  2. DOMPDF is not particularly tolerant to poorly-formed HTML input.  We recommend you run your HTML through a HTML validator/cleaner (such as Tidy or the W3C Markup Validation Service).
  3. CSS Float is a known issue with DOMPDF and may not produce the desired results
  4. Large amounts of HTML and/or markup can cause PDF to take a bit to render. Try increasing your WordPress memory limit to help prevent timeouts.

Set PDF Templates

The Set PDF Templates is less flexible in customization capabilities but does provide good functionality preconfigured receipts. The following will overview each option displayed when the Generation Method is set to Set PDF Templates:

Receipt Template — The PDF Receipts come with 12 different default templates to choose from. See the section below called “Templates” for previews of each of them.

Preview PDF — This will preview how the PDF will appear to donors. Be sure to save your changes prior to previewing. This will add the sample data in the place of your template tags.

Logo Upload — You can add an image or Logo to your PDF Receipts by uploading that here. This uses the standard WordPress media uploader so you can also simply select and image that you have already uploaded as well.

Organization Name — This is where you can add the name of your Organization.

Name — This is where you can add your name.

Address Fields — These are for your organizations mailing address

Email Address — This is where you enter the email address that will appear on the receipt.

Display Website URL — If you check this box, the website url will be displayed on the receipt.

Header Message — If you insert text here, it will appear at the very top of the PDF Receipt, above the logo.

Footer Message — If you insert text here, it will appear at the very bottom of the page, below everything else.

Additional Notes — If you add text here, it will appear directly below the Donation details table. There are several useful “shortcodes” you can use to enter dynamic information:

  • {page} – Page Number
  • {sitename} – Site Name
  • {today} – Date of Receipt Generation
  • {date} – Receipt Date
  • {receipt_id} – Receipt ID

Special Characters — Occasionally the Open Sans font might cause trouble with special characters. If you are having trouble like that, check this box and save changes and it should be resolved right away.

Set PDF Templates

Templates give your PDF Receipts a unique and attractive look and feel. Below are previews of what each template looks like.

Adding a Link in your Donor Emails

If you want to make the PDF available to your donors in the confirmation email, you’ll need to do one additional step.

1) Go to WP-Admin > Donations > Settings and then go to the Emails tab.

2) Click on the sub section titled “Donation Receipt”. There you’ll see your email message that is sent to the donor upon a successful donation. Directly below the textarea you’ll see a list of shortcodes which you can use to add dynamic information. Now that you have PDF Receipts activated you’ll also see a shortcode called `{pdf_receipt}`

3) Add `{pdf_receipt}` anywhere in that email, and a unique link to the download will be populated in the email automatically.

NOTE: A user account is NOT required for donors to be able to access the PDF download. The PDF is generated automatically based on their unique link. This means that PDF’s are not created until requested, which is a good use of server resources

How Donors Access PDF Receipts

After the plugin has been configured donors will have access to download a PDF copy of their donation in two places: (1) The Donation Confirmation page; and (2) The Donation History page.

Give Donation Confirmation page with Downloadable Receipt
Give Donation Confirmation page with Downloadable Receipt
Give Donation History page with Downloadable Receipt
Give Donation History page with Downloadable Receipt

Recurring Donations

If you are using the Recurring Donation add-on to allow the donor to do recurring donations on your website, you can use the following email tags in your PDF receipts:

{subscription_frequency} – Displays the subscription frequency based on its period and times. For instance, “Monthly for 3 Months”, or simply “Monthly” if the number of bill times is 0.

{subscriptions_completed} – Displays the number of subscriptions completed with the total number of bill times. For instance “1/3” or “1 / ∞”.

{cancellation_date} – The date this subscription was cancelled.