Redirecting a link to a specific sales page in the Web Services

We recommend always adding a [&tmsource=YYY] to external links to identify where the patron first entered the web sales process. Carts are tagged with the source code and it provides the most direct correlation between:
  • Where the patron started at this external web site, responded to a specific eblast, or clicked a button in facebook offer for a specific show etc -and-
  • if they actually created a cart, whether completed or not.
It is straightforward to redirect a link from your main web site to a specific web page on the Theatre Manager web listeners if you construct a link using the following syntax (generally with a target="_blank")

https:// tickets. yourvenue. org [/TheatreManager/1/login[?action=0|number][&lang=XX][&tmsource=YYY]]

The meaning of the parts of the above syntax is:

  • https:// tickets. yourserver. com is the direct link to the Theatre Manager web server. It is the only part that is mandatory.
  • /TheatreManager/1/login - if supplied, is used by the apache server to direct the user to the theatre manager web listeners and begin the sales process. The '1' is replaced by your outlet number in a multi-outlet site. In most cases, it is '1' corresponding to the '1' folder within the standard 'WebPages' web page structure.
  • ?action=0|number - 'action=' is replaced by one of the specific words as shown in the sections that follow (eg action might be 'event' or 'pass' or 'donation'). If you use 0 as the parameter, the user will be able to start at the selection process for 'action'. If you use a specific number as the parameter, then the user will be placed directly at the start of the sales process for the 'action'. For ticket sales web page access, there are some other options as described below.
  • &lang=XX - if you build a multi language web site, you can direct the user to begin using a language you specify. &lang=EN is the default. There must be a WebPagesXX folder for each language you want to support
  • &tmsource=yyy - which is an optional parameter that can be used to detect the web site referrer and attach it to a shopping cart. The idea with this is that you might tie the source to an eblast, another web site, your own site, some tourism source, etc. The value 'yyy' is attached to a shopping cart and once a value is in the cart, it cannot be changed. This means that the first source (or referrer) is used. Note: the source can also be set using a cookie if you want instead of a command line argument. For additional steps on setting up source references, click here.

Note that parameters in a URL are case sensitive.

Most keyword parameters are lower case unless they refer to an actual database variable. The documentation attempts to show examples in the appropriate case.

It is possible to write an interface to extract the event information and upload it your main marketing web site. For example: you can use the extracted information to publish data from TM into a custom calendar object and create 'buy now' links using the patterns above.

You can only use 'GET' style links on web pages in normal format or behind pictures of buttons.

You cannot simulate these links with 'posts' due to PCI compliance requirements to use form-tokens in each post per OWASP requirements to prevent cross-site scripting

Standard Access to Web Sales

https://tickets.yourvenue.org/TheatreManager/1/login?event=0

 

The general starting place for all sales is usally a link like the one above which is placed on the main web site. This link directs the patron to the Event List within the online sales. It allows them to start their online shopping experience by selecting the first performance they are interested in purchasing.

Direct Link to Login

https://tickets.yourvenue.org/TheatreManager/1/login[?tmsource=yyyyy]

 

Each direct link contains a reference to login. This allows the link to bypass the login window and access the desired location. When a link to only the login window is desired, leave out any additional parameters on the URL.

Parameters are:

  • tmsource=yyyyyy (optional) where yyyyyy is a tracking code that is placed on any cart for tracking the source of the referral.

Direct Link to Event

https://tickets.yourvenue.org/TheatreManager/1/login?event=xx[&tmsource=yyyyyy]

 

To create links beside each event advertise on your web site:

Click here to purchase tickets to Event #1 - https://tickets.yourvenue.org/TheatreManager/1/login&event=51
Click here to purchase tickets to Event #2 - https://tickets.yourvenue.org/TheatreManager/1/login&event=52
Click here to purchase tickets to Event #3 - https://tickets.yourvenue.org/TheatreManager/1/login&event=58
Click here to purchase tickets to Event #4 - https://tickets.yourvenue.org/TheatreManager/1/login&event=62

