Land

Land is a clickstream tracker for Rails applications. It will track visits, pageviews, marketing attribution and more.

Add this line to your application's Gemfile:

gem 'land'

And then execute:

$ bundle install

Or, install it yourself:

$ gem install land

To copy migrations to db/migrate run:

$ rails land:install:migrations

Install with:

$ rails g land:install

Then edit config/initializers/land.rb.

After checking out the repo, run bin/setup to install dependencies, create database, and confirm test suite is working. You can also run rails console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

To start a console run bin/rails console or rails c

Land uses a gem called appraisal to test against multiple versions of Rails. Another gem, combustion provides a minimal environment to run Rails.

Setup your database using rails db:drop db:create db:migrate.

To run the test suite against all versions of rails run rake or appraisal rspec. To run the test suite against just the latest version of rails run rspec.

Appraisal | Combustion

Bug reports and pull requests are welcome on GitHub at https://github.com/companygardener/land.

The gem is available as open source under the terms of the MIT License.