Difference between revisions of "Understanding the CLIO URL Scheme"
| (7 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{NeedsDemonstration}} | {{DocumentationPage}}{{NeedsDemonstration}} | ||
== Overview == | == Overview == | ||
The CLIO web application uses a | The CLIO web application uses a query system to load the interface dynamically based on the parameters in the URL. This is similarly to the way options are passed into a programming function. When the CLIO web application is opened without any parameters, it will default to the full “Facilitator Mode” experience. | ||
== Using URL Parameters == | == Using URL Parameters == | ||
By utilizing some URL configuration parameters, we can change how the web application will appear when loaded. This is helpful for configuring how we would like any standalone kiosks to operate, such as automatically loading an exhibit or activity on startup, or for sending links to activities for use in remote lesson plans. | By utilizing some URL configuration parameters, we can change how the web application will appear when loaded. This is helpful for configuring how we would like any standalone kiosks to operate, such as automatically loading an exhibit or activity on startup, or for sending links to activities for use in remote lesson plans. | ||
We can navigate to a full facilitator mode experience using http://www.cliomuseums.org/clio/exhibit/. Parameters are attached to the end of the URL with a question mark ('?'). As an example, we can load the kiosk experience using http://www.cliomuseums.org/clio/exhibit/?mode=kiosk. Multiple arguments can be added together with an ampersand ('&'), such as https://www.cliomuseums.org/clio/exhibit/?program=NaturesNetworks&activity=salmon. | We can navigate to a full facilitator mode experience using http://www.cliomuseums.org/clio/exhibit/. Parameters are attached to the end of the URL with a question mark ('?'). | ||
As an example, we can load the kiosk experience – with hardware control options – using http://www.cliomuseums.org/clio/exhibit/?mode=kiosk. Multiple arguments can be added together with an ampersand ('&'), such as https://www.cliomuseums.org/clio/exhibit/?program=NaturesNetworks&activity=salmon. | |||
== Parameters == | == Parameters == | ||
| Line 20: | Line 22: | ||
|This is the unique system id of the program, not the friendly name. | |This is the unique system id of the program, not the friendly name. | ||
''For example, the “Getting Started” program has a system name of “Default”.'' | ''For example, the “Getting Started” program has a system name of “Default”.'' | ||
{{See|Understanding the CLIO Content Folder}} | |||
|- | |- | ||
|activity | |activity | ||
|This is the activity to be loaded. | |This is the activity to be loaded. | ||
''This requires that a program has been specified.'' | ''This requires that a program has been specified.'' | ||
|This is the unique system id of the activity, not the friendly name. | |This is the unique system id of the activity, not the friendly name. | ||
{{See|Understanding a CLIO Activity Configuration File}} | |||
|- | |- | ||
|menu | |menu | ||
|This is the menu section to be loaded. | |This is the menu section to be loaded. | ||
''This option will be ignored if there is a program and activity defined.'' | ''This option will be ignored if there is a program and activity defined.'' | ||
|The system | |The system id of the menu, as defined below. | ||
| Line 45: | Line 49: | ||
|mode | |mode | ||
|This will configure the CLIO interface experience. | |This will configure the CLIO interface experience. | ||
|The system | |The system id of the mode, as defined below. | ||
| Line 55: | Line 59: | ||
activity: ''Activity mode. Requires program and activity to be set.'' | activity: ''Activity mode. Requires program and activity to be set.'' | ||
The mode setting will control navigation back up the interface. For instance, if <code>mode=facilitator</code>, then Activity Mode will allow kiosk users to return home to Exhibit Mode, and then return to facilitator mode with the PIN code. If <code>mode=activity</code>, then the home button is removed so access to Exhibit Mode is prevented. When <code>mode=exhibit</code> is defined, return to Facilitator Mode is allowed by default, but it can be disabled with a setting in the CLIO configuration file. | |||
|- | |- | ||
|view | |view | ||
| Line 88: | Line 94: | ||
|http://www.cliomuseums.org/clio/exhibit/?mode=exhibit&program=Default&activity=prototype | |http://www.cliomuseums.org/clio/exhibit/?mode=exhibit&program=Default&activity=prototype | ||
|} | |} | ||
{{DocumentationNavigation}} | |||
Latest revision as of 12:13, 2 November 2022
Overview
The CLIO web application uses a query system to load the interface dynamically based on the parameters in the URL. This is similarly to the way options are passed into a programming function. When the CLIO web application is opened without any parameters, it will default to the full “Facilitator Mode” experience.
Using URL Parameters
By utilizing some URL configuration parameters, we can change how the web application will appear when loaded. This is helpful for configuring how we would like any standalone kiosks to operate, such as automatically loading an exhibit or activity on startup, or for sending links to activities for use in remote lesson plans.
We can navigate to a full facilitator mode experience using http://www.cliomuseums.org/clio/exhibit/. Parameters are attached to the end of the URL with a question mark ('?').
As an example, we can load the kiosk experience – with hardware control options – using http://www.cliomuseums.org/clio/exhibit/?mode=kiosk. Multiple arguments can be added together with an ampersand ('&'), such as https://www.cliomuseums.org/clio/exhibit/?program=NaturesNetworks&activity=salmon.
Parameters
There are several options that can be configured through the URL.
| Parameter | Description | Options |
|---|---|---|
| program | This is the program to be loaded. | This is the unique system id of the program, not the friendly name.
For example, the “Getting Started” program has a system name of “Default”.  Read More: Understanding the CLIO Content Folder
|
| activity | This is the activity to be loaded.
This requires that a program has been specified. |
This is the unique system id of the activity, not the friendly name. |
| menu | This is the menu section to be loaded.
This option will be ignored if there is a program and activity defined. |
The system id of the menu, as defined below.
facilitation: Facilitation Menu settings: Settings Menu accessibility: Accessibility Menu about: Help Menu |
| mode | This will configure the CLIO interface experience. | The system id of the mode, as defined below.
facilitator: Facilitator mode exhibit: Exhibit mode. Requires program to be set. activity: Activity mode. Requires program and activity to be set. The mode setting will control navigation back up the interface. For instance, if |
| view | Configure how activity links are displayed within the interface. | 'list' or 'grid' |
| development | Used by kiosk mode to enable hidden hardware settings. | 'true' or 'false' |
Examples
| Example | URL |
|---|---|
| Facilitator Mode | http://www.cliomuseums.org/clio/exhibit/ |
| Facilitator Mode, with the Settings menu loaded | http://www.cliomuseums.org/clio/exhibit/?menu=settings |
| Kiosk Mode | http://www.cliomuseums.org/clio/exhibit/?mode=kiosk |
| "Getting Started" Program in Exhibit Mode | http://www.cliomuseums.org/clio/exhibit/?mode=exhibit&program=Default |
| "Visual Thinking" activity from the "Getting Started" Program in Activity Mode | http://www.cliomuseums.org/clio/exhibit/?mode=activity&program=Default&activity=prototype |
| "Getting Started" Program in Exhibit Mode, with the "Visual Thinking" activity loaded | http://www.cliomuseums.org/clio/exhibit/?mode=exhibit&program=Default&activity=prototype |
| Documentation | |
|---|---|
| Installation | Look and Feel |
| Interaction Modes | Developing Activity Types |
| Creating an Interactive | Framework |
| Integrating CLIO | Contribute |
