๐Ÿ“ˆ A @middleman plugin to handle generating your Google Analytics tracking code.
Gherkin Ruby HTML
Fetching latest commitโ€ฆ
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
features Add option "disable" and "test" Dec 21, 2016
fixtures
lib Add option "disable" and "test" Dec 21, 2016
.coveralls.yml
.gitignore https://github.com/github/gitignore Apr 16, 2014
.travis.yml
CHANGELOG.md
Gemfile
Gemfile-v3 Add Coveralls Sep 24, 2016
LICENSE Happy New Year! Jan 1, 2017
README.md
Rakefile
middleman-google-analytics.gemspec Required Ruby Version >= 2.2.0 Dec 21, 2016

README.md

middleman-google-analytics

Gem Version Build Status Dependency Status Coverage 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:
gem 'middleman-google-analytics', '~> 3.0'
  1. 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
  1. In your layout, after your footer, call google_analytics_tag and include the results in the page:

Haml:

= google_analytics_tag

ERB:

<%= google_analytics_tag %>

JavaScript with ERB (js.erb):

<%= google_analytics_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

  # Enhanced Link Attribution (default = false)
  ga.enhanced_link_attribution = false

  # Log detail messages to the console (default = false)
  ga.debug = false

  # Trace debugging will output more verbose information to the console (default = false)
  ga.debug_trace = false

  # Disable extension (default = false)
  ga.disable = true

  # Testing your implementation without sending hits (default = true) in development
  ga.test = true

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

  # Output style - :html includes <script> tag (default = :html)
  ga.output = :js
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-2017 Daniel Bayerlein. See LICENSE for details.

Copyright (c) 2013 Jon Frisby.