=== VotePulse Election System ===
Contributors: eh6142302
Donate link: https://eslamdev.com/
Tags: election, voting, vote, candidates, polls
Requires at least: 5.0
Tested up to: 7.1
Stable tag: 1.1.0
Requires PHP: 7.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A secure election voting system with encrypted votes and admin-controlled candidate management.

== Description ==

VotePulse Election System provides a robust solution for creating and managing online voting systems directly within your WordPress site. Whether you're running a small community election or a voting event, this plugin offers an intuitive interface, secure voter management, and customizable email notifications to streamline the process.

= Features =
* **Voter Management**: Add, edit, and remove voters with ease through an admin-friendly interface.
* **Token-Based Voting**: Generate unique voting tokens for each voter to ensure secure and verifiable votes.
* **Responsive Voting Form**: A beautifully designed voting interface that works seamlessly on desktops, tablets, and mobile devices.
* **Live Voting Reports**: Monitor real-time voting results and detailed statistics directly from the dashboard or public shortcode.
* **Multilingual Support**: Supports RTL and LTR layouts dynamically and can be translated using standard WordPress localization tools.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/votepulse-election-system` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Use the `VotePulse Elections` menu to configure the plugin and add candidates/voters.
4. Add the `[votepulse_vote_form]` shortcode to a page to display the voting form to users.
5. Add the `[votepulse_results]` shortcode to display live election results.

== Frequently Asked Questions ==

= How do voters get their tokens? =
Tokens are assigned in Voter Management and can be distributed to voters directly or via email notifications.

= What does "Force Vote" mean? =
If enabled, voters must select exactly the number of candidates specified in their allowed vote count.

= Is voting anonymous? =
Votes are linked to encrypted emails and IPs for security, but voter identity is protected.

== Screenshots ==

1. Admin Settings Page. Customize email templates and manage voting settings.
2. Voting Interface. A clean and responsive voting form for users.
3. Email Notification. Example of a voter-added email with token and vote count.

== Credits & Assets ==

* **Status Icons**: Bundled locally in `assets/images/` under creative commons / Icons8 license.

== Changelog ==

= 1.1.0 =
* Initial public release on WordPress.org under VotePulse Election System brand.