Package Exports

docusaurus-plugin-segment
docusaurus-plugin-segment/src/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (docusaurus-plugin-segment) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

docusaurus-plugin-segment

A Docusaurus plugin for Segment API Analytics based on prior work by Moesif

Disclaimer: This is a community plugin. It may not work. Use at your own risk.

How to install

Install docusaurus-plugin-segment

npm install --save docusaurus-plugin-segment

Add plugin to docusaurus.config.js

Method a: use themeConfig with Docusaurus v1

module.exports = {
  plugins: ['docusaurus-plugin-segment'],
  themeConfig: {
    segment: {
      apiKey: 'Your Segment Write API Key',
      // Add other options here.
    },
  },
};

Method b: use plugin options with Docusaurus v2

module.exports = {
  plugins: [
    'docusaurus-plugin-segment',
    {
      apiKey: 'Your Segment Write API Key'
      // Add other options here.
    }
  ]
}

Test it works

Because the plugin is disabled when NODE_ENV is set to development, you'll want to create a production build:

npm run build

npm run serve

How to use

Any of the Segment browser APIs are accessible via window.analytics. The plugin tracks page views automatically but we also recommend identifying the user like so:

window.analytics.identify("97980cfea0067", {
  name: "Peter Gibbons",
  email: "peter@example.com",
  plan: "premium",
  logins: 5
});

Configuration Options

For full list of configuration options, see this page.

The page option defaults to false, and the plugin will use a hook to send page tracking events.