In the above examples the event value is defined by Theatre Manager as the unique event number for each different event. The event number is found by:

You can add other parameters to the event list such as:

  • &year=201x (to get events for that year)
  • &month=xx (to get events for that month)
  • &genre=mm (to show only events for that genre)
  • &venue=zz (to those only events in that venue)
  • and you can use a combination of the above to limit to a specific year and month if you want, or a specific year in a venue
  • tmsource=yyyyyy (optional) where yyyyyy is a tracking code that is placed on any cart for tracking the source of the referral.

Note: years are in yyyy format, Months are 0 to 12, genre # is from code tables, venue # is from list of venues. eg:

https://tickets.yourvenue.org/TheatreManager/1/login&event=51&year=2016&month&9&venue=5

  • Click Setup >> Events.
  • Click the button to populate the Event List.
  • Locate the Event # column to the far left.

    This column in the Event List shows the unique sequence number for each item in the list. Use the Event # to replace the "xx" in the link above.

Direct Link to Performance

https://tickets.yourvenue.org/TheatreManager/1/login?performance=xx[&tmsource=yyyyyy]

 

Parameters are:

  • tmsource=yyyyyy (optional) where yyyyyy is a tracking code that is placed on any cart for tracking the source of the referral.
  • performance=xx - The link above will go directly to selling a performance (bypassing the event selection - per the example below). The unique performance number will replace the "xx" in the link. To find the performance number:
    • Click Setup >> Events.
    • Click the button to populate the Event List.
    • Double-click an Event to open it.
    • In the Event Setup Window, select the Performance Tab to see the list of Performances for that Event.
    • Locate the far left column, labeled Perf #

      This column displays the unique performance number for each performance of the Event. Replace the "xx" in the link above with the desired performance number to create a direct link to the performance.

 

Example of page for Direct Link To Performance

 

Direct Link to Genre

https://tickets.yourvenue.org/TheatreManager/1/login?event=0&genre=xx&[tmsource=yyyyyy]

 

Parameters:

  • &event=0 is required prior to the &genre=xx parameter to create a link for genre's of events
  • &genre=xx - he genre options are the same as those defined for ticket trove and cannot be changed by the venue. The values for xx can be found in the 'event genre' code table:
    • Click Setup >> System Tables >> Code Tables.
    • Select the Event Genre option in the left column.
    • Locate the Seq # column.

      This is the unique number representing the genera. It can be used to replace the "xx" in the link above.

  • tmsource=yyyyyy (optional) where yyyyyy is a tracking code that is placed on any cart for tracking the source of the referral.

Direct Link to Pick-Your-Seat

https://tickets.yourvenue.org/TheatreManager/1/login?bestavail=xx&section=yy&pricecode=Z&qty=qq&separate=1&seats=123,124,125[&tmsource=yyyyyy]

 

The link above will go directly to the best available seats to the performance named by bestavail (bypassing the event and performance selection).

Each of the items in the link (except bestavail) are optional
They mean:
  • bestavail=xx xx=the unique performance number. This parameter is mandatory
  • section=yy causes seats to be suggested in the best available section which is set up for the pricing map used for that performance. Leave blank to search the entire venue.
  • pricecode=Z causes seats to be suggested that matches a price code enabled for the performance. If the price code is not valid or not enabled for the performance, nothing will be shown on the best seat map.
  • qty=qq causes the system to look for 'qq' seats.
    • If not specified, this will default to the suggested purchase quantity for a performance in the Web tab. This is usually it is 2 for tickets and 1 for courses.
    • If specified, it overrides the default in the suggested purchase quantity
    • Specifying qty=0 has a special meaning. It will take the patron from directly the select your seats without pre-selecting anything. This means the option is select your seat with no fallback choices for the patron
  • separate=1 allows the system to suggest seats that are separate from each other, which is useful as the performance sells out. separate=0 is the default, meaning that seats offered to the patron must be together
  • seats=123,124,125 allow you to specify which logical seats you want to select on the the 'choose your own seats' map. It is not guaranteed that the patron will get those seats, only that they will be highlighted on the map and then the patron will have to choose them and have Theatre Manager confirm that it is ok to choose them. The seat numbers are the left column in the pricing map
  • tmsource=yyyyyy (optional) where yyyyyy is a tracking code that is placed on any cart for tracking the source of the referral.

