About this project

Plausible Analytics is a Discourse theme component designed to send pageviews and detailed custom events to a Plausible Analytics instance, either the hosted service or a self‑hosted deployment. It loads the official Plausible script in manual mode so that standard features like engagement time, scroll depth, referrer attribution, and the plausible_ignore opt‑out work unchanged. The component hooks into Discourse appEvents (topic:created, post:created, page:like-toggled, bookmarks:changed, etc.) and also captures search queries and outbound link clicks, applying privacy rules that exclude private messages, admin pages, and optionally personal profile pages. Each event type can be toggled individually via the component’s admin UI, and additional Discourse appEvents can be forwarded through the forward_app_events setting. Installation is done through the Discourse admin interface under Customize → Themes → Components, after which the plausible_domain and plausible_host settings are configured to point at the desired Plausible site. The component includes localization files for several languages and is released under the Apache License 2.0.