=== Form Enhancer for Fluent Forms ===
Contributors: vyskoczilova
Tags: fluentform, contact form, fluent forms, ecomail
Requires at least: 6.4
Tested up to: 6.9
Requires PHP: 8.1
Stable tag: 1.3.1
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight add-on that extends Fluent Forms and Fluent SMTP with new fields, admin tools, and features to boost form functionality.

== Description ==

A lightweight add-on that extends **Fluent Forms** and **Fluent SMTP** with new fields, admin tools, and features to boost form functionality without the bloat. Other form plugins might be added in the future.

Checkout all the features and documentation at [formenhacer.com](https://formenhancer.com).


== Features available in the FREE version ==

=== Input fields ===

- **[Confirm Field](https://formenhancer.com/fields/#confirm)** - A confirmation field that validates if its value matches another field (useful for confirming emails, passwords, etc.).
- **[Czech & Slovak Identification Numbers (IČO)](https://formenhancer.com/fields/#ico)** – Three new fields for Czech, Slovak, and combined Czech/Slovak IČO—complete with validation via ARES and FinStat on submission.
- **[EU VAT Number](https://formenhancer.com/fields/#eu-vat)** – Field for entering EU VAT numbers, with automatic validation through the VIES service.

=== Functions ===

- **Apply Block Editor Submit Button Style** - Applies the same styling as Gutenberg's button block to all Fluent Forms submit buttons.
- **Enhanced Admin Approval** – Automatically notify users by email when their submission is waiting for approval—includes the same message shown on the form.
- **Disable Captchas for Logged-in Users** – Turn off reCAPTCHA, hCaptcha, and Turnstile for logged-in users—perfect for smoother user flows or running automated tests on live sites.
- **[Store a single IP](https://formenhancer.com/docs/store-a-single-ip/)** – Store just one IP address per submission to avoid issues with Mailchimp and similar integrations caused by multiple IPs.

=== Integrations ===

- **[ACF/SCF Field Type](https://formenhancer.com/docs/advanced-custom-fields-acf-secure-custom-fields-form-field/)** – Adds a "Fluent Form" field type to Advanced Custom Fields and Secure Custom Fields, allowing you to select Fluent Forms in the Field Groups - returns either ID or Form object.


==  ⭐ PRO version (starting at 9 USD) ==

By upgrading to [PRO version](https://formenhancer.com/pricing/) you’re directly supporting the ongoing development of Form Enhancer. Your license keeps the project alive and independent.

=== Input fields ===

- **[Checkbox with “Other” Option](https://formenhancer.com/fields/#checkbox-other)** – Let users tick multiple choices or add their own response via a custom text or textarea “Other” input (text or textarea).
- **[Radio with “Other” Option](https://formenhancer.com/fields/#radio-other)** - Let users pick from preset options or let them write their own response using a flexible “Other” field (text or textarea).
- **[Enhanced Email Field](https://formenhancer.com/fields/#enhanced-email)** – Block free email providers (like Gmail or Yahoo) together with disposable addresses or restrict specific domains to collect only valid business emails.

=== Integrations ===

- **[Ecomail](https://formenhancer.com/docs/ecomail/)** - Sync your newsletter subscription easily, from forms to your lists.


=== Features ====

- **[Duplicate Entry](https://formenhancer.com/docs/duplicate-entry/)** – Quickly duplicate form entries directly from the entries list using bulk actions.
- **FluentSMTP – Telegram Notification on Failure** – Get instantly notified in your Telegram channel if a form submission fails to send via FluentSMTP.


== Installation ==

1. Upload the plugin files to `/wp-content/plugins/formenhancer`, or install via the WordPress plugin dashboard.
2. Activate it through the ‘Plugins’ menu.
3. Go to ‘Settings -> Form Enhancer‘ to configure the plugin.


== Frequently Asked Questions ==

= Does it work with the free version of Fluent Forms? =
Yes! It works with both free and Pro versions.

= Can I use this with other form plugins? =
Currently, no — this plugin is built specifically for Fluent Forms. Want support for a different builder? [Let me know](https://formenhancer.com/suggest-a-feature/).

= I need another feature, could you add it? =
Maybe. [Suggest a feature](https://formenhancer.com/suggest-a-feature/) and I will get back to you!

= Which external services are used? =
This plugin uses several external services to validate business identification numbers and VAT numbers. These services are used only when the corresponding validation fields are present in your forms. All these services are publicly available databases, and the company data being validated is publicly accessible information. The plugin only performs validation checks and does not track or store any data during the validation process.

**ARES (Administration of Registers and Economic Subjects)**
The plugin connects to ARES, a service provided by the Ministry of Finance of the Czech Republic, to validate Czech business identification numbers (IČO). When a user submits a form containing a Czech IČO field, the plugin sends the IČO number to ARES for validation. This service is essential for ensuring the accuracy of Czech business identification numbers. [Terms of Service - Czech only](https://ares.gov.cz/stranky/podminky-provozu)

**Finstat**
For Slovak business identification numbers (IČO), the plugin uses Finstat, a data provider that aggregates and enriches data from the Slovak Business Register, the Statistical Office, and other public sources. When a form containing a Slovak IČO field is submitted, the plugin sends the IČO number to Finstat for verification. This ensures that only valid Slovak business identification numbers are accepted. More info at [finstat.sk](https://finstat.sk)

**VIES (VAT Information Exchange System)**
The plugin integrates with VIES, a service operated by the European Commission, to validate EU VAT numbers. When a user submits a form containing an EU VAT field, the plugin sends the VAT number (country code + number) to VIES for validation. This service is crucial for ensuring the accuracy of EU VAT numbers. [VIES database](https://ec.europa.eu/taxation_customs/vies/)

= How do I display a Fluent Form using the ACF/SCF field? =
If you selected "Return Format: Form ID" in your ACF/SCF field settings, use this code in your template:

```php
$form_id = get_field('your_field_name');
if ($form_id && function_exists('fluentFormRender')) {
   echo fluentFormRender(["id" => $form_id])
}
```

If you selected "Return Format: Form Object", you'll get the form data object. To display it, use:

```php
$form_object = get_field('your_field_name');
if ($form_object && function_exists('fluentFormRender')) {
    echo fluentFormRender(["id" => $form_object->id])
}
```

= How can I report security bugs? =

You can report security bugs through the Patchstack Vulnerability Disclosure Program. The Patchstack team helps validate, triage and handle any security vulnerabilities. [Report a security vulnerability.](https://patchstack.com/database/vdp/2bb45636-3671-473b-9865-49a654c37887)


== Changelog ==

= 1.3.1 (2026-03-25) =

* Update deprecated Fluent Forms hooks from underscore to slash format (fluentform_ → fluentform/).

= 1.3.0 (2025-02-03) =

* Enhancement add conditional logic support for custom fields in the Fluent Forms editor. Form Enhancer fields can now be used as conditions when building forms.
* Updated the Freemius SDK integration to version 2.13.0.

= 1.2.0 (2025-09-11) =

* Fix free/pro activation conflicts.
* Fix version naming, the 1.1.1 should have been 1.2.0 in order to keep semantic versioning.

= 1.1.1 (2025-09-09) =
* Added ACF/SCF integration - adds a "Fluent Form" field type to Advanced Custom Fields and Secure Custom Fields.

= 1.1.0 (2025-05-21) =
* Added new Confirm field - allows you to add a confirmation field that validates if its value matches another field (useful for confirming emails, passwords, etc.).
* Added option to style submit buttons as Block buttons (adds WordPress Block Editor button styling classes).
* Added support for Fluent Forms Conversational Forms with all Form Enhancer fields.

= 1.0.1 (2025-05-16) =
* Added Czech language translation
* Fixed various typos in text and documentation

= 1.0.0 (2025-05-12) =
* Updated the Freemius SDK integration to version 2.12.0 for improved licensing and analytics functionality.
* WordPress repository release for free version.
* Skip plugin initialization in WP_CLI environments.

= 0.1.1 (2025-05-05) =
* Update PHP-DI library to 7
* Added info about external services used
* Enabled Freemius `is_org_compliant` mode.
* Removed load_plugin_textdomain() for loading the plugin translations (not needed for WordPress.org directory since WordPress 4.6)

= 0.1.0 (2025-04-30) =
* Fixed plugin icon file path
* Added documentation link in plugin listing

= 0.0.6 (2025-04-25) =
* Initial release
