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.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 98c3e9b7467d60fb0f3265a4623f73ddf851120420d60d16ea08e55ebcd095d1 |
|
MD5 | 37bb1a2b3b5453f1cc1017edfa748282 |
|
BLAKE2b-256 | 14d08c7e0520a59c862e03dc2b495d8b09a4db19abb6e4d46d56882c550d05be |
Hashes for material_plausible_plugin-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 69a1c151432eaadd2b8df2972d726c6ddee1fa18708f8d8c98c19a32c2c9c242 |
|
MD5 | 1102e653c44e0055f05bc835d7404f1b |
|
BLAKE2b-256 | 4ab2ed48fd36facf7f9e8953da031fdad6f4057a7bb45d5f9507b6be7ad13728 |