Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A Middleman plugin to handle generating your Google Analytics tracking code.
branch: master

README.md

middleman-google-analytics

Gem Version Build Status Dependency Status

middleman-google-analytics is a Middleman extension that generates Google Analytics tracking code, and keeps your config in config.rb, where it belongs.

Installation

  1. Specify the dependency in your project's Gemfile:

    # Gemfile
    gem "middleman-google-analytics"
  2. Activate the Google Analytics extension in your project's config.rb:

    # config.rb
    activate :google_analytics do |ga|
      ga.tracking_id = 'UA-XXXXXXX-X' # Replace with your property ID.
    end
  3. In your layout, after your footer, call google_analytics_tag or google_analytics_universal_tag and include the results in the page:

    Haml:

    # Google Analytics
    = google_analytics_tag
    # Universal Analytics
    = google_analytics_universal_tag

    ERB:

    # Google Analytics
    <%= google_analytics_tag %>
    # Universal Analytics
    <%= google_analytics_universal_tag %>

Configuration

activate :google_analytics do |ga|
  # Property ID (default = nil)
  ga.tracking_id = 'UA-XXXXXXX-X'

  # Removing the last octet of the IP address (default = false)
  ga.anonymize_ip = false

  # Tracking across a domain and its subdomains (default = nil)
  ga.domain_name = 'example.com'

  # Tracking across multiple domains and subdomains (default = false)
  ga.allow_linker = false

  # Tracking Code Debugger (default = false)
  ga.debug = false

  # Tracking in development environment (default = true)
  ga.development = true

  # Compress the JavaScript code (default = false)
  ga.minify = false
end

Usage

Once you've bundled you should be able to run middleman as normal, and have it display the GA tracking code.

Special Thanks

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

License

Copyright (c) 2014-2015 Daniel Bayerlein. See LICENSE for details.

Copyright (c) 2013 Jon Frisby.

Something went wrong with that request. Please try again.