SocialPoll – Instagram style Polls

Engage Your Audience Like Never Before!

SocialPoll brings the simplicity and elegance of Instagram-style polls to your WordPress website. Create stunning, interactive polls that capture attention and drive engagement with just a few clicks.

Why Choose SocialPoll?

• 🚀 Lightning Fast Setup – Create and publish polls in under 60 seconds
• 📱 Mobile-First Design – Beautiful, responsive polls that look perfect on any device
• 🔒 Privacy-Focused – No user registration required, token-based voting prevents duplicates
• 📊 Instant Voting – One-click voting with no submit button – see results immediately
• 🎨 Modern Interface – Clean, intuitive admin powered by React 19
• ⚡ Performance Optimized – Built with Alpine.js for blazing-fast frontend interactions

Perfect For:

• Content Creators – Boost engagement and gather audience opinions
• Marketers – Conduct quick market research and product feedback
• Publishers – Add interactive elements to articles and blog posts
• Community Managers – Spark conversations and understand your community
• Educators – Create interactive quizzes and gather student feedback

Key Features

Powerful Admin Dashboard
– Modern React-based interface for effortless poll management
– Bulk actions for efficient workflow
– Real-time preview before publishing
– Comprehensive analytics at your fingertips

Smart Voting System
– One-click instant voting – no submit button needed
– Anonymous voting with duplicate prevention
– No login required – reduce friction, increase participation
– Instant results display with animated percentages
– Token-based security prevents manipulation

Developer Friendly
– Well-structured, maintainable codebase
– Modern build process with Vite for optimized assets
– WCAG accessibility compliant

Built for Scale
– Optimized database structure with denormalized counts
– Efficient caching mechanisms
– Handles high-traffic scenarios with ease

How It Works

1. Create – Design your poll with multiple options in the intuitive admin panel
2. Customize – Set visibility options and configure display settings
3. Publish – Add to any page or post using shortcodes or Gutenberg blocks
4. Engage – Watch as your audience participates and shares their opinions
5. Analyze – Review detailed voting statistics and insights

Shortcode Usage

Simply add [socialpoll id="X"] to any post or page, where X is your poll ID.

Pro Tips

• Plan your questions carefully – published polls are locked to maintain vote integrity.
• Use clear, concise option text for better mobile display
• Place polls strategically within your content for maximum engagement

Technical Information

Database Structure

SocialPoll uses three optimized tables:
* Polls table – stores poll metadata
* Options table – stores poll choices
* Votes table – records individual votes with unique tokens

Performance

• Denormalized vote counts for instant results
• Efficient database queries
• Minimal frontend JavaScript footprint with Alpine.js
• Smart bundling and minification with Vite
• Optimized asset delivery

Security

• All data properly escaped and sanitized
• Nonce verification on all actions
• Capability checks for admin operations
• SQL injection prevention
• XSS protection

Source Code

All JavaScript and CSS source files are included in the src/ directory of this plugin.

Build Process:
This plugin uses modern build tools to compile and optimize JavaScript and CSS assets:
* Vite – for admin and frontend React/Alpine.js components
* webpack (@wordpress/scripts) – for Gutenberg blocks

Source files:
* src/admin/js/ – React admin interface components
* src/frontend/js/ – Alpine.js frontend code
* src/components/ui/ – Reusable UI components (TypeScript/React)
* src/blocks/ – Gutenberg block source
* src/lib/ – Utility libraries
* CSS source files in respective directories

Compiled output:
* dist/ – Vite compiled assets
* build/blocks/ – webpack compiled Gutenberg blocks

Building from source:
1. Install Node.js (version 16 or higher)
2. Install dependencies: npm install
3. Development build: npm run dev
4. Production build: npm run build
5. Build Gutenberg blocks: npm run build:blocks

All dependencies are listed in package.json and use standard packages from the public npm registry.

Support

Need help? We’re here for you!

• Plugin Page: [Coming Soon]
• Support & Feature Requests: WordPress.org Support

1. Upload the socialpoll folder to the /wp-content/plugins/ directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Navigate to the ‘SocialPoll’ menu in your WordPress admin
4. Create your first poll and start engaging your audience!

Automatic Installation

1. Log in to your WordPress dashboard
2. Navigate to Plugins > Add New
3. Search for “SocialPoll”
4. Click “Install Now” and then “Activate”
5. You’re ready to create your first poll!

1.0.1

Voting animation fix. Smooth options overlay reveal after successful voting.

1.0.0

• Initial release
• Instagram-style poll functionality
• React-based admin interface
• Alpine.js powered frontend
• Instant one-click voting experience
• Token-based voting system
• Gutenberg block support
• Shortcode implementation
• WCAG accessibility compliance
• Mobile-responsive design
• Real-time vote counting
• Bulk actions support
• Published poll protection
• Multi-language ready
• Vite-powered build optimization