You can put any combination of the parameters together that you wish. if the system cannot find seats based on your combination of selections, you'll be told.

The simplest form of the url to get any seats anywhere in the venue is

An example to allow pick your own without reserving seats first

 

To find the performance number:

  • Click Setup >> Events.
  • Click the button to populate the Event List.
  • Double-click an Event to open it.
  • In the Event Setup Window, select the Performance Tab to see the list of Performances for that Event.
  • Locate the far left column, labeled Perf #

    This column displays the unique performance number for each performance of the Event. Replace the "xx" in the link above with the desired performance number to create a direct link to the performance.

Direct Link to Coupon & Pre-Access Codes

Pre-Access Codes

https://tickets.yourvenue.org/TheatreManager/1/online?presale&code=xxx[&tmsource=yyyyyy]

 

Coupon

https://tickets.yourvenue.org/TheatreManager/1/online?coupon&code=xxx[&tmsource=yyyyyy]

 

Parameters:

  • code=xxx - where xxx is the coupon code
  • tmsource=yyyyyy (optional) where yyyyyy is a tracking code that is placed on any cart for tracking the source of the referral.

The above links will auto add a pre-access or coupon code for a patron.

Direct Link to Courses

https://tickets.yourvenue.org/TheatreManager/1/login?event=0&search=PB_SALES_METHOD='xx'[&tmsource=yyyyyy]

 

This link will take the patron to a select list of Performances based on the Sales Method for the Performance. The "xx" represents the Performance Sales Method sequence value from within Theatre Manager.

Sequence #Performance Sales Method
1Reserved Performances
2Festival Seating Performances
3Inventory
6Courses
Other parameters
  • tmsource=yyyyyy (optional) where yyyyyy is a tracking code that is placed on any cart for tracking the source of the referral.

Direct Link to Future Tickets

https://tickets.yourvenue.org/TheatreManager/1/login?futuretickets

 

This link will take the patron to your web site and, after they log in, will show them your future tickets. At that time, they can print those which allow print at home.

 

Example of future tickets web page on web site

The example below shows that the future tickets web page looks like when a customer logs in online. They can see their events with the new dates, along with the ability to print tickets at home. If you change many tickets for many events, this might be the best thing to direct customers to with an email, so that they can view and print their own.

Direct Link to Print-at-Home Tickets

Printable HTML: https://tickets.yourvenue.org/TheatreManager/1/login?futureticketsprint&[ cart=xxx] | [&order=yyyy]

PDF: https://tickets.yourvenue.org/TheatreManager/1/login?futureticketspdf&[ cart=xxx] | [&order=yyyy]

Logged In Options

Theatre Manager supports print at home tickets in either bar or QR code format which means you can send URL's to the user via email to get ticket printed. Theatre Manager does the one for the cart automatically on the confirmation letter during the sales process

By adding options to the URL above, you can print tickets for

  • All future tickets - leave the URL blank
  • A specific order - add &order=xxxx to the URL
  • A specific shopping cart - add &cart=yyyy to the URL

Note: if the patron owning the tickets is:

  • currently logged in to the online sales web site, the ticket print dialog will open.
  • not logged in, then the web site will require a log in before taking the patron to the print tickets window

Testing Options

Printable HTML: https://tickets.yourvenue.org/TheatreManager/1/login?futureticketsprint&test=1

PDF content as HTML: https://tickets.yourvenue.org/TheatreManager/1/login?futureticketspdf&test=1&html=1

Direct Link to Venue

https://tickets.yourvenue.org/TheatreManager/1/login?venue=xx[&tmsource=yyyyyy]

 

Purchasing Tickets to a Venue

