=== DominoForm - Advanced Contact Form, Polls, Survey & Quiz Builder ===
Contributors: dominopress
Tags: form builder, contact form, survey, poll, quiz
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A professional, high-performance visual form, poll, survey, and quiz builder for WordPress. Design premium interactive questionnaires, customer feedback surveys, live voting debates, and lead generation forms with zero coding required.

== Description ==

**DominoForm** is the ultimate all-in-one visual form, survey, poll, and quiz creation suite engineered for lightning-fast speed and effortless design directly inside WordPress. Whether you need a conversion-focused contact form, a complex multi-step customer satisfaction survey, an interactive live-voting poll, or a timed multiple-choice quiz, DominoForm handles it all with a sleek, modern, state-of-the-art visual builder.

With DominoForm, you get a premium, drag-and-drop workspace inside your WordPress admin dashboard. Customize everything from advanced field validation rules to rich color palettes and dynamic cover banners—without writing a single line of code.

= ✨ Comprehensive Feature Highlights =

**🎨 4-in-1 Powerhouse Suite**
* **Contact Forms:** High-converting lead generation forms with customizable floating material labels and instant email notifications.
* **Interactive Surveys:** Professional customer satisfaction questionnaires, NPS scoring, and employee feedback surveys.
* **Live Voting Polls:** Standalone voting contests, Versus Debates, and Image Choice polls with animated live bar results.
* **Timed Quizzes & MCQs:** Engaging multiple-choice quizzes with custom point assignments, correct answer grading, and countdown limits.

**🛠️ Interactive Visual Survey Canvas & Editor**
* **Intuitive Drag & Drop Workspace:** Seamlessly drag question cards from a clean, always-expanded Question Bank directly into your survey canvas with real-time insertion indicator lines and mid-drop zones.
* **Dynamic Uncropped Cover Banners:** Personalize your questionnaires with custom profile logos and dynamic header cover banners. Intelligent auto-scaling ensures your uploaded images display at their natural aspect ratio on both desktop and mobile without cropping. Includes built-in sizing recommendations (1200×300px landscape ratio) for optimum aesthetics.
* **Sticky Single-Line Modal Navigation:** Navigate effortlessly through comprehensive survey configuration tabs (**General**, **Branding & Logo**, **Theme & UI**, **Share & Embed**, **Demographics**, and **Security & Rate Limiting**) via sticky single-line navigation bars.

**📋 24+ Rich Question Types & Advanced Field Settings**
* **Extensive Question Bank:** Choose from Short Text, Paragraph Text, Numeric Inputs, Email, Phone Number, Website URL, Single-Choice Radio circles, Multi-Select Checkboxes, Dropdowns, Yes/No Toggles, Star Ratings (customizable from out-of-5 up to out-of-100!), Numeric Rating Bars, Emoji Satisfaction Faces, Range Sliders, NPS (Net Promoter Score 0-10), Likert Agreement Scales, Matrix Rating Grids, Item Ranking, Image Choice galleries, File Upload dropzones, Date/Time pickers, and electronic Signatures!
* **Advanced Field Restrictions & Validation:**
  * **File Upload Controls:** Specify allowed file formats (Images `.jpg,.png`, Documents `.pdf,.docx`, Spreadsheets, Media, or custom extension ranges) and enforce maximum file size limits (1 MB up to 50 MB). Supports single and multi-file drag-and-drop uploads with real-time validation alerts and review cards.
  * **Numeric & Slider Validation:** Configure minimum values, maximum limits, custom step increments, and decimal/fractional allowance toggles.
  * **Date & Time Restrictions:** Restrict calendar pickers to future dates only (for deadlines/bookings) or past dates only (for birthdays/history).
  * **Text & Paragraph Length Rules:** Define precise minimum and maximum character counts and custom regular expression matching patterns.

**👥 Dedicated Customer Demographics Module**
* Easily collect essential respondent background data (Full Name, Email Address, Age Group, Gender Identity, Occupation, Education Level, and Location/Country) using modular toggles without cluttering your main survey canvas.
* Displays a polite demographic intake profile at the top of your questionnaire and organizes respondent demographic breakdown in your backend reports.

