=== Divine Smart Forms - Drag & Drop Contact Form Builder ===
Contributors: divineboyaditya
Tags: contact form, form builder, google sheets, lead generation, anti-spam
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.2.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create responsive contact & lead forms using a fast drag & drop builder with real-time Google Sheets integration and robust anti-spam protection.

== Description ==

**Divine Smart Forms** is a lightweight, fast, and modern WordPress form builder plugin designed to help you create beautiful, responsive contact forms without writing a single line of code. 

Whether you need a simple contact form, a complex lead generation form, a booking form, or a feedback form, our intuitive drag & drop interface makes it effortless. Built for speed, performance, and security, Divine Smart Forms ensures your website remains fast while keeping your inbox free from spam.

= 🚀 Why Choose Divine Smart Forms? =

* **100% Beginner Friendly:** Create custom WordPress forms in minutes.
* **Fully Customizable Design:** Easily customize form colors, widths, and alignments to match your theme perfectly.
* **Advanced Anti-Spam:** Protect your forms with Honeypot, Google reCAPTCHA v2, Cloudflare Turnstile, or hCaptcha.
* **Google Sheets Integration:** Automatically sync your form submissions to Google Sheets in real-time.
* **Local Database Storage:** Never lose a lead! All form entries are securely saved inside your own WordPress admin dashboard.
* **Page Builder Friendly:** Works seamlessly with Gutenberg (Block Editor), Elementor, Divi, Beaver Builder, and other popular page builders.
* **GDPR & Privacy Ready:** You own your data. Form entries are stored safely in your plugin-owned tables.

= ✨ Key Features =

* **Drag & Drop Form Builder:** No coding required to build complex layouts.
* **Form Style Customizer:** Visually adjust form width, height, alignment, background opacity, text colors, and placeholder colors.
* **Anti-Spam & Captcha Integration:** Global settings for Google reCAPTCHA v2, Cloudflare Turnstile, hCaptcha, and built-in Honeypot.
* **Advanced Fields:** Includes dedicated Name field, Email, and International Phone Input (with automatic country flags and prefixes).
* **Responsive & Mobile-Ready:** Forms look perfect on desktops, tablets, and smartphones.
* **AJAX Form Submission:** Submit forms without page reloads for a seamless user experience.
* **File Upload Support:** Easily collect documents, images, and attachments from your users securely.

= 🎥 Video Tutorials & Guides =

Want to see Divine Smart Forms in action? Check out our step-by-step video tutorials on YouTube to master form building in minutes:

