Repository is archived
No commit activity in last 3 years
No release in over 3 years
A Liquid tag to add Plausible analytics to your site.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.6

Runtime

>= 0.15, < 2.0
 Project Readme

PROJECT MOVED TO btrb/bridgetown-plausible

  • Introduction
  • Installation
  • Configuration
  • Usage
  • Demo
  • Contributing
  • License

Introduction

Plausible is a lightweight and open-source website analytics tool. It doesn’t use cookies and is fully compliant with GDPR, CCPA and PECR. This plugin is meant to remove all friction from adding your Plausible Analytics tracking script code to your Bridgetown site.

The alternative to using this plugin is just pasting your Plausible tracking script code directly into the head of your document:

<head>
  <!-- ... -->
  <script async defer data-domain="yourdomain.com" src="https://plausible.io/js/plausible.js"></script>
  <!-- ... -->
</head>

But if you use this plugin, all you need to do is define your Plausible domain in your Bridgetown config file and paste this into your document head:

<head>
  <!-- ... -->
  {% plausible %}
  <!-- ... -->
</head>

Installation

If you're running Bridgetown v0.15 or later, you can install this plugin via an automation to guide you through the configuration:

bundle exec bridgetown apply https://github.com/andrewmcodes/bridgetown-plausible-tag

Otherwise, you can run this command to add this plugin to your site's Gemfile:

bundle add bridgetown-plausible-tag -g bridgetown_plugins

or add the following to your Gemfile:

group :bridgetown_plugins do
  gem "bridgetown-plausible-tag", "~> 0.0.1"
end

Run bundle install and then modify your bridgetown.config.yml configuration to point to your Plausible domain.

Configuration

# bridgetown.config.yml

plausible:
  # Your Plausible domain.
  # Note that this domain should not include www or https://
  #
  # Type: String
  # Required: true
  domain: example.com

Usage

This plugin provides the plausible Liquid tag to your site.

Use the tag in the head of your document:

{% plausible %}

Refer to the Plausible Documentation for more information.

Demo

bridgetown-plausible-starter

This starter can be used to reproduce issues as well as provide an example of the plugin's usage.

You can view the live version at: andrewmcodes.github.io/bridgetown-plausible-starter.

Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page. You can also take a look at the contributing guide.

License

This plugin is released under the MIT License.