Guide

Quiz Builder troubleshooting

Recurring failures from editor builds, submit, and Firebase.

Guided diagnosis

Quiz Builder issues

Pick the symptom that matches what you see.
Question 1
Question 1

What is failing?

Blocks missing after a build

Symptom: prc-quiz/controller (or another quiz block) missing or invalid.
Cause: load_blocks() globs build/*/; missing compiled PHP is logged and skipped.
Fix: Rebuild @prc/quiz-builder and verify PHP under build/.

Submissions fail

Symptom: Submit returns 403, 404, 429, or a generic error.
Cause: $rest_disabled kill switch, unpublished/missing quiz, or rate limit (100/quiz/IP/minute).
Fix: Confirm publish state; wait on 429; set $rest_disabled = false only for a real emergency.

Group quizzes return 503

Symptom: Create-group or group submit says the results service is unavailable.
Cause: Firebase Realtime Database or Auth not configured.
Fix: Generate the service account (npm run gen:firebase-sa); confirm prc-firebase loads it. Non-group submits may still return persisted: false.

Analytics sidebar missing

Symptom: No quiz analytics panel in the editor.
Cause: Panel enqueues only when $screen->post_type === 'quiz'.
Fix: Edit the quiz CPT directly, not only a page that embeds Synced Quiz.

Was this helpful?