=== Flex Forms ===
Contributors: flexfields
Donate link: https://future-systems.am/
Tags: form, field, shortcode, input, email
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.0
Stable tag: 2.1.8
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight yet powerful form builder with database storage, email alerts, reCAPTCHA, SMTP configuration, and deep Flex Fields integration.

== Description ==

**Flex Forms** is a modular and flexible form builder plugin for WordPress, designed to be lightweight yet feature-rich. It allows you to quickly build forms with various field types, manage submissions, and integrate with your theme and workflow easily.

**Key Features:**

- Easy form creation via WordPress admin
- Drag-and-drop field ordering
- Email notifications on submission
- Submission storage in database
- Google reCAPTCHA v2/v3 support
- Custom shortcode per form
- SMTP email sending support with test email
- Force “From” email override (site-wide)
- Full integration with [Flex Fields](https://flex-fields.com/)
- Developer-friendly hooks and filters

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/flex-forms` directory, or install the plugin through the WordPress plugin screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Navigate to **Flex Forms > Add New** to create your first form.
4. Use the generated shortcode to embed the form into any page or post.

== External Services ==

Flex Forms may interact with third-party services depending on your configuration:

=== Email Sending ===

Flex Forms supports custom SMTP configuration for reliable email delivery.

- **What data is sent:** Form submission content (user input).
- **When data is sent:** When a user submits a form or when a notification is triggered.
- **Where data is sent:** To the configured email recipient(s) via your selected email service provider.
- **Privacy & Terms:** Email service providers' policies apply (e.g., SendGrid, Mailgun, custom SMTP).
  - Example terms:
    - SendGrid: https://sendgrid.com/policies/tos/
    - Mailgun: https://www.mailgun.com/legal/

=== Google reCAPTCHA ===

Used to prevent spam form submissions.

- **What the service is and what it is used for:**
  Verifies that a user is human when submitting a form.
- **What data is sent and when:**
  The user's IP address and browser information are sent to Google when the user interacts with a reCAPTCHA-enabled form.
- **Where data is sent:**
  Google servers.
- **Privacy & Terms:**
  - https://policies.google.com/terms
  - https://policies.google.com/privacy

== Screenshots ==

1. Form builder – Create and configure forms with various field types.
2. Form settings – Configure success/error behavior, email notifications, and storage.
3. Submissions list – View and manage form submissions in the admin.
4. Settings – SMTP, reCAPTCHA, and license configuration.
5. Frontend form – Example of a form rendered on the front end.

== Changelog ==

= 2.1.7 =
* Security fixes: escaping, nonces, $_GET validation, $_POST checks.
* Performance: reCAPTCHA scripts load only when forms are present.
* Added index.php, uninstall.php, load_plugin_textdomain.
* Added DEPLOY.md, Screenshots section, deployment docs.
* Fixed readme tags (5 max for WordPress.org).

= 2.1.8 =
* Fixed SMTP settings not saving on first click (checkbox options not persisting).
* Fixed form submission emails not sending when SMTP is enabled (missing Content-Type header).
* Settings API now uses explicit defaults for all options.

= 2.1.6 =
* Added global SMTP configuration option.
* Added "Force From Email" and "From Email" override.
* Improved PHPMailer integration and compatibility.
* Improved test email feature.
* Minor fixes and improvements.

== Upgrade Notice ==

= 2.1.8 =
Fixes SMTP settings not saving and form emails not sending. Recommended for all users.

= 2.1.7 =
Security and performance update. reCAPTCHA loads only on form pages. Recommended for all users.

= 2.1.6 =
Adds new global SMTP and "Force From" options. Recommended update for all users using email notifications.