=== dtElection Poll Embed === Contributors: amcloudaide Tags: poll, voting, survey, scheduling, embed Requires at least: 5.0 Tested up to: 6.9 Stable tag: 1.6.1 Requires PHP: 7.4 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Embed dtElection polls in your WordPress site. Let visitors vote on polls directly without leaving your site. == Description == **dtElection Poll Embed** lets you embed polls from [dtElection](https://dtelection.com) directly into your WordPress posts and pages. = Features = * **Easy embedding** - Just paste your poll URL or token * **Inline voting** - Visitors vote without leaving your site * **Gutenberg block** - Modern block editor support * **Shortcode support** - Works with classic editor too * **Responsive design** - Looks great on all devices * **Real-time results** - Poll updates after voting * **Yes/Maybe/No voting** - Full support for 3-option voting * **Email collection** - Optional email requirement for voters * **Location display** - Show poll location with Google Maps link * **Hero images** - Display poll hero images (Pro+ feature) * **External links** - Show attached links (Enterprise feature) * **White-label option** - Remove branding for Pro+ tiers = How to Use = 1. Create a poll at [dtelection.com](https://dtelection.com) 2. Copy the poll URL or token 3. Add to your WordPress content: * **Gutenberg**: Insert "dtElection Poll" block, paste URL/token * **Shortcode**: `[dtelection poll="YOUR_TOKEN"]` = Examples = Using the shortcode with a token: `[dtelection poll="abc123"]` Using the shortcode with a full URL: `[dtelection poll="https://dtelection.com/poll/abc123"]` == Installation == 1. Upload the `dtelection-embed` folder to `/wp-content/plugins/` 2. Activate the plugin through the 'Plugins' menu in WordPress 3. Start embedding polls using the shortcode or Gutenberg block == Frequently Asked Questions == = Do I need a dtElection account? = You need to create polls at dtelection.com first. Creating polls is free. = Can visitors vote without an account? = Yes! Visitors can vote on embedded polls without creating any account. = Does this work with the block editor? = Yes! There's a dedicated "dtElection Poll" block for the Gutenberg editor. = Can I style the poll to match my theme? = The current version uses dtElection branding. Custom styling options are planned for a future release. == External Services == This plugin connects to the dtElection API to fetch poll data and submit votes. This is the core functionality of the plugin - it cannot work without this external service. = What data is sent = * **Poll token** - When displaying an embedded poll, the plugin sends the poll token to fetch poll details (title, options, current votes). * **Vote data** - When a visitor submits their vote, the plugin sends their name, selected options, and optionally their email (if the poll requires it). = When data is sent = * When a page containing an embedded poll is loaded (to fetch poll data) * When a visitor clicks "Vote" to submit their selection = Service provider = This service is provided by dtElection. * Service website: [https://dtelection.com](https://dtelection.com) * Terms of Service: [https://dtelection.com/terms](https://dtelection.com/terms) * Privacy Policy: [https://dtelection.com/privacy](https://dtelection.com/privacy) == Screenshots == 1. Embedded poll in a WordPress post with voting options 2. dtElection Poll block in the Gutenberg editor 3. Poll results view with colored progress bars 4. Admin documentation page with usage guide == Changelog == = 1.6.1 = * Fixed text domain to match plugin slug for WordPress.org translations * Added External Services documentation for API transparency * Removed remote favicon dependency - now uses local assets only * Updated contributor information = 1.6.0 = * Added Yes/Maybe/No voting buttons for polls with "allow maybe" enabled * Added email input field when poll requires email * Added location display with clickable Google Maps link * Added hero image support (displayed at top of poll) * Added external link display (Enterprise feature) * Added conditional branding - Pro/Enterprise tiers can hide dtElection branding * Improved results display showing separate yes/maybe counts * Updated responsive styles for mobile devices = 1.5.0 = * Added single selection mode (radio buttons vs checkboxes) * Improved error handling with specific error messages * Better domain whitelist validation = 1.4.0 = * Added support for closed poll detection * Improved vote submission error handling = 1.3.0 = * Added dtElection favicon to brand link * Brand link now opens the actual poll on dtElection * Result bars now use dtElection colors (teal/orange) * Leading vote highlighted in orange * Improved visual design = 1.1.0 = * Added duplicate vote prevention (remembers if user voted via localStorage) * Added "How to Use" documentation page in WordPress admin * Added dtElection menu item with full usage guide * Shows "already voted" message with voter name * Improved user experience for returning visitors = 1.0.0 = * Initial release * Shortcode support * Gutenberg block support * Inline voting == Upgrade Notice == = 1.6.0 = Major update with Yes/Maybe/No voting, email collection, location display, hero images, and white-label support for Pro+ tiers. = 1.1.0 = Duplicate vote prevention and in-admin documentation page. = 1.0.0 = Initial release of dtElection Poll Embed.