Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

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

branch: master
README.markdown

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."

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 

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

  class Post  "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  "User"
    record_activity_of :author, :if => Proc.new { |post| post.private == false }
  end

If you record activities different than the default create and destroy you can specify the :actions option

  class Post  "User"
    record_activity_of :author, :actions => [:create, :update, :destroy]
  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

If the action is not related to any item, just don't use it.

  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

Something went wrong with that request. Please try again.