=== LeadJaw ===
Contributors: leadjaw
Tags: lead generation, analytics, visitor tracking, b2b, crm
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
 
Identify the companies visiting your WordPress site and turn anonymous traffic into B2B leads.
 
== Description ==
 
LeadJaw identifies the B2B companies visiting your website, even when they never fill in a form.
 
Install this plugin to connect your WordPress site to your LeadJaw account in minutes, with no code changes needed.
 
= What you see inside WordPress =
 
Once connected, a LeadJaw dashboard appears in your WordPress admin showing:
 
* Your top 5 most visited pages over the last 30 days
* Live tracking status and your current plan
* Monthly usage - companies identified against your plan limit
* Trial countdown and upgrade prompts when relevant
* Live visitor stats - how many people are on your site right now, total visitors this week and your all-time daily record
 
It is a quick-glance view designed to sit alongside your day-to-day WordPress workflow.
 
= Show live visitor stats on your website =
 
Every paid plan includes a front-end stats widget that lets you display live visitor data anywhere on your site - on a landing page, homepage, sidebar or any custom template.
 
Three counters are available:
 
* Visitors on site right now (updates every 60 seconds)
* Total visitors in the last 7 days
* Your record daily visitor count
 
Add them with a single line of HTML or a shortcode. No coding experience required.
 
= Personalise your content by visitor industry =
 
LeadJaw can identify the industry of the company visiting your site. The plugin lets you use that data to show different content to different visitors - automatically and without any extra tools.
 
For example, if a law firm visits your site they can see a section written specifically for legal businesses. If a construction company visits, they see content tailored to them. Everyone else sees your default content.
 
You set it up by adding a simple attribute to any HTML element:
 
&lt;div data-lj-show-for="legal services"&gt;
  Hello law firm - this section is just for you.
&lt;/div&gt;
 
The plugin settings page shows you the exact industry names matched from your real visitors so you can copy and paste them directly into your content blocks. No guesswork needed.
 
All industry identification happens server-side. No personal data is returned to the browser.
 
= What you get in the full LeadJaw app =
 
The real power is in your LeadJaw dashboard at app.leadjaw.com. From there you can:
 
* See every company visiting your site, enriched with name, industry, employee count, location and Companies House data
* Capture form fills and tie them to the company visit automatically
* Track lead sources across campaigns, channels and referrers
* Score leads as hot, warm or cold based on visit frequency, pages viewed and time on site
* Build streams - saved filters that surface the exact companies you care about
* Set alert rules so you are notified by email when a target company or high-intent visitor lands on your site
* View your visitors on an interactive 3D globe or world atlas
* Access a full suite of reports covering company activity, lead sources, form fills and 404 errors
* Manage team access with role-based permissions
* Connect via REST API for custom integrations and workflows
* Receive weekly email digests with your top companies, lead sources and key activity
 
= How it works =
 
LeadJaw uses a lightweight JavaScript tracking snippet, injected automatically by this plugin. It matches visitor IP addresses to company networks and enriches each visit with business data. No cookies are required for company-level identification. All data is processed in compliance with GDPR.
 
= Getting started =
 
1. Install and activate this plugin
2. Create your free LeadJaw account at https://app.leadjaw.com/register
3. Copy your Tracking ID and Account Token from LeadJaw > Settings
4. Paste them into the LeadJaw plugin settings page
5. Tracking goes live immediately - your first identified companies will appear within a few hours of real traffic
 
A LeadJaw account is required. A 10-day FREE trial is available with no credit card needed. Plans start from GBP £39 / USD $49 / EUR €45 per month.
 
**External services**
 
This plugin loads a tracking script from `app.leadjaw.com` on the front end of your site. This script sends visitor data (IP address, page URL, referrer) to the LeadJaw platform for processing. By installing and activating this plugin you consent to that data transfer.
 
The dashboard widget and front-end stats widget fetch summary data from the LeadJaw API at `app.leadjaw.com` using your Account Token or public widget token. Industry-based personalisation uses a server-side IP lookup against your LeadJaw visitor data. No personal data is returned to the browser.
 
