Documentation > Admin >
Yahoo! Maps
A variety of mapping tools can be plugged into TicketRx to show ticket locations graphically. For example, TicketRx can be configured to send ticket location data to a web application that integrates with Yahoo! Maps. The simple, mapping.php file provides an example of how to accomplish this. The mapping.php file offers a simple form that can be filled in.
This form matches the specification of the way that TicketRx integrates with mapping plug-ins.
Setting Up Yahoo! Maps integration
To setup the Yahoo! Maps integration, please follow these steps:
1. Obtain a Yahoo! Application ID
Go to http://developer.yahoo.com/wsregapp/index.php to obtain a Yahoo! Application ID. You must be logged in to Yahoo! to access this page.
| Form Field | Value |
|---|---|
| Authentication method | "Generic, No user authentication required" |
| Developer / Company Name | Your company name |
| Product name | mapping.php† |
| Web Application URL | Enter the web address where you will put the mapping.php file on your web site. |
| Contact email | Your email address |
| Description of application | Used to map locate ticket addresses in Yahoo!Maps. |
| Required access scopes | Single Sign On, No user data can be accessed |
† - Note that TicketRx is not a web application, hence this form is not requesting an ID for TicketRx. Rather it is requesting an ID for the very simple, one-screen web application mapping.php.
2. Install the mapping.php file on Your Web Site
Download mapping.php file
Put the mapping.php file on your web site. For example, you might put it at the address,"http://yourcompanysite.com/mapping/mapping.php".
Click here (right-click, Save As..) to download a ZIP file containing mapping.php. Unzip this; you need to post mapping.php itself, not this ZIP file.
Add Yahoo! Application ID to mapping.php file
Once you have obtained a Yahoo! Application ID, enter it on the line shown below, in the mapping.php file.
$appid="<ENTER APPLICATION ID HERE>";Replacing the text shown below with the Yahoo! Application ID.
<ENTER APPLICATION ID HERE>Add Internal ID to mapping.php file
An internal ID needs to be created and entered in the mapping.php file. This internal ID can be any length and can include only letters and numbers. The internal ID is case sensitive. Enter the internal ID on the line shown below, in the mapping.php file.
if ($id=="<ENTER YOUR INTERNAL ID HERE>"){Replacing the text shown below with the internal ID.
<ENTER YOUR INTERNAL ID HERE>Add company website to mapping.php file
Also, your company's website address can be entered in the mapping.php file. Enter your website address on the line shown below, in the mapping.php file.
$link="<http://yourcompanysite.com/>";Replacing the text shown below with your company's website address.
<http://yourcompanysite.com/>3. Configure Selection Options in TicketRx
Use the Admin/Selection Options screen to configure the Yahoo! Maps integration.
- Enter "Yahoo! Maps" as the value for the Label field.
- Enter in the address to the mapping.php file followed by a “?” character and the internal id. For example, http://yourcompanysite.com/mapping/mapping.php?id=yourinternalid. Replacing “http://youcompanysite.com/mapping/mapping.php” with the address where the mapping.php file is hosted on your company's website and "yourinternalid" with the internal ID you entered in the mapping.php file.
- Enter "mapping" as the value for the Category field.
- Click the Save button.
