Plausible Analytics implementation for Material for MkDocs
Project description
Plausible Analytics for Material
Plausible Analytics is a simple, open-source, lightweight and privacy-friendly web analytics alternative to Google Analytics.
This plugin implements Plausible Analytics support in Material for MkDocs.
Quick start
-
Install the plugin:
pip install material-plausible-plugin
-
Add the following lines to
mkdocs.yml
:plugins: - material-plausible extra: analytics: provider: plausible domain: example.com #: If using custom domain proxy or self-hosting Plausible, #: uncomment and specify script path here: # src: "https://plausible.example.com/js/plausible.js" feedback: title: Was this page helpful? ratings: - icon: material/emoticon-happy-outline name: This page was helpful data: good note: >- Thanks for your feedback! - icon: material/emoticon-sad-outline name: This page could be improved data: bad note: >- Thanks for your feedback! Help us improve this page by using our <a href="..." target="_blank" rel="noopener">feedback form</a>.
-
In your Plausible account, go to your website's settings and visit the Goals section. For each rating defined, click on the + Add goal button, select Custom event as the goal trigger and enter
Feedback: {rating data value}
.For example, if you have two ratings –
good
andbad
, addFeedback: good
andFeedback: bad
goals.
Ratings will be shown in the Goal Conversions section at the very bottom of the page, as soon as any are available:
You can click on a specific “goal” to filter your dashboard by it. For example, if you filter by the Feedback: bad
goal, you can see which pages need the most attention in the Top Pages section.
License
material-plausible-plugin
is distributed under the terms of the ISC license.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for material_plausible_plugin-0.1.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0b345a68e39c50279a66a015320dcd4365d895e4ac15bb7373649a7d0127eeca |
|
MD5 | f3a7857ce8e303e067f8bd30384f4439 |
|
BLAKE2b-256 | e112df5d7c12088459c2ef576f3d50c5612c7da13cfc798300baaf2d903c834a |
Hashes for material_plausible_plugin-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 561ae0112ac0211c6dd6f323a40178c9e7b2622dc0b7b811b831e4d20e89d286 |
|
MD5 | 58f495355f438a58fde918cfb093d02c |
|
BLAKE2b-256 | 5ffbbc26eab8897360a49f2ef71992d0d039a33fc147b22b925c9e0da25a0a56 |