=== Bikram Quiz ===
Contributors:      bikram_sth
Tags:              quiz, survey, exam, certificate, test
Requires at least: 5.8
Tested up to:      7.1
Requires PHP:      7.4
Stable tag:        1.0.2
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Create surveys, quizzes, and exams with automatic grading and digital certificates.

== Description ==

Bikram Quiz is a lightweight, easy-to-use plugin that lets you create three types of assessments:

* **Surveys** - Collect feedback without scoring
* **Quizzes** - Fun assessments with instant feedback
* **Exams** - Strict assessments with pass marks and certificates

= Features =

* Three assessment modes: Survey, Quiz, and Exam
* Multiple question types: Multiple Choice, True/False, Short Text
* Automatic grading and scoring
* Digital PDF certificates with unique verification codes
* Public certificate verification page
* Gutenberg block and shortcode support
* Mobile-friendly responsive design
* GDPR compliant with data export/erase tools
* Lightweight and fast - no external API calls or accounts required

= Usage =

**Shortcode:**
`[bikram_quiz id="1"]`

**Gutenberg Block:**
Search for "Bikram Quiz" in the block inserter.

= Certificate Verification =

Every issued certificate has a unique code that can be verified at:
`yoursite.com/?bq_verify=CERTIFICATE_CODE`

== Installation ==

1. Upload the `bikram-quiz` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to 'Bikram Quiz' in your admin menu to create your first quiz
4. Use the shortcode `[bikram_quiz id="1"]` or the Gutenberg block to display it

== Frequently Asked Questions ==

= How do I add a certificate background image? =

When editing your quiz, click the "Choose Image" button next to Certificate Background Image and select or upload an image from your Media Library. A live preview will appear once selected.

= Can users retake a quiz? =

Yes, users can retake any quiz. Each attempt is saved separately.

= Are certificates verifiable? =

Yes! Every certificate has a unique code. Anyone can verify it by visiting `yoursite.com/?bq_verify=CODE`.

= Does this plugin support logged-out users? =

Yes, guests can take quizzes by providing their name and email.

== Credits ==

This plugin bundles [FPDF](http://www.fpdf.org/), a free PHP library for PDF generation created by Olivier Plathey, used here to generate downloadable certificate PDFs. FPDF is released under a permissive free license that is compatible with the GPL.

== Screenshots ==

1. The plugin lives under Tools → Bikram Quiz, keeping your admin menu uncluttered — manage all your quizzes from one list.
2. Create a new quiz, survey, or exam. Set the pass mark, choose the type, and optionally add a certificate background image.
3. Build your questions with multiple-choice options, per-question point values, and instant answer marking.
4. Drop a quiz anywhere on your site with a simple shortcode.
5. A generated certificate using a custom decorative background image, set via the new Media Uploader.
6. The default certificate style when no background image is selected.

== Changelog ==

= 1.0.2 =
* Fixed: Resolved fatal error during certificate generation by including missing FPDF font files.
* Added: Native WordPress Media Uploader for selecting the certificate background image.
* Improved: Replaced plain text URL input with an interactive "Choose Image" button and live preview.
* Fixed: Removed invalid PHP tags from external JavaScript file to prevent syntax errors.

= 1.0.1 =
* Fixed invalid Plugin URI.
* Renamed FPDF class to prevent namespace conflicts.
* Moved admin menu to the "Tools" section for better hierarchy.

= 1.0.0 =
* Initial release
* Support for surveys, quizzes, and exams
* Digital PDF certificates
* Public certificate verification
* Gutenberg block and shortcode
* GDPR compliance

== Upgrade Notice ==

= 1.0.2 =
Fixes a certificate generation error and adds an easier way to pick certificate backgrounds via the Media Uploader. Recommended for all users.
