changes based on milan review

Author: Paurikova2

MATOMO_CONFIGURATION.md

@@ -0,0 +1,37 @@
+# Matomo Statistics Configuration
+
+## Enable/Disable Matomo
+
+### To Disable Matomo (Default)
+```typescript
+matomo: {
+  enabled: false,
+  hostUrl: 'https://your-matomo-server.com/',
+  siteId: '1',
+  dimensionId: 1
+}
+```
+
+### To Enable Matomo
+```typescript
+matomo: {
+  enabled: true,
+  hostUrl: 'https://your-matomo-server.com/',
+  siteId: '1',
+  dimensionId: 1
+}
+```
+
+## Files to Modify
+
+- environment.test.ts
+- default-app-config.ts
+- config.example.ts
+
+## After Changes
+
+1. Restart the application
+2. Clear browser cache
+
+When disabled: No Matomo scripts load, statistics page shows "disabled" message.
+When enabled: Matomo tracking works normally.

config/config.example.yml

@@ -465,5 +465,6 @@ accessibility:
   cookieExpirationDuration: 7
 
 matomo:
+  enabled: false
   hostUrl: http://localhost:8135/
   siteId: 1

src/config/default-app-config.ts

@@ -452,6 +452,7 @@ export class DefaultAppConfig implements AppConfig {
 
   // Matomo configuration
   matomo: MatomoConfig = {
+    enabled: false,
     hostUrl: 'http://localhost:8135/',
     siteId: '1',
     dimensionId: 1

src/config/matomo-config.ts

@@ -5,6 +5,8 @@ import { Config } from './config.interface';
  */
 export class MatomoConfig implements Config {
 
+  public enabled: boolean;
+
   public hostUrl: string;
 
   public siteId: string;

src/environments/environment.test.ts

@@ -356,6 +356,7 @@ export const environment: BuildConfig = {
   signpostingEnabled: true,
 
   matomo: {
+    enabled: false,
     hostUrl: 'http://localhost:8135/',
     siteId: '1',
     dimensionId: 1

src/main.browser.ts

@@ -51,6 +51,10 @@ function addMatomoStatistics() {
     .then((config) => {
       const matomoConfig = config.matomo;
 
+      if (!matomoConfig?.enabled) {
+        return;
+      }
+
       // Push all configuration commands first
       (window as any)._paq.push(['setTrackerUrl', matomoConfig.hostUrl + 'matomo.php']);
       (window as any)._paq.push(['setSiteId', matomoConfig.siteId]);