feat(matomo): support custom tracker urls (#236)

Co-authored-by: Harlan Wilton <[email protected]>

Author: reslear

docs/content/scripts/analytics/matomo-analytics.md

@@ -83,6 +83,19 @@ const matomoAnalytics = useScriptMatomoAnalytics({
 })
 ```
 
+### Using Matomo Whitelabel
+
+For Matomo Whitelabel, set trackerUrl and scriptInput.src to customize tracking.
+
+```ts
+const matomoAnalytics = useScriptMatomoAnalytics({
+  trackerUrl: 'https://c.staging.cookie3.co/lake',
+  scriptInput: {
+    src: 'https://cdn.cookie3.co/scripts/analytics/latest/cookie3.analytics.min.js',
+  },
+})
+```
+
 Please follow the [Registry Scripts](/docs/guides/registry-scripts) guide to learn more about advanced usage.
 
 ### MatomoAnalyticsApi
@@ -100,10 +113,12 @@ You must provide the options when setting up the script for the first time.
 ```ts
 // matomoUrl and site are required
 export const MatomoAnalyticsOptions = object({
-  matomoUrl: string(), 
+  matomoUrl: string(),
   siteId: string(),
+  trackerUrl: optional(string()),
   trackPageView: optional(boolean()),
   enableLinkTracking: optional(boolean()),
+  disableCookies: optional(boolean()),
 })
 ```
 

src/runtime/registry/matomo-analytics.ts

@@ -4,10 +4,12 @@ import { boolean, object, optional, string } from '#nuxt-scripts-validator'
 import type { RegistryScriptInput } from '#nuxt-scripts'
 
 export const MatomoAnalyticsOptions = object({
-  matomoUrl: string(), // site is required
+  matomoUrl: optional(string()),
   siteId: string(),
+  trackerUrl: optional(string()),
   trackPageView: optional(boolean()),
   enableLinkTracking: optional(boolean()),
+  disableCookies: optional(boolean()),
 })
 
 export type MatomoAnalyticsInput = RegistryScriptInput<typeof MatomoAnalyticsOptions, false, false, false>
@@ -23,7 +25,7 @@ declare global {
 export function useScriptMatomoAnalytics<T extends MatomoAnalyticsApi>(_options?: MatomoAnalyticsInput) {
   return useRegistryScript<T, typeof MatomoAnalyticsOptions>('matomoAnalytics', options => ({
     scriptInput: {
-      src: withBase(`/matomo.js`, withHttps(options?.matomoUrl)),
+      src: withBase(`/matomo.js`, withHttps(options?.matomoUrl || '')),
       crossorigin: false,
     },
     schema: import.meta.dev ? MatomoAnalyticsOptions : undefined,
@@ -48,7 +50,14 @@ export function useScriptMatomoAnalytics<T extends MatomoAnalyticsApi>(_options?
           if (options?.enableLinkTracking) {
             _paq.push(['enableLinkTracking'])
           }
-          _paq.push(['setTrackerUrl', withBase(`/matomo.php`, withHttps(options?.matomoUrl))])
+
+          if (options?.disableCookies) {
+            _paq.push(['disableCookies'])
+          }
+
+          if (options?.trackerUrl || options?.matomoUrl) {
+            _paq.push(['setTrackerUrl', options?.trackerUrl ? withHttps(options.trackerUrl) : withBase(`/matomo.php`, withHttps(options?.matomoUrl || ''))])
+          }
           _paq.push(['setSiteId', options?.siteId || '1'])
         },
   }), _options)