=== Pagereckon: Cookie-Free Analytics & AI Traffic ===
Contributors: pagereckon
Tags: analytics, statistics, ai crawlers, privacy, server log
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Real visitors, AI crawlers and visits from ChatGPT and Perplexity, read from your server log. No cookies, no tracker, no consent banner.

== Description ==

Pagereckon reads the access log your web server already writes and turns it into a clear dashboard inside WordPress. Because it does not depend on a JavaScript tracker, ad blockers do not hide your visitors, and there are no cookies to ask consent for.

**What you see**

* **Humans vs bots.** Every request is sorted: known bots by user agent, scanners by the paths they probe, disguised bots by behaviour (outdated browsers, bursts, HEAD requests, pages opened without loading CSS or images). Only people who pass are counted as visitors.
* **AI crawlers.** GPTBot, ClaudeBot, PerplexityBot, OAI-SearchBot, Google-Extended, Bytespider, Meta and more: how many pages each one reads, and which pages. Split into training crawls, AI search indexes and live reads (ChatGPT-User, Claude-User, Perplexity-User) that happen because a person asked an assistant about your page.
* **AI referral traffic.** Visits that arrive from chatgpt.com, perplexity.ai, gemini.google.com, copilot and claude.ai, including links that carry `utm_source=chatgpt.com`. No GA4 setup needed.
* **Sources.** Google, Bing, DuckDuckGo, AI assistants, social networks, newsletters and direct visits, with the exact source name.
* **Pages, countries, cities, devices, browser language.** A city map from the free DB-IP Lite database.
* **Live.** Who is on the site in the last 5 and 30 minutes, read straight from the end of the log.
* **Page panel.** An admin bar panel on every page of your site with the last 24 hours for that page.
* **Google watch.** Googlebot crawls per page, and whether Google crawled a page after you edited it.
* **Affiliate clicks.** Clicks on redirect links (/go/, /recommends/, Pretty Links, ThirstyAffiliates) per page, source and link.

**Privacy by design**

* Pagereckon's database never stores IP addresses. A visitor is a salted hash of IP and browser; a strict mode changes the salt every day. (In PHP request log mode, the request files hold IPs for 3 days, like a server log, and are then deleted.)
* History is deleted after the number of days you choose (90 by default).
* Nothing leaves your server. Pagereckon does not send your data anywhere.

**Works on most hosting**

The "Find my log" wizard checks the usual places for cPanel, Plesk, CWP, DirectAdmin, Apache, Nginx and LiteSpeed, and tests each file it finds. It reads the combined and common formats and JSON lines, several files at once and rotated .gz copies. When your host hides the server log, Pagereckon can write its own request log from PHP instead (less complete: pages served from a page cache are missing, and the settings page says so).

**Pagereckon Pro (optional add-on)**

Pro connects Google Search Console and Bing Webmaster Tools and answers the next question: which pages should you fix, and did the fix work? It lists pages with many impressions and too few clicks, lets you mark a page as fine-tuned with a control date, and on that date compares the 28 days before and after. It suggests and measures; it never rewrites your content. Pro is a separate plugin, available at [pagereckon.com](https://pagereckon.com/).

== Installation ==

1. Install and activate Pagereckon.
2. Open **Pagereckon → Settings**. The "Find my log" table lists the access logs PHP can read; press **Use this log** next to the one for your site.
3. Optional: press **Download DB-IP City Lite now** for countries, cities and the map.
4. The log is processed every 10 minutes by WordPress cron. A server cron is faster and lighter:
   `*/5 * * * * wp --path=/path/to/site pagereckon ingest --max-seconds=240`

== Frequently Asked Questions ==

= Do I need a cookie banner for Pagereckon? =

No. Pagereckon sets no cookies and stores no IP addresses. It reads the server log, which your host keeps anyway. Check your own legal situation, but there is nothing for a visitor to consent to.

= Where is my access log? =

Run **Find my log** in Settings. On cPanel and CWP it is usually `/usr/local/apache/domlogs/<domain>` or `~/access-logs/<domain>`, on Plesk `/var/www/vhosts/<domain>/logs/access_ssl_log`, on Nginx `/var/log/nginx/access.log`. If PHP cannot read it, ask your host to give the web server user read access, or use the PHP request log.

= How do I see AI referral traffic without GA4? =

Open the Humans tab and pick the AI source group, or the Insights tab. Visits from chatgpt.com, perplexity.ai, gemini.google.com, copilot.microsoft.com and claude.ai are counted from the referer and from the `utm_source` parameter assistants add to links.

= Why are my numbers lower than Google Analytics? =

Usually they are higher, because ad blockers do not hide log lines. They are lower when many "visitors" were bots that GA counted, or when you use the PHP request log behind a page cache.

= Does it slow my site down? =

No. Visitors only load a 42-byte image once per session (it proves a real browser). The log is processed in the background in small steps.

= Can it block bad bots? =

Pagereckon Free shows which bots are suspicious. One-click blocking (.htaccess section or an Nginx snippet) is part of Pro.

== Screenshots ==

1. Humans: visitors, sources and the live list.
2. AI crawlers and the pages they read.
3. AI referral traffic: people sent by ChatGPT, Perplexity and Gemini.
4. Find my log: the wizard that finds and tests your access log.
5. The page panel in the admin bar.

== Changelog ==

= 1.0.0 =
* First public release.

== Third-party data ==

IP geolocation by [DB-IP](https://db-ip.com), licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). The database is downloaded from download.db-ip.com only when you press the download button in Settings or once a month after that.