The above link can be used when a venue has different type of events and a link is required to directly sell any performance in that venue.

Parameters:

  • venue=xx - the 'venue' value is defined by Theatre Manager as the unique venue map number. To find the venue map number:
    • Click Setup >> Venue Maps.
    • Locate the far left column is labeled Map #:

      This is the unique sequence number representing the map. It can be used to replace the "xx" in the link above.

  • tmsource=yyyyyy (optional) where yyyyyy is a tracking code that is placed on any cart for tracking the source of the referral.

Direct Link to event from an advertisement

https://tickets.yourvenue.org/TheatreManager/1/login?event=0[&tmsource=yyyyyy]

 

To create links to show only events relating to a pre advertise on your web site:

Click here to purchase tickets to Event #1 - https://tickets.yourvenue.org/TheatreManager/1/login?event=51
Click here to purchase tickets to Event #2 - https://tickets.yourvenue.org/TheatreManager/1/login?event=52
Click here to purchase tickets to Event #3 - https://tickets.yourvenue.org/TheatreManager/1/login?event=58
Click here to purchase tickets to Event #4 - https://tickets.yourvenue.org/TheatreManager/1/login?event=62

In the above examples the event value is defined by Theatre Manager as the unique event number for each different event. The event number is found by:

  • Click Setup >> Events.
  • Click the button to populate the Event List.
  • Locate the Event # column to the far left.

    This column in the Event List shows the unique sequence number for each item in the list. Use the Event # to replace the "xx" in the link above.

Other Parameters

  • tmsource=yyyyyy (optional) where yyyyyy is a tracking code that is placed on any cart for tracking the source of the referral.

Direct link to Calendar

https://tickets.yourvenue.org/TheatreManager/1/calendars/upcoming_events?view=month&start=2018-06-01

 

The Calendar displays upcoming Performances and Classes available for purchase. Patrons can choose to download an existing copy of the calendar as it appears today in an ICS file format or subscribe to the calendar which will allow for automatic updates to their iCal, Outlook or Google calendar program.

 

Optional Parameters

  • view
    • view=month - show items in a monthly calendar view as per the example below - this is the default
    • view=week - show items in weekly calendar format
    • view=list - show items in a list view
  • start
    • indicate the start date for the calendar in yyyy-mm-dd format

Direct link to Manage Performances

https://tickets.yourvenue.org/TheatreManager/1/login?manageperf=xx

 

This link will take the a staff member or volunteer with permission to manage events online to the 'manage event' page in the online sales. The "xx" represents the event # from within Theatre Manager. If the event number is zero, then the employee/volunteer will see a list of all events that they can manage.

Permission to manage an event online is occurs when three things are true:

This link displays the tmEventManagement.html web page. Once the Instructor is on this page, they can:

Direct Link to Subscriptions

https://tickets.yourvenue.org/TheatreManager/1/login?subscription=xx[&tmsource=yyyyyy]

 

Parameters

  • subscription=xx - the link above will take the patron directly to a Season Subscription. The "xx" represents the unique subscription number for that subscription package value as it is defined by Theatre Manager. To find the subscription number:
    • Click Patron Sales >> Season Reservations >> Setup Season Packages.
    • Click the button to populate the list.
    • Location the subscription number for each package.

      The Subscription number is in the far left column labeled Seq #. It can be used to replace the "xx" in the link above.

  • tmsource=yyyyyy (optional) where yyyyyy is a tracking code that is placed on any cart for tracking the source of the referral.

Direct Link to Special List of Events

https://tickets.yourvenue.org/TheatreManager/1/login?event=0&search=XXXXXX[&was tmsource=yyyyyy]

 

