BarakoCMS.Analytics.Umami v0.1.0

[arnelirobles]

Umami web analytics, right in the barakoCMS admin. A new module — BarakoCMS.Analytics.Umami — puts visitor stats (visitors, pageviews, top pages, referrers, countries) on an Analytics page under System in the admin. It's a server-side proxy over a self-hosted Umami instance, so Umami credentials never reach the browser. You can also register a new tracked site from the admin and it hands back the paste-in snippet.

Set it up

1. Run Umami (self-hosted) and create an account the CMS will read with. Give it admin role if you want it to see sites owned by other accounts.
2. Register the module (already done in BarakoCMS.Suite / the barako-cms image):

   services.AddBarakoCMS(config, m => m.Add(new UmamiAnalyticsModule()));

3. Configure (env vars; the section is Umami). Ships disabled until you set these:

   Env	Example	Notes
   Umami__Enabled	true	turns the integration on
   Umami__BaseUrl	http://umami:3000/analytics	server-to-server URL; include Umami's base path if it has one
   Umami__Username	barakocms	account the CMS reads with
   Umami__Password	•••••	kept server-side, never sent to the browser
   Umami__PublicUrl	https://your.site/analytics	browser origin for the tracking snippet (defaults to BaseUrl)

4. Open Analytics in the admin sidebar. Pick a site + range; use Add website to start tracking a new one.

Until configured it's inert — GET /api/analytics/websites returns { configured: false } and the admin shows a "connect Umami" hint instead of an error.

Endpoints (Admin / SuperAdmin only)

Method	Route	Purpose
GET	/api/analytics/websites	tracked sites (for the picker)
POST	/api/analytics/websites	register a site; returns the snippet
GET	/api/analytics/{id}/summary?range=7d	headline counters
GET	/api/analytics/{id}/series?range=7d	pageviews/sessions over time
GET	/api/analytics/{id}/metric?type=path&range=7d	top-N (path,referrer,country,browser,os,device)

range is 24h, 7d (default), 30d, or 90d. Verified against Umami v3 (3.2.0). The module persists nothing — every read is live from Umami.

Ships in the barakoCMS suite (barako-cms image) now; publishes to NuGet + GitHub Packages as BarakoCMS.Analytics.Umami with the next suite release.