Difference between revisions of "Creating a CLIO Interactive"
| (7 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{NeedsDemonstration}} | {{DocumentationPage}}{{NeedsDemonstration}} | ||
== Installing CLIO == | == Installing CLIO == | ||
The first step to creating an interactive is completing the [[CLIO Installation|CLIO Installation guide]] or [[Creating a POP Kiosk|POP Kiosk Creation Guide]]. After you're done, you've successfully created your first Interactive! | The first step to creating an interactive is completing the [[CLIO Installation|CLIO Installation guide]] or [[Creating a POP Kiosk|POP Kiosk Creation Guide]]. After you're done, you've successfully created your first Interactive! Now, we can look at the default settings to configure this Interactive how we want. | ||
Now, we can look at the default settings to configure this Interactive how we want. | |||
== Configuring an Interactive == | == Configuring an Interactive == | ||
{{Coding Template|Download URL=https://cliomuseums.org/clio/exhibit/config/@Configuration.json|Edit URL=https://cliomuseums.org/jsoneditor/?file=https://cliomuseums.org/clio/exhibit/config/@Configuration.json}} | There is a ''@Configuration.json'' file stored in the ''<nowiki/>'config''' folder located within the CLIO root directory. This file provides a place for Interactive-specific settings to be saved persistently. This includes options controlled through the Facilitator Mode interface, as well as screensaver and PIN code settings that cannot be changed elsewhere. When these options are changed through Facilitator Mode, this file is updated to reflect these changes.{{Coding Template|Download URL=https://cliomuseums.org/clio/exhibit/config/@Configuration.json|Edit URL=https://cliomuseums.org/jsoneditor/?file=https://cliomuseums.org/clio/exhibit/config/@Configuration.json&name=@Configuration}} | ||
Below, we have a description of each setting and what value is expected for that setting within the JSON file. We provide a default template you can download in case you run into errors. Also, you can use our online JSON template editor to make your desired changes and download a properly-formatted @Configuration.json file to replace the default. | |||
=== Screensaver Options === | === Screensaver Options === | ||
These options cannot be changed through the Facilitator Mode interface. They are provided as a way for institutions to configure branding and design integration of their Interactives. | |||
{| class="wikitable" | {| class="wikitable" | ||
!Setting | !Setting | ||
| Line 26: | Line 25: | ||
=== Device Options === | === Device Options === | ||
These options cannot be changed through the Facilitator Mode interface. They are provided as a way for institutions to configure device-specific Interactive options, such as the Facilitator PIN code and the default POP kiosk screen brightness. | |||
{| class="wikitable" | {| class="wikitable" | ||
!Setting | !Setting | ||
| Line 41: | Line 41: | ||
=== Settings === | === Settings === | ||
These settings are controllable on-the-fly through the Facilitator Mode interface. | |||
{| class="wikitable" | {| class="wikitable" | ||
!Setting | !Setting | ||
| Line 48: | Line 49: | ||
|Default Program | |Default Program | ||
|This is the default brightness when used on the POP kiosk. | |This is the default brightness when used on the POP kiosk. | ||
| | |The System ID (folder name) of a Program within the 'content' directory, e.g. default{{See|Understanding the CLIO Content Folder}} | ||
|- | |- | ||
|Screensaver | |Screensaver | ||
| Line 66: | Line 67: | ||
|"5000", "10000", "15000", "30000", "60000", "120000", or "300000" | |"5000", "10000", "15000", "30000", "60000", "120000", or "300000" | ||
|} | |} | ||
{{DocumentationNavigation}} | |||
Latest revision as of 18:00, 15 December 2022
Installing CLIO
The first step to creating an interactive is completing the CLIO Installation guide or POP Kiosk Creation Guide. After you're done, you've successfully created your first Interactive! Now, we can look at the default settings to configure this Interactive how we want.
Configuring an Interactive
There is a @Configuration.json file stored in the 'config' folder located within the CLIO root directory. This file provides a place for Interactive-specific settings to be saved persistently. This includes options controlled through the Facilitator Mode interface, as well as screensaver and PIN code settings that cannot be changed elsewhere. When these options are changed through Facilitator Mode, this file is updated to reflect these changes.
Below, we have a description of each setting and what value is expected for that setting within the JSON file. We provide a default template you can download in case you run into errors. Also, you can use our online JSON template editor to make your desired changes and download a properly-formatted @Configuration.json file to replace the default.
Screensaver Options
These options cannot be changed through the Facilitator Mode interface. They are provided as a way for institutions to configure branding and design integration of their Interactives.
| Setting | Description | Expected Parameters |
|---|---|---|
| Text | This is the text that is displayed when the screensaver is activated. | Plain Text |
| Image | This is the image that is displayed when the screensaver is activated. | Image File |
Device Options
These options cannot be changed through the Facilitator Mode interface. They are provided as a way for institutions to configure device-specific Interactive options, such as the Facilitator PIN code and the default POP kiosk screen brightness.
| Setting | Description | Expected Parameters |
|---|---|---|
| Screen Brightness | This is the default brightness when used on the POP kiosk. | 1 - 10 |
| PIN Code | PIN to allow facilitators to return the kiosk from Exhibit Mode to Facilitator Mode. | Any four-digit number. |
Settings
These settings are controllable on-the-fly through the Facilitator Mode interface.
| Setting | Description | Expected Parameters |
|---|---|---|
| Default Program | This is the default brightness when used on the POP kiosk. | The System ID (folder name) of a Program within the 'content' directory, e.g. default Read More: Understanding the CLIO Content Folder
|
| Screensaver | Enable or disable the screensaver. | "true" or "false" |
| Contrast Mode | Configure whether a contrast mode is enabled by default. | "blackonwhite", "whiteonblack", or "greenonblack" |
| Activity Timeout | The amount of time the kiosk should remain idle while in Exhibit Mode before returning to the activity carousel. | "15", "30", "60", "300", "600", or "99999999" |
| Slide Duration | The amount of time each activity should be displayed on the carousel while in Exhibit Mode. | "5000", "10000", "15000", "30000", "60000", "120000", or "300000" |
| Documentation | |
|---|---|
| Installation | Look and Feel |
| Interaction Modes | Developing Activity Types |
| Creating an Interactive | Framework |
| Integrating CLIO | Contribute |
