This document explains what's new in CanCan 1.6. If you are just getting started with CanCan, first check out the README.
If you have MetaWhere installed, it is now possible to use those queries in abilities.
can :read, Project, :priority.lt => 3 can :update, Article, :published_at.not_eq => nil
| joining are not supported yet but hopefully will be soon. If you are interested in helping add this please see the issue tracker.
It is now possible to pass a scope instead of an SQL string when using a block in an ability.
can :read, Article, Article.published do |article| article.published_at <= Time.now end
This is really useful if you have complex conditions which require
joins. A couple caveats:
candefinitions that match the same action and model since it is not possible to combine them. An exception will be raised when that is the case.
cannot, the scope needs to be the inverse since it's passed directly through. For example, if you don't want someone to read discontinued products the scope will need to fetch non discontinued ones:
cannot :read, Product, Product.where(:discontinued => false) do |product| product.discontinued? end
It is only recommended to use scopes if a situation is too complex for a simple hash condition.
check_authorization method now supports
:unless options. Either one takes a method name as a symbol. This method will be called to determine if the authorization check will be performed. This makes it very easy to skip this check on all Devise controllers since they provide a
class ApplicationController < ActionController::Base check_authorization :unless => :devise_controller? end
Here's another example where authorization is only ensured for the admin subdomain.
class ApplicationController < ActionController::Base check_authorization :if => :admin_subdomain? private def admin_subdomain? request.subdomain == "admin" end end
check_authorization only ensures that authorization is performed. If you have
authorize_resource the authorization will still be performed no matter what is returned here.
This update includes many other minor fixes and improvements.
load_and_authorize_resourceto add it before any previously defined filters
accessible_byinstead of always using
Check out the CHANGELOG for the full list of changes and credits.