ActsAsScribe

A simple plugin that allows to keep history records of the users activities. Common uses could be user's wall, public timeline portlets, etc...

Scribe (From Wikipedia, the free encyclopedia): "A scribe was traditionally a person who could read and write. This usually indicated secretarial and administrative duties such as dictation and keeping business, judicial, and history records for kings, nobles, temples, and cities."

Changes in this fork

The model 'Activity' is now defined as a module called 'ScribeActivity' so, know, you can define a model in your app, for example 'Activity' and include the module like this:

class Activity < ActiveRecord::Base 
    include ScribeActivity
end

so you can complete your model with some actions, finders, etc ...

Resources

Install

• Run the following command:

script/plugin install git://github.com/linkingpaths/acts_as_scribe.git

• Generate the tables via the given generator:

script/generate acts_as_scribe_migration

• And finally...

rake db:migrate

Record activities in your models

  class Comment < ActiveRecord::Base    
    record_activity_of :user
  end

You can use any association that is related to an user:

  class Post < ActiveRecord::Base


belongs_to :author, :class_name => "User"
record_activity_of :author


  end

This will register automatically a new activity when you create or destroy a new record. If you want control over the activities registration based on your model's state just use the :if option

  class Post < ActiveRecord::Base
    belongs_to :author, :class_name => "User"
    record_activity_of :author, :if => Proc.new { |post| post.private == false }
  end

Record activities without related item

If you want to record activities not related to any specific model just use Activity.report in your code:

  def grant_admin(user)


user.admin = true
Activity.report(current_user, :grant_admin, user)


  end

  def login


current_user = User.find(…)
Activity.report(current_user, :login)


  end

More

http://github.com/linkingpaths/acts_as_scribe

http://github.com/linkingpaths/acts_as_scribe/wikis

Copyright (c) 2008 Linking Paths, released under the MIT license