=== Pakistan Driving License Signs Quiz ===
Contributors: fazalniazi
Tags: quiz, traffic signs, driving license, pakistan, mcq
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Interactive traffic signs quiz for Pakistan driving license test preparation. Car, Motorcycle, LTV/HTV/PSV categories with MCQ format.

== Description ==

**Pakistan Driving License Signs Quiz** helps visitors prepare for the Pakistan Driving License (E-Sign) Test directly on your WordPress website.

= Features =

* **4 Quiz Categories:** Car/Jeep, Motorcycle, LTV/HTV/PSV, and English Test
* **MCQ Format:** Multiple choice questions matching the real E-Sign test format
* **Instant Feedback:** Shows correct/wrong answers immediately after selection
* **Explanations:** Detailed explanation for every question
* **Score & Result:** Pass/Fail result with percentage score
* **Progress Bar:** Visual progress indicator throughout the quiz
* **Randomized Questions:** Questions and options are shuffled each time
* **Shortcode:** Easy to embed on any page or post
* **Widget:** Add the quiz to any sidebar or widget area
* **Fully Responsive:** Works perfectly on mobile, tablet, and desktop
* **No registration required:** Works for all visitors instantly

= How to Use =

**Shortcode (Full Quiz with category selector):**
`[pakistan_driving_signs_quiz]`

**Shortcode (Specific category):**
`[pakistan_driving_signs_quiz category="car"]`
`[pakistan_driving_signs_quiz category="motorcycle"]`
`[pakistan_driving_signs_quiz category="ltv"]`
`[pakistan_driving_signs_quiz category="english"]`

**Shortcode (Custom settings):**
`[pakistan_driving_signs_quiz category="car" questions="10" pass_mark="60" show_explanation="yes"]`

= Shortcode Parameters =

* `category` — car | motorcycle | ltv | english (default: shows selector)
* `questions` — Number of questions (default: 10)
* `pass_mark` — Percentage required to pass (default: 60)
* `show_explanation` — yes | no (default: yes)
* `title` — Custom title text

= Widget =

Go to **Appearance → Widgets** and add the **Pakistan Driving Signs Quiz** widget to any sidebar.

= Quiz Categories =

* **Car / Jeep Test** — Road signs, rules, and traffic regulations for car drivers
* **Motorcycle Test** — Specific questions for motorcyclists including helmet rules
* **LTV / HTV / PSV Test** — Questions for commercial and heavy vehicle drivers
* **Test in English** — English terminology used on road signs

== Installation ==

1. Upload the `pakistan-driving-signs-quiz` folder to `/wp-content/plugins/`
2. Activate the plugin through **Plugins** menu in WordPress
3. Add the shortcode `[pakistan_driving_signs_quiz]` to any page or post
4. Or use the **Pakistan Driving Signs Quiz** widget in your sidebar

== Frequently Asked Questions ==

= What categories does the quiz support? =

Car/Jeep, Motorcycle, LTV/HTV/PSV, and English sign terminology — matching the real Pakistan E-Sign test format.

= Can I use this on multiple pages? =

Yes! You can add the shortcode `[pakistan_driving_signs_quiz]` to as many pages or posts as you like.

= Can I change the number of questions? =

Yes. Use `[pakistan_driving_signs_quiz questions="5"]` to set any number between 1 and 15.

= Does it work on mobile? =

Yes, the quiz is fully responsive and works on all screen sizes.

== Screenshots ==

1. Category selection screen
2. Quiz question with options
3. Correct answer with explanation
4. Pass result screen

== Changelog ==

= 1.0.0 =
* Initial release
* Car, Motorcycle, LTV/HTV/PSV, and English quiz categories
* Shortcode and widget support
* Randomized questions and options
* Pass/Fail result with percentage

== Upgrade Notice ==

= 1.0.0 =
Initial release.
