=== PulseIQ - Plain English Website Analytics & Weekly AI Reports ===
Contributors: blankcanvasdigital
Tags: analytics, reports, statistics, uptime, ai
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.1.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Your website's weekly AI coach - tracks visitors anonymously and emails you a plain-English report on what to fix.

== Description ==

**Analytics you can actually understand.**

Most website statistics tools show you charts and leave you to work out what they
mean. PulseIQ does the opposite. It watches how real people use your website,
then emails you a short report in plain English: what happened, what it means,
and exactly what to fix.

No jargon. No dashboards to learn. Just clear advice, written for business
owners rather than marketers.

**A real example of what a report says:**

> "47 people visited your contact page but only 3 got in touch. Most left after
> 8 seconds. Your contact form has 9 fields - that's too many. Cut it to Name,
> Email and Message."

= Why people use PulseIQ =

* **It explains, rather than just measures.** Every issue comes with one
  concrete thing to do about it.
* **Cookie-free and privacy-friendly.** No cookies are set on your visitors, and
  no names, emails or personal details are ever collected. That means no cookie
  banner needed for PulseIQ, and a simpler GDPR position.
* **Set up in two minutes.** Install, confirm your email, done. The plugin
  connects your site and installs the tracking for you - there is no code to
  paste and nothing to configure.
* **Built for small businesses.** Trades, clinics, salons, therapists,
  consultants - anyone who has a website but no time to learn analytics.

= What it tracks =

* Pages viewed, and the journey people take through your site
* Clicks on phone numbers, email links and buttons - the things that turn into
  real enquiries
* How far down your pages people actually read
* Whether visitors are on a phone, tablet or computer
* Whether your site is up or down (paid plans)

= Free and paid plans =

The free plan gives you visitor tracking, a monthly plain-English report with
one priority action, and access to your dashboard - free forever, no card
needed.

Paid plans (from a few pounds a month) add weekly reports, three ranked action
items, uptime monitoring with instant alerts if your site goes down, and "Ask
PulseIQ", an AI chat that answers questions about your own site's data.

Full pricing is at [trypulseiq.co.uk](https://trypulseiq.co.uk).

== Installation ==

1. Install the plugin through **Plugins > Add New**, or upload the plugin folder
   to `/wp-content/plugins/`.
2. Activate PulseIQ through the **Plugins** menu.
3. Go to the **PulseIQ** menu in your WordPress admin.
4. Confirm the email address that should receive your reports and dashboard
   access, then click **Connect this site to PulseIQ**.

That's it. Tracking starts immediately, and your first report follows once
enough visits have been recorded.

To view your dashboard at any time, use the button on the PulseIQ admin page, or
go to [app.trypulseiq.co.uk](https://app.trypulseiq.co.uk) and sign in with the
email you confirmed. There is no password - you receive a secure sign-in link by
email.

== Frequently Asked Questions ==

= Do I need a PulseIQ account before installing? =

No. The plugin creates your account when you confirm your email during setup.

= Does this replace Google Analytics? =

They do different jobs. Google Analytics gives you raw numbers; PulseIQ tells
you what those numbers mean and what to do about them. You can run both, but if
you have never found Google Analytics useful because it feels too complicated,
PulseIQ works perfectly well on its own.

= Is it GDPR friendly? =

PulseIQ is designed to be. It sets no cookies on your visitors' browsers,
collects no names, emails or other personal information, and uses anonymous
session identifiers only. It also respects the browser "Do Not Track" setting.
You should still describe your use of analytics in your own privacy policy.

= Will it slow my site down? =

No. The tracking script is very small and loads after your page has rendered, so
visitors see your content first.

= What if my site does not get much traffic? =

PulseIQ still helps. Even with a handful of visitors a week it can spot
structural problems - a form nobody completes, a phone number that is not
tappable on mobile, a page people leave immediately - that affect every visitor
regardless of how many there are.

= Which email do the reports go to? =

Whichever address you confirm during setup. It is pre-filled with your WordPress
admin email, but you can change it - useful if the site owner is not the person
who administers WordPress.

= What happens if I deactivate the plugin? =

Tracking stops and no further data is collected. Your existing reports remain
available in your dashboard.

== Screenshots ==

1. PulseIQ in your WordPress admin - connected, with a link straight to your dashboard.
2. Your weekly report email - plain English, with ranked things to fix.
3. Your dashboard - what happened on your site this week, in numbers.
4. What is working, what to look at, and Ask PulseIQ.

== External services ==

This plugin connects to PulseIQ, an external analytics service operated by Blank
Canvas Digital (https://trypulseiq.co.uk), to register your site and collect
anonymous visitor analytics. The plugin cannot function without it.

**What is sent, and when:**

* **On setup:** when you click "Connect this site to PulseIQ", your site's URL
  and the email address you confirm are sent to
  `https://pulseiq-backend-production.up.railway.app/register` in order to
  create your PulseIQ account. Nothing is sent before you confirm.
* **On every front-end page view:** once connected, a tracking script is loaded
  from `https://pulseiq-backend-production.up.railway.app/pixel.js`. It records
  anonymous page views, clicks and scroll depth, along with your site's
  identifier. No cookies are set and no personally identifiable information
  about visitors is collected.

Service terms: https://trypulseiq.co.uk/terms.html
Privacy policy: https://trypulseiq.co.uk/privacy.html

== Privacy ==

PulseIQ does not collect names, email addresses or any personally identifiable
information about your website's visitors. It uses anonymous, per-session
identifiers only, sets no cookies, and honours the "Do Not Track" browser
setting. The only personal data associated with your account is the email
address you provide, which is used to send your reports and to sign you in.

== Changelog ==

= 1.1.4 =
* Plugin slug and text domain changed to pulseiq-website-analytics, per WordPress.org review feedback. No change to functionality.

= 1.1.3 =
* Corrected the plugin and author URLs in the plugin header.

= 1.1.2 =
* The setup reminder now clears as soon as a site connects.

= 1.1.1 =
* Tracking script now loaded via wp_enqueue_script, and output escaping
  tightened, to meet WordPress.org coding standards.

= 1.1.0 =
* Setup now asks the owner to confirm which email receives reports and dashboard
  access, instead of assuming the WordPress admin email.

= 1.0.0 =
* First release: automatic site registration, tracking, and admin dashboard link.

== Upgrade Notice ==

= 1.1.4 =
Plugin slug changed to pulseiq-website-analytics. No change to how tracking works.

= 1.1.3 =
Header correction only. No change to how tracking works.