The above can be used to create a direct link to a specific list of events (or date range of events) where a customized search is required. The options below are examples of search strings that can be used to replace the "XXXXXX" in the link above. Do NOT place quotes around the entire search parameter. Example:

  • P_SEQ IN (x,y,z,...) where x, y, z are valid P_SEQ (event) numbers - find these 3 specific events
  • PB_SEQ IN (x,y,z,...) where x, y, z are valid PB_SEQ (performance) numbers - find these 3 specific performances.
  • VE_SEQ=a where a is a valid VE_SEQ (venue) number - find all performances in venue 'a'
  • VE_SEQ IN (a,b,c) where a, b and c are valid VE_SEQ (venue) numbers - find all performances in venues 'a', 'b', and 'c'
  • TM_SEQ IN (a,b,c) where a, b and c are valid TM_SEQ (pricing map) numbers - find all performances using pricing maps 'a', 'b', and 'c'
  • P_SEQ IN(x,y) or TM_SEQ=a this will give you the 2 events 'x' and 'y', along with ANY performance in venue 'a'
  • PB_PERFORM_DATE between date '2017-09-15' and date '2017-10-31' This will give you all performances between Sep 15 2017 and Oct 31 2017
  • PB_PERFORM_DATE=current_date will be a list of today's events
  • PB_PERFORM_DATE<=now()+%2B+interval+'7+days' is a list of everything in the next 7 days. The %2B is an encoded 'plus' sign since plus has special meaning of a space
  • PB_PERF_FLAG in ('A','C') This will give you all performances having either of those two letters in the Theatre Manager performance flag field
  • P_GENRE_FC_SEQ not in (100,101,102) can be used to pick all events that do not have a specific genre that is in the code tables.

An Example link directing patrons to TWO (2) specific events would appear like:

Refer to comments within WebPages/1/WebPages/TMTickets.html for more examples on searching for performances within the Ticketing Page.

To find the Event Sequence #:

  • Click Setup >> Events.

    The Event List window will open.

  • Click the button to populate the Event List.
  • The Event # will be listed in the far left column

    This is the unique sequence number for the event and can be used when creating a P_SEQ link.

To find the Performance Sequence #:

  • Click Setup >> Events.
  • Click the button to populate the Event List.
  • Double-click an Event to open it.
  • Select the Performance tab.
  • The far left column, labeled Perf #, shows the unique performance number for each performance of the Event.

    This number can be used with creating a link that references PB_SEQ.

To find the Venue Sequence #:

  • Click Setup >> Venue Maps.
  • The far left column, labeled Venue #, is the Venue Sequence #.

    The Venue # can be used to create a link with a TM_SEQ reference.

Direct Link Using Performance Flag

https://tickets.yourvenue.org/TheatreManager/1/login?event=0&search=PB_PERF_FLAG='A'[&tmsource=yyyyyy]

The link above allow a reference to the Performance Flag within the Performance and will only display the Performances with the matching results within the field. The reference within the Performance Flag field will replace the "xx" in the link. To locate or alter the Performance Flag follow the steps below:

  • Click Setup >> Events.
  • Click the button to populate the Event List.
  • Double-click an Event to open it.
  • In the Event Setup Window, select the Performance tab.
  • Double click on the Performance to be included by the link.
  • Select the Web Settings tab.
  • Locate the Performance Flag field.

    This field will contain the value to replace the XX from the link above. If a value is not present one can be added. Multiple values can be referenced at one time by separating multiple 'XX' references with commas and defining the XX with each unique reference.

Direct Link Using Performance Type

https://tickets.yourvenue.org/TheatreManager/1/login?event=0&search=PB_TYPE1_FC_SEQ=27785[&tmsource=yyyyyy]

 

The above link uses the Sequence number associated with the Performance Type to create a direct link to select Performances. By using this link a defined list of performances can be grouped together and displayed for purchased. To locate the Sequence number references in the link follow the steps below:

  • Click Setup >> System Tables >> Code Tables.
  • Select the Perf Type option in the left column.
  • Locate the Seq # column.

    This column will contain the value to replace the XX in the link above. Multiple values can be referenced at one time by separating multiple XX references with commas and defining the XX with each unique sequence number.

 

