=== Lead Magnet For Utiliko ===
Contributors: codengine
Tags: wpforms, utiliko, crm, leads, lead management
Requires at least: 6.6
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.11
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect WPForms with Utiliko CRM and synchronize mapped form submissions as leads.

== Description ==
Lead Magnet For Utiliko connects WPForms with Utiliko CRM. Administrators can authenticate a Utiliko tenant, map WPForms fields to Utiliko lead fields, send a unique test lead, and review a limited debug history when troubleshooting submissions.

== Features ==
* WPForms to Utiliko lead synchronization.
* Per-form field mapping.
* Explicit Utiliko tenant authentication.
* Unique test-lead email generation.
* Token-redacted debug logging with a limited history.
* One-click debug history clearing.
* Responsive WordPress admin interface.

== Requirements ==
* WordPress 6.6 or later.
* PHP 7.4 or later.
* WPForms Lite or WPForms Pro.
* A valid Utiliko tenant/account.

== Installation ==
1. Install and activate WPForms Lite or WPForms Pro.
2. Upload the plugin ZIP through Plugins > Add New > Upload Plugin, or install it from the WordPress Plugin Directory when available.
3. Activate Lead Magnet For Utiliko.
4. Open **Utiliko LeadSync** in the WordPress admin.
5. Enter the Utiliko tenant name and click **Authenticate**.
6. Open **Field Mapping**, select a WPForms form, and map the required fields.
7. Use **Send Test Lead (Unique Email)** to verify the connection.

== External Services ==
This plugin connects to the Utiliko CRM API to authenticate the integration and submit lead data from configured WPForms submissions. When a form is submitted and synchronization is enabled, the mapped lead data is transmitted to Utiliko.

Utiliko service: https://utiliko.io/

Users should review Utiliko's terms and privacy documentation before enabling lead synchronization.

== Frequently Asked Questions ==

= Which form plugin is supported? =
WPForms Lite and WPForms Pro are supported.

= What happens if I disconnect Utiliko? =
The site-specific tenant is cleared and the integration must be authenticated again before leads are sent.

= Where can I troubleshoot a failed submission? =
Open **Utiliko LeadSync > Debug Log**. The plugin stores a limited history and redacts the access token from request logs.

= Can I clear the debug history? =
Yes. Use **Clear Debug Log** on the Debug Log screen.

== Changelog ==

= 1.1.11 =
* Hardened field-mapping form handling with recursive input sanitization.
* Internal code quality and WordPress Coding Standards compliance improvements.
* No functional changes to lead synchronization, authentication, or debug behavior.

= 1.1.8 =
* Refined plugin metadata and WordPress.org documentation.
* Organized the plugin implementation into dedicated include files without changing the integration flow.
* Moved admin styles into a dedicated stylesheet.
* Added plugin branding assets and standard documentation files.
* Retained field mapping, authentication, test lead, submission, and debug functionality.

== Upgrade Notice ==
= 1.1.11 =
Internal hardening and code-quality release. No action required.

= 1.1.8 =
This release reorganizes the plugin for maintainability and WordPress.org distribution while retaining the existing integration behavior.

== License ==
Lead Magnet For Utiliko is licensed under the GNU General Public License v2 or later. See `license.txt` for the complete license text.
