https:// tickets. yourvenue. org [/TheatreManager/1/login[?action=0|number][&lang=XX][&tmsource=YYY]]
The meaning of the parts of the above syntax is:
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:
|
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.
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:
They are displayed on the tmTickets.html web page
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:
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 |
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.
Parameters are:
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.
Parameters:
This is the unique number representing the genera. It can be used to replace the "xx" in the link above.
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 |
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
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.
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.
The example below shows that the future tickets web page looks like when a customer logs in online. They can see their events with:
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]
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
Note: if the patron owning the tickets is:
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. |
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:
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
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:
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 #:
The Event List window will open.
This is the unique sequence number for the event and can be used when creating a P_SEQ link.
To find the Performance Sequence #:
This number can be used with creating a link that references PB_SEQ.
To find the Venue Sequence #:
The Venue # can be used to create a link with a TM_SEQ reference.
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:
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')
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:
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:
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.
You can also use many of the link that are ticket related if you provide the event # for the course
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 |
1 | Reserved Performances |
2 | Festival Seating Performances |
3 | Inventory |
6 | Courses |
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:
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
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.
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.
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) |
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.
[&DD_FLD1_FC_SEQ=pp][& DD_FLD2_FC_SEQ=qq][& DD_FLD3_FC_SEQ =rr][&frequency=0][¶m=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:
|
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.
The following parameters can be added after the tickets.yourvenue.org/TheatreManager/1/login?
Use the param features if you want the patron to go directly to the checkout page. Patrons will:
Note: If any donor popup is mandatory in company preferences, you must specify this parameter and a value for it in the URL. |
Values of frequency are:
In this example, there are 4 actual links:
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:
NOTE: make sure to put the URL into the right field
It looks like a regular email sent to people. Theatre Manager tracks
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.
The example code is below the image
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:
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¶m=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¶m=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¶m=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> |
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 |
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¶m=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¶m=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¶m=altbtn=btnCheckout&frequency=1&tmsource=mysourcetag" target="_blank"> Donate $10 a month - a little for a lot </a> </body> </html> |
The link above will take the patron directly to the package purchase window in the online sales.
Parameters:
The Package List window will open.
For more information on the Package List window, click here.
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.
Parameters
The Subscription number is in the far left column labeled Seq #. It can be used to replace the "xx" in the link above.
They are displayed on the tmpass.html web page
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
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.
The above link will direct a patron to the specific pass or gift certificate, ready to buy it.
or
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
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
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 |
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.
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 |
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.
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 |
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.
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 |
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 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 |
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. |
Coupon
Parameters:
Example of Pre-Access Codes added to a cart and displays all valid events for the pre-access
There are two aliases for 'redirect' that can be used interchangeably:
The above links will auto add a pre-access or coupon code for a patron.
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:
This is the unique sequence number representing the map. It can be used to replace the "xx" in the link above.
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:
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.
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.
This link will allow a patron to subscribe to the mail lists indicated by simply adding their first name, last name and email address.
The Mail Lists that are visible in this web page are those with the following characteristics:
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.
The Mail Lists that are visible in this web page are those with the following characteristics:
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.