Direct Donation Add Link (quick add)

[&DD_FLD1_FC_SEQ=pp][& DD_FLD2_FC_SEQ=qq][& DD_FLD3_FC_SEQ =rr][&frequency=0][&param=altbtn=btnCheckout][&tmsource=zzzzz]


This link allows you to add a donation to the shopping cart with minimal interaction. It means you can put it anywhere on any web page. The user does not get any choices. If you wish choices like Donate $10 or Donate $50, you will need to put multiple buttons on the page.

This URL supports quickly adding a donation to a cart from ANY web page including: and taking you to checkout right away, subject to any rules:
  • for setting up accounts or quick checkout -and-
  • the minimum data required for a donation. If, for example, donation field 1 is mandatory, you need to specify a valid value

Sample web flow using this link

In the image above, the URL to quickly add a donation can be on any page. If it contains the minimum data needed, the diagram shows the flow that occurs for regular patron checkout and for guest checkout.


Parameters on the URL

The following parameters can be added after the

  • donationquick=xx where xx represents the Campaign # from within Theatre Manager.
  • amount=100.00 is required and sets the amount of the donation.
  • param=altbtn=btnCheckout (optional). After the donation is added, the user is typically taken to the shopping cart.

    Use the param features if you want the patron to go directly to the checkout page. Patrons will:

    • need to log in to their account, -or-
    • if you allow use of the limited profile patron feature (AKA guest checkout) for donations, the patron can make an account that meets minimum data required for a patron.
  • DD_FLD1_FC_SEQ=pp (optional). If specified, pp must be a valid, active value from the Donor#1 Popup code table. Invalid values will result in rejection.

    Note: If any donor popup is mandatory in company preferences, you must specify this parameter and a value for it in the URL.
  • DD_FLD2_FC_SEQ=qq (optional). If specified, qq must be a valid, active value from the Donor#2 Popup code table
  • DD_FLD3_FC_SEQ =rr (optional). If specified, rr must be a valid, active value from the Donor#3 Popup code table
  • frequency=0 (optional) and suggests the frequency for recurring donations. The default is 0, for a single, one-time donation.

    Values of frequency are:

    • 0 - one time gift (the default)
    • 1 - monthly recurring gift
    • 2 - A Gift Every 2 Weeks
    • 3 - A Gift Every 3 Months (each Quarter)
    • 4 - Annual Gift
    • 5 - Daily Gift
    • 6 - Weekly Gift
    • 7 - A Gift Every 2nd Month
  • tmsource=yyyyyy (optional) where yyyyyy is a tracking code that is placed on any cart for tracking the source of the referral.

Example donation quicklink in form letters

This example shows URL's added to a fundraising form letter, suitable for eblasting to patron to ask for a donation with two embedded donation quicklink's.

In this example, there are 4 actual links:


Making the sample form letter

The links (above) are part of this sample fundraising form letter created in Theatre Manager with the purpose of emailing to ask people to donate. It is based on patrons so that I could use a mail list to determine the people to send to - meaning it could be volunteers plus donors in past year, plus ticket buyers with cancelled shows, etc.

The general steps to create the letter were:

  • Type the content
  • Add merge field for the patron's name to make it feel personal
  • Add the images by:
    • Clicking the cursor where I wanted an image to be placed
    • Drag the images onto the document from the desktop (company logo, youtube logo, $50 one time, $10 a month)
    • If you get the image in thr wrong spot, you can cut/paste it, or drag it.
    • If the image is too big, DOUBLE CLICK on it, click the size tab and indicate how you want it scaled (refer to the image to the right)
  • once you have the document looking like you want it, you add a URL one of two ways:
    • for images (see sample instructions in the full document above)
      • double click on the image again
      • click on the link tab
      • Click on picture can be clicked - if you don't do this, then the image will not respond top clicks in the users mail client when sent as an email
      • Paste the URL into the area for the URL. NOTE: make sure you try the URL in a browser before pasting it here
    • for text links:
      • Highlight the text that you want the link to be behind
      • Right click to get the context menu
      • Select Insert Document Object
      • Select Hyperlink from the sub menu
      • The text hyperlink window opens

        NOTE: make sure to put the URL into the right field


