Skip to main content
ModdedMana channel avatar
ModdedMana Cozy & horror gaming, mods and tools from Mana.

Manalytics

Self-hosted, cookie-free website analytics in plain PHP & MySQL — your data stays on your own server.

One installation tracks one website · v1.0.0 · free to install and use under the Manalytics Licence.

Screenshots

Overview dashboardScreenshot placeholder — stat cards, daily views/uniques chart, popular pages & referrers with real data
Date ranges & breakdownsScreenshot placeholder — the range picker and a browser/OS/device table
API keysScreenshot placeholder — scoped keys, shown once, revocable
Exports / WordPress pluginScreenshot placeholder — CSV & JSON export options, or the plugin's Analytics settings

Manalytics answers the core traffic questions — which pages are viewed, how many visits arrive each day, where traffic comes from, which browsers and devices are used, and which custom events occur — while the data stays in your own database, on your own server.

How it works

A small tracker script served by your own installation records page views and custom events. A cron job aggregates them into daily statistics, and the authenticated dashboard reports totals, estimated unique visitors, a daily traffic chart, popular pages, referrers, browser and operating-system breakdowns, device types, screen-width ranges and custom events. A versioned JSON API and CSV/JSON exports expose the same data for integrations and further analysis. One installation tracks one website; separate sites run separate installations.

Deliberately minimal collection

The tracker sets no cookies, no IP addresses are stored in the analytics pipeline, and there are no persistent cross-day visitor profiles. Unique-visitor estimates use a pseudonymous identifier that rotates every day, and can be switched off entirely. Do Not Track and Global Privacy Control are respected by default, site owners can exclude their own visits, and raw-data retention is configurable.

Built to run anywhere PHP does

Plain PHP with MySQL or MariaDB: no framework, Composer dependency, build step, daemon, Redis or third-party runtime library. The included installer creates the schema and administrator account, then locks itself. Conventional shared hosting can run it, and an optional WordPress plugin adds the tracker to a WordPress site without making WordPress a requirement.

Download

Version 1.0.0 · PHP 8.2+ with MySQL 8.0+/MariaDB 10.6+ · free to install and use under the Manalytics Licence. Download links will go live here when the artifacts are published.

Manalytics application — v1.0.0 self-hosted install

Upload, point your document root at public/, run the installer, set up cron. Full steps in the installation section below.

WordPress plugin — optional GPL-2.0-or-later

Adds the tracker to a WordPress site automatically. Not required to use Manalytics.

Requirements: PHP 8.2+ with the pdo_mysql, mbstring and json extensions, MySQL 8.0+ or MariaDB 10.6+ (InnoDB, utf8mb4), HTTPS strongly recommended, and cron for reports. See the table below for details.

Features

Dashboard

  • Page views, unique estimates, custom events and daily average
  • Daily views and uniques chart (server-rendered SVG, no charting library)
  • Popular pages, referrers and Direct traffic
  • Browser, operating-system, device and screen-width tables
  • Custom-event table with unique estimates and share
  • 7/30/90/365-day, all-time and custom date ranges
  • Freshness, stale and incomplete-data indicators
  • API key management, exports, settings, password change and in-app docs

API & integrations

  • Versioned JSON API v1 with scoped bearer keys (read / collect)
  • Totals, daily series, popular pages, referrers, browsers, OS, devices, widths, events
  • CSV/JSON exports from the dashboard and the API
  • Authenticated server-side ingestion for integrations
  • Optional WordPress tracker plugin (GPL-2.0-or-later)

Privacy controls

  • No analytics cookies; no third-party tracking script
  • No stored IP addresses in the analytics pipeline
  • No persistent cross-day visitor profiles; daily pseudonymous estimates, optional and switchable
  • Configurable query-parameter stripping and exclusions
  • DNT and GPC respected by default
  • Configurable raw-data retention
  • WordPress role exclusions when the optional plugin is used

Under the hood

  • Plain PHP — no framework, Composer, build step, daemon or Redis
  • Prepared statements, CSRF protection, strict security headers
  • API keys generated with random_bytes(), stored only as SHA-256 hashes, revocable
  • Idempotent transactional aggregation guarded by a database advisory lock
  • CLI cron plus a keyed web-cron for hosts without shell access
  • Backup and restore runbook covering the database and src/config.php

Requirements

RequirementNotes
PHP8.2 or newerNeeds the pdo_mysql, mbstring and json extensions
DatabaseMySQL 8.0+ / MariaDB 10.6+InnoDB, utf8mb4
Web serverApache, LiteSpeed, nginx or PHP built-inNo URL rewrite rules required; public/ is the recommended document root
CronRequiredCollection is immediate, but reports read daily aggregates; CLI or keyed web-cron
HTTPSStrongly recommended
ExtrasNoneNo Composer, framework, build step, Redis or runtime JavaScript framework

One installation tracks one website — separate sites need separate installations. Each installation has its own database, configuration file and administrator account.

Privacy

