Google Analytics plugin for Grav CMS
Switch branches/tags
Clone or download
Latest commit afaa319 Mar 30, 2017

README.md

Grav Google Analytics Plugin

The Google Analytics Plugin for Grav CMS allows you to integrate and configure Google Analytics without the need to touch any code within your Grav site.

Features

  • Preload the Google Analytics script asynchronously
  • IP Anonymization
  • Choose the Google Analytics code position in the HTML document (head or body).
  • Force SSL (HTTPS). Send all data using SSL, even from insecure (HTTP) pages.
  • Renaming of the Global (ga) Object
  • Debug Mode with Trace Debugging
  • Custom Cookie Configuration. Name, domain and expiration time are configurable.
  • Blocking IP Addresses
  • Multi-Language Support for the Grav Administration Panel

Installation

Installing the Google Analytics plugin can be done in one of two ways. The GPM (Grav Package Manager) installation method enables you to quickly and easily install the plugin with a simple terminal command, while the manual method enables you to do so via a zip file.

GPM Installation (Preferred)

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 ganalytics

This will install the Google Analytics plugin into your /user/plugins directory within Grav. Its files can be found under /your/site/grav/user/plugins/ganalytics.

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 ganalytics. You can find these files on GitHub or via GetGrav.org.

You should now have all the plugin files under

/your/site/grav/user/plugins/ganalytics

NOTE: This plugin is a modular component for Grav which requires Grav to operate.

Configuration

Before configuring this plugin, you should copy the user/plugins/ganalytics/ganalytics.yaml to user/config/plugins/ganalytics.yaml and only edit that copy.

Here is the default configuration and an explanation of available options:

enabled: true
trackingId: ""

position: "head"
objectName: "ga"
forceSsl: false
async: false
anonymizeIp: false
blockedIps: []

cookieConfig: false
cookieName: "_ga"
cookieDomain: ""
cookieExpires: 63072000

debugStatus: false
debugTrace: false
  • enabled Toggles if the Google Analytics plugin is turned on or off.

  • trackingId The Google Analytics Tracking ID. This value is required.

  • position Code Position in the HTML document (head or body). Default is head.

  • async Toggles if the Google Analytics script is preloaded asynchronously.

  • forceSsl Toggles if Google Analytics should send all data using HTTPS.

  • objectName The name for the global (ga) object. Default is ga.

  • anonymizeIp Toggles if Google Analytics will anonymize the IP address for all hits.

  • blockedIps Here you can blacklist IP addresses. For those the Google Analytics script will not be embedded.

  • cookieConfig: Toggles if the a custom cookie configuration should be used.

  • cookieName The cookie name. Default ist _ga

  • cookieDomain The cookie domain.

  • cookieExpires The cookie expiration time in seconds. Google default is 2 years (63072000 seconds)

  • debugStatus Toggles if the debug version of Google Analytics is enabled or disabled.

  • debugTrace Toggles if the debugger will output more verbose information to the console. debugStatus must be enabled.

Usage

  1. Sign in to your Google Analytics account.
  2. Select the Admin tab.
  3. Select an account from the dropdown in the ACCOUNT column.
  4. Select a property from the dropdown in the PROPERTY column.
  5. Under PROPERTY, click Tracking Info > Tracking Code.
  6. Copy the Tracking ID (a string like UA-000000-01)
  7. Add it to the configuration of this plugin.