=== TS Hotspot Quiz ===
Contributors: rktaiwala,techsarathy
Tags: quiz, education, lms, image hotspot, interactive
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.1.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn static images into interactive "Connect the Dots" quizzes. Perfect for anatomy, geography, and technical training assessments.

== Description ==

**TS Hotspot Quiz** transforms boring multiple-choice tests into engaging, interactive visual challenges. Instead of asking students to *select* an answer, make them **point to it**.

Built specifically for medical students (anatomy), geography teachers (maps), and technical trainers (diagrams), this plugin allows you to create "Match the Following" style quizzes directly on top of any image.



### 🚀 Free Features (Included)

* **Connect Mode:** Students drag a line from a term (e.g., "Left Ventricle") to the correct hotspot on the image.
* **Visual Builder:** Easy-to-use backend editor. Just upload an image and click to set hotspots.
* **Instant Feedback:** Students see immediate pass/fail results with a scoring breakdown.
* **Responsive:** Works perfectly on desktops, tablets, and mobile devices.
* **Shortcode Embed:** Place your visual quiz on any page, post, or lesson using `[ts_visual_quiz id="123"]`.
* **Unlimited Quizzes:** Create as many visual assessments as you need.

### 🏆 Pro Features (Upgrade)

Upgrade to **TS Hotspot Quiz Pro** for advanced assessment capabilities:

* **🖊️ Draw Mode:** Students must draw the actual path/line with their mouse or finger (perfect for tracing nerves or rivers).
* **⌨️ Type Mode:** No word bank! Students must type the correct label for a hotspot from memory.
* **🕵️ Forensic Analytics:** See exactly where students clicked incorrectly. Identify common misconceptions with heatmaps.
* **🏅 Leaderboards:** Gamify your classroom with top score lists.
* **🎓 LMS Integration:** Native support for LearnDash, LifterLMS, and TutorLMS.



== Installation ==

1.  Upload the plugin files to the `/wp-content/plugins/ts-hotspot-quiz/` directory, or install the plugin through the WordPress plugins screen directly.
2.  Activate the plugin through the 'Plugins' screen in WordPress.
3.  Go to **TS Hotspot Quiz > Add New** to create your first quiz.
4.  Copy the shortcode (e.g., `[ts_visual_quiz id="5"]`) and paste it into any Post or Page.

== Frequently Asked Questions ==

= Is this plugin compatible with my theme? =
Yes, TS Hotspot Quiz is designed to work with any standard WordPress theme. The quizzes are responsive and adapt to your content container width.

= Can I use this for Geography maps? =
Absolutely. Upload a map image, set hotspots on cities or countries, and have students match the names to the locations.

= Does the Free version save student results? =
The Free version provides instant feedback to the student (Pass/Fail score). To save detailed attempts, view historical data, and analyze class performance, you will need the Pro version.


== Screenshots ==

1. **The Visual Builder:** Simply click on your image to add a hotspot and assign a matching answer.
2. **Student View (Connect Mode):** A clean, interactive interface where students drag lines to match terms.
3. **Results Screen:** Beautiful feedback showing the student's score and pass/fail status.


== Changelog ==

= 1.0.0 =
* Initial release on WordPress.org.
* Added "Connect" interaction mode.
* Added basic scoring engine.
* Added Shortcode support.

== Upgrade Notice ==

= 1.0.0 =
This is the first version of TS Hotspot Quiz. Install to start creating visual assessments!