**📊 Interactive Polls & Versus Competitions**
* Launch standalone single-question voting polls or engaging image debates with customizable options and vibrant progress bars.
* Flexible results visibility controls: display live voting counts before voting, reveal immediately after submission, or reserve exclusively for admin analysis.

**⚡ Multi-Channel "Share Survey" Hub & Distribution Suite**
* **Standalone Public Permalinks:** Automatically generates clean WordPress URLs (`yoursite.com/survey/custom-slug`) for published surveys with 1-click copy buttons and live testing links.
* **Native WordPress Shortcodes:** Easily embed surveys anywhere on your posts, pages, or widgets using simple shortcode blocks (`[dominoform id="123"]` or `[dominoform_survey id="123"]`).
* **Responsive HTML Iframe Embeds:** Copy responsive `<iframe width="100%" height="650">` wrapper codes to embed questionnaires seamlessly on external landing pages, Notion docs, or third-party platforms.
* **Live QR Code Generator:** Instantly generates scannable QR Code preview graphics that respondents can scan directly from flyers, slides, or mobile devices.
* **One-Click Social Media Distribution:** Share your forms directly to X (Twitter), Facebook, LinkedIn, or via Email with custom pre-populated sharing prompts.

**🛡️ Enterprise Security, Anti-Spam & Rate Limiting Suite**
* Protect your forms, surveys, and polls from automated spam bots, abusive submission flooding, and repetitive ballot stuffing.
* **Multi-Layer Verification:** Easily toggle Cookie Tracking, IP Address Verification, logged-in WordPress User account requirements, and intelligent CAPTCHA / Bot protection.
* **Granular Rate Limiting Controls:** Configure automated cooldown windows (`Every 5 Minutes`, `Every 10 Minutes`, `Every 1 Hour`, `Once Every 24 Hours`, or strict `One Submission Ever per User/IP`) and customize rejection warning messages shown to rate-limited visitors.

**📈 Real-Time Analytics & CSV Data Export**
* Track total submission volume, conversion completion rates, average sentiment ratings, and individual response timelines in real time.
* Export complete response datasets or customized survey summaries directly to standard CSV files for analysis in Excel or Google Sheets.

**🔄 Streamlined Survey Management & Status Toggles**
* **1-Click Status Transitions:** Effortlessly manage all questionnaires in a clean admin dashboard table. Click any **`● PUBLISHED`** or **`○ DRAFT`** status badge or dropdown action to toggle survey visibility instantly without re-opening the full visual editor!

== Installation ==

1. Upload the `dominoform-form-builder` folder to your `/wp-content/plugins/` directory, or upload the zipped package directly through your WordPress admin Plugins screen.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Locate and click on the new **DominoForm** icon in your WordPress admin sidebar menu.
4. Choose whether to design a Contact Form, Customer Survey, interactive Poll, or timed Quiz from scratch, or load one of our prebuilt one-click templates.
5. Use the provided WordPress shortcodes (e.g., `[dominoform id="123"]` or `[dominoform_survey id="123"]`) on any post, page, block, or elementor/builder layout to render your interactive form.

== Frequently Asked Questions ==

= How do I customize accepted file upload types and maximum file size limits? =
When editing a questionnaire in the Survey Builder, click on any **File Upload** question card and select **Settings**. Under the **General** tab, you will find dedicated controls to choose Accepted File Types (Images only, Documents only, Spreadsheets, Media, or custom extensions) and select Maximum File Size Limits (from 1 MB up to 50 MB) alongside multiple-file upload toggles.

= Will my custom banner image be cropped on mobile or desktop screens? =
No! DominoForm utilizes an intelligent dynamic container sizing architecture. When you upload a cover banner URL, the survey canvas automatically scales its height naturally to match the exact aspect ratio of your picture, guaranteeing that your entire image remains 100% uncropped and visually stunning across all devices. We recommend a banner image resolution of **1200 × 300px (4:1 landscape ratio)** for crisp display.

