Widget Install.yaml

Widget Install Configuration

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.