=== Bucketforms Lite ===
Contributors: chadcombinator
Donate link: https://bucketforms.netlify.app/
Tags: forms, survey, multi-step form, conversational form, typeform
Requires at least: 6.0
Tested up to: 6.7
Stable tag: 1.1.2
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create high-converting, Typeform-style split-layout conversational forms and surveys in WordPress. 100% self-hosted.

== Description ==

**Bucketforms Lite** is the modern conversational form builder for WordPress. Say goodbye to boring, endless vertical forms and expensive recurring SaaS subscriptions. 

With Bucketforms Lite, you can build engaging, one-question-at-a-time forms that guide respondents smoothly through your questions with responsive 50/50 split layouts, fluid animations, and keyboard navigation.

All form submission data stays 100% self-hosted on your own WordPress site, giving you complete data privacy and ownership with zero artificial submission caps or locked leads.

### ✨ Key Features

* **Conversational 50/50 Split Runner:** Questions are presented one-at-a-time with intuitive keyboard shortcuts (Enter / Tab). On desktop, respondents enjoy a split layout; on mobile, it smoothly adapts to a clean fullscreen experience.
* **15 Free Field Types:** Short Text, Long Text, Multiple Choice, Star Rating, Opinion Scale (1–10), Yes/No Boolean, Statement, Number, Email, Phone, Date Picker, Website URL, Legal Agreement / Terms, Document / File Upload, and Digital Signature Pad.
* **Smart Conditional Logic (Branching):** Create personalized questionnaire paths by showing or jumping to specific steps based on respondent choices.
* **Score & Quiz Calculations:** Real-time formula scoring, points calculation, and dynamic outcome brackets for quizzes, assessments, and lead qualification.
* **Standalone Landing Pages:** Every form gets an instant, distraction-free landing page at `/bf/{slug}` with zero theme chrome or distractions.
* **Page Builder Integrations:** Native Gutenberg Block (`bucketforms/form-embed`) and Elementor widget, plus standard WordPress shortcodes (`[bucketform id="123"]`).
* **Submissions Viewer & CSV Export:** View detailed respondent answers, timestamps, and step completions with one-click clean UTF-8 CSV exports. Zero locked leads or submission limits.
* **GDPR & Privacy Compliant:** Integrates directly with WordPress Core Privacy Tools (Export Personal Data & Erase Personal Data) with customizable data retention purge schedules.

### 🎨 Design Studio & Presets

* 12 Curated Visual Presets: Ocean (default), Aurora, Sunset, Midnight, Emerald, Minimal, Citrus, Berry, Mint, Lavender, Crimson, and Cyber.
* Ambient wave color animations.
* Custom background images directly from your WordPress Media Library.
* Light and Dark theme modes.

== Installation ==

1. Upload the `bucketforms-lite` folder to the `/wp-content/plugins/` directory, or install the ZIP file via **Plugins > Add New > Upload Plugin** in your WordPress admin.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Navigate to **Bucketforms** in your admin menu to create your first interactive form.
4. Embed your form onto any page or post using the **Bucketform** Gutenberg block, Elementor widget, shortcode `[bucketform id="YOUR_FORM_ID"]`, or view the standalone page at `/bf/YOUR-SLUG`.

== Frequently Asked Questions ==

= Do I need a third-party account to use Bucketforms Lite? =
No. Bucketforms Lite is 100% self-hosted on your own WordPress site and database. You own all your data.

= Are file uploads and digital signatures free? =
Yes! All 15 field types—including Document/File Uploads and Digital Signature Pads—are 100% free and unlocked.

= Are there any limits on forms or submissions in Lite? =
No. Bucketforms Lite does not cap your forms or lock your submissions. You can create as many forms and collect as many submissions as your server can handle.

= Is Bucketforms Lite compatible with Gutenberg and Elementor? =
Yes. Bucketforms Lite includes a dedicated Gutenberg block and an Elementor widget for instant embedding. You can also use the shortcode `[bucketform id="..."]` anywhere.

= What is the standalone form URL? =
Every published form can be accessed directly without theme headers/footers via `/bf/{slug}`, ideal for paid ad funnels and social media bio links.

= What happens if someone submits a form on mobile? =
The responsive form runner automatically switches to an optimized fullscreen experience on mobile devices with touch-friendly controls and bottom navigation.

= Can I use my Bucketforms Pro license on multiple websites? =
Yes! Every Bucketforms Pro license key is valid for up to 10 WordPress websites. You can activate it across your own sites and client installations directly from your WordPress admin.

== Screenshots ==

1. All Forms dashboard showing active forms, aggregate submissions, completion rates, and shortcode embed tools.
2. Submissions manager with completion status filter, timestamps, and one-click CSV export.
3. Detailed submission response modal with question-by-question answers and Google Sheets sync indicator.
4. Visual Form Builder with step reordering, real-time live preview, and question settings inspector.
5. Theme & Design Studio featuring 12 visual presets (Ocean, Sunset, Midnight, Cyber, etc.) and custom color palettes.
6. Standalone conversational form runner at `/bf/{slug}` with 50/50 split layout and progress indicator.
7. Dark mode form runner demonstrating modern multiple choice selection with keyboard shortcuts.
8. Thank You / Completion screen with custom success messaging and optional agency branding badge.

== Changelog ==

= 1.1.2 =
* Rebranded to Bucketforms Lite.
* Updated standalone form route to `/bf/{slug}`.
* Added native Gutenberg block (`bucketforms/form-embed`) and Elementor widget.
* Completely removed submission lock restrictions and form creation limits.
* Fully decoupled Pro extensions (Google Sheets sync, outbound webhooks, automatic license updates) into modular Bucketforms Pro add-on.
* Script and stylesheet asset loading optimization with full REST API hardening.
* WordPress Core GDPR Export and Erase personal data tool support.
* Ocean background preset set as default with zero external image dependencies.

== Upgrade Notice ==

= 1.1.2 =
Initial release of Bucketforms Lite. Enjoy building modern conversational forms!
