=== LeadJaw ===
Contributors: leadjaw
Tags: personalisation, dynamic content, visitor tracking, b2b, lead generation
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.3.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
 
Personalise your WordPress site for every B2B visitor automatically. Show different content by industry, identify the companies visiting your site and turn anonymous traffic into leads.
 
== Description ==
 
LeadJaw does two things most WordPress plugins cannot.
 
First, it personalises your site automatically for every B2B visitor - showing different content to different industries without any extra tools, coding or manual segmentation.
 
Second, it identifies the companies behind that traffic, even when visitors never fill in a form. You see which businesses are on your site, what they viewed and where they came from.
 
Install this plugin to connect your WordPress site to your LeadJaw account in minutes, with no code changes needed.
 
= Website personalisation by visitor industry =
 
LeadJaw identifies the industry of visiting companies server-side and lets your content respond to it automatically. A law firm sees legal content. A construction company sees construction content. Everyone else sees your default.
 
This is dynamic content personalisation without a CRM, without a data warehouse and without a developer. It works on any page, any template and any theme.
 
Add a single HTML attribute to any content block:
 
&lt;div data-lj-show-for="legal services"&gt;
  This section is written for law firms.
&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. No guesswork.
 
All lookups happen server-side. No personal data is returned to the browser. GDPR compliant by design.
 
= 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.
 
= Identify the B2B companies visiting your site =
 
Beyond personalisation, LeadJaw tells you exactly which companies are visiting your site and what they are doing. Every identified visit is enriched with company name, industry, employee count, location and Companies House data where available.
 
You see warm leads you would otherwise never know about - companies that browsed your pricing page, read three blog posts and left without filling in a form. LeadJaw captures them all.
 
= 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. Company-level identification does not require cookies. The personalisation feature is also cookieless. Some optional features such as session continuity may use a first-party cookie where permitted. All data is processed in compliance with GDPR.
 
= Getting started =
 
1. Search for LeadJaw in the WordPress plugin directory and click Install, or upload the leadjaw folder to /wp-content/plugins/ via FTP
2. Activate the plugin from the Plugins screen in WordPress
3. Create your free LeadJaw account at https://app.leadjaw.com/register if you do not have one yet
4. Go to LeadJaw > Settings in your WordPress admin
5. Enter your Tracking ID and Account Token from your LeadJaw account settings page
6. Save settings - tracking goes live immediately
 
Your first identified companies will appear within a few hours of real traffic. 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 ==
 
Search for LeadJaw in the WordPress plugin directory and click Install, or upload the leadjaw folder to /wp-content/plugins/ via FTP. Activate the plugin, then go to LeadJaw > Settings and enter your Tracking ID and Account Token. Full setup instructions are in the Getting started section above.
 
== 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, if available, 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.
 
= Can I show different content to different types of visitor? =
 
Yes. This is the core personalisation feature. Add a data-lj-show-for attribute to any HTML element with the industry name you want to target. Visitors whose company matches that industry see the block. Everyone else sees your default content. The plugin settings page lists every industry detected from your real traffic so you can copy the exact names to use.
 
= What industries can I personalise content for? =
 
Any industry that LeadJaw identifies from your traffic. Common examples include legal services, financial services, construction, technology, healthcare, manufacturing and marketing. The exact list depends on which types of companies visit your site. Your plugin settings page shows the full list pulled from your own visitor data.
 
= Does personalisation work without a cookie consent banner? =
 
Yes. Industry identification is server-side and does not use cookies or store data in the visitor's browser, so it is not subject to cookie consent requirements. Some optional LeadJaw features such as session continuity may use a first-party cookie, but the personalisation lookup itself does not. If you want to gate personalisation behind a consent banner anyway, add the data-lj-consent-only attribute to any block and it will only activate after consent is given.
 
= Can I use personalisation with Gutenberg or the classic editor? =
 
Yes. Use the shortcode [leadjaw_stat type="industry"] in any block, widget or classic editor area. For direct HTML control, add the data-lj-show-for attribute to any HTML block in Gutenberg or any custom HTML section.
 
= How is this different from other personalisation plugins? =
 
Most personalisation plugins require you to know who your visitor is before you can target them - usually through a login, a form fill or a cookie. LeadJaw identifies the company behind the visit automatically using IP matching, so personalisation works from the very first page view, even for anonymous visitors who have never interacted with your site before.
 
= Will personalisation slow my site down? =
 
No. The industry lookup is a lightweight server-side call that runs in parallel with your page load. There is no client-side delay and no render-blocking requests.
 
== 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.1 =
* readme update - improved description, tags and FAQ to better reflect personalisation and dynamic content features
 
= 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