=== HT Live Polls & Voting ===
Contributors: hiteshtarasariya
Tags: poll, opinion poll, voting, surveys, vote
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A secure opinion polls and voting system for WordPress. Easily create workplace polls, enforce unique email votes, and view live progress bars.

== Description ==

HT Live Polls & Voting provides an intuitive, real-time opinion poll and voting engine designed for workplace polls, community feedback, and public surveys.

= Key Features =
* **Poll UI Design:** Modern option box cards with embedded radio selectors, real-time percentages, horizontal progress bars, and total voter count footers.
* **Unique Email Voting:** Enforces unique votes per poll based on Email Address (and user ID) to guarantee authentic results.
* **Poll Expiration Datetime:** Set expiration date and time for polls to automatically close voting when expired.
* **Bulk Multi-Delete Functionality:** Select multiple polls, questions, or vote submissions and delete them simultaneously with AJAX confirmation modals.
* **Comprehensive Shortcodes:** Easily embed polls (`[live_poll id="123"]`), standalone questions (`[live_question id="123"]`), user login/registration forms, and front-end support ticket forms.
* **Submissions & Analytics:** View real-time response distribution graphs and voter submission logs in the WordPress admin dashboard.
* **Theme Overrides:** Seamlessly override plugin templates by placing files inside `your-theme/ht-live-polls-and-voting/`.
* **WordPress.org Compliant:** Strict security practices, sanitization, escaping, and nonces.

== Installation ==

1. Upload the `ht-live-polls-and-voting` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Add the `[live_poll id="123"]` shortcode to any page or post.

== Shortcodes ==

* `[live_poll id="123"]` - Embeds an opinion poll with option selection, real-time percentage indicators, progress bars, and total voter count.
* `[live_question id="123"]` - Embeds a standalone question/poll card.
* `[live_polls_login]` - Renders user login form with client-side validation and AJAX authentication.
* `[live_polls_register]` - Renders user registration form and triggers welcome emails.
* `[live_polls_forgot_password]` - Renders password reset request form.
* `[live_polls_support]` - Renders a front-end contact and support ticket submission form.

== Template Overrides ==

To customize poll templates in your active theme:
1. Create a folder named `ht-live-polls-and-voting` in your active theme's directory (e.g. `wp-content/themes/your-theme/ht-live-polls-and-voting/`).
2. Copy `wp-content/plugins/ht-live-polls-and-voting/templates/quiz/quiz-card.php` or `question-card.php` into `wp-content/themes/your-theme/ht-live-polls-and-voting/`.
3. Modify the template as needed!

== Frequently Asked Questions ==

= How is unique voting handled? =
Unique votes are checked based on Email Address to prevent voters from submitting multiple responses on the same poll.

= Can I view graphical analytics of poll submissions? =
Yes! Log into WordPress Admin and go to **Polls > Submissions & Analytics** to view real-time horizontal distribution bar graphs.

== Screenshots ==

1. Front-end live poll box with embedded radio selector options and real-time progress bars.
2. WordPress Admin Dashboard view showing poll creation.
3. Submissions & Analytics dashboard showing real-time voter breakdown and submission log.

