Do you have a Firefox or Chrome browser plugin with a user interface and want to understand how it's being used? PostHog is the perfect way to do just that.
Setup for Firefox & Chrome plugins
Installing PostHog inside your plugin
Open the HTML file used in your default_popup
and add the PostHog array.js
script. To do this you'll need to either:
- Copy the latest version of array.js from: https://app.posthog.com/static/array.js and import it locally using
<script src="array.js" />
before the</head>
tag - If you're packaging your plugin automatically use the npm module for posthog.js
All you need to do now is initialize PostHog, add the following code to a new js file and import it into your default_popup
html file to initiate PostHog.
posthog.init('your_project_token',{api_host:'https://app.posthog.com',persistence:'localStorage'})
your_project_token
- This is theProject API key
which can be found on PostHog under Project Settingsapi_host
- This is the URL to your PostHog instance (if you're not using PostHog Cloud)persistence
- This indicates we should store user data in localStorage rather than cookies - there are issues with cookie persistence on Firefox plugins
Tracking events
One of the best things about using PostHog is, all the interactions like clicks will automatically generate events in PostHog, so you don't need to do anything else to start analyzing.
If you'd like to instrument your own custom events, all you need to do is:
posthog.capture('custom_event_name', {})
See our browser JS library guide for more details