ROCKVIEW SLPS — TEST YOUR IQ & QUIZ MODULE
==========================================

WHAT THIS ADDS
- A separate staff/admin module named “Test Your IQ & Quiz”.
- Quiz builder with multiple-choice, select-all-that-apply, dropdown, short-answer and written-answer questions.
- Correct answer configuration and marks per question.
- Per-question countdown duration in seconds (0 means no per-question timer).
- Optional overall quiz duration in minutes.
- Public shareable quiz links. Participants do not need to log into SLPS.
- Automatic movement to the next question when its timer expires; automatic submission when the overall timer expires.
- Automatic scoring, pass mark, attempt register, score distribution, pass rate, average score, question charts, spreadsheet-style response view, correction, and CSV export.
- Drafts, publishing/version history, duplicate, close/reopen, attempt limits, optional one-attempt-per-browser, and optional cover image.

IMPORTANT DATA COLLECTIONS GUARANTEE
The existing Data Collections PHP, JavaScript, CSS, SQL migrations, and response data are not replaced by this module. The IQ Quiz module has its own files, API, public page, uploads directory, and database tables prefixed iq_. The shared module shell/navigation files are extended only to register the new module.

INSTALLATION — EXISTING SLPS IN CPANEL
1. Back up the current public_html/slps folder and the SLPS database.
2. Upload the Production Patch ZIP into public_html and extract it there, preserving the slps/ folder paths. Allow overwrite only for the shared module shell, panel permission catalogue, navigation policy, and portal label files included in the patch.
3. Open cPanel → phpMyAdmin → select the SLPS database → Import.
4. Import slps/database/migrations/20261104_iq_quiz.sql. This creates only iq_quizzes, iq_quiz_versions and iq_quiz_attempts. Do not re-import the Data Collections migration.
5. Confirm public_html/slps/uploads/iq-quizzes exists and its .htaccess is present and writable by PHP for image uploads.
6. Sign out and back into SLPS, then hard-refresh (Ctrl+F5).
7. Staff/Admin: open “Test Your IQ & Quiz” from the left navigation.
8. Create a quiz, add questions, set each question's time in seconds, set optional overall duration and pass mark, save, preview, and publish.
9. Use “Copy / Share link” and test the public link in a private/incognito browser before sharing it widely.

PUBLIC LINK
The generated link uses:
https://YOUR-DOMAIN/slps/shared/views/iq_quiz_public.php?f=48_CHARACTER_PUBLIC_KEY

NOTES
- 0 seconds on a question means no individual countdown for that question.
- 0 minutes for overall duration means no overall quiz deadline.
- Multiple-choice and checkbox questions are scored automatically. Short/written answers are marked by case-insensitive exact matching against the expected answer. For open-ended answers, staff can review and correct attempts in the spreadsheet/individual response views; scoring is recalculated after a correction.
- Per-question timers are enforced in the public quiz interface and the submitted elapsed-time data is checked by the server. For high-stakes examinations, additional server-side proctoring and per-question server checkpoints should be added.
- Do not delete any Data Collections files or tables as part of this installation.
