Refactor Matomo analytics initialization and tracking

- Simplified the analytics initialization process by consolidating logic into `resolveMatomoSiteId` and `ensureMatomoInitialized` functions.
- Updated site ID resolution to support different environments (localhost, Netlify, production).
- Enhanced SPA navigation tracking by ensuring page views are tracked on route updates.
- Removed unnecessary checks and streamlined the code for better readability and maintainability.

Signed-off-by: Pete Cheslock <[email protected]>

Author: petecheslock

src/clientModules/analytics.js

@@ -1,84 +1,56 @@
-// Client module for global Matomo analytics - runs on every page
+// Client module for global Matomo analytics
 import ExecutionEnvironment from '@docusaurus/ExecutionEnvironment';
 
 let isInitialized = false;
 
-function initializeAnalytics() {
-  // Only run analytics on development or Netlify preview deployments
-  const isLocalDevelopment = window.location.hostname === 'localhost';
-  const isNetlifyPreview = window.location.hostname.includes('netlify.app') || 
-                          window.location.hostname.includes('netlify.com');
-  
-  if (!isLocalDevelopment && !isNetlifyPreview) {
-    console.log('Matomo: Analytics disabled - not running on localhost or Netlify preview');
+function resolveMatomoSiteId(hostname) {
+  if (!hostname) return null;
+  const host = hostname.toLowerCase();
+  const isPreview = host === 'localhost' || host.includes('netlify.app') || host.includes('netlify.com');
+  const isProd = host === 'llm-d.ai' || host.endsWith('.llm-d.ai');
+  if (isPreview) return '6';
+  if (isProd) return '7';
+  return null; // unknown host -> do not track
+}
+
+function ensureMatomoInitialized() {
+  if (isInitialized) return;
+  const siteId = resolveMatomoSiteId(window.location.hostname);
+  if (!siteId) {
+    // Not a recognized host; keep analytics disabled
     return;
   }
 
-  console.log('Matomo: Initializing analytics with site ID 6 on', window.location.hostname);
+  window._paq = window._paq || [];
+  window._paq.push(['disableCookies']);
+  window._paq.push(['alwaysUseSendBeacon', true]);
+  window._paq.push(['enableLinkTracking']);
 
-  // Initialize Matomo (only once)
-  if (!isInitialized) {
-    window._paq = window._paq || [];
-    window._paq.push(['trackPageView']);
-    window._paq.push(['enableLinkTracking']);
-    
-    (function() {
-      const u = "//analytics.ossupstream.org/";
-      window._paq.push(['setTrackerUrl', u + 'matomo.php']);
-      window._paq.push(['setSiteId', '6']);
-      const d = document,
-        g = d.createElement('script'),
-        s = d.getElementsByTagName('script')[0];
-      g.async = true;
-      g.src = u + 'matomo.js';
-      s.parentNode.insertBefore(g, s);
-    })();
-    
-    isInitialized = true;
+  const baseUrl = '//analytics.ossupstream.org/';
+  window._paq.push(['setTrackerUrl', baseUrl + 'matomo.php']);
+  window._paq.push(['setSiteId', siteId]);
 
-    // Listen for route changes to track page views
-    const originalPushState = history.pushState;
-    const originalReplaceState = history.replaceState;
-    
-    history.pushState = function() {
-      originalPushState.apply(history, arguments);
-      setTimeout(() => {
-        if (window._paq) {
-          window._paq.push(['setCustomUrl', window.location.href]);
-          window._paq.push(['setDocumentTitle', document.title]);
-          window._paq.push(['trackPageView']);
-        }
-      }, 100);
-    };
-    
-    history.replaceState = function() {
-      originalReplaceState.apply(history, arguments);
-      setTimeout(() => {
-        if (window._paq) {
-          window._paq.push(['setCustomUrl', window.location.href]);
-          window._paq.push(['setDocumentTitle', document.title]);
-          window._paq.push(['trackPageView']);
-        }
-      }, 100);
-    };
+  const d = document;
+  const g = d.createElement('script');
+  const s = d.getElementsByTagName('script')[0];
+  g.async = true;
+  g.src = baseUrl + 'matomo.js';
+  s.parentNode.insertBefore(g, s);
 
-    window.addEventListener('popstate', () => {
-      setTimeout(() => {
-        if (window._paq) {
-          window._paq.push(['setCustomUrl', window.location.href]);
-          window._paq.push(['setDocumentTitle', document.title]);
-          window._paq.push(['trackPageView']);
-        }
-      }, 100);
-    });
-  }
+  isInitialized = true;
 }
 
-// Initialize analytics when DOM is ready
-if (ExecutionEnvironment.canUseDOM) {
-  if (document.readyState === 'loading') {
-    document.addEventListener('DOMContentLoaded', initializeAnalytics);
-  } else {
-    initializeAnalytics();
+export function onRouteDidUpdate({location, previousLocation}) {
+  if (!ExecutionEnvironment.canUseDOM) return;
+  ensureMatomoInitialized();
+  if (!window._paq || !isInitialized) return;
+
+  // Track SPA navigations
+  if (previousLocation) {
+    const referrer = `${previousLocation.pathname}${previousLocation.search || ''}${previousLocation.hash || ''}`;
+    window._paq.push(['setReferrerUrl', referrer]);
   }
+  window._paq.push(['setCustomUrl', window.location.href]);
+  window._paq.push(['setDocumentTitle', document.title]);
+  window._paq.push(['trackPageView']);
 }