=== TechPad – WhatsApp for Forminator ===
Contributors: thetechpad
Tags: whatsapp, forminator, whatsapp notification, whatsapp business api, lead, form, notification
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Send Forminator submissions straight to your WhatsApp — never miss a lead.

== Description ==

Send Forminator submissions straight to your WhatsApp — never miss a lead.

Every lead counts. When a visitor submits a form on your WordPress site, the details land in your WhatsApp instantly — so you can reply while the interest is hot, not hours later.

This plugin connects Forminator to **The Tech Pad**, a WhatsApp Business API platform. It uses the official Meta WhatsApp Business API — no unofficial libraries, no click-to-chat links. Messages are sent as approved WhatsApp templates and replies come back into your Tech Pad inbox.

= Features =

* **Instant lead alerts** — every successful submission sends a WhatsApp message to you (or any number you choose).
* **Per-form control** — enable notifications per form, override the recipient and template for each one.
* **Field mapping** — map form fields to template variables in {1}, {2}… order, or send all fields automatically.
* **Customer confirmations (opt-in)** — when your form has a phone field and an opt-in checkbox, a confirmation goes to the submitter too (Meta-compliant).
* **Test send** — verify delivery from the settings page before going live.
* **Delivery log** — every send is recorded with status, Meta message id and errors; failed sends retry automatically and can be re-sent manually.
* **Spam & flood protection** — respects your form plugin's spam detection and rate-limits sends per form.

= How it works =

1. Install and activate this plugin (it needs Forminator active).
2. Open **The Tech Pad → Forminator**.
3. Paste your API key and phone number ID from The Tech Pad dashboard (Developer settings) and pick an approved WhatsApp template.
4. Enable the forms you want notified and save.

The WhatsApp number the messages send from is your Tech Pad number, so all replies and conversations are managed in your Tech Pad inbox — campaigns, team inbox, automations and more.

Get a free workspace at **thetechpad.com**.

== Installation ==

1. Upload the `techpad-forminator` folder to `/wp-content/plugins/`, or install the plugin through WordPress's “Add Plugins” screen.
2. Activate the plugin. Forminator must be installed and active.
3. Go to **The Tech Pad → Forminator**, paste your API key + phone number ID, pick your template and save.
4. Send a test message, then enable the forms you want notified.

== Frequently Asked Questions ==

= Do I need a The Tech Pad account? =

Yes. The plugin sends through The Tech Pad's WhatsApp Business API platform. Create a free workspace at https://thetechpad.com — your first 1,000 conversations a month are free on WhatsApp's standard pricing.

= Do I need an approved template? =

Yes — WhatsApp template messages are required for the first contact with a number. Create your template in The Tech Pad Template hub and wait for Meta approval (usually a few hours). The plugin sends every notification as a template message.

= What happens if the send fails? =

The delivery log shows the error. Failed sends retry automatically up to 3 times, and a Retry button is available on the settings page.

= Can I send to my customer's number? =

Yes, with explicit opt-in. In the form settings, pick your form's opt-in checkbox field and phone field — when the visitor ticks the box, a confirmation goes to their number. Sending to a number without opt-in violates WhatsApp's policy.

= Does this slow down my form? =

No. Notifications are queued and sent in the background via WordPress cron — the visitor's submission completes instantly.

== Changelog ==

= 1.1.3 =
* Fixed: an enabled form could send nothing while the log blamed the API key.
  The readiness check asked for the recipient and template to be set globally,
  even though both can be set per form — so a form with its own recipient and
  template was skipped with "Connection not configured". Readiness now needs
  the two credentials only (send key + sending number), and every skip message
  names exactly what is missing.
* New: the Connection card shows a checklist of anything a send still needs
  (send key, WhatsApp number, default recipient, default template) instead of a
  bare "Not connected yet".
* New: forms that are enabled but cannot send yet are flagged in red above the
  forms table, with the reason per form (no template chosen, no recipient, …).
* New: delivery-log skip reasons now list the missing setup items and point at
  the exact field to fill, so "form submitted, no WhatsApp message" is
  diagnosable without support.

= 1.1.2 =
* Fixed: an enabled form could send nothing while the log blamed the API key.
  The readiness check asked for the recipient and template to be set globally,
  even though both can be set per form — so a form with its own recipient and
  template was skipped with "Connection not configured". Readiness now needs
  the two credentials only (send key + sending number), and every skip message
  names exactly what is missing.
* New: the Connection card shows a checklist of anything a send still needs
  (send key, WhatsApp number, default recipient, default template) instead of a
  bare "Not connected yet".
* New: forms that are enabled but cannot send yet are flagged in red above the
  forms table, with the reason per form (no template chosen, no recipient, …).
* New: delivery-log skip reasons now list the missing setup items and point at
  the exact field to fill, so "form submitted, no WhatsApp message" is
  diagnosable without support.

= 1.1.1 =
* New: every Tech Pad plugin now lives in ONE **The Tech Pad** menu in wp-admin.
  Each platform gets its own labelled row (Contact Form 7, WPForms, Bookly…)
  instead of every plugin adding an identically named row under Settings, and
  the menu opens with a site overview: your connection plus a link to each
  Tech Pad plugin installed on this site.
* New: one shared delivery log for the whole family. Install several Tech Pad
  plugins and their sends are recorded in one table (each plugin still shows
  only its own provider's rows). Rows from the previous per-plugin table are
  carried over automatically on update.
* New: one shared template-list cache, so a site with several Tech Pad plugins
  asks the API once every five minutes instead of once per plugin.

= 1.1.0 =
* New: one-click email connect — the plugin creates your free Tech Pad
  workspace, send key and site connection from just your email (no dashboard
  visit, no key entry). Connect your WhatsApp number in the dashboard and the
  settings page auto-fills the number ID and templates.
* New: one connect serves the whole site — install another Tech Pad plugin and
  it is already connected (shared site connection).

= 1.0.0 =
* Initial release.
