PinnacleQuant.com Analytics – Live Visitors, Visitor Tracking & Real-Time Stats

PinnacleQuant.com Analytics shows you, in real time, the people on your site, one row per visitor, as they arrive, with the traffic source of every visit. It is self-hosted visitor tracking: everything stays in your own WordPress database, with no account and no outside service. Open source, GPL. For each visitor you see:

• Whether they are on the site right now
• IP address
• City, state and country
• ISP or organization
• New or returning, with the visit number and first-seen date
• Where they came from: Google, Bing, social networks, AI assistants, ads (click IDs), UTM campaigns, or another site
• The page they are reading now and every page they read, with time on each
• Screen type and resolution, browser and operating system
• One-click Block from site for any address

Plus totals for today, yesterday, 7 days and 30 days, the bounce rate, a by-hour table for today, a 30-day table, a screen size breakdown, a dashboard widget, a search box and a CSV export. Email report Have a short report emailed to you every day or every week, at the time you pick: visitors, page views, returning visitors, bounce rate, average visit, bots, where visitors came from, the most read pages, locations and screens, each next to the day or week before. Turn it on under Settings, where a button sends you a sample right away. Traffic flow The Traffic flow page shows, for today, yesterday, or the last 7, 30 or 90 days: entry pages, exit pages, what visitors opened right after any page you pick (and right before it), the most common paths through the site, and every page with views, visits, time on page, entries and exits. The Visitors page lists the pages of each visit in the row, with a green mark on the page the visitor is reading right now, refreshed every 15 seconds. The CSV export includes the page path of every visit. Everything stays on your site

• No account, no key, no analytics service.
• Visitor details are written to tables in your own WordPress database and nowhere else.
• City, state and ISP are looked up on your own server from two free database files (from db-ip.com) that you download into your uploads folder with one click on the Visitors or Settings page; after that click, the plugin fetches a fresh copy once a month.
• Nothing in your visitors' browsers contacts any other server. The small script on your pages talks only to your site.
• Old visits are removed automatically after the number of days you choose (90 by default).

Free live chat The Live Chat page in the plugin menu explains how to add the free chat add-on so you can talk with the people on your site in real time. When you are not available to chat, the widget takes their name, email, phone and a brief message and emails it to you. The add-on is downloaded from https://pinnaclequant.com/analytics-systems and needs a free key, requested by email. Bots Crawlers that reach PHP are counted separately and never mixed into your visitor totals. Pages served from a cache or CDN are not seen, so bot counts are indicative only. Location data from DB-IP The city, state, country and ISP of a visitor are looked up on your own server, using two free database files published by DB-IP (https://db-ip.com): IP to City Lite and IP to ASN Lite. Nothing is downloaded until you click Download the location files on the Visitors page, or Download on the Settings page. From that click on, the plugin fetches the files from https://download.db-ip.com/free/ into your uploads folder and downloads a fresh copy once a month. Only the download request reaches DB-IP; it carries no information about your visitors, and no visitor data is ever sent to DB-IP or anyone else. Without the files, the plugin works the same, with city, state and ISP left blank. The files are provided under the Creative Commons Attribution 4.0 license, which is why the plugin pages show the line "IP geolocation by DB-IP". DB-IP terms of use: https://db-ip.com/tos.php. DB-IP privacy policy: https://db-ip.com/privacy.php. Included library The plugin includes the MaxMind DB Reader for PHP (https://github.com/maxmind/MaxMind-DB-Reader-php), Apache License 2.0, to read the database files. It is used as is.

1.8.1

• Past visits: a returning visitor's row now has a Past visits button. It opens the pages this visitor opens most, with how many of their visits included each page, and then every visit kept in the retention period, newest first, with its date, length, source and the pages read in order.
• Fewer database writes on every page view and heartbeat: the plugin no longer keeps a request counter in the WordPress options table. Instead, each address can start at most 120 visits a minute, each visit keeps at most 60 pages a minute and 500 pages in all, and a page reports at most once every 3 seconds.
• A visitor who stays on the site for a long time is no longer dropped from the Visitors page for a minute at a time.
• The daily cleanup removes old visits in groups of 2,000 rows, so a large site is not held up while it runs, and it no longer re-reads the whole page-view table. When there is more to remove than fits in 20 seconds, it continues 5 minutes later.
• The daily cleanup also removes visitor records that have no visit left in the retention period, unless they carry a name, email, phone, note or label.
• The Visitors page refreshes its three charts (today by hour, last 30 days, screens) every 5 minutes instead of every 15 seconds. The cards, the rows and the green marks still refresh every 15 seconds.

1.7.8

• Traffic flow page: the Entry pages and Exit pages tables, and the two tables under Where visitors go next, now share the full width instead of leaving a third of it empty.

1.7.7

• Lighter page views: the list of blocked addresses is prepared when the plugin is activated or updated, not during a visitor's page view.
• The plugin's admin stylesheet loads only on its own pages and on the Dashboard, where its widget is.

1.7.5

• Plugin header links updated.

1.7.3

