﻿=== BBForms - Flexible Contact Forms, Survey, Quiz, Poll & Custom Forms Editor, now with AI ===
Contributors: rubengc, eneribs, dioni00, tinocalvo, flabernardez
Tags: contact form, custom form, forms, shortcode, code
Requires at least: 4.4
Tested up to: 7.1
Stable tag: 2.0.5
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Build your [forms] faster and easily just by typing them! AI assistant included!

== Description ==

[BBForms](https://bbforms.com "BBForms") is a high-performance, code-based WordPress form builder designed for speed, flexibility, and absolute control.

By using shortcode-style BBCode syntax, BBForms eliminates heavy drag-and-drop bloat while giving complete control to build complex forms, handle custom actions, and generate fully functional forms in seconds with natural language AI.

Whether you need a simple contact form, multi-column survey, or advanced lead capture system, BBForms loads only when needed with an ultra-light footprint.

https://youtu.be/cfD8wqzgchs

### 🚀 Why BBForms?

* ⚡ **Lightning Fast Performance:** Loads assets strictly on pages containing forms. Unmatched page load speed with zero frontend bloat.
* ✨ **Built-in AI Assistant:** Describe what you need in plain text, and let the AI generate the fields, actions and form configuration automatically.
* 📋 **Text-Based Portability:** Easily copy, paste, backup, or share form configurations across client sites via raw code or simple `.txt` files.
* 🛠️ **Developer & Site Owner Friendly:** Total control over layout, column structures, custom messages, and placement without wrestling with restrictive drag-and-drop canvas UIs.

= 🔥 Features =

📋 **Flexible Form Creation**

* [20 fields](https://bbforms.com/docs/features/fields/) (text, email, file uploads, date/time, quiz, number, range, etc.).
* [20 BBCodes](https://bbforms.com/docs/features/bbcodes/) (columns, table, bold, etc).
* Responsive multi-column form layout.
* AI assistant to design forms in seconds.
* File uploads.
* Form templates ([live demo](https://bbforms.com/docs/features/form-templates/)).
* Live form preview.
* Categories & tags to organize your forms.

🚀 **Powerful Processing & Actions**

* [6 actions](https://bbforms.com/docs/features/actions/) (record, email, redirect, etc).
* Execute multiple actions per submission (send as many email notifications as you wish!).
* GDPR actions to automate export & deletion requests.
* [Tags](https://bbforms.com/docs/features/tags/) to place dynamic content anywhere.

⛔ **Access Control & Anti-Spam**

* [14 form options](https://bbforms.com/docs/features/form-options/) (clear & hide form on success, show required fields notice, etc).
* Restrict form access to logged-in users only.
* Prevent duplicate submissions by unique field values.
* Apply a submissions limit.
* Anti-bot & anti-spam protection.
* Honeypot spam protection + Quiz field for custom math/question CAPTCHAs.

📊 **Advanced Submissions Management**

* Store, view, filter, edit & delete your submissions easily.
* Export submissions to CSV.
* Submissions auto-cleanup.

👑 **Extra**

* Role management settings.
* Export/Import forms by copying & pasting code or using `.txt` files.
* Override form & field messages globally.
* Light & dark mode editor.
* Mobile ready & designed for accessibility.
* Optimized for speed (CSS: 4kb & JS:9kb).

= ✨ AI Assistant included! =

Built-in AI Assistant designed to design, create, and manage forms using natural language!

Example Prompts:
```
Create a job application form, limit submissions to 1 and restrict to logged-in users only
```
```
Do a 3-question form about Spanish geography that records the submission & sends a congratulatory email
```

**Important:** This assistant uses the WP AI Connectors. Without a configured connector, it won't be able to perform any tasks.

= 🙌 The perfect form solution for everyone =

BBForms is designed to be accessible to everyone helping you to create your forms easily, whether you build them for yourself or for a client:

🧑‍💻 **Site owners:** Build your own forms without coding experience! BBForms is shipped with ready-to-use templates and every control provides several examples like an email field auto-filled with the logged-in user email.
🛠️ **Developers:** Building forms for clients has never been so easy! Create and store your own form templates, then import them into your client websites in seconds.
🌐 **Sites network owners:** Managing multiple websites? BBForms makes support much easier! Share complete form configurations with your customers by simply copying & pasting code or as a `.txt` file.

= ⭐ Add-ons to extend BBForms =

* [Address Autocomplete](https://bbforms.com/add-ons/address-autocomplete/)
* [Calculations](https://bbforms.com/add-ons/calculations/)
* [Conditional Display](https://bbforms.com/add-ons/conditional-display/)
* [Conditional Logic](https://bbforms.com/add-ons/conditional-logic/)
* [Email Balancer](https://bbforms.com/add-ons/email-balancer/)
* [Geolocation](https://bbforms.com/add-ons/geolocation/)
* [Multi-Step Forms](https://bbforms.com/add-ons/multi-steps-forms/)
* [Post Submissions](https://bbforms.com/add-ons/posts/)
* [Rating Field](https://bbforms.com/add-ons/rating/)
* [Repeatable Fields](https://bbforms.com/add-ons/repeatable-fields/)
* [Save Progress](https://bbforms.com/add-ons/save-progress/)
* [Signature Field](https://bbforms.com/add-ons/signature/)
* [Users Management](https://bbforms.com/add-ons/users/)

Spam protection add-ons:

* [Google reCAPTCHA v2 & v3](https://bbforms.com/add-ons/recaptcha/)
* [hCaptcha](https://bbforms.com/add-ons/hcaptcha/)
* [Cloudflare Turnstile](https://bbforms.com/add-ons/cloudflare-turnstile/)

= ⚙️ Integrations =

* **AutomatorWP:** Trigger no-code automations and pass field values to 300+ plugins and apps.
* **Easy Digital Downloads (EDD):** Tags to display customer information and order history anywhere.
* **GamiPress:** Award points, achievements, and ranks when users submit forms.
* **WooCommerce:** Tags to display customer information and order history anywhere.

= ♥️ More plugins from the BBForms team =

🕹️ [GamiPress](https://wordpress.org/plugins/gamipress/) - Gamification plugin to boost engagement by rewarding users with points, achievements, badges & ranks.
🤖 [AutomatorWP](https://wordpress.org/plugins/automatorwp/) - Automator plugin that connects +300 plugins, platforms and sites together with support to webhooks.
🔗 [ShortLinks Pro](https://wordpress.org/plugins/shortlinkspro/) - Link management plugin for shortened URLs & branded affiliate links.
👤 [WhatAvatar](https://wordpress.org/plugins/whatavatar/) - Powerful avatar editor for creating unique avatars without uploading personal photos.

== Installation ==

= From WordPress backend =

1. Navigate to Plugins -> Add new.
2. Click the button "Upload Plugin" next to "Add plugins" title.
3. Upload the downloaded zip file and activate it.

= Direct upload =

1. Upload the downloaded zip file into your `wp-content/plugins/` folder.
2. Unzip the uploaded zip file.
3. Navigate to Plugins menu on your WordPress admin area.
4. Activate this plugin.

== Screenshots ==

1. Create forms with an easy-to-use editor.
2. Responsive multi-column form layout.
3. Advanced submissions view with the ability to export them as CSV.
4. Easily edit any submission entry.
5. Reusable form templates.
6. Built-in AI assistant ready to help you design and create your forms in seconds!
7. Export/Import forms by copying & pasting code or TXT file.
8. Configure the actions to process anything you want (record, email, redirect, etc).
9. Change the form options easily including require to log in, unique field & submissions limit.
10. Form editor comes with helper controls to build forms faster.
11. Light & dark mode included.
12. Check the documentation inside the plugin, without abandon your dashboard.


== Frequently Asked Questions ==

= Why code forms instead of a visual builder? =

Coding your forms brings greater flexibility, control, and scalability compared to relying on a visual builder.

While visual builders may seem easier at first, they quickly reveal their limitations, becoming less flexible and slower to use.

Defining your forms in text gives you complete control over their content. You can insert custom elements wherever you need, copy and paste only the parts you want, and easily share your form code with others.

By contrast, visual builders force you to work within a graphical interface and restrict you to the actions they support. As a result, even a simple task like duplicating one or multiple fields depends on whether the editor includes a specific control for it.

In short, a text-based editor offers a level of freedom and efficiency that visual builders simply cannot match.

= Will BBForms slow down my website? =

Absolutely not. BBForms was built carefully with performance in mind to make BBForms run smoothly & fast with just 4kb CSS & 9kb JS.

In addition, BBForms only loads styles & scripts in the pages where you place a form.

= What types of forms can I build with BBForms? =

BBForms is designed to build multipurpose forms, which means that you can build almost any kind of form you need. Here are some types of WordPress forms you can create:

* Contact Forms
* Job Application Forms
* File Upload Forms
* Quiz Forms
* Lead Forms
* Feedback Forms
* Polling & Survey Forms
* Appointment Forms
* Booking Forms
* Event Registration Forms
* RSVP Forms
* Newsletter Signup Forms
* CRM Forms
* Email Forms
* Support Ticket Forms
* Request Forms
* Sales Forms
* Questionnaire Forms
* Export or Delete Data Request Forms

With our premium add-ons you can build even more advanced forms:

* Calculation Forms
* Multi-Step Forms
* Signature Contract Forms
* Conditional Forms
* Repeatable Fields Forms
* Address Autocomplete Forms
* User Login Forms
* User Registration Forms
* User Account Management Forms
* Content Contribution Forms
* Post Creation Forms
* Payment Calculator Forms
* Quote & Cost Calculator Forms
* Health & Fitness Calculator Forms

... and many more!

= Which form fields are included in BBForms? =

* [text] - Text
* [textarea] - Text Area
* [email] -Email
* [tel] - Phone
* [url] - URL
* [password] - Password
* [date] - Date
* [time] - Time
* [file] - File
* [number] - Number
* [range] - Range
* [check] - Checkbox
* [radio] - Radio
* [select] - Select
* [country] - Country
* [quiz] - Quiz
* [hidden] - Hidden
* [honeypot] - Honeypot
* [submit] - Submit
* [reset] - Reset

Documentation about fields can be found [here](https://bbforms.com/docs/features/fields/).

= Which actions are included in BBForms? =

* [record] - Records the submission in the database.
* [email] - Sends an email.
* [redirect] - Redirects user to the URL of your choice.
* [message] - Shows a message in the form.
* [export_request] - Registers an email in the WP personal data export tool.
* [delete_request] - Registers an email in the WP personal data deletion tool.

Documentation about actions can be found [here](https://bbforms.com/docs/features/actions/).

= Can I connect BBForms with other plugins and platforms? =

Yes. We are the authors of [AutomatorWP](https://wordpress.org/plugins/automatorwp/), an automation plugin that can connect your forms with +200 plugins & platforms like OpenAI, HubSpot, Learndash & WooCommerce.

In addition, you can create custom workflows like:

Enroll in a LifterLMS course after submit a form

* Update a Google Sheets with the submitted data
* Register as contact in WPFusion after submit a form
* Send a webhook to Zapier with the submitted data
* Register as affiliate in AffiliateWP after submit a form

The possibilities are unlimited!

= Is BBForms compatible with any theme? =

We have tested BBForms with the most popular WordPress themes and since it uses HTML5 inputs, almost all themes should display them correctly.

If your theme does not display a field correctly, just [let us know](https://bbforms.com/contact-us/) to fix it as soon as possible.

= Is BBForms translation ready? =

Yes, BBForms is stored in the official WordPress plugins repository where you (and anyone) are able to [submit your own translations](https://translate.wordpress.org/projects/wp-plugins/bbforms).

= Is BBForms GDPR compliant? =

Yes. All user submitted data is stored locally on your server only, unless you expressly configure BBForms to send it elsewhere, for example via an email action.

We never see or collect any user submitted data and we do not act as Data Controllers or Data Processors per GDPR Article 4.

If you collect Personally Identifiable Information (PII) using BBForms, here is a guide to [make your forms GDPR compliant](https://bbforms.com/docs/miscellaneous/gdpr-make-your-forms-gdpr-compliant/) and also you can [automate export and deletion data requests](https://bbforms.com/docs/miscellaneous/gdpr-automate-export-deletion-requests/).

= Does BBForms include spam protection? =

Yes, BBForms includes anti-bot & anti-spam protection through honeypot which is enabled on all forms by default in the form options.

Additionally, there are [premium integrations](https://bbforms.com/add-ons/) with Google reCAPTCHA (v2 & v3), hCaptcha, & Cloudflare Turnstile.

Lastly, you can add a custom Captcha using the Quiz field to create math or question-based captcha for your forms.

== Changelog ==

= 2.0.5 =

* **Improvements**
Updated the CMB2 library to the latest version.

= 2.0.4 =

* **Improvements**
Updated the CMB2 library to the latest version.

= 2.0.3 =

* **Bug Fixes**
* Release updated minified assets.

= 2.0.2 =

* **Improvements**
* Improved submissions UI.

= 2.0.1 =

* **Improvements**
* Force columns to be displayed in the form live preview.

= 2.0.0 =

* **New Features**
* Added the AI Assistant!!!
* AI Assistant: Added the ability to create forms (with support to fields, actions and options).
* New setting on BBForms > Settings > General > Disable AI Assistant.

= 1.1.8 =

* **Improvements**
* Several tweaks and improvements.

= 1.1.7 =

* **Bug Fixes**
* Fixed Reply-To email header.

= 1.1.6 =

* **Improvements**
* Improved cmb2 select2 library.

= 1.1.5 =

* **Improvements**
* Improved error messages.

= 1.1.4 =

* **Bug Fixes**
* Fixed button order in form editor.

= 1.1.3 =

* **Bug Fixes**
* Small fixes related to CSS styles.

= 1.1.2 =

* **Bug Fixes**
* Fixed deprecated function notice.

= 1.1.1 =

* **Bug Fixes**
* Fix notice for review.

= 1.1.0 =

* **Improvements**
* Improved security in some ajax requests.

= 1.0.9 =

* **Improvements**
* Fixed PHP Deprecated: strip_tags() notice for newer versions of PHP.

= 1.0.8 =

* **Improvements**
* Tooltip library updated.

= 1.0.7 =

* **Developer Notes**
* Tested with WordPress 6.9.

= 1.0.6 =

* **Improvements**
* Tooltip library updated.

= 1.0.5 =

* **Improvements**
* Improved video upload handler.

= 1.0.4 =

* **Improvements**
* Improved field descriptions.

= 1.0.3 =

* **Improvements**
* Prevent hidden and honeypot fields to create extra margin.

= 1.0.2 =

* **Improvements**
* Improved columns display on mobiles when column has a custom width.

= 1.0.1 =

* **Improvements**
* Improve tags display.

= 1.0.0 =

* Initial Release.