To locate or alter the Performance Type for a select Performance follow the steps below:

  • Click Setup >> Events.
  • Click the button to populate the Event List.
  • Double-click an Event to open it.
  • In the Event Setup Window, select the Performance tab.
  • Double click on the Performance to be included by the link.
  • Locate the Perf Type field.

    This field will contain the value referenced by the Performance. The value can be changed using the drop down. The link above will reference all performances where the value within this field matches the sequence number from the link.

 

Direct Link to a Donation (use fillable form)

https://tickets.yourvenue.org/TheatreManager/1/login?donationcampaign=xx&amount=100.00 [&frequency=0][&tmsource=yyyyyy]

 

This link will take the patron to the donation page in the online sales. It will show a fillable form where he patron can make changes to their choices, change amounts and then add the donation to their shopping cart.

  • donationcampaign=xx represents the Campaign # from within Theatre Manager. This link will ensure that indicated Campaign appears as the default in the drop down. Any additional Campaigns available via the internet will also appear in the drop down. This is a unique sequence number assigned to the Campaign by Theatre Manager.
  • amount=100.00 is optional and allows you to set a default amount for the donation if you send people here from an external web site.
  • frequency=1 is optional and suggests the frequency for recurring donations. 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
    The web page template file /tmTemplates/setDonationRecurringFrequencyList.html must have the frequencies enabled that you wish to use.
  • tmsource=yyyyyy (optional) where yyyyyy is a tracking code that is placed on any cart for tracking the source of the referral.
NOTE: the normal route taken by the web server after adding the donation is to go to the shopping cart window. You can alter that destination in a form by using the hidden param below within your form

<input type="hidden" name="param" value="altbtn=btnCheckout" />

altbtn=btnCheckout can be substituted for other web pages, so you could, for example, take the patron to the gift certificate page.

If you would like to show progress to a target, then edit the Statistics Tab on the donation campaign window and click the show on internet (meaning show the progress on internet)

Finding Donation Campaign Number

  1. Click Setup >> System Tables >> Donation Campaigns.
  2. Right-click on the column header in the Donation Campaigns List window.
  3. Select Preferences >> Change Columns.

  4. Single click the Seq # option only if it's not already highlighted or checked.
  5. Click the button in the Campaign List window.

    The Donation List window will populate with Donation Campaigns. Replace the "xx" in the link above with the appropriate donation sequence number to create a direct link to the donation.

    For more information on the Donation List widow click here.

Direct Donation Add Link (quick add)

https://tickets.yourvenue.org/TheatreManager/1/login?donationquick=xx&amount=100.00

