=== VioTrade - Lead Capture & CRM ===
Contributors: viotrade
Tags: crm, lead capture, trades, invoicing, contact form
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect your WordPress site to VioTrade to capture leads and sync contact form submissions to your dashboard.

== Description ==

VioTrade is the all-in-one business app for UK tradespeople - plumbers, electricians, builders, roofers, painters, landscapers, and more.

This plugin connects your WordPress website to your VioTrade account, so every enquiry from your website lands directly in your VioTrade dashboard as a new lead.

**Features:**

* **Drop-in lead capture form** - add a professional contact form to any page using the `[viotrade_form]` shortcode or the Gutenberg block
* **Contact Form 7 integration** - automatically forward CF7 submissions to VioTrade
* **WPForms integration** - automatically forward WPForms submissions to VioTrade
* **Customisable appearance** - choose accent colour, light or dark theme, and custom button text
* **Auto-inject option** - optionally add the form to every page footer
* **Spam protection** - built-in honeypot field
* **Mobile-friendly** - fully responsive design
* **Zero dependencies** - works without jQuery or any CSS framework

**How it works:**

1. Install and activate the plugin
2. Enter your VioTrade Business ID in the settings
3. Add the form to your pages
4. Enquiries appear in your VioTrade dashboard instantly

**Requirements:**

* A VioTrade account (Business Pro or All Inclusive plan)
* Your VioTrade Business ID (found in Dashboard > Integrations)

Don't have a VioTrade account? [Sign up for a free 7-day trial](https://www.viotrade.co.uk/signup) - no credit card required.

**Third-Party Service:**

This plugin relies on [VioTrade](https://www.viotrade.co.uk), an external service provided by Vioscale Technologies Ltd, to deliver its functionality. The plugin communicates with VioTrade in the following ways:

* The lead capture form is loaded from `https://www.viotrade.co.uk/embed/lead-form.js` and rendered on your site using Shadow DOM.
* When a visitor submits the form (or when a Contact Form 7 / WPForms submission is forwarded), the data is sent to `https://www.viotrade.co.uk/api/leads/submit`.
* Data transmitted includes: visitor name, email, phone number, service/subject, and message.

No data is collected or transmitted until a visitor actively submits a form. No cookies, tracking pixels, or analytics scripts are added to your site.

By using this plugin, you agree to VioTrade's terms:

* [Terms of Service](https://www.viotrade.co.uk/terms-of-service)
* [Privacy Policy](https://www.viotrade.co.uk/privacy-policy)

== Installation ==

1. Upload the `viotrade` folder to the `/wp-content/plugins/` directory, or install directly through the WordPress plugin screen
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to **Settings > VioTrade**
4. Enter your Business ID from your [VioTrade dashboard](https://www.viotrade.co.uk/dashboard/integrations)
5. Add the form to any page using the `[viotrade_form]` shortcode or the **VioTrade Lead Form** Gutenberg block

== Frequently Asked Questions ==

= Where do I find my Business ID? =

Log in to your VioTrade account at [viotrade.co.uk](https://www.viotrade.co.uk), go to **Dashboard > Integrations**, and copy your Business ID.

= Does this work with Contact Form 7? =

Yes! Enable the Contact Form 7 integration in **Settings > VioTrade** and your form submissions will automatically sync to VioTrade as new leads. The plugin auto-detects common field names (name, email, phone, message, subject).

= Does this work with WPForms? =

Yes! Enable the WPForms integration in **Settings > VioTrade** and submissions will sync automatically. Field mapping is detected from field types and labels.

= Can I customise the form appearance? =

Yes. You can set the accent colour, theme (light or dark), and button text in the plugin settings. You can also override these per-form using shortcode attributes:

`[viotrade_form accent="#ff6600" theme="dark" button="Get a Quote"]`

= Does this slow down my website? =

No. The form script loads asynchronously from VioTrade's CDN and uses Shadow DOM for complete style isolation. It has zero impact on your page load time.

= What data is sent to VioTrade? =

Only the form fields that your visitors fill in: name, email, phone, service/subject, and message. No cookies, tracking pixels, or analytics are added to your site.

= Is there a free plan? =

The embeddable widget feature requires a VioTrade Business Pro (£29.99/mo) or All Inclusive (£39.99/mo) plan. Both include a 7-day free trial.

== Changelog ==

= 1.0.0 =
* Initial release
* Lead capture form shortcode and Gutenberg block
* Contact Form 7 integration
* WPForms integration
* Customisable theme, accent colour, and button text
* Auto-inject option for site-wide forms

== Upgrade Notice ==

= 1.0.0 =
Initial release of the VioTrade WordPress plugin.
