iorum-ie/acts_as_viewable

acts_as_viewable

A rather application specific gem for rails 2 which adds the ability to count views of your records.

When a model acts_as_viewable its instances are endowed with a view! method, which takes a single argument - an IP address. Invoking view! on a record records the viewing and increments a counter unless the IP in question has viewed this record within the last n minutes, where n can be specified in minutes via the :ttl option to acts_as_viewable (defaults to 60).

A rake task is provided for pruning view recordings.

Installation

config.gem 'acts_as_viewable'

$ rake gems:install
$ ./script/generate acts_as_viewable
$ rake db:migrate

Example

class Foo < ActiveRecord::Base
	acts_as_viewable :ttl => 60 * 24
end

class FoosController < ActionController::Base
	def show
		@foo = Foo.find(params[:id])
		@foo.view!(request.remote_ip)
		@total_viewings_for_all_time = @foo.views
		@records_of_viewings = @foo.viewings
		@twelve_most_viewed_foos_of_all_time = Foo.most_viewed(12)
	end
end

To delete viewing records greater than 10 days old.

$ rake acts_as_viewable:delete_old_records[10]

This will not effect the total viewings of any record.

Copyright

Copyright (c) 2010 iorum design & technology consultants. See MIT-LICENSE for further details.

acts_as_viewable's Issues

acts_as_viewable no longer works when I use acts_as_archive

I introduced a gem acts_as_archive which allows me to do a "soft delete" -- but acts_as_viewable stops working -- it doesn't recognize the method....is there some overlap between the two?