What does the eblast look like?

It looks like a regular email sent to people. Theatre Manager tracks

  • who you sent the email to
  • and if they opened it or not


What does clicking on the donation buttons do

In the sample letter, I clicked on both buttons to show the effect and logged in. Because I clicked on them one at a time, both donations got added to a shopping cart as per the image below. The buttons below are included and active in case you want to try them.

This illustrates an e-blast with a one button donation ask for specific amounts. All the user would need to do is log in (or create an anonymous profile that you can merge later) and pay. A donation can be done in 3 button clicks.

Example donation quicklink within TM

This example shows 3 donation buttons placed inside your web pages at the top of the event list. Using this concept, these could be placed anywhere and would be themed to look like your web pages.

The example code is below the image

Sample code placed in tmTicketCustomPatronInstructions.html

While the code below could be placed anywhere in an appropriate web page file in Theatre Managers 'WePages' folder, the following was added to TMtemplates/tmTicketCustomPatronInstructions.html as an existing convenient way to place buttons at the top of the event list. Other good places to add donation buttons are:

  • TMtemplates/tmCheckoutExtraMessagesEmail.html which is used by the confirmation email and typically has nothing in it.
  • TMtemplates/tmCartEmpty.html which is displayed when the shopping cart is empty. For this situation, we'd suggest leaving the destination page as the cart.
  • TMtemplates/rowCartDonationSuggestion.html which is displayed on the cart window suggesting that people make a donation - and in this case, you could add some 'quickdonation' options to make it easier for the patron. For this situation, we'd suggest leaving the destination page as the cart.

The TMtemplates/tmTicketCustomPatronInstructions.html file is used in all event lists and normally has nothing in it.

<div class="alert alert-warning fade in">
<!--#include virtual="TMtemplates/tmMessageDismiss.html" -->
Please consider a donation to the theatre during this time of need. All donations are tax deductible.
<a class="btn btn-info btn-sm" href="<field>F_HTML_FIREWALL</field>login?donationquick=1&amount=50.00&param=altbtn=btnCheckout&tmsource=sometag">
<i class="fa fa-usd">
50 one time
<a class="btn btn-primary btn-sm" href="<field>F_HTML_FIREWALL</field>login?donationquick=1&amount=250.00&param=altbtn=btnCheckout&tmsource=sometag">
<i class="fa fa-usd">
250 one time
<a class="btn btn-success btn-sm" href="<field>F_HTML_FIREWALL</field>login?donationquick=1&amount=10.00&param=altbtn=btnCheckout&frequency=1&has tmsource=sometag">
<i class="fa fa-usd">
10 a month - I'd like to give a little for a little longer

Example donation quicklink outside TM commerce pages

This example shows 3 donation links placed in a web page. Using this concept, you can place them anywhere on any web site you want, such as you main marketing web site, facebook, any marketing partner, etc.

Three sample links are shown below that you can click on followed by the example web page in yellow.

Note: the web page looks very plain because all stylesheet information has been removed for clarity. You may need to add your own style sheets to create buttons like the example code within Theatre Managers event list


Sample code placed a web page

The code below is a complete web page - including the head and body tags. You would only want to copy the links to place them into any of your existing web code such as facebook or wordpess sites

<!DOCTYPE html>
<html lang="en">
Asking for a donation on a simple web page
Sample web page snippet asking for a donation. The links below have not been enhanced with any stylesheet themes
<a href="https:∕∕" target="_blank">
Donate $50 one time
<a href="https:∕∕" target="_blank">
Donate $250 one time
<a href="https:∕∕" target="_blank">
Donate $10 a month - a little for a lot