Setting up External Links to the Program Calendar

Your library can offer URL links to the program calendar from an external web site such as your library's home page. You can configure these links to display programs for the current month or an alternate month (in either the Grid View or the List View), as well as programs for the current day. Additionally, you can link to a calendar display limited by location or program type.

Each link to a different view of the program calendar has a unique syntax. The syntax for these links are:

Link Type	Link Syntax
Current Day	http://[domain name]:[server port]/iii/calendar/today
Current Month (Grid View)	http://[domain name]:[server port]/iii/calendar/month
Current Month (List View)	http://[domain name]:[server port]/iii/calendar/list
Current Month, Limited by Location	http://[domain name]:[server port]/iii/calendar/month/C&R=[s#]
Current Month, Limited by Program Type	http://[domain name]:[server port]/iii/calendar/month/C&P=|[p#]
Current Month, Limited to Multiple Program Types	http://[domain name]:[server port]/iii/calendar/month/C&P=|[p1#]|[p2#]|[p3#]...
Alternate Month	http://[domain name]:[server port]/iii/calendar/month/C&M=[date]

The following defines the variables used in the URL links above.

URL Element	Description
[domain name]	The domain name for your library's server.
[server port]	The port number associated with the domain name. Typically this value is 80.
[s#]	The scope number from the scope menu file.
[p#]	The program type number from the Program Type table. You can list multiple program type numbers in a single link by separating the values with a vertical bar (|) symbol.
[date]	The date for the alternate month to display in the program calendar in the following format: MM-YYYY.

You can combine the limits used above in a single link. For example, you can offer a link to an alternate month that is limited by both location and program type. The syntax for this link would be:

http://[domain name]:[server port]/iii/calendar/month/C&M=[date]&R=[s#]&P=|[p#]

Note that the letters following the ampersand (&) in the link above are case sensitive. For example, if you enter p=|[p#] instead of P=|[p#], the program type variable is not recognized. The link still might connect to the calendar, but it does not default to the program type you specified.

You specify the language and suite by appending the following to URLs:

Link Type	Link Syntax
Language	http://[domain name]:[server port]/iii/calendar/month?lang=[language code]
Suite	http://[domain name]:[server port]/iii/calendar/month?suite=[suite code]

You can combine the language and suite elements in a single link. For example, you can offer a link to an alternate month that is limited by location and program type, uses a specific suite, and specifies a language. The syntax for this link would be:

http://[domain name]:[server port]/iii/calendar/month/C&M=[date]&R=[s#]&P=|[p#]?lang=[language code]&suite=[suite code]