• Visitor IP address: in Automatic mode the Cloudflare header is used only when the request comes from Cloudflare's own addresses, and the proxy headers only when the request comes from a proxy on the site's own network; when a proxy header lists several addresses, the one added by the proxy is used. A visitor can no longer pretend to be another address.
• The per-address request limit keeps its counters in a fixed number of slots, so it cannot grow with the number of addresses.
• Works on WordPress Playground and other SQLite-backed installs: the queries behind the by-hour and 30-day tables, the bounce rate, the CSV export and the daily cleanup use only portable SQL.

1.7.2

• Settings page: the help line under a field no longer overlaps the field, and the Email report heading has room above it.

1.7.1

• Email report: under Settings, choose every day or every week, the time, the day for the weekly report and the address. Every day covers yesterday, every week the last 7 days, each number next to the day or week before, with the dates in the heading. A Send me a sample now button sends one right away.
• Bounce rate: the share of visits that viewed one page and left within 10 seconds. A card on the Visitors page (last 30 days, with today and 7 days underneath), the Traffic flow card formerly called Left after one page, and a line in the email report.
• Time zone setting: every time in the plugin, the day totals and the email report follow the time zone you pick under Settings; it starts out as the WordPress setting.
• A tab that reports again after more than 30 minutes starts a new visit instead of stretching the old one.
• Times in the Visitors table use one clock style, with AM and PM, in every column.

1.6.0

• Note box under the Chat and Block from site buttons on every visitor row: a few words that stay with that visitor and show on every later visit, in the search box and in the CSV export.
• The Live Chat add-on (1.4 or later) sends its check-in with the Analytics page signal instead of separately, so an idle visitor costs one request per interval instead of three or more.
• The monthly refresh of the location files stays on when the plugin is deactivated and activated again with the files already installed.

1.5.3

• The location files are no longer fetched by themselves after activation. Click Download the location files on the Visitors page (or Download on the Settings page) and the plugin fetches them, then keeps them fresh once a month. Sites that already have the files keep working as before.
• Table names are passed to the database through placeholders in every query.
• The Visitors page tells administrators, in one line, that the location files are not there yet, with the button right there.
• Requires WordPress 6.2 or newer.

1.5.2

• Every name the plugin uses in your database now starts with pqanalytics instead of pqa, so it cannot collide with another plugin. Existing tables, settings, blocked addresses and location files are carried over by themselves on update; nothing to redo. Only the plugin's own four tables and its own options are touched.
• Location files are moved into place with the WordPress file system class.
• The Visitors, Traffic flow and Settings pages now work on sites with plain permalinks (the address of the plugin's own data requests was built wrongly there).
• The location file reader library is updated to its current release.
• Readme: how the DB-IP location files are obtained, and the included library.

1.4.11

• Came from also recognizes Snapchat Ads, Taboola and Outbrain clicks, and the second ChatGPT ad parameter.
• Screen sizes are exact again for phones with a fractional pixel ratio (1080 x 2340 instead of 1079 x 2338).
• Wording on the Live Chat page and in the thank-you line.

1.4.10

• Visits from ChatGPT ads (the oppref click parameter) show as ChatGPT Ads, paid, in Came from.
• Visitors table: the Chat and Block from site buttons sit under the IP address, so every column fits on a laptop screen with nothing hidden, and long page paths wrap instead of being cut.

1.4.9

• The home page is listed by its domain name (yoursite.com) instead of a bare slash in Pages this visit and in the full page list.

1.4.8

• Reworded the paragraph the plugin suggests for your privacy policy (Settings, Privacy, Policy Guide).

1.4.7

• Visitors table: the Chat and Block buttons stay in view on the right while the rest of the table scrolls sideways, on a phone as much as on a narrow window. Pages this visit shows the page path without its tracking parameters (the full address is in the link).

1.4.6

• A page loaded again within a minute and a half of the last time it was on the visitor's screen (a refresh, or the browser reloading it) now stays one line in Pages this visit, with the time on page adding up, instead of a new line and a new page view.

1.4.5

• Settings: "Let Editors see the Visitors and Traffic flow pages too". Blocking, the CSV export and the Settings page stay with Administrators.

1.4.4

• When logged-in users are counted, a member's visit shows their first and last name in the Visitor column (never the login name or email; a member without a name shows as Member #ID). The name is also in the CSV export and in the search box.

1.4.2

• Hosting resources: a setting for how often an open page reports, 10 to 120 seconds.

1.4.1

• A note under the cards explains that logged-in users are left out, so you do not count yourself while logged in.

1.4.0

• New look: rounded cards, small bar charts in the cards for today, 7 days, 30 days and bots, and bars behind the numbers in every table.

1.3.0

• The location files download by themselves after activation.
• Visitors page: the pages of each visit are listed in the row, with a green mark on the current page and a link to the full list.
• Traffic flow page: plainer labels.
• Live visitors are shared with the Live Chat add-on for its "On the site now" list.
• Suggested privacy policy wording under Settings, Privacy.

1.2.0

• Traffic flow page: entry pages, exit pages, next pages from any page, common paths, all pages with time on page.
• The page path of each visit is included in the CSV export.
• Visits that move between pages without a full reload are counted.
• The open page path on the Visitors page refreshes with the rest of the page.

1.1.0

• Free DB-IP databases only; no account needed.
• Visitor name, email and phone columns, filled in by the chat add-on.
• Live Chat page with the steps to add the free chat.
• Clearer wording throughout.

1.0.0

• First release.