=== Thenameda Partial Form Recovery for WPForms ===

Contributors: thenameda123
Tags: abandoned forms, form tracking, lead recovery, csv export, email
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.0.0
Requires Plugins: wpforms-lite
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Track and recover partial WPForms submissions before visitors leave your site.

== Description ==

**Thenameda Partial Form Recovery for WPForms** helps you capture incomplete form submissions when visitors start filling out a WPForms form but leave before submitting.

The plugin integrates directly with the WPForms form builder. Enable tracking per form, choose which fields to store, and pick the email field used to identify each abandoned visitor.

= Why use this plugin? =

* **Recover lost leads** — Turn incomplete visits into follow-up opportunities.
* **Per-form control** — Enable tracking only on the forms that matter.
* **Privacy-conscious defaults** — Sensitive field types such as file uploads, payments, and signatures are not captured.
* **No coding required** — Configure everything from the WPForms builder and WordPress admin.

= Key features =

* **Per-form tracking toggle** in WPForms → Settings → Abandoned Forms
* **Email field selection** to identify abandoned users
* **Field allowlist** so you choose exactly which inputs are stored
* **Automatic capture** when visitors change fields and leave the page
* **Abandoned Users admin list** with email, IP address, and submission date
* **Manual recovery emails** with a customizable global template
* **Secure recovery links** with token-based URLs that pre-fill saved field values
* **CSV export** filtered by form
* **Automatic cleanup** when a visitor completes and submits the form

= How it works =

1. A visitor starts filling out a WPForms form on your site.
2. As they type, partial data is saved in the background.
3. If they leave without submitting, an abandoned entry is stored in WordPress.
4. You can review the entry, export it, or email the visitor a recovery link.
5. When they return via the link, their previous answers are pre-filled.
6. After a successful submission, the abandoned entry is removed automatically.

= Compatibility =

* WordPress 6.2 or later (tested up to 7.0)
* PHP 7.2 or later
* [WPForms Lite](https://wordpress.org/plugins/wpforms-lite/) 1.8.0 or later (tested up to 1.10.2)
* WPForms Pro
* Classic and modern WPForms front-end markup
* Multipage forms

= Privacy note =

This plugin stores partial form submissions that may include personal data (such as names and email addresses). Make sure your privacy policy explains that incomplete form data may be collected, and only enable tracking on forms where you have a lawful basis to do so.

== Installation ==

= Automatic installation =

1. In your WordPress dashboard, go to **Plugins → Add New**.
2. Search for **Thenameda Partial Form Recovery for WPForms**.
3. Click **Install Now**, then **Activate**.
4. Confirm that **WPForms Lite** (or WPForms Pro) is installed and active.

= Manual installation =

1. Download the plugin ZIP file.
2. Go to **Plugins → Add New → Upload Plugin**.
3. Choose the ZIP file, click **Install Now**, then **Activate**.

= Configuration =

1. Edit any form in **WPForms → All Forms**.
2. Open the **Settings** panel in the form builder.
3. Select the **Abandoned Forms** section.
4. Enable abandoned form tracking.
5. Choose the **Email field** used to identify visitors.
6. Select the **Fields to track** you want stored.
7. Save the form.

Abandoned entries appear under **Abandoned Forms** in the WordPress admin menu.

== Frequently Asked Questions ==

= Does this work with WPForms Lite? =

Yes. The plugin works with both WPForms Lite and WPForms Pro.

= Do I need WPForms Pro? =

No. WPForms Lite is sufficient. The plugin uses its own storage for abandoned entries and does not require the WPForms entries feature.

= Which fields are not tracked? =

For security and privacy, the plugin does not capture file uploads, payment fields, credit card fields, signatures, CAPTCHA values, or similar sensitive inputs.

= When is an entry considered abandoned? =

An entry is saved when a visitor interacts with the form and then leaves the page—for example by navigating away, closing the tab, or moving the mouse off the page—before submitting successfully.

= Can I send recovery emails automatically? =

Version 1.0.0 supports manual recovery emails from the admin. You can customize the default email subject and body under **Abandoned Forms → Mail Notification Settings**.

= What placeholders can I use in recovery emails? =

* `{email}` — the visitor's email address
* `{contact_form}` — the form title
* `{link}` — a secure recovery URL that pre-fills saved field values

= Are recovery links secure? =

Yes. Recovery URLs include a unique token. The token is verified on the server before any data is loaded or updated.

= Can I export abandoned entries? =

Yes. On the **Abandoned Forms** list screen, choose a form from the filter dropdown and click **Export CSV**.

= Does the plugin delete entries after submission? =

Yes. When a visitor successfully submits the form, the matching abandoned entry is removed automatically.

= Will this slow down my site? =

The front-end script loads on public pages and throttles save requests to avoid excessive AJAX traffic.

== Screenshots ==

1. Abandoned Forms list with email, IP address, emails sent, and send-mail actions.
2. Abandoned Forms settings panel inside the WPForms form builder.
3. Mail Notification Settings for the global recovery email template.
4. Send Mail screen for emailing a single abandoned visitor.
5. Abandoned entry detail showing captured field values.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release of Thenameda Partial Form Recovery for WPForms for sites using WPForms Lite or Pro.
