Reimplement Plausible analytics

[mrdarrengriffin]

The tracker was inlined into main.html with a bare init, which meant the privacy plugin downloaded it at build time and served a frozen self-hosted copy, and every referrer reached Plausible untouched. Visitors arriving from their own Home Assistant or ESPHome instance send that private URL as the referrer, so those had to be filtered before Plausible ever recorded them.

• Move the tracker into a partials/plausible.html partial, included from the extrahead block, and read the script and dashboard URLs from extra in mkdocs.yml.
• Exclude the Plausible host from the privacy plugin so the tracker is loaded from the Plausible instance and stays current.
• Add a source/hooks/plausible.py hook that fetches the Open Home Foundation referrer allow list once per build, caches it under .cache alongside the translations, and exposes it to the templates. Fetch failures fall back to the cached copy and never fail the build.
• Initialize the tracker with a transformRequest that replaces any referrer outside the allow list with a single unlisted.invalid bucket, so we can see how much is filtered without learning anything about individual visitors.
• Guard the 404 event on window.plausible and point the footer dashboard link at the configured URL.

Claude-Session: https://claude.ai/code/session_01UkMvZDbHQRYGY1u1P53uFd

[Copilot]

Pull request overview

This PR reimplements Plausible analytics integration for the MkDocs site to prevent private referrer URLs (e.g., from Home Assistant / ESPHome) from being recorded by Plausible, by fetching an allow list at build time and filtering referrers client-side before events are sent.

Changes:

• Moved Plausible initialization into a dedicated partials/plausible.html partial and included it from main.html.
• Added an MkDocs hook to fetch/cache an Open Home Foundation referrer allow list and expose it via config.extra for templating.
• Updated MkDocs config to keep Plausible assets remote (privacy plugin exclude) and parameterized tracker/dashboard URLs via extra.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
source/overrides/partials/plausible.html	Adds Plausible init with transformRequest referrer filtering using a build-fetched allow list.
source/overrides/partials/footer.html	Points the public dashboard link at a configurable config.extra.plausible.dashboard URL.
source/overrides/main.html	Includes the new Plausible partial from the extrahead block.
source/overrides/404.html	Guards the 404 Plausible event call on window.plausible availability.
source/hooks/plausible.py	Adds build-time allow list fetch + cache logic and injects it into config.extra.plausible.allowed_referrers.
source/assets/stylesheets/extra.css	Removes an extraneous blank line (no functional change).
mkdocs.yml	Configures privacy plugin asset exclusions, registers the new hook, and adds Plausible script/dashboard URLs under extra.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.