@devular/gatsby-plugin-plausible

This plugin was forked from pixelplicity/gatsby-plugin-plausible to support Plausible's proxying configuration.

A Gatsby plugin for adding Plausible analytics to your Gatsby site.

The plugin includes the Plausible tracking script. It supports using a custom domain and excluding specific paths from recording page views.

Install
- Manual
- Gatsby Recipe
How to use
Changelog
License

Install

Manual

Install @devular.gatsby-plugin-plausible

npm install --save @devular/gatsby-plugin-plausible

Add plugin to gatsby-config.js

// In your gatsby-config.js
module.exports = {
  plugins: [
    // The only required option is the domain
    {
      resolve: `@devular/gatsby-plugin-plausible`,
      options: {
        domain: `your-site.com`,
        proxyScript: `/sub-directory/script.js`,
        proxyApi: `/sub-directory/api/event`,
      },
    },
  ],
};

Gatsby Recipe

This will install @devular/gatsby-plugin-plausible and add a sample configuration.

Upgrade gatsby-cli and gatsby to the latest version:

npm install -g gatsby-cli@latest npm install gatsby@latest
Run the recipe gatsby recipes https://raw.githubusercontent.com/devular/gatsby-plugin-plausible/master/gatsby-recipe-plausible.mdx
Update gatsby-config.js options.

To read more about recipes check out the announcement.

How to use

NOTE: By default, this plugin only generates output when run in production mode. To test your tracking code, run gatsby build && gatsby serve.

Options

Option	Explanation
`domain`	The domain configured in Plausible (required)
`proxyScript`	A script location for a proxy configuration
`proxyApi`	An collection endpoint for aproxy configurations
`excludePaths`	Array of pathnames where page views will not be sent

_NOTE: You can read more about proxying Plausible here

Pageview events

Pageviews are sent automatically when a user changes routes, including the initial load of your site.

Triggering custom events

To track goals and conversions you have to trigger custom events first.

window.plausible('Signup', {
  callback: () => console.info('Sent Signup event'),
});

The event name can be anything. The second argument is an object with options. The only supported option is callback that is called once the event has been sent.

NOTE: Custom events will not show up right away. You have to configure a goal in your Plausible dashboard.

Changelog

See CHANGELOG.md.

License

MIT | Devular

Forked from: https://github.com/pixelplicity/gatsby-plugin-plausible with MIT

License

devular/gatsby-plugin-plausible

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

Error
Looks like something went wrong!

Packages