Materia Widget Install Configuration
Every widget needs an install.yaml
file which describes the various settings that will be put into your Materia database to describe that widget.
Here is an example install.yaml file from the Crossword widget:
---
general:
# REQUIRED. String. Name of this widget (spaces and dashes ok).
name: Crossword
# REQUIRED. String. Not used.
group: Materia
# REQUIRED. Int. Pixel height of the iframe. Use `0` for 100%
height: 573
# REQUIRED. Int. Pixel width of the iframe. Use `0` for 100%
width: 715
# REQUIRED. Boolean. Widget is shown in the highlight catalog.
in_catalog: Yes
# REQUIRED. Boolean. `No` hides the widget from all catalog views.
is_playable: Yes
# REQUIRED. Boolean. Enables edit instance and save as draft buttons.
is_editable: Yes
# REQUIRED. Boolean. Does this widget store tabular data using the Storage Manager?
is_storage_enabled: No
# REQUIRED. Int. Version of the Materia API this widget uses. Use `2`.
api_version: 2
# REQUIRED. Boolean. Not used
is_qset_encrypted: Yes
# REQUIRED. Boolean. Not used
is_answer_encrypted: Yes
files:
# REQUIRED. String. Name of the the player html file
player: player.html
# OPTIONAL. String. Name of the creator html file.
creator: creator.html
# REQUIRED. Int. Flash player version required for the player and creator
flash_version: 0
score:
# REQUIRED. Boolean. Does this widget score?
is_scorable: Yes
# OPTIONAL. String. Name of the Class in the score module
score_module: Crossword
# OPTIONAL - name of the custom score screen html file. Omit to use default score screen
score_screen: ScoreScreen.html
meta_data:
# REQUIRED. List of Strings. What feature tags should be displayed on the widget detail page
# If empty, set to an empty array - `features: []`
# NOTE: These will be displayed in the widget catalog and are used as search filters
features:
- Customizable
- Scorable
- Mobile Friendly
# REQUIRED. List of Strings. What question types can be imported.
# Supported Options: `Question/Answer` and `Multiple Choice`, and custom types
# If empty, set to an empty array - `supported_data: []`
# NOTE: These will be displayed in the widget catalog and are used as search filters
supported_data:
- Question/Answer
# REQUIRED. Paragraph. Long description displayed on the widget detail page.
about: >
In Crossword, fill in the blank squares
with (a) words based on the clues provided
in the text and/or (b) by the letters
overlapping from other words.
# REQUIRED. Paragraph. Short description shown in catalog.
excerpt: >
A quiz tool that uses words and clues to
randomly generate a crossword puzzle.
# OPTIONAL. These enable the widget catalog and detail pages to communicate your widget's accessibility status.
accessibility_keyboard: Full # Allowed values are `Full`, `Limited`, or `None`
accessibility_reader: Full # Allowed values are `Full`, `Limited`, or `None`
accessibility_description: >
Special navigation hotkeys are utilized. These
hotkeys are communicated visually and to the screen reader.