=== Scope Quote Widget ===
Contributors: tryscope
Tags: lead generation, quote, tradesmen, tradesperson, form, contact form, cta
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed the Scope quote widget on your WordPress site. Capture leads with photos, get a push to your phone, send branded PDF quotes from the van.

== Description ==

Scope is a lead-capture widget built for UK tradespeople and the web agencies that host them. Customers describe the job, upload photos, and hit send. The lead pings the tradesperson's phone in under 10 seconds. A branded PDF quote goes out from the mobile app.

This plugin makes it one-click easy to embed the widget on any WordPress site. Paste your Scope Client ID into the settings page and you're live.

**Features**

* One-line install: paste your Scope Client ID, widget is live on every page.
* Shortcode `[scope_widget]` to drop the widget inline in a specific page or post.
* Per-client widget customisation from the Scope dashboard (colours, fields, layout).
* Photo uploads on the form, no extra plugins needed.
* Push notifications to the Scope mobile app for every new lead.
* Branded PDF quote templates with Xero / QuickBooks integration.
* Free tier available at tryscope.co.uk.

**Who it's for**

* Solo tradespeople (plumbers, electricians, builders, roofers, landscapers) who want every website visitor to become a qualified lead.
* Web agencies managing 5-100 tradesperson clients who need a single dashboard and reseller billing.

**Setup**

1. Install and activate this plugin.
2. Sign up at [tryscope.co.uk](https://tryscope.co.uk) (free, no card required).
3. Create a widget in your dashboard at `/dashboard/customize`.
4. Copy your Client ID (a UUID).
5. Paste it into Settings → Scope Widget in your WP admin.
6. Save. Widget is live on your site.

== Installation ==

= From the WordPress Plugin Directory =

Once listed: Plugins → Add New → search "Scope Quote Widget" → Install → Activate.

= Manual upload =

1. Download `scope-widget.zip` from [tryscope.co.uk/downloads/scope-widget.zip](https://tryscope.co.uk/downloads/scope-widget.zip).
2. WP admin → Plugins → Add New → Upload Plugin → choose the zip → Install Now → Activate.
3. Settings → Scope Widget → paste your Client ID → Save.

== Frequently Asked Questions ==

= Where do I get my Client ID? =

Sign up at tryscope.co.uk, create a widget in your dashboard, and copy the UUID shown in the install snippet. It looks like `ef1b1350-2797-4e65-9640-54208081a927`.

= Does this work with page builders (Elementor, Divi, Beaver)? =

Yes. The widget injects into `wp_footer`, which every well-behaved theme and builder triggers. For inline placement inside a builder, use the shortcode `[scope_widget]`.

= Will this slow my site down? =

No. The widget script is `async defer`, so it loads in parallel with your page and doesn't block render. It's ~35 KB gzipped.

= Can I hide the widget on specific pages? =

Not yet from this plugin. Uncheck "Widget enabled" to turn off site-wide. Per-page control is on the roadmap.

= What data does Scope collect? =

Only what your customer types into the widget: their name, contact details, and their description/photos of the job. It goes directly to your Scope dashboard. No third-party trackers.

= Do I need to be Gas Safe, NICEIC registered, etc.? =

No. Scope is a lead-capture tool; your own certifications are separate.

== Changelog ==

= 1.2.0 =
* Gutenberg block: "Scope Widget" now appears in the Add-blocks picker with a branded icon.

= 1.1.0 =
* Admin control panel: live/not-live status, 7-day lead count, brand colour tile, live preview iframe.
* Premium setup add-on (£99 one-off): book white-glove widget configuration straight from the Settings page.

= 1.0.0 =
* Initial release.
* Settings page under Settings → Scope Widget.
* Auto-inject script into `wp_footer` when a Client ID is set.
* `[scope_widget]` shortcode for inline placement.
* UUID validation on save.

== Upgrade Notice ==

= 1.0.0 =
First release. Welcome to Scope.
