How crabston/grav-plugin-umami-analytics works
This Grav plugin adds Umami tracking to public sites, optionally proxying tracker scripts and tracking requests through the site, and provides an optional Admin2 analytics dashboard. The public workflow runs through plugin configuration and asset injection; proxy requests are handled separately from the dashboard’s server-side API requests. The dashboard workflow runs from the Admin2 page through a registered API route to the controller, which fetches and caches Umami data for display. Proxy details beyond the sampled request handling are supported by the README; unsampled source is not treated as inspected.
Main entry points: DashboardController.php Dashboard Controller · umami-analytics.php Tracking Setup · umami-analytics.js Dashboard Page · umami-analytics.yaml Plugin Settings
Components 12
Site Tracking
- Tracking Setup
umami-analytics.php
Same-Origin Proxy
- Script Proxy
umami-analytics.php - Event Proxy
umami-analytics.php
Admin Dashboard
- Dashboard Page
admin-next/pages/umami-analytics.js - Dashboard Route
umami-analytics.php - Dashboard Controller
classes/Api/DashboardController.php
Plugin Configuration
- Plugin Settings
umami-analytics.yaml - Grav Cache
Other components
- Site Visitor
- Grav Site
- Umami Service
- Admin User
Connections 14
- Grav Site → Tracking Setup: loads plugin
umami-analytics.php - Plugin Settings → Tracking Setup: configures
umami-analytics.php - Tracking Setup → Grav Site: adds tracker
umami-analytics.php - Site Visitor → Umami Service: uses tracker
README.md - Tracking Setup → Script Proxy: serves script
README.md - Script Proxy → Umami Service: fetches script
README.md - Site Visitor → Event Proxy: sends events
README.md - Event Proxy → Umami Service: forwards requests
umami-analytics.php - Admin User → Dashboard Page: opens dashboard
README.md - Dashboard Page → Dashboard Route: fetches dashboard
admin-next/pages/umami-analytics.js - Dashboard Route → Dashboard Controller: dispatches to
umami-analytics.php - Dashboard Controller → Umami Service: requests analytics
classes/Api/DashboardController.php - Dashboard Controller → Grav Cache: reads and writes
classes/Api/DashboardController.php - Dashboard Controller → Dashboard Page: returns dashboard data
classes/Api/DashboardController.php