Introduction

Roles & Permissions

The table below shows every significant action in the platform and which roles can perform it independently.

Signing In

The Quiz Editor is a separate application from the Quiz itself. Access it by navigating to:

https://your-domain.com/quizme/quiz-editor.php

Authentication

The editor displays a sign-in screen with a license key field. Your license key is the personal key assigned to you by the Administrator — it identifies you and determines which quiz files appear in your editing panel.

What you see after signing in

After a successful sign-in the editor opens with:

1. A left sidebar listing all quiz files you have been given edit access to
2. A top navigation bar with two sections: Edit Quiz and File Operations
3. A New Quiz button at the bottom of the sidebar, always visible
4. Your name and a Collaborator role chip below the logo

If the sidebar shows "No editable quizzes yet"

This means no quiz files have been assigned to your account's editableQuizzes list yet. This is normal for a brand-new Collaborator account. You can still create a new quiz using the New Quiz button — that quiz will be added to your list automatically. Alternatively, the Administrator can assign existing quiz files to your account.

Editor Overview

The Quiz Editor is divided into two main sections, selected from the top of the left sidebar navigation:

The Edit Quiz workspace

When you select a quiz from the sidebar, the workspace loads three areas:

Save button behavior

Both the Save Header and Save Question buttons are intentionally grayed out until you make a change. This prevents accidental saves and makes it visually clear when edits are pending.

• Gray button — no unsaved changes; nothing to save
• Green button — unsaved changes are present; click to save
• Orange dot in the question list — that question has unsaved changes
• "Unsaved changes" banner in the top bar — either header or question has pending edits

Navigating away with unsaved changes

If you try to navigate to a different question while the current one has unsaved changes, the editor will prompt you with three options: Cancel (stay on the current question), Discard & Continue (lose your changes), or Save & Continue (save before moving). The browser will also warn you if you try to close or reload the tab.

Creating a Quiz

There are two ways to create a new quiz as a Collaborator: build one from scratch in the editor, or upload an existing JSON file through File Operations.

Method 1 — Build from scratch

1. 1
   Click New Quiz in the bottom of the left sidebar. This button is always visible regardless of which section you are in.
2. 2
   Enter a Quiz Title. As you type, the filename field below auto-fills with a suggested name (e.g. My New Quiz.json). You can edit this manually.
3. 3
   Confirm the filename. The editor checks in real-time that the filename is not already in use. A green confirmation message appears when the name is available.
4. 4
   Click Create Quiz. The file is created on the server, added to your editable quiz list in the sidebar, and the editor opens it immediately.
5. 5
   Edit the header. The Quiz Header panel is shown first. Add a description if desired, then click Save Header.
6. 6
   Add questions using the Add Question button in the question list panel. See the Editing Questions section for details.

Method 2 — Upload a JSON file

1. 1
   Go to File Operations in the top sidebar navigation.
2. 2
   Drop a file onto the upload zone, or click the zone to browse for a file. Only .json files are accepted.
3. 3
   Validation runs automatically. The editor checks JSON syntax and confirms the file has the required quiz root structure and a title. Errors are displayed immediately; the file is not uploaded if validation fails.
4. 4
   Review the result card. On success, it shows the quiz title, question count, and any warnings (e.g. questions with no correct answer set).
5. 5
   Click Open in Editor to switch directly to the Edit Quiz section with the uploaded file loaded.

Required JSON structure

If you are preparing a quiz file externally (in a text editor or another tool) before uploading, it must follow this structure:

{
  "quiz": {
    "title": "Your Quiz Title",
    "description": "Optional description",
    "questions": [
      {
        "id": "1",
        "question": "Question text here",
        "options": ["Option A", "Option B", "Option C", "Option D"],
        "answer": "Option A",
        "comment": "Optional explanation shown after answering"
      }
    ]
  }
}

For multiple correct answers, answer should be a JSON array: ["Option A", "Option C"].

Editing Questions

Loading a quiz to edit

Click any quiz title in the left sidebar. The editor opens the quiz header and displays the first question. If the sidebar is empty, you have no quizzes assigned to your account yet — use New Quiz or contact the Administrator.

Anatomy of a question

Each question in the editor has five editable components:

Adding and removing options

Click Add Option below the options list to add a new blank option. The cursor moves directly to it. To remove an option, click the × button on the right of that row. You cannot remove an option if it is the only one remaining.

