Skip to content

Repository files navigation

Build Status

Action Tracker

Action and event trackers made easy. With this gem you can track your user actions without adding unnecessary code in your controllers.

Installation

Add this line to your application's Gemfile:

gem'action_tracker'

And then execute:

$ bundle

Or install it yourself as:

$ gem install action_tracker

The Tracker file structure must follow the controllers names and actions

Simple usage

Simple add the wanted actions to track, with same name as the controller.

# app/trackers/users_tracker.rbclassUsersTracker < ActionTracker::Base# This file tracks UsersControllerdefindex;enddefshow;enddefcreate;endend

Advanced usage

The parameters that will be send to Tracker tools can be easily customized. As the example above, is necessary to create the action, same as controllers and the return will be send to tracker tool.

# app/trackers/posts_tracker.rbclassPostsTracker < ActionTracker::Base# This file tracks PostsControllerdefshow{name: 'post-was-viewed',data: {post_id: @post.id,tags: @post.tags}}endend

Options

NameDescriptionDefault
nameThe name of the tracked event.The controller action name. Eg.: 'users#index'

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/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.

Contributing

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

License

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

About

Easy way to track actions in your application

Resources

Stars

7 stars

Watchers

7 watching

Forks

Releases

Packages

Used by

Contributors

Languages