https://github.com/oddcamp/datocms-plugin-plausible

Plausible integration for DatoCMS
https://github.com/oddcamp/datocms-plugin-plausible

analytics datocms datocms-plugin plausible

Last synced: about 2 months ago
JSON representation

Plausible integration for DatoCMS

• Host: GitHub
• URL: https://github.com/oddcamp/datocms-plugin-plausible
• Owner: oddcamp
• License: mit
• Created: 2022-01-27T16:50:21.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2022-02-17T11:09:55.000Z (over 3 years ago)
• Last Synced: 2025-09-04T02:52:06.135Z (about 2 months ago)
• Topics: analytics, datocms, datocms-plugin, plausible
• Language: TypeScript
• Homepage: https://github.com/oddcamp/datocms-plugin-plausible
• Size: 731 KB
• Stars: 0
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Plausible DatoCMS Plugin

DatoCMS plugin that provides a link to [Plausible](https://www.plausible.io) for the current record on the sidebar

## Setup

### Adding the plugin from the marketplace

In your DatoCMS project, go to Settings -> Plugins -> Add new (plus sign at the bottom) -> From Marketplace -> Search for Plausible -> Install this plugin.

### Adding as a private plugin

In your DatoCMS project, go to Settings -> Plugins -> Add new (plus sign at the bottom) -> Create new plugin -> Enter the following configuration:

- **Plugin Name:** Plausible

- **Small Description:** Provides sidebar links to Plausible

- **Entry Point URL:** https://datocms-plugin-plausible.netlify.app/

![Plugin Settings](./docs/plugin-settings-01.png)

Then click on Save plugin settings

## Plugin parameters

After installing the plugin, in the new settings form we must enter the parameters for our Plausible project.

- **Plausible Site:** The name of our site in plausible,  

  ex: mysite.com

Then for each model, we'll have the following fields:

- **[DATOCMS MODEL] URL Pattern:** The pattern used to construct the Plausible URL for the specified model,  

  ex: ?page=%2f

- **[DATOCMS MODEL] Slug Field:** The field of the specified model that will be used as slug,  

  ex: First Name

The combination of the 3 parameters will be later used by the plugin to create a link, ex:  

https://plausible.io/mysite.com?page=%2fjoakim

![Plugin Parameters](./docs/plugin-settings-02.png)

Then click on Save Settings

## Plugin

After the setup is complete, we can navigate to content and select a record from one our models.  

The plugin will show up in the sidebar.

![Plugin Link](./docs/plugin-link.png)

## Development

Clone the repo -> `$ yarn install` -> `$ yarn start` -> In your DatoCMS project, settings -> plugins -> Plausible -> Edit private plugin -> Change the Entry Point URL to http://localhost:3000