opscms-analytics-plugin
v1.0.3
Published
Per-site analytics for an OpsCMS platform: each site's own Google, Matomo, Plausible, Fathom, Umami, PostHog or custom settings, and the server-side GA4 workflow action.
Maintainers
Readme
opscms-analytics-plugin
Per-site analytics for the OpsCMS platform, built with opscms-sdk.
analytics-integrations: each site's own analytics providers: Google (GA4 and Tag Manager), Matomo, Plausible, Fathom, Umami, PostHog, or a custom script. A site can run several at once. The server secret (GA4's Measurement Protocol secret) is encrypted under the site's key and shown masked; the platform's public content API never returns it. A custom script is injected verbatim into every page of the site, so only the platform owner may write one.- The
ga4-send-eventworkflow action: carries out the platform'ssend_analytics_eventblock, sending a server-side event to GA4 with the site's own measurement id and secret. A site with no active GA4 setup is skipped successfully: tracking is best-effort and never fails the business workflow.
Meta's own server-side events belong to the Meta plugin (meta-conversion-event), not to this one.
Install
From the admin: Plugins → Install from npm → opscms-analytics-plugin. The platform creates the plugin's table (its one migration), lists the plugin
with its logo, and restarts to start it. Removing the plugin drops its table and the secrets in it.
The platform currently carries this plugin in its own code under the same key; install the package only after that copy has been removed. The platform's
public content API serves this collection to a site's storefront by its slug, analytics-integrations.
Needs
payload ^3 and opscms-sdk ^0.1.7 (the platform provides both).
Develop
npm install
npm run typecheck && npm test && npm run build && npm pack --dry-runopscms-sdk is linked from a sibling checkout (file:../opscms-sdk) until it is published.
