pushword / quiz

1.0.51 2026-10-10 11:37 UTC

Requires

• pushword/core: *
• symfony/rate-limiter: ^8.0

Suggests

• pushword/admin: Manage pages, media and users from an EasyAdmin-based back-office.
• pushword/admin-block-editor: Rich block editor (EditorJS) for the admin.
• pushword/advanced-main-image: Choose the main image format per page, from hidden to full hero.
• pushword/api: Token-authenticated REST API mirroring the admin, OpenAPI-described.
• pushword/conversation: Add comments, a contact form or any user input to your website.
• pushword/docs: Pushword documentation, readable offline from vendor/.
• pushword/flat: Turn Pushword into a flat-file CMS: content as Markdown in Git.
• pushword/link-improver: Automatic internal links: page names become in-content links at render time.
• pushword/newsletter: Audiences, segmented campaigns and criteria-driven automations.
• pushword/page-scanner: Find dead links, 404s, redirects and TODO reminders.
• pushword/page-update-notifier: Get an email when a page is created or edited.
• pushword/repurpose: Turn a page into ready-to-post social carousels (PNG/PDF).
• pushword/search: SQLite-native full-text search via Loupe, zero infrastructure.
• pushword/snippet: Reusable content fragments and dev-registered Twig components.
• pushword/static-generator: Export the whole site as static files (GitHub Pages, Apache, FrankenPHP).
• pushword/template-editor: Edit Twig view files online from the admin.
• pushword/version: Keep a version history of your pages and compare revisions.

MIT

• Robin@PiedWeb

• cms
• survey
• quiz
• QCM
• pushword
• personality-test

Published on Packagist.org on 2026-10-11 20:41 UTC

README

Interactive quizzes (QCM) and personality tests for Pushword.

• {% quiz %}{ …json… }{% endquiz %} block — declare a quiz inline in a page. The JSON is the raw tag body, so quotes need no escaping. The legacy {{ quiz('…json…') }} function still works (escape ' as \'). A malformed quiz shows admins an error panel and visitors nothing; a missing media file is skipped.
• EditorJS block — knowledge quiz, difficulty levels or personality test, chosen from its Type selector.
• Progressive enhancement — the quiz is rendered server-side as a readable, schema.org-tagged Q&A (SEO, no-JS); quiz.js turns it into a one-question-at-a-time game with feedback and a score donut.
• Difficulty levels (levels) behind an accessible tab selector, and personality tests (mode: profile) where answers weigh named profiles.
• Anonymous percentile — POST /quiz/result stores a score (no PII) and returns "better than X% of participants".
• Conversion form — set cta to a pushword/conversation form type to show a lead form at the end. Optional dependency.
• Validation for agents — pw:quiz:validate <file|-> lints quiz blocks in a flat file or stdin; POST /api/quiz/validate does the same over the API. Both return {path, message} violations. pw:quiz:schema and GET /api/quiz/schema serve the payload's JSON Schema.
• Results API — GET /api/quiz/result lists attempts; GET /api/quiz/result/stats tallies them per quiz.

Installation

composer require pushword/quiz
php bin/console doctrine:schema:update --force
php bin/console assets:install

Example

{
  "title": "Montagnes du monde",
  "difficulty": "Facile",
  "feedback": "immediate",
  "cta": "newsletter",
  "questions": [
    {
      "q": "Quel est le plus haut sommet du monde ?",
      "media": "everest.jpg",
      "alt": "Le mont Everest",
      "answers": [
        { "a": "Mont Blanc" },
        { "a": "Everest", "correct": true },
        { "a": "K2" }
      ],
      "explanation": "Le mont Everest culmine à 8 849 mètres."
    }
  ],
  "results": [
    { "min": 0, "msg": "À retravailler !" },
    { "min": 80, "msg": "Bravo !" }
  ]
}

Documentation

Fields, levels, personality tests, styling and APIs: pushword.piedweb.com/extension/quiz.

License

MIT — see the license.