GoSquared for Grav
This is a Grav plugin that adds the GoSquared Analytics tracking code to Grav pages.
Installation
Installing the GoSquared plugin can be done in one of two ways.
Admin Installation (Preferred)
If you have the GRAV Admin plugin installed (and you really should ) you can install this plugin from your browser. Simply log in to your Admin area, click on "Plugins" in the left sidebar menu, and then click on + Add in the top right of the Plugins view.
Simply scroll to the GoSquared Analytics plugin (or filter by name) and then click + Install on the right end of the row for the plugin.
GPM Installation
The simplest way to install this plugin is via the Grav Package Manager (GPM) through your system's Terminal (also called the command line). From the root of your Grav install type:
bin/gpm install gosquared
This will install the GoSquared plugin into your /user/plugins directory within Grav. The plugin files should now be in /your/site/grav/user/plugins/gosquared
Manual Installation
To install this plugin, just download the zip version of this repository and unzip it under /your/site/grav/user/plugins. Then, rename the folder to gosquared.
You should now have all the plugin files under
/your/site/grav/user/plugins/gosquared
Config Defaults
Prior to the Admin plugin, you could modify a plugins' yaml file directly (you still can actually), but now the Admin screens offers a much easier and safer way to adjust the plugin settings.
The gosquared.yaml contains only 3 settings:
enabled: true
gsn: ''
gsInAdmin: false
If you need to change any value, I recommend using the Admin screens available via the Admin plugin . This will let you change any of the settings and provide a useful tooltip for each setting (hover over the settings label).
Usage
- In your GoSquared account, open the domain you're using Grav on (or add one if needed).
- At the bottom of the left side menu, you will find Settings — click on it.
- Copy the GoSquared Site Token and paste it into the settings for the plugin (I recommend pasting not typing...)