Integration of Google analytics with Lektor CMS
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore
LICENSE
MANIFEST.in
README.md
lektor_google_analytics.py
setup.py

README.md

lektor-google-analytics

Requirements Status

This plugin adds support for Google analytics to Lektor CMS.

Once the plugin is enabled, a generate_google_analytics() function is available to be included in target template which automatically include Google-Analytics code in final HTML files rendered by Lektor.

Basic Usage

Enabling the Plugin

To enable the plugin add this to your project file:

[packages]
lektor-google-analytics = 0.1.3

Configuring the Plugin

The plugin needs a config file with your Google analytics code in it.

Just create a file named google-analytics.ini into ./configs folder in your Lektor project's base directory. And, put the GOOGLE_ANALYTICS_ID key with target property ID of form UA-XXXXXXXX-Y which you obtained from:

GOOGLE_ANALYTICS_ID = UA-XXXXXXXX-Y

Using in Templates

Now you can add a Google analytics code-snippet in your templates by just calling the generate_google_analytics function in its tag as below.

<div class="ga-script">{{ generate_google_analytics() }}</div>

That's it. All the HTML files that rendered from that template will include Google-Analytics code automatically.


Advanced

  • You can use GOOGLE_ANALYTICS_PROPERTY property to include your custom-built Google Analytics tracking code. In that case, your ./configs/google-analytics.ini will look like this:
GOOGLE_ANALYTICS_ID = UA-XXXXXXXX-Y
GOOGLE_ANALYTICS_PROPERTY = 'my custom code'

Don't use this property unless you know what are you doing. By default, it is set to auto.

To go deeper than this, please refer to Google-Analytics documentation.


Copyright (c) 2015, Khaled Monsoor All rights reserved.

Licensed under BSD license.