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 |
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