=== Frontierline Forms for Contact Form 7 ===
Contributors: frontierline2015, freemius
Tags: contact form 7, multi step form, confirmation, conditional logic, form database
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 2.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a confirmation screen, multi-step forms, and database-saved submission history that Contact Form 7 is missing - with no limits.

== Description ==

Frontierline Forms extends Contact Form 7 with the features Japanese websites most often need. All features below are fully functional and have no usage limits.

This plugin is an add-on for Contact Form 7 and requires Contact Form 7 to be installed and active. It is not affiliated with, endorsed by, or sponsored by the Contact Form 7 project or its author.

= Features =

* **Multi-step forms** — Split a single Contact Form 7 form into multiple steps using a `[step]` tag. No limit on the number of steps.
* **Confirmation screen** — Add an "input -> confirm -> submit" flow that Contact Form 7 does not provide out of the box.
* **Completion screen** — Replace the form with a custom completion message on success, or redirect to a thank-you page (useful for GA4 conversion tracking).
* **Conditional logic** — Show or hide fields based on what the visitor enters, using simple HTML data attributes. No limit on the number of rules.
* **Progress bar** — Three styles (numbered steps, bar, dots).
* **Submission history** — Every submission is saved to your own WordPress database and can be browsed, searched, and viewed in the admin screen.
* **CSV export** — Export your saved submissions to a CSV file (UTF-8 with BOM, Excel-friendly).
* **Honeypot** — Built-in spam protection, enabled automatically.
* **Brand colors** — Set primary/secondary colors, border radius, and font family to match your site's design.

= Requirements =

* Contact Form 7 5.7 or later
* WordPress 6.0 or later
* PHP 7.4 or later

= Premium version =

A separate premium version with additional features is available from the developer's website. The premium code is **not** included in this free plugin. See https://frontierline.co.jp/plugins/frontierline-forms/ for details.

== External services ==

This plugin connects to one external service.

**Freemius** — This plugin uses the Freemius SDK to manage the optional upgrade to the premium version, license activation, and update delivery. When you opt in to usage tracking (you are asked, and it is optional), or when you activate a premium license, the plugin sends information such as your site URL, WordPress and PHP versions, and the active theme/plugins list to Freemius. No form submission content is ever sent. Freemius is provided by Freemius, Inc.
Terms of Service: https://freemius.com/terms/
Privacy Policy: https://freemius.com/privacy/

The free plugin does not send your form submissions to any external service. Any services used by the separate premium version are documented within that version and are only active when you configure them.

== Installation ==

1. Make sure Contact Form 7 is installed and active.
2. In your WordPress admin, go to Plugins -> Add New, search for "Frontierline Forms", then install and activate it.
3. Open the "Frontierline Forms" menu in the admin sidebar to configure it.

= Creating a multi-step form =

In the Contact Form 7 form editor, insert a `[step]` tag at each step boundary:

`[step "Basic info"]
[text* your-name]
[email* your-email]

[step "Your message"]
[textarea your-message]

[step "Confirm" confirmation]
Please review your input and submit.

[submit "Send"]`

= Using conditional logic =

Wrap the fields you want to toggle with HTML data attributes:

`<div data-cf7mp-show-if="contact-type" data-cf7mp-show-value="estimate">
  [text estimate-amount placeholder "Budget"]
</div>`

== Frequently Asked Questions ==

= Do I need Contact Form 7? =

Yes. Contact Form 7 5.7 or later must be installed and active. This plugin is an add-on for it.

= Is the confirmation screen on by default? =

No. Enable it under Settings -> General. It is off by default.

= Where are submissions stored? =

In your own WordPress database, in tables created by this plugin. Nothing is sent to an external service.

= How do I remove all data on uninstall? =

Enable the data-deletion option in the settings before deleting the plugin. Otherwise, your data is preserved on uninstall.

== Screenshots ==

1. Multi-step form with the standard Input, Confirm and Complete steps.
2. Settings: turn on the confirmation screen and see how each feature is enabled with a single tag.
3. Design settings: brand colors, rounded corners, fonts and progress bar styles.
4. Admin dashboard with submission counts and conversion rate.
5. Submission list stored in your database, with keyword search and CSV export.

== Changelog ==

= 2.0.3 =
* The admin interface is now in English by default, with a bundled Japanese translation. Additional languages can be contributed on translate.wordpress.org.

= 2.0.2 =
* Added an optional review request shown only on the plugin's own admin screens. It appears after the plugin has been used and is permanently dismissible.

= 2.0.1 =
* Added a "Complete" step to the progress bar so multi-step and confirmation forms show the standard Input -> Confirm -> Complete (3-step) flow.
* The progress bar now stays visible on the completion screen with the final step highlighted.

= 2.0.0 =
* Renamed the plugin and made all built-in features fully functional with no usage limits.
* Multi-step forms and conditional logic are now unlimited.
* Submission history and CSV export available with no limits.
* Removed the arbitrary custom-CSS input; brand styling is now done with discrete color/typography settings.
* Moved all admin scripts to properly enqueued assets and added nonce verification to the CSV export.
* Documented external services.

== Upgrade Notice ==

= 2.0.3 =
Admin UI is now English by default with a bundled Japanese translation.

= 2.0.2 =
Minor update. Adds a dismissible review request on the plugin's own screens.

= 2.0.1 =
Adds the Input -> Confirm -> Complete 3-step progress display. Recommended update.

= 2.0.0 =
All built-in features are now fully functional with no limits. Recommended update.