[&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 tickets.yourvenue.org/TheatreManager/1/login?

  • 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.
<br/>
<br/>
<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">
</i>
50 one time
</a>
<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">
</i>
250 one time
</a>
<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">
</i>
10 a month - I'd like to give a little for a little longer
</a>
</div>

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">
<head>
<title>
Asking for a donation on a simple web page
</title>
</head>
<body>
Sample web page snippet asking for a donation. The links below have not been enhanced with any stylesheet themes
<br/>
<a href="https:∕∕tickets.artsman.com/TheatreManager/1/login?donationquick=1&amount=50.00&param=altbtn=btnCheckout&morning&tmsource=mysourcetag" target="_blank">
Donate $50 one time
</a>
<br/>
<a href="https:∕∕tickets.artsman.com/TheatreManager/1/login?donationquick=1&amount=250.00&param=altbtn=btnCheckout&tmsource=mysourcetag" target="_blank">
Donate $250 one time
</a>
<br/>
<a href="https:∕∕tickets.artsman.com/TheatreManager/1/login?donationquick=1&amount=10.00&param=altbtn=btnCheckout&frequency=1&tmsource=mysourcetag" target="_blank">
Donate $10 a month - a little for a lot
</a>
</body>
</html>

Direct link to Donation Campaign List

https://tickets.yourvenue.org/TheatreManager/1/login?donationcampaigns[&tmsource=zzzzz]

 

This URL takes a user to a list of all the campaigns that are available online as per the image below.

Direct Link to Pass Categories

Showing all Passes and Gift Certificates by Category

https://tickets.yourvenue.com/TheatreManager/1/login?membershiptypes[&tmsource=yyyyyy]

 

If no category is used, the above link will direct a patron to the Pass/Gift Certificate merchandise page and show all passes in all categories. The patron will see a list of all passes, like the HTML page below, from which they can pick.

A sample is shown at the bottom of the help page.

General Parameters

  • tmsource=yyyyyy (optional) where yyyyyy is a tracking code that is placed on any cart for tracking the source of the referral.

 

Showing selected Categories of Passes/Gift Certificates

https://tickets.yourvenue.com/TheatreManager/1/login?membershiptypes&category=1035&category=1037[&tmsource=yyyyyy]

 

You can specify one or more categories in the URL and only those categories will be shown. In this case, the category numbers must be the same as the code table entry number in the Gift Certificate Categories Code Table shown to the right. Icons are entered on the Marketing Tab in Gift Certificate setup.

You might use this to show upcoming subscription passes for next year on a separate page, or gift certificates on a separate page.

 

You can also Link to specific pass if you wish.

 

Direct Link to a Pass

https://tickets.artsman.com/TheatreManager/1/login?membershiptype=9[&tmsource=yyyyyy]

The above link will direct a patron to the specific pass or gift certificate, ready to buy it.

 

or

 

https://tickets.yourvenue.org/TheatreManager/1/login?pass=0[&tmsource=yyyyyy]

 

The above link will direct a patron to the pass/Gift Certificate/merchandise page. The patron can then use the drop down options to choose the type of Pass, Gift Certificate or Membership they wish to purchase.

You can also have a link to one (or more) groupings (categories) of passes/memberships.

Other Parameters

  • tmsource=yyyyyy (optional) where yyyyyy is a tracking code that is placed on any cart for tracking the source of the referral.

Direct Link to a Package

https://tickets.yourvenue.org/TheatreManager/1/login?package=xx[&tmsource=yyyyyy]

 

The link above will take the patron directly to the package purchase window in the online sales.

Parameters:

  • tmsource=yyyyyy (optional) where yyyyyy is a tracking code that is placed on any cart for tracking the source of the referral.
  • package=xx - yhe "xx" represents the Package # from within Theatre Manager. This is a unique sequence number assigned to the package by Theatre Manager. To find the Package # for the Package:
    1. Click Setup >> System Tables >> Packages.

      The Package List window will open.

      For more information on the Package List window, click here.

    2. Click the button to populate the list.

      The Package # column will be the first column in the list. Replace the "xx" in the link above with the appropriate package number to create a link to the package.

Direct Link to Mail Lists

https://tickets.yourvenue.org/TheatreManager/1/login&maillistquickadd=xx[&tmsource=yyyyyy]

 

This link will allow a patron to subscribe to the mail lists indicated by simply adding their first name, last name and email address. This will create a limited profile for the patron in the Theatre Manager database.

To edit the mail list options available the tmMailListQuickAddInsert.html page needs to be altered. This page needs to be updated with the mail list sequence number and the desired name to be displayed for the mail list. The Mail List Sequence number can be found in Theatre Manager by:

  1. Click Setup >> Mail Lists.
  2. Search for the desired Mail List in the Mail Lists window.
  3. Take note of the number in the List # column.

    This is the Mail List number. It can be used in the tmMailListQuickAddInsert.html page as the input value for the mail lists a patron can subscribe to.

 

https://tickets.yourvenue.org/TheatreManager/1/login?maillist[&tmsource=yyyyyy]

 

This will take the patron directly to the Mail List page within the online sales. Patrons can choose to subscribe and unsubscribe to Mail Lists after they have logged into the online sales.

Accessing Web Page Images

https://tickets.artsman.com/TheatreManager/1/image?event=60

 

You can access the images on the web site for events or venues. They are done in a heirarchy, so that if you ask for the event image and it is not available, you'll get the venue image. If that is not available, you'll get the outlet image.