Changelog

What changed in each version of Mini Metrics. To update, follow the upgrade guide.

Version 1.1.0

Released 2026-11-11

  • The dashboard now shows the Mini Metrics version in its footer, next to a Get help link to the documentation.
  • Date presets: Today, Yesterday, Last 7 Days, Last 30 Days, This Month, Last Month and Last 12 Months, one click each.
  • Click a page, country, city or referrer in the top lists to show only that one.
  • For a date range, Total Pageviews and Unique Visitors show the change against the previous period of the same length (for example "↑ 12% vs previous 7 days").
  • Bots, crawlers, uptime monitors and scripts are no longer counted.
  • More reliable tracking: page views are now saved before the location lookup, and the lookup happens after the response is sent, so a slow or unreachable location service can no longer delay or lose a page view. Uses curl when available, so locations also work on hosts that disable allow_url_fopen.
  • No more lost page views when several arrive at once: Mini Metrics now waits briefly for a busy database instead of failing right away.
  • The tracking script sends page views with sendBeacon as a simple request, so there's no extra preflight (OPTIONS) request that some hosts and firewalls block, and page views still go out while a page is closing. It also finds its own address when track.js is renamed.
  • Going back or forward to a page the browser kept in memory now counts as a page view. Pages the browser loads ahead of time (prerendering) are only counted when someone actually opens them.
  • Tracking errors no longer show PHP error messages; they go to the server's error log.
  • /about/ and /about now count as the same page (existing data is merged automatically on the first dashboard visit).
  • Always clear what you're looking at. The header shows the selected site ("All sites (3)" or one domain) and the period at all times, and a sentence above the numbers spells it out, for example "All 3 sites combined, last 30 days (Oct 13 – Nov 11), compared with Sep 13 – Oct 12". Active filters show as chips with Clear filters, and "No filters, every pageview counts" when there are none. Add filter opens the filter search directly.
  • Switching sites keeps your period and filters.
  • Fixed: without a chosen period, the totals counted all stored data while the dashboard said "Last 30 Days". The numbers, chart and lists now all cover the same period, and the change against the previous period is shown by default.
  • New "Views per visitor" number, with its change against the previous period. Each number explains itself on hover.
  • The chart shows the previous period as a dashed grey line, with a legend naming both date ranges; hovering shows both days side by side.
  • The top lists show each row's share of all page views. With All sites, Pages and Recent activity show the domain of each page, so "/" of different sites is no longer merged into one row.
  • Empty lists now say when your period or filters are the reason, instead of "No data yet".
  • The "Add a filter" suggestions only list pages, countries, cities and referrers of the selected site.
  • The footer names the time zone used for dates and times.
  • A cleaner, calmer dashboard. The period, custom date range, filter search and CSV download live in one tidy panel under the period button: presets in a list with a check mark on the one in use, the custom range and filter search next to it, and Download CSV at the bottom. The period you're looking at and your active filters are shown above the stats, the numbers and the chart sit together, and each row in the top lists shows a light bar for its share. The login page and dialogs got the same treatment.
  • After an upgrade you always get the new styles and scripts: their links now carry a version stamp, so browsers and CDNs (like Cloudflare) can't serve old cached copies.
  • The new Mini Metrics logo.
  • Location lookups are now cached in the database instead of a cache/ folder with one file per visitor IP. Expired entries are removed automatically, so the cache no longer grows without limit.
  • Visitor IP addresses taken from request headers are validated before use.
  • Private and reserved IP addresses no longer trigger a location lookup.
  • Locations now come from the free GeoJS service (get.geojs.io) instead of geoip.st. Your server needs outgoing HTTPS access to get.geojs.io; nothing to change in config.php, and existing location data stays as it is.
  • Everything the dashboard needs now ships in the new assets/ folder: no more loading styles and scripts from external CDNs. The stylesheet is generated with only the styles the dashboard uses (about 27 KB instead of the 400 KB in-browser Tailwind compiler). Bundled: Alpine.js 3.17.5, Chart.js 4.6.1, Tom Select 2.7.0; licenses are in assets/THIRD-PARTY-LICENSES.txt.
  • Design fixes: the site picker's dropdown arrow is properly spaced, and header buttons, filter fields and buttons line up at the same height. The filter search now matches the date fields. City names no longer show a stray space before the comma, and long country names truncate like the other lists. The setup guide's Copy code button sits in a bar above the tracking script instead of on top of it, and the script wraps so all of it is visible. Long filter values, locations in Recent activity and domain names are shortened with an ellipsis instead of pushing other things out of place.
  • The pageviews chart keeps a usable height on phones and shows dates as "Nov 11" instead of "2026-11-11".
  • Recent Activity no longer flashes open while the page loads; changing the site keeps working with special characters.
  • Accessibility: form fields have proper labels, icon buttons have names, dialogs close with Escape, keyboard focus is visible everywhere, and animations respect the "reduce motion" setting.
  • Stronger login protection against password guessing and bots:
    • The login limit can no longer be bypassed with forged X-Forwarded-For or CF-Connecting-IP headers. It uses the address your web server sees (REMOTE_ADDR), and Cloudflare's header only when the request really comes from Cloudflare. Behind your own reverse proxy or load balancer, let the web server pass the real visitor IP (Apache mod_remoteip, Nginx real_ip).
    • Repeat offenders wait longer: 5 wrong passwords lock that IP for 15 minutes, the next 5 for 1 hour, then 4 hours, up to 24 hours.
    • Many guesses sent at the same moment are now counted correctly.
    • The login form carries a one-time token and ignores submissions sent without loading the form, sent within a second, or from a form older than an hour. A hidden field catches form-filling bots.
    • Logging in with the default password changeme (or an empty one) is refused until you set your own in config.php.
    • Failed logins are written to the server's error log as Mini Metrics: failed login from <IP>, ready for fail2ban.
    • Failed logins are stored in analytics.db with hashed IPs; the old login_attempts.json file (raw IPs) is removed automatically. Changing your password clears all lockouts.
  • Fixed: after 5 wrong passwords, login stayed blocked forever instead of for 15 minutes.
  • Fixed: adding a domain containing $ could corrupt config.php and take the dashboard down. Domains are now checked (letters, numbers, dots and hyphens) and stored in lowercase.
  • Fixed: times were shown in UTC instead of your time zone (Recent Activity, CSV export), and "today" and date filters used UTC days.
  • Fixed: picking a date range older than 30 days showed the totals but empty lists and no chart.
  • Fixed: the chart skipped days without visits instead of showing 0.
  • Fixed: CSV export ignored the country, city, page and referrer filters, and flooded the PHP error log on PHP 8.4.
  • Fixed: "Today's Pageviews" ignored the country, city, page and referrer filters.
  • Fixed: invalid dates or unusual links (like ?country[]=x) could produce wrong results or a PHP error.
  • Fixed: login didn't work on sites without HTTPS, and login/logout jumped to the site root when Mini Metrics is installed in a subfolder.
  • Security: a fresh session ID after login; spreadsheet formulas in exported data are neutralized; tracking data has length limits; database errors are no longer shown to visitors.

Upgrading from 1.0.0: replace index.php, track.php, track.js and favicon.png, and add the new assets/ folder next to them (keep your config.php). The old cache/ folder next to your database is no longer used and can be deleted. Because bots are no longer counted, your numbers may be a little lower than before.

Version 1.0.0

Released 2026-02-10

  • First release.