=== Simple Lead Generator ===
Contributors: Surror
Tags: lead generation, lead capture, contact form, inquiry form, ajax form
Donate link: https://www.paypal.me/surror/
Tested up to: 7.1
Stable tag: 1.4.0
Requires at least: 6.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Lightweight WordPress lead generation and lead capture form with AJAX submissions and a modern admin dashboard.

== Description ==

**Simple Lead Generator** is a lightweight WordPress lead generation plugin that lets you add a lead capture form to any page or post using a simple shortcode.

Visitors can submit their contact details and inquiry without a full page reload. Submissions are stored privately in WordPress and can be managed from the plugin's modern **Leads** admin tab.

It is designed for businesses, freelancers, agencies, service providers, and website owners who need a simple way to collect leads and inquiries without setting up a large form or CRM system.

= Why use Simple Lead Generator? =

* Add a lead capture form anywhere with a shortcode
* Collect inquiries directly in your WordPress website
* Submit forms using AJAX without a full page reload
* Manage submitted leads from a dedicated admin dashboard
* Keep lead data stored in your own WordPress installation
* Configure form messages and basic lead-generation estimates
* Use the plugin without creating an external account
* Optional platform telemetry and support features

= Features =

* **WordPress lead capture form** — Add a simple inquiry and lead form to pages and posts.
* **AJAX form submission** — Submit leads without reloading the entire page.
* **Shortcode-based** — Place the form wherever you need it with `[simple_lead_generator]`.
* **Private lead storage** — Form submissions are stored as private `slg_lead` entries.
* **Lead management** — View, paginate, and delete submitted leads from the Leads tab.
* **Lead statistics** — View lead counts and estimates such as pipeline and potential revenue.
* **Form settings** — Customize the form title, description, submit button text, and success message.
* **Modern admin dashboard** — Manage the plugin through Home, Leads, Settings, and Support screens.
* **Offline-friendly** — The lead form does not require a platform account or external service.
* **Optional platform features** — Platform telemetry is opt-in and support can be connected when available.

= Shortcode =

Add the lead capture form to any page or post:

`[simple_lead_generator]`

You can customize the form using shortcode attributes. Open the plugin's **Home** screen in WordPress admin for the available options.

= Managing Leads =

After a visitor submits the form, the submission is saved as a lead in WordPress.

Open:

**WordPress Admin → Simple Lead Generator → Leads**

From there you can:

* View submitted leads
* Browse leads using pagination
* Open contact information using available email or telephone links
* Expand submitted messages
* Delete leads you no longer need

= Form Settings =

The plugin provides settings for common form and lead-estimation options, including:

* Form title and description
* Submit button text
* Success message
* Close-rate estimate
* Currency symbol
* Monthly marketing cost

These settings help you customize the form and understand basic estimated lead economics without requiring an external CRM.

= Privacy =

Simple Lead Generator stores submitted lead information in your WordPress database.

The basic lead form does not require an external account or platform connection to operate.

Optional platform telemetry is disabled unless you choose to enable it.

Make sure your website's privacy policy and data-handling practices appropriately describe how you collect, store, and use visitor information.

= Support =

