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

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

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.

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.
Refer to the tmLogin.html for more information.

Direct Links - Ticket Related

The following show examples of direct links that get you to events or performances.

They are displayed on the tmTickets.html web page

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 second 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 (by passing the event and performance selection).

Each of the items in the link (except bestavail) are optional
You can also use this to quickly select a number of general admission tickets for purchase
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 Future Tickets or Streaming Performances

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 and/or streaming content 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.
  • or upcoming streaming live events that they have purchased - may require and edit to TMcheckoutinvoiceEmail.html to indicate how to see the performances online.

 

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 out any additions to the URL blank
  • A specific order - add &order=xxxx to the URL where xxxx is the order number
  • A specific shopping cart - add &cart=yyyy to the URL where yyyy is the shopping cart number

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

If you want to print a test PDF ticket to see what it looks like, use the URL(s) below

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

IF you are trying to make tickets that print on ticket printers, please see the documentation about ticket faces for ticket printers.

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 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 Special List of Events

https://tickets.yourvenue.org/TheatreManager/1/login?event=0&search=XXXXXX[& 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 A 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 A from the link above. If a value is not present one can be added. Multiple values can be referenced at one time by separating the references with commas and using the 'in' clause.

    For example: PB_PERF_FLAG in('A','B','C','D')

     

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 - Course Related

the following are links that are related to selling courses or taking attendance.

You can also use many of the link that are ticket related if you provide the event # for the course

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 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 - Donation Related

The following show links to donation related items

Direct link to Donation Campaign List

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

 

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

 

If no category is used, the above link will direct a patron to the Donation Campaign Page and show all donation campaigns in all categories, like the HTML page below, from which they can pick.

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

General Parameters

  • category=xxxxxx (optional) where xxxxx is the code table value from the Donation Campaign Code Table. You can repeat this parameter in the URL for each category you want to show.
  • 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 Donation Campaigns

https://tickets.yourvenue.com/TheatreManager/1/login? donationcampaigns&category=1042&category=1043[&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 Donation Campaign Code Table shown above. Icons are entered on the Description Tab in Donation Campaign setup.

You might use this to show capital campaign or individual gifts on a separate web page.

 

You can also Link to specific donations if you wish.

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 - Packages

https://tickets.yourvenue.org/TheatreManager/1/online?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 - 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 - Pass/GC Related

The links that follow are related to passes and gift certificates.

They are displayed on the tmpass.html web page

Direct Link to Pass Categories

Showing all Passes and Gift Certificates by Category

https://tickets.yourvenue.com/TheatreManager/1/login?membershiptypes[&category=xxxxxx][&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

  • category=xxxxxx (optional) where xxxxx is the code table value from the Gift Certificate Categories Code Table. You can repeat this parameter in the URL for each category you want to show.
  • 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 get Gift Certificate Balance

Showing the current balance on a patron's gift certificates/passes

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

 

The above link will direct a patron to the pass/Gift Certificate page that shows the current balance on any passes that still have a balance that can be used. The patron will need to log in first, if they are not currently logged in.

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 - Inventory/Merchandise Related

the following shows some of the direct links for inventory, merchandise or rental related items

Direct Link to Merchandise

https://tickets.yourvenue.org/TheatreManager/1/online?merchandise

 

Merchandise and Rentals are resources and found in the same location with Theatre Manager. If your organization offers both options online the ?merchandise link will display only those items where the Sales Method is set to For Sale.

For further definition of merchandise items you may wish to use &group=XX as an additional parameter to access resources based on their Resource Group. Each resource requires a Resource Group at the time of setup. To determine the value of XX you'll need to locate the Facility Resource Group number.

Merchandise are resources where the sales method is set to FOR SALE

 

Facility Resource Group Sequence Number

  • Click Setup >> System Tables >> Code Tables.
  • Select Facility Resource Groups
  • Locate the Facility Resource Group number in the Seq # column

    The Facility Resource Group number is in the far left column labelled Seq #. It can be used to replace the "xx" in the example link above.

Direct Link to Rentals

https://tickets.yourvenue.org/TheatreManager/1/online?rentals

 

Rentals and Merchandise are resources found in the same location with Theatre Manager. If your organization offers both options online the ?rental link will display only those items where the Sales Method is set to Rental.

For further definition of rental items you may wish to use &group=XX as an additional parameter to access resources based on their Resource Group. Each resource requires a Resource Group at the time of setup. To determine the value of XX you'll need to locate the Facility Resource Group number.

Merchandise are resources where the sales method is set to RENTAL

 

Facility Resource Group Sequence Number

  • Click Setup >> System Tables >> Code Tables.
  • Select Facility Resource Groups
  • Locate the Facility Resource Group number in the Seq # column

    The Facility Resource Group number is in the far left column labelled Seq #. It can be used to replace the "xx" in the example link above.

Direct Link to Resources

https://tickets.yourvenue.org/TheatreManager/1/online?resources

 

Resources can consist of a combination of Resources, Rentals and Merchandise. All of these options are setup in the same location with Theatre Manager. By using the ?resources link a full list of all Rentals and For Sale items, as defined in the Pricing & Inventory tab of the resource setup, will appear online.

