QUESTIONNAIRES / PRESENTATION

Classification

Ask the learner to assign each object to a category.

1. What the learner does and sees

Ask the learner to assign each object to a category.

Use it for taxonomies, properties, concept families, or grouping activities.

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 Classification.
  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 created as a question of type Classification.
  • Each question needs at least two objects and two categories.
  • The solution must map all objects to a valid category.
  • The activity requires embedded solutions.

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": "Classify living things",
  "language": "en",
  "grading": {
    "mode": "embedded-key"
  },
  "questions": [
    {
      "id": "q1",
      "type": "classification",
      "prompt": "Classify each item",
      "points": 2,
      "items": [
        {
          "id": "dog",
          "text": "Dog"
        },
        {
          "id": "oak",
          "text": "Oak"
        }
      ],
      "categories": [
        {
          "id": "animal",
          "text": "Animal"
        },
        {
          "id": "plant",
          "text": "Plant"
        }
      ],
      "solution": {
        "assignments": [
          {
            "item": "dog",
            "category": "animal"
          },
          {
            "item": "oak",
            "category": "plant"
          }
        ]
      }
    }
  ]
}

5. How to read the example

items are the objects, categories are the destinations and solution.assignments contains one assignment per object.

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 "Classification" \
  --renderer "https://p2lrn.org/renderer/questionnaire/classification"

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/classification

Profile

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

Content type

application/vnd.p2lrn.questionnaire+json

8. Interaction and accessibility

Objects and categories can be selected using buttons and keyboard; dragging is an aid, not the only method.

9. Completion and scoring

Each assignment updates the answer. The score is calculated by comparing all assignments with the solution.

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.