Manalytics is designed to reduce the data a site collects for analytics. The tracker sets no cookies, stores no IP addresses and creates no persistent cross-day visitor profiles. Visitor estimates use a pseudonymous identifier that changes every day. Site owners can disable visitor counting, strip query strings, respect Do Not Track and Global Privacy Control, exclude their own visits and set retention periods for raw data.

This is a privacy-conscious design, not a compliance certification. Manalytics does not claim GDPR or other certification, does not include a consent banner, and page titles, referrers and custom event properties are supplied by the site — the site owner remains responsible for notices, consent and retention choices.

Licence

Manalytics is free to install and use for any purpose — personal, organisational and commercial — and you may modify it and build upon it. You may also run it, including a modified version, to provide a service to others (including hosted or network-accessible services) without distributing the software itself.
If you run it as a hosted or network-accessible service, include a reasonably visible attribution to your users — an About page or documentation is sufficient: “This service uses Manalytics — © 2026 Mana — moddedmana.com/manalytics”.
Redistribution of the application or modified versions — publishing, sublicensing or selling it to third parties — requires prior written permission ([email protected]). Independently developed extensions, themes, integrations and add-ons may be created and distributed freely, provided they do not contain the Manalytics software.

The optional WordPress plugin is licensed separately under GPL-2.0-or-later. Your analytics data, site content, configuration and exports are yours; the licence makes no claim on your data.

This section is a plain-language summary, not the full legal text — the complete licence ships with every release and that full text is the version that governs.

FAQ

Is Manalytics free?

Yes. The application may be installed and used free of charge for personal, organisational and commercial use under the Manalytics Licence. Redistribution of the application or modified versions requires prior written permission.

Is it open source?

The application is source-available under a custom licence, not open source. The optional WordPress plugin is licensed separately under GPL-2.0-or-later.

Does it use cookies?

No. The tracker sets no cookies. It uses sessionStorage to avoid duplicate sends within a short window and localStorage for a voluntary site-owner exclusion flag.

Does it store IP addresses?

The analytics pipeline does not store IP addresses. The IP is read in memory for local-address and ignore-list checks, and is truncated and hashed only when visitor counting is enabled. Login throttling stores a keyed IP hash for up to 24 hours, never the raw address.

Are visitors completely anonymous?

No. Visitor estimates use a pseudonymous identifier that is stable within a day and stored with behavioural metadata for that day. It changes daily and cannot be linked across days by the application, but it is not accurate to call the result completely anonymous.

Can I disable unique visitor counting?

Yes. With visitor counting off, no visitor identifier is derived, unique values are reported as unavailable, and page views and events are still counted.

Do I need WordPress?

No. Manalytics works independently of WordPress. The WordPress plugin is optional.

What hosting do I need?

PHP 8.2+ with the pdo_mysql, mbstring and json extensions, plus MySQL 8.0+ or MariaDB 10.6+. Conventional shared hosting can work. HTTPS is strongly recommended.

Do I need cron?

Yes for reports. Collection is immediate, but the dashboard reads daily aggregates produced by cron. Run it every few minutes. A keyed web-cron URL is available if the host does not provide shell access.

Is it real-time?

Not in the usual sense. Hits are collected immediately, but reports read daily aggregates. Today is provisional and refreshed on each cron run. The dashboard warns when aggregation is stale.

Can I track multiple websites in one installation?

No. One installation tracks one website. Separate websites require separate installations.

Can I export my data?

Yes. CSV and JSON exports are available for daily totals, popular pages, referrers, raw events and raw page views. Raw datasets contain only rows still retained by the retention policy.

Does it import data from Google Analytics?

No. v1.0.0 does not include an importer for other analytics platforms.

Does it block all bots?

No. It applies a configurable User-Agent bot filter and browser-side checks for common automation and prerendering cases. Bot filtering is heuristic and cannot catch every automated client.

Does it include a consent banner?

No. Manalytics is designed to reduce data collection, but it does not provide a consent-management banner and does not determine whether a site needs one. That is the site owner's responsibility.

Is it GDPR compliant?

Manalytics does not claim GDPR or other compliance certification. Compliance depends on how the site is configured, what it sends, its legal basis and its jurisdiction.

How large a site can it handle?

The v1.0.0 benchmark aggregated a seeded 100,000-page-view day in 2.16 seconds in a single-process test. Report endpoints answered in 9–88 ms, a 30-day dashboard rendered in 13 ms and a 100,000-row CSV export streamed in 1.79 seconds. That is an order-of-magnitude measurement, not a concurrent-load test or a guarantee for other environments.

Does the WordPress plugin work on multisite?

The plugin is designed for a single WordPress site and has not been tested on a multisite network.

What happens if the analytics server is unavailable?

On WordPress, the tracker script simply fails to load and the WordPress site is unaffected. Page views during the outage are not recorded. The plugin makes no server-side requests to Manalytics.

How do I back it up?

Back up both the database and src/config.php. CSV/JSON exports are not backups. The full procedure, including restore and rollback, is in the included docs/BACKUP.md.