Drag options by their handle (the dot grid on the left) to reorder them. If a reordered option is the current correct answer, the answer reference updates automatically.

Navigating between questions

Use the Previous and Next arrows at the bottom of the editor, or click any question number in the question list panel on the left. If the current question has unsaved changes, you will be prompted before the navigation completes.

Duplicating a question

The Duplicate button creates an exact copy of the current question and inserts it immediately after. The copy is saved to the file right away. Useful when creating a set of similar questions.

Deleting a question

Reordering questions

In the question list panel, drag any question row up or down to reorder it. The change is saved to the file immediately. If you have unsaved changes on the current question, you will be prompted to save or discard them first.

File Operations

The File Operations section (accessible from the sidebar navigation) provides two capabilities: uploading quiz files and downloading quiz files.

Uploading a quiz file

The upload zone accepts .json files via drag-and-drop or click-to-browse. Validation occurs in two stages:

1. 1
   Client-side validation runs instantly in the browser. It checks that the file is valid JSON syntax and has the required quiz root key and quiz.title field. If either check fails, the file is rejected before any data is sent to the server.
2. 2
   Server-side validation re-confirms the JSON structure after upload. This is a safety check in case of any inconsistency.
3. 3
   The result card appears showing the quiz title, question count, and any warnings such as questions with no answer set.
4. 4
   If the file is new, it is automatically added to your editable and allowed quiz lists in the license database — the same as creating a quiz from scratch.
5. 5
   If the file already exists, the existing file is replaced. Use this to push a revised version of a quiz you have edited offline.

Downloading a quiz file

The Download section lists all quizzes in your editable list. Click Download next to any quiz to save its raw JSON file to your computer. This is useful for:

• Keeping a local backup before making major edits
• Editing the file in a text editor or spreadsheet tool for bulk changes
• Sharing the quiz content with someone outside the platform
• Version control — storing revisions in a folder on your computer

Publishing Workflow

Creating or editing a quiz in the editor does not automatically make it available to users. The steps below show the full path from a new quiz idea to licensed users being able to take it.

Full workflow: new quiz from creation to delivery

Updating an existing quiz that is already live

Because saves are immediate, any change you make to a quiz that is already in users' allowed lists takes effect right away. No Administrator action is needed for content updates — only for access changes. Follow these guidelines:

• Fix typos, update answer explanations, or adjust wording freely
• If adding or removing questions significantly, inform the Administrator so they can update any documentation or user communications
• If changing correct answers, consider whether users who already took the quiz will be affected
• Download a backup before major structural changes

Shared Editing

Multiple Collaborators can be given edit access to the same quiz file. This allows teams to divide work across a large question set or review each other's content.

How shared access works

The Administrator adds the same quiz filename to the editableQuizzes list of each Collaborator who should have access. Both Collaborators will then see the quiz in their sidebar and can open and edit it.

Recommended practice for shared quizzes

1. 1
   Divide the question set — Agree in advance which Collaborator is responsible for which range of questions (e.g. Q1–Q20 vs Q21–Q40).
2. 2
   Communicate before editing — Let co-editors know when you are starting a session on a shared quiz, especially for a quiz that is already live.
3. 3
   Download before bulk changes — If making large structural changes, download a copy first and share it with co-editors so they have a reference.
4. 4
   Save frequently — Save each question before moving to the next to minimize the window of potential conflict.

Requesting shared edit access

Only an Administrator can grant a Collaborator edit access to a quiz. If you need access to a quiz created by another Collaborator, contact the Administrator with:

• Your license key (so the Administrator knows which account to update)
• The exact filename of the quiz you need access to
• The reason for the request (e.g. peer review, additional questions)

What a Collaborator cannot do even with shared access

Shared edit access only grants the ability to edit questions. Even as a shared editor, you cannot:

• Delete questions (Administrator only)
• Delete the quiz file from the server
• Change who else has access to the quiz
• See the activity log for the quiz

Collaborator Limits

This section summarizes everything a Collaborator cannot do independently and must request from an Administrator.

Things that always require an Administrator

What to include when contacting the Administrator

To minimize back-and-forth, include the following information whenever you request an Administrator action:

Quick Reference

A one-page summary of the most important information for day-to-day use. Print or bookmark this section.

Key contacts