/astro-matomo

Matomo integration for Astro

Primary LanguageTypeScriptGNU General Public License v3.0GPL-3.0

Astro Matomo

npm npm GitHub package.json version GitHub Workflow Status

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