QUESTIONNAIRES / PRESENTATION

Crossword

Build a connected crossword puzzle from clues and textual answers.

1. What the learner does and sees

Build a connected crossword puzzle from clues and textual answers.

Use it when the answers are short words, the clues are clear, and the set shares enough letters to form a single board.

2. Create in Studio

This is the normal path if you are creating the course visually. You don't need to write JSON or execute commands.

  1. Abre Studio.Use the hosted editor or the Studio you have integrated into your project.
  2. Add the activity.In Add content, abre Games and choose Crossword.
  3. Edita visualmente.Change statements, responses, and options with editor controls. The JSON remains as an advanced view, not a requirement for use.
  4. Check the learner View.Play the activity before downloading or saving the course.

3. Content requirements

  • In Studio it is edited with questions of type Text response.
  • You need between 4 and 80 responses.
  • Each standardized response must be between 3 and 17 characters and a non-empty clue.
  • All words must form a single connected crossword puzzle. If there is no complete provision, the submission is rejected.

4. Valid data example

This block shows a complete and valid questionnaire for this presentation. It is used to understand the format or to walk through the CLI; If you use Studio, the editor generates this structure for you.

quiz.json
{
  "schema": "https://p2lrn.org/schema/native-questionnaire/0.4.0",
  "version": "0.4.0",
  "title": "Crossword",
  "language": "en",
  "grading": {
    "mode": "embedded-key"
  },
  "questions": [
    {
      "id": "q1",
      "type": "text",
      "prompt": "Place where people live",
      "points": 1,
      "solution": {
        "acceptedAnswers": [
          "HOME"
        ]
      }
    },
    {
      "id": "q2",
      "type": "text",
      "prompt": "Amphibian that jumps",
      "points": 1,
      "solution": {
        "acceptedAnswers": [
          "TOAD"
        ]
      }
    },
    {
      "id": "q3",
      "type": "text",
      "prompt": "Water bird",
      "points": 1,
      "solution": {
        "acceptedAnswers": [
          "DUCK"
        ]
      }
    },
    {
      "id": "q4",
      "type": "text",
      "prompt": "Container with a handle",
      "points": 1,
      "solution": {
        "acceptedAnswers": [
          "CUP"
        ]
      }
    }
  ]
}

5. How to read the example

The four questions provide the clues and the words HOUSE, TOAD, DUCK and CUP. They are answers compatible with the construction of the connected board.

6. Create by CLI — advanced alternative

Use this tour only if you are generating the course by code. Requires Toolkit installed via NPM. The file quiz.json It must contain a valid questionnaire like the example above.

Terminal
p2lrn-create add-questionnaire ./workspace ./quiz.json \
  --key quiz \
  --title "Crossword" \
  --renderer "https://p2lrn.org/renderer/questionnaire/crossword"

p2lrn-create build ./workspace ./course.p2lrn --strict-profiles

--renderer Select the preferred presentation. It does not create a second copy of the questions: the content remains the native questionnaire.

7. Technical presentation identifier

Typically Studio sets this up for you. You only need this identifier when you select presentation from code, CLI, or the viewer.

Technical identifier

https://p2lrn.org/renderer/questionnaire/crossword

Profile

https://p2lrn.org/profile/native-questionnaire

Content type

application/vnd.p2lrn.questionnaire+json

8. Interaction and accessibility

Each editable box is a one-character field with identifiable position. The activity includes explicit checking actions.

9. Completion and scoring

When checking, the Player compares all letters with the solution; When the board is complete you can finish and score.

To save the result on your platform, see Events and Host Adapter.

10. Try the example

Open the demo package in the real viewer and check the interaction before integrating it.