* [How to create your first Contact Form](https://youtu.be/UPWHmJrNwJ4)
* [How to connect forms with Google Sheets](https://youtu.be/6-011FsSA6w)
* [Setting up Email Notifications & Autoresponders](https://youtu.be/GenahsZecao)

= 💡 Need Help or Support? =
We are constantly improving Divine Smart Forms. If you need any assistance, have a feature request, or find a bug, please reach out via the WordPress support forum.

== External services ==

This plugin can connect to third-party services when you enable the related features in the plugin settings or in a form's configuration.

= Google Sheets =
This plugin can connect to Google Sheets so form submissions can be written to a spreadsheet and, when needed, a spreadsheet can be created and checked from the WordPress admin area.

Data sent:
* Google service account credentials that you paste into the plugin settings are used only to request an OAuth access token from Google.
* Spreadsheet metadata such as the spreadsheet ID, sheet name, and header row may be requested when you validate or use a Google Sheets connection.
* Form submission values are sent to Google Sheets only when Google Sheets sync is enabled for a form and a submission is processed.

When data is sent:
* When you save and use a Google service account for Sheets access.
* When the plugin validates a configured spreadsheet or reads sheet headers.
* When a visitor submits a form that has Google Sheets sync enabled.

Service provider:
* Google: [Google API Services User Data Policy](https://developers.google.com/terms/api-services-user-data-policy), [Google Terms of Service](https://policies.google.com/terms), [Google Privacy Policy](https://policies.google.com/privacy)

= Anti-Spam / Captcha Services =
When captcha is enabled for a form, the plugin loads the required JavaScript API from the configured third-party captcha provider and sends a server-side verification request to validate the user's response. No data is sent unless an administrator configures API keys in the plugin settings and enables captcha on a form.

**Google reCAPTCHA v2**
Data sent: The user's captcha response token and IP address are sent to Google for server-side verification.
When data is sent: On each form submission where Google reCAPTCHA is active.
JavaScript loaded from: `www.google.com/recaptcha/api.js`
Service provider: [Google reCAPTCHA Terms](https://policies.google.com/terms), [Google Privacy Policy](https://policies.google.com/privacy)

**Cloudflare Turnstile**
Data sent: The user's captcha response token and IP address are sent to Cloudflare for server-side verification.
When data is sent: On each form submission where Cloudflare Turnstile is active.
JavaScript loaded from: `challenges.cloudflare.com/turnstile/v0/api.js`
Service provider: [Cloudflare Terms of Service](https://www.cloudflare.com/terms/), [Cloudflare Privacy Policy](https://www.cloudflare.com/privacypolicy/)

**hCaptcha**
Data sent: The user's captcha response token and IP address are sent to hCaptcha for server-side verification.
When data is sent: On each form submission where hCaptcha is active.
JavaScript loaded from: `js.hcaptcha.com/1/api.js`
Service provider: [hCaptcha Terms of Service](https://www.hcaptcha.com/terms), [hCaptcha Privacy Policy](https://www.hcaptcha.com/privacy)

= Optional Plugin Tracking =
This plugin can optionally send limited analytics data to our Team only after a site administrator explicitly allows it from the plugin settings or tracking prompt.

Data sent when tracking is allowed:
* A random anonymous site identifier generated by the plugin
* Plugin activation and deactivation events
* WordPress version
* PHP version
* Plugin version
* Site URL

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/divine-smart-forms` directory, or install the plugin directly through the WordPress `Plugins > Add New` screen by searching for "Divine Smart Forms".
2. Activate the plugin through the `Plugins` screen in WordPress.
3. Open `Divine Forms` in the left-hand WordPress admin menu.
4. Click `+ Add New` to create your first form and save it.
5. Copy the generated shortcode (e.g., `[divismfo_form id="123"]`) and place it on any page, post, or widget where you want the form to appear.

== Frequently Asked Questions ==

= How can I protect my forms from spam? =
Version 1.2.4 introduces robust anti-spam features. You can enable built-in Honeypot, Google reCAPTCHA v2, Cloudflare Turnstile, or hCaptcha from the global settings and apply them to any form.

= Can I customize the design and colors of my forms? =
Yes! The plugin now includes a Form Style customization tab. You can easily adjust form width, alignment, text colors, placeholder transparency, and more directly from the builder.

= Does this plugin store entries in WordPress? =
Yes. Form entries are stored in the plugin's custom database tables and can be easily viewed and managed from the `Divine Forms > All Entries` section in your WordPress admin area.

= How do I display a form on my site? =
Create a form in `Divine Forms`, save it, and copy the shortcode from the forms list. Then paste that shortcode into any page, post, or text widget.

= Can I use this with Elementor or Gutenberg? =
Absolutely! Just paste your form's shortcode into an Elementor Shortcode widget or a Gutenberg Shortcode block.

= Does the plugin support Google Sheets? =
Yes. The plugin includes a built-in Google Sheets integration to automatically sync your submissions to your spreadsheet.

= Can I remove plugin data on uninstall? =
Yes. Enable the `Delete All Data on Uninstall` option in the plugin settings before deleting the plugin to keep your database clean.

== Screenshots ==

1. **Drag & Drop Builder:** The intuitive interface to easily build your forms without coding.
2. **Form Style Customizer:** Visually adjust colors, width, and alignment to match your theme.
3. **Anti-Spam Settings:** Global settings to secure your forms with reCAPTCHA, Turnstile, or hCaptcha.
4. **Form Entries Dashboard:** View, manage, and export all your form submissions directly from WordPress.
5. **Advanced Fields:** Showcasing the International Phone input with automatic country flags.
6. **Google Sheets Sync:** Easy 1-click setup to connect your forms with Google Sheets.
7. **Email Settings:** Configure custom email notifications for admins and form submitters.

== Changelog ==

= 1.2.4 =
* Added anti-spam captcha support: Google reCAPTCHA v2, Cloudflare Turnstile, hCaptcha, and Honeypot.
* Added global captcha API key settings tab in plugin settings.
* Added per-form captcha enable/disable toggle in form builder.
* Added form style customization tab with width, height, alignment, colors, and opacity controls.
* Added input text color, placeholder color with transparency slider.
* Fixed form builder reset on save/refresh by correcting edit URL encoding.
* Fixed duplicate form opening blank builder.
* Tested up to WordPress 7.1.

= 1.2.3 =
* Added Name field type for dedicated name collection in forms.
* Added international phone input with country flag selector and automatic country code prefixing.
* Updated entries list to prioritize the Name field type for the Name column.
* Tested up to WordPress 7.0.

= 1.2.2 =
* Added privacy policy helper text and external service disclosure for optional tracking.
* Fixed uninstall cleanup so plugin data is only removed when the delete-on-uninstall setting is enabled.
* Fixed file upload handling so uploaded files are saved correctly in entries, upload references, and Google Sheets submissions.
* Improved file upload UX with selected filename display and a remove-file button.

= 1.2.1 =
* Replaced direct inline admin scripts with enqueued admin JavaScript.
* Simplified the plugin feature set by removing WhatsApp, PDF, and payment integrations.
* Kept Google Sheets documentation and WordPress-compliant asset loading in place.

= 1.2.0 =
* Fixed All issues.

= 1.1.9 =
* Fixed redirect submissions so redirect-enabled forms skip the default success message and redirect immediately.
* Improved form save/submit JSON handling to avoid corrupting form settings.
* Improved debug log creation so troubleshooting logs are actually written when enabled.

= 1.1.8 =
* Initial public release.
* Added a fuller WordPress.org readme with usage instructions, feature overview, and FAQs.

== Upgrade Notice ==

= 1.2.4 =
* Adds anti-spam captcha support (Google reCAPTCHA, Cloudflare Turnstile, hCaptcha, Honeypot), form style customization, and critical bug fixes.

= 1.2.3 =
* Adds Name field type and international phone input with country flags.

= 1.2.2 =
* Fixes uninstall data retention behavior, and resolves file upload handling issues.

= 1.2.1 =
* Updated asset loading and streamlined external service disclosures for plugin review compliance.

= 1.2.0 =
* Fixed All issues.

= 1.1.9 =
* Fixed redirect submissions so redirect-enabled forms skip the default success message and redirect immediately.
* Improved form save/submit JSON handling to avoid corrupting form settings.
* Improved debug log creation so troubleshooting logs are actually written when enabled.