Difference between revisions of "Creating a Media Dichotomous Key Activity"

From CLIO

(Created page with "{{NeedsDemonstration}} ==Overview== Within our Getting Started Package, you will find a Template folder. We have provided a template for the configuration file, which is used...")
 
Line 11: Line 11:
!Examples
!Examples
|-
|-
|Scale to Fit
|Correct Answer
|Should the image be scaled to fill the screen, or should it remain at its full size and be centered?
|The correct answers from the defined answers.
|True or False
|Index name of a defined answer
|[[File:Scale to Fit - Small.png|center|300x300px|Scale to Fit - Small Screen|link=https://cliomuseums.org/wiki/index.php/File:Scale_to_Fit_-_Small.png]][[File:Scale to Fit - Large.png|center|300x300px|Scale to Fit - Large Screen|link=https://cliomuseums.org/wiki/index.php/File:Scale_to_Fit_-_Large.png]]
|
|-
|Prompt Text – Top
|Displayed at the top of the screen while checking the users answer.
|Plain Text
|
|-
|Prompt Text – Bottom
|Displayed at the bottom of the screen while checking the users answer.
|Plain Text
|
|-
|Answer Titles – User
|Displayed above the user's answer while they are being compared.
|Plain Text
|
|-
|Answer Titles – Correct
|Displayed above the correct answer while they are being compared.
|Plain Text
|
|}
 
==== Image Configuration ====
These are the images that are displayed in the right side panel.
{| class="wikitable"
!Property
!Description
!Expected Parameters
!Examples
|-
|-
|Image
|Image
|This is the image that will be annotated.
|The image to be displayed.
|Image File
|Image File
|[[File:Image.png|center|300x300px|Image source for the background|link=https://cliomuseums.org/wiki/index.php/File:Image.png]]
|
|-
|Description
|The caption to be displayed alongside this image.
|Plain Text
|
|}
 
==== Question Configuration ====
These are the questions that are asked in the left side panel.
{| class="wikitable"
!Property
!Description
!Expected Parameters
!Examples
|-
|Prompt
|Prompt displayed before the two options.
|Plain Text
|
|-
|Option 1 – Text
|Text displayed on button 1.
|Plain Text
|
|-
|Option 1 – Goto Type
|Signify whether selecting this button should lead to another question or an answer.
|"Question" or "Answer"
|
|-
|Option 1 – Goto Location
|The location that should be loaded when the user selects this button.
|Index name of the question or answer
|
|-
|Option 2 – Text
|Text displayed on button 2.
|Plain Text
|
|-
|Option 2 – Goto Type
|Signify whether selecting this button should lead to another question or an answer.
|"Question" or "Answer"
|
|-
|Option 2 – Goto Location
|The location that should be loaded when the user selects this button.
|Index name of the question or answer
|
|}
 
==== Answer Configuration ====
These are all of the possible answers a user could get.
{| class="wikitable"
!Property
!Description
!Expected Parameters
!Examples
|-
|-
|Header
|Title
|''Optional.''  This can be used to display a "name plate" in the bottom right corner.
|The title for this answer.
|Plain Text
|Plain Text
|[[File:Header.png|center|300x300px|Header that is used for the "name plate".|link=https://cliomuseums.org/wiki/index.php/File:Header.png]]
|
|-
|-
|Description
|Description
|''Optional.''  This is the description displayed when the Header "name plate" is touched.
|Look Closer content displayed when the user selects the Look Closer button.
|Rich Text
|Rich Text
|[[File:Description.png|center|300x300px|link=https://cliomuseums.org/wiki/index.php/File:Description.png]]
|
|-
|-
|Dimensions - Height
|Image
|The pixel height of the image to be annotated.  This is used by ScaleToFit.
|The image that is displayed alongside this answer.
|Unitless integer [ 0 - 9999]
|Image File
|[[File:Height.png|center|300x300px|Height of the image|link=https://cliomuseums.org/wiki/index.php/File:Height.png]]
|
|-
|Dimensions - Width
|The pixel width of the image to be annotated.  This is used by ScaleToFit.
|Unitless integer [ 0 - 9999]
|[[File:Width.png|center|300x300px|Width of the image|link=https://cliomuseums.org/wiki/index.php/File:Width.png]]
|}
|}
==Creating the Activity==
==Creating the Activity==

Revision as of 14:02, 27 April 2022

Add a photo.png

Overview

Within our Getting Started Package, you will find a Template folder. We have provided a template for the configuration file, which is used by the CLIO interface to set up the activity. We also include a content drafting template created in Microsoft Word that can aid collaboration when creating activities as part of a development team.

Options

Configuration

These are configuration settings specific to this activity type.

Property Description Expected Parameters Examples
Correct Answer The correct answers from the defined answers. Index name of a defined answer
Prompt Text – Top Displayed at the top of the screen while checking the users answer. Plain Text
Prompt Text – Bottom Displayed at the bottom of the screen while checking the users answer. Plain Text
Answer Titles – User Displayed above the user's answer while they are being compared. Plain Text
Answer Titles – Correct Displayed above the correct answer while they are being compared. Plain Text

Image Configuration

These are the images that are displayed in the right side panel.

Property Description Expected Parameters Examples
Image The image to be displayed. Image File
Description The caption to be displayed alongside this image. Plain Text

Question Configuration

These are the questions that are asked in the left side panel.

Property Description Expected Parameters Examples
Prompt Prompt displayed before the two options. Plain Text
Option 1 – Text Text displayed on button 1. Plain Text
Option 1 – Goto Type Signify whether selecting this button should lead to another question or an answer. "Question" or "Answer"
Option 1 – Goto Location The location that should be loaded when the user selects this button. Index name of the question or answer
Option 2 – Text Text displayed on button 2. Plain Text
Option 2 – Goto Type Signify whether selecting this button should lead to another question or an answer. "Question" or "Answer"
Option 2 – Goto Location The location that should be loaded when the user selects this button. Index name of the question or answer

Answer Configuration

These are all of the possible answers a user could get.

Property Description Expected Parameters Examples
Title The title for this answer. Plain Text
Description Look Closer content displayed when the user selects the Look Closer button. Rich Text
Image The image that is displayed alongside this answer. Image File

Creating the Activity

Define the Activity

All CLIO activities, regardless of their Activity Type, contain many of the same configuration settings.  These are used to configure the screen and load the correct content.  By defining this information, we can begin to draft more specific activity content.  This information is included in both the drafting template and the coding template provided with each activity type.


Drafting the Content

Imbox style.png

Coding the Activity

Imbox style.png