For further definition of resource items you may wish to use &group=XX as an additional parameter to access resources based on their Resource Group. Each resource requires a Resource Group at the time of setup. To determine the value of XX you'll need to locate the Facility Resource Group number.

Merchandise are resources where the sales method is either RENTAL or FOR SALE

 

Facility Resource Group Sequence Number

  • Click Setup >> System Tables >> Code Tables.
  • Select Facility Resource Groups
  • Locate the Facility Resource Group number in the Seq # column

    The Facility Resource Group number is in the far left column labelled Seq #. It can be used to replace the "xx" in the example link above.

Direct Link to specific resource

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

 

The link above will go directly to the resource or inventory item named by resource (by providing the resource/inventory item #).

Each of the items in the link (except resource) are optional
You can also use this to quickly select a number of merchandise or resources for purchase
They mean:
  • resource=xx xx=the unique resource or inventory number. This parameter is mandatory
  • qty=qq causes the system to default for 'qq' resources or inventory items to purchase. If not specified, this will default to 1.
  • 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 the resource based on your combination of selections, you'll be told.

Direct Link specific resource (quick add)

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

 

The link above will ADD the resource or inventory item named by resource (by providing in the resource/inventory item).

Each of the items in the link (except resourcequick) are optional
You can also use this to quickly select a number of merchandise or resources for purchase
They mean:
  • resourcequick=xx xx=the unique resource or inventory number. This parameter is mandatory
  • qty=qq causes the system to default for 'qq' resources or inventory items to purchase. If not specified, this will default to 1.
  • 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 the resource based on your combination of selections, you'll be told.

The image below shows what a resources if you were adding it normally. resourecequick bypasses this window and adds the item directly to the cart - as if it had filled in the fields that you see on the image.

Direct Link to Coupon & Pre-Access Codes

Pre-Access Codes

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

 

Coupon

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

 

Parameters:

  • code=xxx - where xxx is the short name of the coupon code. For example: coupon&code=FIVEOFFTUESDAY
  • redirect=zzzz (optional) can be used to direct the user to a specific web page after the coupon is accepted. The default is the cart page but you can substitute btnGetEventList for zzzzz to send the user to the event list if its a pre-access code.

     

    Example of Pre-Access Codes added to a cart and displays all valid events for the pre-access

    https://tickets.yourvenue.org/TheatreManager/1/online?presale&code=xxx&redirect=btnGetEventList

     

    There are two aliases for 'redirect' that can be used interchangeably:
    • next -or-
    • F_HTML_REDIRECT_COUPON
  • 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 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 pay for Order

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

 

Selecting an ordr to pay online

The above link can be used when you wish to send an email to a patron to have them pay for the order online.

Parameters:

  • order - indicates that the web page should open at the unpaid order selection window online

    if you add the order number using order=xxx then the specific order will be automatically added to the cart. It means you can put a link in an email merge to pay for a specific order if you want.

This will land the patron on the Order Balance web page (after they log in) so that they can select the order to pay online.

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 Mail Lists

If you make some mail lists available online, that patrons can subscribe to them in one of two ways:
  • You can direct people to a sign up web site that only requires name, email address and clicking on some mail lists that describe how your venue will contact them. This always uses a 'double-opt-in' approach for data accuracy and prevent spamming.
  • You can also have people log into the web site and select mail lists on the patron account window. These mail lists may optionally be set for double opt in
Diataxis: 

Direct Link to mail list sign up page needing only Name and email

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

  • If the patron's email address does not exist, Theatre Manager will create a limited profile patron in the Theatre Manager database.
  • If the patron's email address already exists, Theatre Manager adds the patron to the mail list
  • In both cases, a double opt in email is sent to the patron's email address asking them to confirm they want to be added to the mail list. If they fail to respond within the time limit on company preferences, they will be removed from the mail list automatically

 

Setup Requirements for adding to a mail list Anonymously

The Mail Lists that are visible in this web page are those with the following characteristics:

  • allow subscribe/unsubscribe on the web -and-
  • patron does not have to be logged in to subscribe
  • External Name is a short name that the user can click on the web page such as 'Tell me about Auditions'
  • Description is a longer description that can explain to the patron what the purpose of the mail list using 'marketing friendly' words like 'we will keep you informed about upcoming auditions for your children about a month before they occur'

Direct Link for patrons to manage their own email lists after logging in

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

 

You can use this link to allow people to see which mail lists they belong to. Since they have to log in, double opt in is not applicable, but can be used.

 

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.

 

Setup Requirements for adding to a mail list Anonymously

The Mail Lists that are visible in this web page are those with the following characteristics:

  • allow subscribe/unsubscribe on the web -and-
  • patron must be logged in to subscribe
  • External Name is a short name that the user can click on the web page such as 'Tell me about Auditions'
  • Description is a longer description that can explain to the patron what the purpose of the mail list using 'marketing friendly' words like 'we will keep you informed about upcoming auditions for your children about a month before they occur'

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.