=== Solar Lead Capture Lite ===
Contributors: user256
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.5.4
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Tags: lead generation, forms, solar, lead capture, email

Multi-step solar lead capture with inline or modal display, WordPress lead storage, and email delivery via wp_mail or your own SMTP server.

== Description ==

Solar Lead Capture Lite adds a configurable multi-step quote form for solar lead collection.

Features include:
* Inline form shortcode and popup trigger shortcode
* WordPress lead storage under a dedicated admin menu
* Email delivery via wp_mail or generic SMTP (Gmail App Password, GMX, Outlook, Fastmail, iCloud, Brevo, Mailgun, Postmark, Proton Bridge, Zoho, custom — your own credentials; no plugin-vendor relay)
* Optional address lookup and UK postcode validation modes
* Optional calculator widget shortcode

== External services ==
This plugin connects to the following external services:

* Google Places API (New) — used for address autocomplete in the form and calculator when enabled by the site administrator.
  Data sent: user-typed address fragments and selected place IDs are sent from the WordPress site server to Google while the visitor searches for an address.
  Terms: https://cloud.google.com/maps-platform/terms
  Privacy: https://policies.google.com/privacy
  Site administrators must disclose this use in their public terms and privacy policy before enabling Google Places.

* Postcodes.io — used for UK postcode validation when that validation mode is enabled.
  Data sent: the postcode the visitor enters, sent from the visitor's browser to Postcodes.io for validation.
  Terms: https://postcodes.io/docs/licences (MIT Licence, OS OpenData licence)
  Privacy: https://terms.ideal-postcodes.co.uk/website/privacy.html (operated by Ideal Postcodes Ltd)

* Administrator-configured SMTP server (optional) — used to send lead notifications, reminders, data-request exports, and test messages when SMTP delivery is enabled.
  Data sent: message recipients, subjects, bodies (which can contain lead details), and the administrator's SMTP credentials are transmitted to the SMTP server selected by the administrator when mail is sent or tested.
  Provider: the administrator chooses and configures the SMTP provider. The plugin vendor does not operate a mail relay. The selected provider's own terms and privacy policy apply and must be reviewed before SMTP is enabled.

== Installation ==

1. Upload the `solar-lead-capture-lite` folder to `/wp-content/plugins/` or install the zip from **Plugins > Add New > Upload Plugin**.
2. Activate **Solar Lead Capture Lite** in WordPress.
3. Open **Solar leads > Settings** and complete the delivery setup.
4. Add `[solar_capture_form]` or `[solar_capture_trigger]` to a page.

== Frequently Asked Questions ==

= How do I place the form on a page? =

Add the shortcode `[solar_capture_form]` to any page, post, or shortcode block.

= How do I show the form in a popup? =

Use `[solar_capture_trigger]`. You can optionally pass a custom label, for example `[solar_capture_trigger label="Get a quote"]`.

= How are leads delivered? =

Notifications are sent by email — either standard WordPress mail (wp_mail) or a generic SMTP server you configure with your own credentials.

= Where are submissions stored? =

Submitted leads are stored inside WordPress under **Solar leads**.

= Does the plugin support address autocomplete? =

Yes. You can use free-text mode, Google Places, Postcodes.io validation, or Google Places plus Postcodes.io validation.

== Screenshots ==

1. Customizable multi-step lead capture form.
2. Qualify visitors with configurable multi-step questions.
3. Google Places address autocomplete on the address step.
4. Exit-intent pop-up to recover visitors who are about to leave.
5. Configurable fields, steps, and validation controls.
6. Theme and appearance controls to match your site.
7. Embeddable questionnaire you can place anywhere with a shortcode.

== Changelog ==

= 1.5.4 =

* Email delivery via wp_mail or a generic SMTP server you control.
* Optional Google Places address autocomplete and UK postcode validation.
* Bill-based solar savings calculator widget.

= 1.5.3 =

* Previous stable release.
