will/cancan
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

little fixes to inline documentation (rdocs)

Browse Source
This commit is contained in:
Ryan Bates 2009-11-19 09:46:30 -08:00
parent 0ae41f57b8
commit 5bd1a85410
2 changed files with 32 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
lib/cancan/ability.rb
View File

@ -17,14 +17,22 @@ module CanCan
#
module Ability
attr_accessor :user
# Use to check the user's permission for a given action and object.
#
# can? :destroy, @project
#
# You can also pass the class instead of an instance (if you don't have one handy).
#
# can? :create, Project
#
# Not only can you use the can? method in the controller and view (see ControllerAdditions),
# but you can also call it directly on an ability instance.
#
# ability.can? :destroy, @project
#
# This makes testing a user's abilities very easy.
#
#
# def test "user can only destroy projects which he owns"
# user = User.new
# ability = Ability.new(user)
@ -103,17 +111,35 @@ module CanCan
@can_history << [action, target, block]
end
# Finally, you can use the "alias_action" method to alias one or more actions into one.
# Alias one or more actions into another one.
#
# alias_action :update, :destroy, :to => :modify
# can :modify, Comment
#
# Then :modify permission will apply to both :update and :destroy requests.
#
# can? :update, Comment # => true
# can? :destroy, Comment # => true
#
# This only works in one direction. Passing the aliased action into the "can?" call
# will not work because aliases are meant to generate more generic actions.
#
# alias_action :update, :destroy, :to => :modify
# can :update, Comment
# can? :modify, Comment # => false
#
# Unless that exact alias is used.
#
# can :modify, Comment
# can? :modify, Comment # => true
#
# The following aliases are added by default for conveniently mapping common controller actions.
#
# alias_action :index, :show, :to => :read
# alias_action :new, :to => :create
# alias_action :edit, :to => :update
#
# This way one can use params[:action] in the controller to determine the permission.
def alias_action(*args)
@aliased_actions ||= default_alias_actions
target = args.pop[:to]

6
lib/cancan/controller_additions.rb
View File

@ -47,8 +47,8 @@ module CanCan
::Ability.new(current_user)
end
# Use the "can?" method in the controller or view to check the user's permission
# for a given action and object.
# Use in the controller or view to check the user's permission for a given action
# and object.
#
# can? :destroy, @project
#
@ -58,7 +58,7 @@ module CanCan
# <%= link_to "New Project", new_project_path %>
# <% end %>
#
# This simply calls "can?" on the current_ability.
# This simply calls "can?" on the current_ability. See Ability#can?.
def can?(*args)
(@current_ability ||= current_ability).can?(*args)
end