LeadJaw privacy policy: https://www.leadjaw.com/privacy-policy
LeadJaw terms of service: https://www.leadjaw.com/terms
 
== Installation ==
 
1. Upload the `leadjaw` folder to `/wp-content/plugins/`
2. Activate the plugin from the Plugins screen in WordPress
3. Go to LeadJaw > Settings
4. Enter your Tracking ID and Account Token from your LeadJaw account
5. Save settings
 
== Frequently Asked Questions ==
 
= Where do I find my Tracking ID? =
 
Log in to app.leadjaw.com, go to Settings > Tracker Setup and copy your Tracking ID from the panel on the right.
 
= Where do I find my Account Token? =
 
Log in to app.leadjaw.com, go to Settings > Tracker Setup. Your Account Token is shown on the right side of the page. Keep it private.
 
= Will the plugin track logged-in WordPress users? =
 
No, by default logged-in users are excluded. You can change this in LeadJaw > Settings.
 
= Does this plugin work with caching plugins? =
 
Yes. The tracking snippet is injected server-side via wp_head and is not affected by page caching.
 
= Do I need a paid LeadJaw plan? =
 
A LeadJaw account is required. We offer a 10-day trial so you can see how it works for yourself. The front-end stats widget and personalisation features are available on all paid plans. Visit https://www.leadjaw.com to see current plans and pricing.
 
= What data does the plugin collect? =
 
The tracking script collects the visitor IP address, page URL and referrer. When a visitor submits a form on your site, LeadJaw also captures the submitted data including name and email address where provided. All data is processed in accordance with the LeadJaw privacy policy at https://www.leadjaw.com/privacy-policy.
 
= How does the personalised content feature work? =
 
LeadJaw identifies the industry of visiting companies server-side using IP matching. When a visitor loads your page, the plugin checks their IP against your visitor data and returns their industry category. Your content blocks use this to show or hide sections. No personal data such as company name, individual name or IP address is ever sent to the visitor's browser.
 
= Is the personalisation feature GDPR compliant? =
 
The industry lookup happens entirely on LeadJaw's servers. Only an aggregate industry category (for example "legal services") is returned to the page. No personal data touches the visitor's browser. For sites with a cookie consent banner, you can add the data-lj-consent-only attribute to any personalised block so it only activates after consent is given.
 
= Does this work with contact form plugins and booking tools? =
 
Yes. LeadJaw captures form fills from most standard WordPress form plugins including Contact Form 7, WPForms and Gravity Forms, as well as Calendly bookings and WooCommerce checkout data.
 
== Screenshots ==

1. WordPress: Dashboard showing top 5 visited pages, usage this month and connection status
2. WordPress: Settings page with Tracking ID, Account Token and tracking options
3. WordPress: Support page with system info
4. Main App: Dashboard view, helping you identify key site activities
5. Main App: 3D Globe view of your actual visitors around the world
6. Main App: World Atlas view of where your site visitors originate from
7. Main App: Sales Funnel, a top down view to help you understand visitor activity

== Changelog ==
 
= 1.3.0 =
* Front-end visitor stats widget for all paid plans - display live visitor counts on any page using HTML or shortcodes
* Personalised content blocks - show different content to visitors based on their identified industry using data-lj-show-for attributes
* Industry list in plugin settings - see exactly which industries have visited your site and copy the names directly into your content blocks
* Live visitor stats on the WordPress admin dashboard - on site now, 7-day total and all-time daily record
* GDPR consent gate - optional data-lj-consent-only attribute to suppress personalisation blocks until cookie consent is given
* Shortcode support - [leadjaw_stat type="live|week|peak|industry"] for use in Gutenberg, classic editor and widget areas
 
= 1.2.1 =
* Improved onboarding notice for new users - clearer two-step setup guide with direct link to create a free 10-day trial account.
 
= 1.2.0 =
* Initial release