=== Leadkeel – Contact Form Email Log & Failure Alerts ===
Contributors: shakeelagency786
Tags: email log, contact form 7, wpforms, form submissions, email not sending
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Know when your contact form emails fail. Leadkeel logs every notification email, warns you when one fails, and keeps a copy of every lead.

== Description ==

**Is your contact form not sending email?** Most site owners only find out when a customer asks why they never got a reply. A plugin update, an SMTP change or a spam filter can stop notification emails while visitors still see "Thank you".

Leadkeel watches every contact form notification email. It records whether each one was sent or failed (with the exact error), warns you on your dashboard as soon as a lead's email fails, and keeps a copy of every submission in WordPress, so the lead is never lost even when email breaks.

It works with Contact Form 7, WPForms, Fluent Forms, Forminator, Gravity Forms and Elementor Forms. Nothing to configure: activate it and your forms are protected.

= Features =

* **Email log for every lead.** See whether each notification email was sent, failed (with the error message), or not confirmed.
* **Failure warnings.** A notice on your dashboard and a count on the Leadkeel menu show leads whose notification email failed.
* **Every submission saved.** Each form entry is stored before your form plugin sends its email, so a failed email never means a lost lead.
* **Email check.** Send a test email from the Form health page to confirm your site can deliver form notifications.
* **Form health.** One screen showing every form, its last submission, last successful email and recent failures.
* **Gone-quiet alerts.** A warning, and optionally an email, when a form that usually gets submissions suddenly stops. A silent form is often a broken form.
* **Weekly summary.** An optional weekly email listing leads whose notification failed and that still need a reply. Nothing is sent in weeks when every lead has been handled.
* **Follow-up status.** Mark inquiries as new, followed up or spam, so you can work through missed leads.
* **Search, filter and CSV export** by status, email result, name, email or message.
* **Multisite ready.** Network-activate Leadkeel and every site, including sites created later, gets its own private inquiry inbox.
* **Translation ready.**
* **Privacy tools.** Automatic deletion after a period you choose, plus support for WordPress's personal data export and erasure tools.

= Leadkeel Pro =

The optional [Leadkeel Pro](https://checkout.freemius.com/plugin/40712/plan/71553/) add-on sends instant alerts on Telegram, Slack, email or SMS when a lead's email fails, retries failed lead emails automatically, and adds a one-click Resend button. Everything in this free plugin keeps working without it.

= Supported form plugins =

* Contact Form 7
* WPForms (Lite and Pro)
* Fluent Forms (free and Pro)
* Forminator (free and Pro)
* Gravity Forms, including background notifications
* Elementor Forms (the Form widget in Elementor Pro)

More form plugins are coming.

= Works alongside SMTP plugins =

Leadkeel does not send email. Keep using WP Mail SMTP, FluentSMTP or your host's mail setup to send it; Leadkeel makes sure you know when it fails and keeps the lead safe either way.

== Installation ==

1. Install and activate Leadkeel from the Plugins screen.
2. Make sure Contact Form 7, WPForms, Fluent Forms, Forminator, Gravity Forms or Elementor Pro is active.
3. Submit one of your forms. The submission appears under **Leadkeel → Inquiries**.

== Frequently Asked Questions ==

= Why is Contact Form 7 not sending email? =

Usually the website's email setup is the problem, not the form: many hosts block or limit PHP mail, or an SMTP setting changed. Leadkeel shows the exact error for each failed Contact Form 7 notification, so you can see why, and it keeps the submission so the lead is not lost. Use the Send test email button on the Form health page to check your site's email, and an SMTP plugin to fix it.

= WPForms, Gravity Forms or Fluent Forms is not sending notifications. Can Leadkeel help? =

Yes. Leadkeel records the result of every notification email from WPForms, Gravity Forms, Fluent Forms, Forminator, Elementor Forms and Contact Form 7, shows the error when one fails, and keeps a copy of the entry, so you can reply to the person directly.

= Is this an email log plugin? =

For your forms, yes. Leadkeel logs every notification email sent by your contact forms, with its recipient, subject and result. It does not log other site email such as password resets.

= Where are my contact form entries saved? =

In your own WordPress database. Open Leadkeel → Inquiries to see, search and export every form submission.

= Does Leadkeel send any data off my site? =

No. The free plugin stores everything in your own WordPress database and makes no external requests.

= Can Leadkeel recover a submission that never reached my site? =

No. Leadkeel saves every submission that reaches WordPress. If a form is broken so that the submission never reaches the server, there is nothing to save.

= What does "Not confirmed" mean? =

Another plugin handled sending the email and did not report the result back to WordPress, so Leadkeel cannot tell whether it was delivered.

= Does Leadkeel change how Fluent Forms sends email? =

Yes, slightly. Fluent Forms can send notification emails in a separate background request, where Leadkeel cannot see whether they succeeded. Leadkeel asks Fluent Forms to send its notification emails during the submission instead, which is how Contact Form 7 and WPForms already work. Other Fluent Forms integrations are not affected. Developers can turn this off with `add_filter( 'leadkeel_fluentforms_sync_email', '__return_false' );`, in which case those emails show as "No email" in Leadkeel.

= Why don't my Elementor forms show on the Form health page? =

Elementor forms live inside your page designs, so Leadkeel cannot list them in advance. Each Elementor form appears on the Form health page as soon as it receives its first submission.

= Does Leadkeel work on multisite? =

Yes. Network-activate it and each site gets its own inquiries, settings and warnings. Sites created later are set up automatically, and a site's Leadkeel data is removed when the site is deleted.

= Why didn't I get the weekly summary? =

It is only sent when leads with a failed notification are still marked New. If your site cannot send email at all, the summary cannot be sent either, so check the Dashboard warnings and use the Send test email button on the Form health page.

= What happens to my inquiries if I delete Leadkeel? =

They are kept unless you tick "Also delete all saved inquiries and email logs" under **Leadkeel → Settings** before deleting the plugin.

== Privacy ==

Leadkeel stores form submissions, which may contain personal data, in your site's database. You choose how long they are kept under **Leadkeel → Settings**. Saved inquiries are included in WordPress's **Export Personal Data** and **Erase Personal Data** tools, matched by email address.

== Screenshots ==

1. Every form submission is saved in one inbox, with the result of its notification email. A warning appears when an email fails.
2. An inquiry whose notification failed, with the exact error and a one-click reply, so the lead is not lost.
3. Form health shows each form's last submission and email result, with a one-click test email.
4. Settings: how long to keep inquiries, quiet-form alerts and the weekly summary.
5. Leadkeel Pro (optional add-on): instant Telegram, Slack, email or SMS alerts, automatic retries and one-click resend for failed lead emails.

== Changelog ==

= 1.0.2 =
* New: Alerts (Pro) screen describing the optional Leadkeel Pro add-on.
* New: link to the optional setup service on the Form health screen.

= 1.0.1 =
* Clearer description of what Leadkeel does.
* New developer hook `leadkeel_mail_result`, fired when a lead's notification email succeeds or fails.

= 1.0.0 =
* Initial release.
* Lead inbox for Contact Form 7, WPForms, Fluent Forms, Forminator, Gravity Forms and Elementor Forms.
* Notification email results (sent, failed with error, or not confirmed) for every inquiry.
* Dashboard warnings and a menu count for leads whose email failed.
* Form health screen, test email button, gone-quiet alerts and an optional weekly summary.
* CSV export, follow-up statuses, retention settings, privacy tools, multisite support.