For questions, feature requests, or assistance, visit [Surror](https://surror.com/).

== Installation ==

= From within WordPress (recommended) =

1. Go to **Plugins → Add New Plugin**.
2. Search for **Simple Lead Generator**.
3. Click **Install Now**.
4. Click **Activate**.
5. Open **Simple Lead Generator** in the WordPress admin.
6. Add `[simple_lead_generator]` to a page or post.

= Manual installation =

1. Download the plugin ZIP file.
2. Upload the `simple-lead-generator` folder to `/wp-content/plugins/`.
3. Go to **Plugins** in WordPress admin.
4. Activate **Simple Lead Generator**.
5. Add `[simple_lead_generator]` to a page or post.

== Frequently Asked Questions ==

= Where do submitted leads go? =

Each form submission is saved as a lead in your WordPress database and appears under **Simple Lead Generator → Leads** in wp-admin.

= Does Simple Lead Generator require an account? =

No. The lead capture form works without creating an account or connecting to an external platform.

= Does the form use AJAX? =

Yes. Form submissions are handled using AJAX, so the page does not need to perform a full reload for each submission.

= Where can I add the lead form? =

You can add `[simple_lead_generator]` to supported WordPress page and post content wherever you want the form to appear.

= Can I customize the form? =

Yes. The plugin provides form settings for the title, description, submit button text, and success message. Additional shortcode options are documented in the plugin's Home screen.

= Can I view and delete leads? =

Yes. The **Leads** admin tab lets you view submitted leads, browse them with pagination, and delete individual submissions.

= Does the plugin require an external CRM? =

No. Simple Lead Generator stores leads directly in WordPress and does not require a CRM or external account for its basic functionality.

= Is platform telemetry required? =

No. Platform telemetry is optional. The basic lead capture functionality works without it.

== Changelog ==

= 1.4.0 =

* New: Form appearance settings — Card, Minimal, and Bordered presets; accent color; max width; optional two-column layout.
* New: Live preview iframe on Settings (uses your form page with unsaved appearance choices).
* New: Optional theme primary color for the submit button and focus rings.
* New: Shortcode attributes `preset`, `accent`, `max-width`, and `columns` override saved appearance per page.
* Improvement: Frontend form markup — labels above fields, accessible field IDs, styled submit button.
* Improvement: AJAX submit shows loading state, inline errors, and a cleaner success message.
* Improvement: Smooth form animations — entrance fade, submit spinner, success/error transitions (respects reduced-motion).
* Improvement: Inline field validation on blur — required hints, email/phone/URL/number format checks, errors clear as you fix them.
* Improvement: Settings live preview uses a secure admin endpoint (no hardcoded page URL); reflects unsaved field + appearance changes; optional link when a public form page exists.

= 1.3.0 =

* Fix: Release zip now bundles PluginKit correctly (fixes fatal error on activate from 1.2.4).
* New: Dynamic form field builder in Settings — add, reorder, enable/disable, and configure field types.
* New: Leads table columns follow your configured form fields.
* New: WordPress visual editor for the post-submit success message.
* Improvement: Shortcode renders fields from saved configuration (per-field shortcode overrides still supported).
* Improvement: Local/staging sites show a clear Support notice instead of “Site not connected”.
* Improvement: Developer platform tools are opt-in only (not shown on every Local WP install).
* Improvement: Settings loading skeleton and cleaner form field row actions.

= 1.2.4 =

* Improvement: Tested up to WordPress 7.1.
* Fix: Plugin Check compliance — languages folder, release composer.json, input sanitization, uninstall variable prefixes.

= 1.2.3 =

* Improvement: Expanded plugin directory readme for SEO and clearer feature documentation.
* New: WordPress Playground blueprint for live demo on wordpress.org.
* New: Plugin directory assets (banner, icon) and Playground blueprint.

= 1.2.2 =

* Improvement: Settings split into separate cards for Form & Messages, ROI Estimates, and Platform & Telemetry.
* Improvement: Platform URL is clearly marked as optional.
* Improvement: Lead form continues to work without a platform connection.

= 1.2.1 =

* New: Form settings for success message, form title and description, and submit button text.
* New: ROI settings for close rate, currency symbol, and monthly marketing cost.
* New: Leads page statistics for pipeline, estimated revenue, and ROI.
* Improvement: Polished leads table with mailto and tel links and expandable messages.

= 1.2.0 =

* New: Leads admin tab for viewing and deleting form submissions.
* Change: Lead storage now uses the private `slg_lead` post type.
* Change: Removed the wp-admin Customers menu.
* Change: Home now links directly to the Leads tab.

= 1.1.1 =

* Fix: Lead submissions are saved as published entries so the Home lead count remains accurate.
* Fix: Platform diagnostics and weekly telemetry honor the per-product `platform_enabled` filter.

= 1.1.0 =

* New: Modern React admin shell with Home, Settings, and Support screens.
* New: Optional platform telemetry and support inbox.
* Improvement: Updated WordPress and PHP requirements.
* Improvement: Preserved the AJAX shortcode form from the 1.0.x releases.

= 1.0.2 =

* Improvement: Removed unwanted files.
* Improvement: Updated compatibility for WordPress 6.2.2.

= 1.0.0 =

* Initial release.

== Upgrade Notice ==

= 1.4.0 =
Polished frontend form styling with appearance presets. Existing shortcodes pick up the Card preset automatically.

= 1.3.0 =
Fixes a fatal error on new installs (1.2.4). Adds form field builder, success message editor, and clearer localhost Support messaging.

= 1.2.4 =
Compatibility update. Confirms support for WordPress 7.1. No code changes required.

= 1.2.3 =
Readme and directory assets update. No code changes required for existing installs.

= 1.2.2 =
Settings UX improvements. The Platform URL is optional, and the lead form works without a platform connection.

= 1.2.0 =
Added the Leads admin tab and private lead storage. If you previously used versions 1.0.x–1.1.x, old Customer posts are not migrated automatically.
