#-- encoding: UTF-8 #-- copyright # OpenProject is a project management system. # # Copyright (C) 2012-2013 the OpenProject Team # # This program is free software; you can redistribute it and/or # modify it under the terms of the GNU General Public License version 3. # # See doc/COPYRIGHT.rdoc for more details. #++ class Role < ActiveRecord::Base # Built-in roles BUILTIN_NON_MEMBER = 1 BUILTIN_ANONYMOUS = 2 scope :givable, { :conditions => "builtin = 0", :order => 'position' } scope :builtin, lambda { |*args| compare = 'not' if args.first == true { :conditions => "#{compare} builtin = 0" } } scope :like, lambda { |q| s = "%#{q.to_s.strip.downcase}%" {:conditions => ["LOWER(name) LIKE :s", {:s => s}] } } before_destroy :check_deletable has_many :workflows, :dependent => :delete_all do def copy(source_role) Workflow.copy(nil, source_role, nil, proxy_association.owner) end end has_many :member_roles, :dependent => :destroy has_many :members, :through => :member_roles acts_as_list serialize :permissions, Array attr_protected :builtin validates_presence_of :name validates_uniqueness_of :name validates_length_of :name, :maximum => 30 def permissions read_attribute(:permissions) || [] end def permissions=(perms) perms = perms.collect {|p| p.to_sym unless p.blank? }.compact.uniq if perms write_attribute(:permissions, perms) end def add_permission!(*perms) self.permissions = [] unless permissions.is_a?(Array) permissions_will_change! perms.each do |p| p = p.to_sym permissions << p unless permissions.include?(p) end save! end def remove_permission!(*perms) return unless permissions.is_a?(Array) permissions_will_change! perms.each { |p| permissions.delete(p.to_sym) } save! end # Returns true if the role has the given permission def has_permission?(perm) !permissions.nil? && permissions.include?(perm.to_sym) end def <=>(role) role ? position <=> role.position : -1 end def to_s name end # Return true if the role is a builtin role def builtin? self.builtin != 0 end # Return true if the role is a project member role def member? !self.builtin? end # Return true if role is allowed to do the specified action # action can be: # * a parameter-like Hash (eg. :controller => '/projects', :action => 'edit') # * a permission Symbol (eg. :edit_project) def allowed_to?(action) if action.is_a? Hash allowed_actions.include? "#{action[:controller]}/#{action[:action]}" else allowed_permissions.include? action end end # Return all the permissions that can be given to the role def setable_permissions setable_permissions = Redmine::AccessControl.permissions - Redmine::AccessControl.public_permissions setable_permissions -= Redmine::AccessControl.members_only_permissions if self.builtin == BUILTIN_NON_MEMBER setable_permissions -= Redmine::AccessControl.loggedin_only_permissions if self.builtin == BUILTIN_ANONYMOUS setable_permissions end # Find all the roles that can be given to a project member def self.find_all_givable find(:all, :conditions => {:builtin => 0}, :order => 'position') end # Return the builtin 'non member' role. If the role doesn't exist, # it will be created on the fly. def self.non_member non_member_role = find(:first, :conditions => {:builtin => BUILTIN_NON_MEMBER}) if non_member_role.nil? non_member_role = create(:name => 'Non member', :position => 0) do |role| role.builtin = BUILTIN_NON_MEMBER end raise 'Unable to create the non-member role.' if non_member_role.new_record? end non_member_role end # Return the builtin 'anonymous' role. If the role doesn't exist, # it will be created on the fly. def self.anonymous anonymous_role = find(:first, :conditions => {:builtin => BUILTIN_ANONYMOUS}) if anonymous_role.nil? anonymous_role = create(:name => 'Anonymous', :position => 0) do |role| role.builtin = BUILTIN_ANONYMOUS end raise 'Unable to create the anonymous role.' if anonymous_role.new_record? end anonymous_role end def self.by_permission(permission) all.select do |role| role.allowed_to? permission end end def self.paginated_search(search, options = {}) limit = options.fetch(:page_limit) || 10 page = options.fetch(:page) || 1 givable.like(search).paginate({ :per_page => limit, :page => page }) end private def allowed_permissions @allowed_permissions ||= permissions + Redmine::AccessControl.public_permissions.collect {|p| p.name} end def allowed_actions @actions_allowed ||= allowed_permissions.inject([]) { |actions, permission| actions += Redmine::AccessControl.allowed_actions(permission) }.flatten end def check_deletable raise "Can't delete role" if members.any? raise "Can't delete builtin role" if builtin? end end