=== FormsKit Lite ===
Contributors: abdulwahabtaqi
Donate link: https://wpkits.io/
Tags: contact form, form builder, drag and drop, forms, survey
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 8.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A feature-rich free form builder for WordPress. 18 field types, conditional logic, entry management, file uploads, and multi-page forms included.

== Description ==

https://www.youtube.com/watch?v=li2EFT0FR6k

https://www.youtube.com/watch?v=0CLda34h_Lg

**FormsKit Lite** is a free drag-and-drop form builder for WordPress. It includes 18 field types, conditional logic, entry management, file uploads, multi-page forms, and spam protection — all at no cost.

= Features =

* ✅ **18 Field Types** — Text, email, phone, address, number, dropdown, checkbox, radio, date/time, and more
* ✅ **Conditional Logic** — Show or hide fields based on user input
* ✅ **Entry Management** — View, search, and export submissions in your dashboard
* ✅ **File Uploads** — Let users attach files to their submissions
* ✅ **Multi-Page Forms** — Break long forms into manageable steps with a progress bar
* ✅ **Email Notifications** — Send up to 2 notification emails per submission
* ✅ **Spam Protection** — Built-in honeypot, custom CAPTCHA, and math puzzles
* ✅ **Gutenberg Block + Shortcode** — Embed forms anywhere

= Lite Fields (All Free) =

* Text, Textarea, Email, Number, Name, Phone, Address, URL, Password
* Dropdown, Radio, Checkbox, Date/Time Picker
* Number Slider, Captcha, File Upload, Page Break, GDPR Consent

= Available in FormsKit Pro =

* Rating, Content, HTML, Section Divider, Layout, Hidden Field
* Digital Signature, Rich Text Editor, Likert Scale
* Net Promoter Score, Camera, Repeater, Entry Preview

= Available in FormsKit Elite =

* Payment Items (Single, Multiple, Checkbox, Dropdown)
* Coupons, Order Total, Payment Gateway

= Performance =

FormsKit is lightweight and built with modern PHP 8.0+ code. No jQuery dependency required on the frontend, no unnecessary database queries, and minimal CSS footprint.

= Developer Friendly =

* Clean PSR-4 autoloading
* Extensive hooks and filters
* Custom Smart Tags API
* Well-documented codebase

== Installation ==

1. Upload the `formskit-lite` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to **FormsKit → Add New** to create your first form
4. Use the Gutenberg block or `[formskit_form id="123"]` shortcode to embed your form

== Frequently Asked Questions ==

= Is FormsKit Lite really free? =

Yes! FormsKit Lite includes 18 field types, conditional logic, entry management, file uploads, multi-page forms, and spam protection — all free with no hidden costs or usage limits.

= What's the difference between Lite, Pro, and Elite? =

**Lite** includes all essential form-building features for free. **Pro** adds advanced fields like digital signatures, repeater fields, and surveys. **Elite** adds payment processing, coupons, and checkout features. See the full comparison at [wpkits.io/formskit-pricing](https://www.wpkits.io/formskit/#pricing).

= Can I accept payments with FormsKit Lite? =

Payment fields are available in the Elite version. FormsKit Lite focuses on form building and data collection.

= Does it work with my theme? =

FormsKit is designed to work with any properly-coded WordPress theme. It uses minimal, non-intrusive CSS that adapts to your theme's styling.

= Is it GDPR compliant? =

FormsKit includes a GDPR/Consent field and stores all submission data locally in your WordPress database. Geolocation enrichment is **disabled by default** and must be explicitly enabled in **FormsKit → Settings** before any IP data is sent to ip-api.com. See the **External Services** section below for full disclosure. Third-party CAPTCHA services are also opt-in only.

= Does FormsKit connect to external services? =

Yes — see the **External Services** section below for complete details on all third-party connections, including what data is transmitted and when.

= Can I migrate from another form plugin? =

FormsKit includes an import feature that supports JSON form configurations.

== External Services ==

This plugin connects to the following third-party services under specific conditions. No external connections are made unless the features described below are actively used or enabled by the site administrator.

= IP Geolocation (ip-api.com) =

FormsKit can optionally enrich form submission entries with geographic location data (city, region, country, coordinates). This feature is **disabled by default** and must be explicitly enabled by the site administrator in **FormsKit → Settings**.

* **What data is sent:** The submitting visitor's IP address.
* **When it is sent:** Only when the geolocation feature is enabled in settings, on each form submission.
* **What is stored:** City, region, country, latitude, and longitude are stored in your WordPress database as entry metadata.
* **Service provider:** ip-api.com
* **Terms of Service:** [https://ip-api.com/docs/legal](https://ip-api.com/docs/legal)
* **Privacy Policy:** [https://ip-api.com/docs/legal](https://ip-api.com/docs/legal)

= Phone Field Country Detection (ipapi.co) =

When a form includes a Phone field with the international telephone input enabled and no default country is specified, the plugin uses ipapi.co to automatically detect the visitor's country and set the correct country code and flag.

* **What data is sent:** The visitor's IP address (sent automatically by the browser as part of the HTTP request).
* **When it is sent:** On page load, only when a form with an international phone field is displayed and no default country has been configured by the site administrator.
* **What is stored:** Only the two-letter country code is used in the browser to set the phone field default. No data from this service is stored in your WordPress database.
* **Service provider:** ipapi.co (Kloudend, Inc.)
* **Terms of Service:** [https://ipapi.co/terms/](https://ipapi.co/terms/)
* **Privacy Policy:** [https://ipapi.co/privacy/](https://ipapi.co/privacy/)

= CAPTCHA Services (Opt-In Only) =

If you choose to enable a third-party CAPTCHA service in **FormsKit → Settings**, the following external scripts will be loaded on pages containing your forms. These connections are **opt-in only** and require you to enter API keys in settings. No CAPTCHA data is transmitted without your explicit configuration.

* **Google reCAPTCHA v2/v3** — Loads scripts from `google.com/recaptcha`. [Google Terms of Service](https://policies.google.com/terms) | [Google Privacy Policy](https://policies.google.com/privacy)
* **Cloudflare Turnstile** — Loads scripts from `challenges.cloudflare.com`. [Cloudflare Terms of Service](https://www.cloudflare.com/website-terms/) | [Cloudflare Privacy Policy](https://www.cloudflare.com/privacypolicy/)
* **hCaptcha** — Loads scripts from `js.hcaptcha.com`. [hCaptcha Terms of Service](https://www.hcaptcha.com/terms) | [hCaptcha Privacy Policy](https://www.hcaptcha.com/privacy)

== Screenshots ==

1. Drag & drop form builder with live preview and element properties panel
2. Field library with 18 field types organized by category
3. Conditional logic builder with AND/OR groups and test scenario tools
4. Entry management dashboard with tags, filters, bulk actions, and analytics
5. Email notification editor with Smart Tags and instant preview
6. Gutenberg and Elementor integration

== Changelog ==

= 1.0.0 =
* Initial release
* 18 field types with drag & drop builder
* Conditional logic
* Entry management with search and export
* Multi-page forms with progress bar
* File upload support
* Spam protection (honeypot + custom CAPTCHA)
* Smart Tags for dynamic content
* Gutenberg block + shortcode support
* 2 email notifications per form
* Import/export forms

== Upgrade Notice ==

= 1.0.0 =
Initial release of FormsKit Lite.
