Astro Matomo

Installation

pnpm add astro-matomo

npm install astro-matomo

yarn add astro-matomo

Options

| Options | Type | Description | | ------------------ | --------- | --------------------------------------------------------- | | enabled | boolean | Controls if the matomo script should be loaded | | host | string | Url to your matomo installation | | siteId | number | Matomo site id. | | heartBeatTimer? | number | If set the heart beat timer will be enabled | | disableCookies? | boolean | If set cookies will be disabled | | preconnect? | boolean | Will create a preconnect link pointing to the matomo host | | setCookieDomain? | string | Share the tracking cookie across multiple domains | | trackerUrl? | string | Defaults to matomo.php | | srcUrl? | string | Defaults to matomo.js | | debug? | boolean | Activate debug mode | | partytown? | boolean | Adds Partytown support. Matomo added as: <script type="text/partytown">...</script> | | crossOrigin? | string | Set crossorigin attribute |

Example usage

// astro.config.mjs

import { defineConfig } from 'astro/config';
import matomo from 'astro-matomo';

// https://astro.build/config
export default defineConfig({
  site: "https://example.lol",
  integrations: [
    matomo({
      enabled: import.meta.env.PROD, // Only load in production
      host: "https://analytics.example.lol/",
      setCookieDomain: "*.example.lol",
      trackerUrl: "js/", // defaults to matomo.php
      srcUrl: "js/", // defaults to matomo.js
      siteId: 666,
      heartBeatTimer: 5,
      disableCookies: true,
      debug: false,
    }),
  ]
});

Development

Make the package available in your local environment:

pnpm link .

npm link

Go to the demo project and link the package:

pnpm link astro-matomo

npm link astro-matomo

Start the dev server:

pnpm run dev

npm run dev