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.

• Table of contents
• Quickstart
• System requirements
• Installation
• Configuration
• Usage
  • Liquid
  • ERB
• Changelog
• Contribution
• License

Use the automation to add to your site:

bundle exec bridgetown apply https://github.com/bt-rb/bridgetown-plausible

• Ruby >= 2.5
• Bundler
• Bridgetown >= 0.16

Automatically add to Gemfile:

bundle add bridgetown-plausible -g bridgetown_plugins

or add manually in Gemfile:

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

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

# bridgetown.config.yml

plausible:
  # Your Plausible domain.
  # Note that this domain should not include www or https://
  #
  # Type: String
  # Required: true
  domain: example.com
  # Your Plausible instance domain.
  # Only set this if you are self-hosting Plausible on your own domain.
  # Requires https.
  #
  # Type: String
  # Required: false
  # Default: "plausible.io"
  server: selfhosted-plausible.com

This plugin provides the plausible Liquid tag & ERB helper to your site. If BRIDGETOWN_ENV is not production, than the tag will be wrapped in an HTML comment to prevent console erros in development. Make sure you set BRIDGETOWN_ENV="production" when you deploy in your script or in Netlify/Vercel/etc.

Use the tag in the head of your document:

{% plausible %}

<%= plausible %>

Detailed changes for each release are documented in the release notes.

Please make sure to read the Contributing Guide before making a pull request.

MIT

Copyright (c) 2021-present, Andrew Mason