= Can I prevent users from taking a survey or poll more than once? =
Yes! Inside your Survey or Poll Editor, open **Survey Settings** (or **More Settings**) and navigate to the **Security & Rate Limiting** tab. Enable Rate Limiting and choose your preferred protection window—ranging from temporary cool-downs (e.g., once every 5 or 10 minutes) up to strict one-time enforcement (`One Submission Ever per User/IP`). You can also combine IP Address checking, Cookie tracking, and WordPress User authentication for ironclad verification.

= How do I share my survey without creating a WordPress page? =
DominoForm automatically creates clean, standalone public permalinks (`yoursite.com/survey/your-slug`) for all published surveys! Click the **Share** button in your admin table or survey editor to open the multi-tabbed distribution hub. From there, you can copy the standalone public link, download a live scannable **QR Code**, copy responsive `<iframe height="650">` HTML snippet code for external websites, or post instantly to social media channels (X, Facebook, LinkedIn, Email).

= How do I switch a published survey back to draft status? =
In your main Survey Management dashboard table, simply click on the glowing green **`● PUBLISHED`** status badge next to your survey title, or select **Unpublish / Set to Draft** from the 5-button Actions row menu. The plugin will display a loading animation and immediately update the status to **`○ DRAFT`** without requiring you to open the full builder.

== Screenshots ==

1. Unified Dashboard displaying active Contact Forms, Surveys, Polls, Quizzes, and prebuilt conversion templates.
2. Advanced drag-and-drop Survey Builder featuring dynamic cover banner previewing and permanently expanded Question Bank.
3. Question Settings modal showing rich field configurations for file upload limits, slider thresholds, and date restrictions.
4. Enterprise Anti-Spam Security & Rate Limiting console with multi-window cooldown selectors and protection toggles.
5. Multi-channel Share Survey distribution modal featuring QR code generation, WordPress shortcodes, and iframe embed tags.

== Changelog ==

= 1.1.0 =
* **New:** Dynamic uncropped cover image rendering in both backend editor and frontend live surveys—banners automatically scale to display complete pictures at their full natural aspect ratios without cropping.
* **New:** Built-in helper sizing recommendations for survey cover banners (1200 × 300 px / 4:1 ratio).
* **New:** Rich File Upload restrictions and validation rules in Question Settings: specify accepted format types (.pdf, .docx, images, media, or custom extensions), enforce maximum file size thresholds (1 MB to 50 MB), and toggle multi-file uploads with real-time drag-and-drop validation cards.
* **New:** Expanded validation controls for Numeric inputs (min/max range and decimal allowances), Range Sliders (custom step increments and bounds), Date Pickers (restrict to past or future calendar windows), and Text fields (character length rules).
* **New:** 1-Click Publish and Unpublish (Move to Draft) transitions directly from the Survey Management dashboard table via interactive status badges and dropdown action controls.
* **New:** Multi-tabbed Share Survey distribution hub featuring standalone public permalinks, shortcodes, copyable responsive HTML `<iframe height="650">` snippets, live downloadable QR codes, and social buttons (X/Twitter, Facebook, LinkedIn, Email).
* **New:** Upgraded Anti-Spam Security and Rate Limiting console featuring intuitive cooldown selectors (5 minutes, 1 hour, 24 hours, or One Submission Ever), multi-layer protection toggles (IP, Cookie, Auth, Bot verification), and an explicit persistent Save Security Settings action button.
* **New:** Sticky single-line navigation tab layout in Survey Settings modal for effortless scrolling through configurations.
* **Tweak:** Removed unnecessary collapsible accordion behavior from the editor Question Bank sidebar so all categories and input field options remain permanently visible.

= 1.0.0 =
* Complete rewrite featuring a sleek, lightning-fast modern visual builder and frontend rendering engine.
* Added support for Surveys and Quizzes.
* Added visual customization options (Themes, colors, radius).
* Added prebuilt templates.
