2017-06-16 20:43:09 +00:00
|
|
|
# Copyright (C) 2012-2016 Zammad Foundation, http://zammad-foundation.org/
|
|
|
|
module HasRoles
|
|
|
|
extend ActiveSupport::Concern
|
|
|
|
|
|
|
|
# Checks a given Group( ID) for given access(es) for the instance associated roles.
|
|
|
|
#
|
|
|
|
# @example Group ID param
|
|
|
|
# user.role_access?(1, 'read')
|
|
|
|
# #=> true
|
|
|
|
#
|
|
|
|
# @example Group param
|
|
|
|
# user.role_access?(group, 'read')
|
|
|
|
# #=> true
|
|
|
|
#
|
|
|
|
# @example Access list
|
|
|
|
# user.role_access?(group, ['read', 'create'])
|
|
|
|
# #=> true
|
|
|
|
#
|
|
|
|
# @return [Boolean]
|
|
|
|
def role_access?(group_id, access)
|
2017-06-20 15:13:42 +00:00
|
|
|
return false if !groups_access_permission?
|
|
|
|
|
2017-06-16 20:43:09 +00:00
|
|
|
group_id = self.class.ensure_group_id_parameter(group_id)
|
|
|
|
access = self.class.ensure_group_access_list_parameter(access)
|
|
|
|
|
|
|
|
RoleGroup.includes(:group, :role).exists?(
|
|
|
|
role_id: roles.pluck(:id),
|
|
|
|
group_id: group_id,
|
|
|
|
access: access,
|
|
|
|
groups: {
|
|
|
|
active: true
|
|
|
|
},
|
|
|
|
roles: {
|
|
|
|
active: true
|
|
|
|
}
|
|
|
|
)
|
|
|
|
end
|
|
|
|
|
|
|
|
# methods defined here are going to extend the class, not the instance of it
|
|
|
|
class_methods do
|
|
|
|
|
2017-06-20 15:13:42 +00:00
|
|
|
# Lists instances having the given access(es) to the given Group through Roles.
|
2017-06-16 20:43:09 +00:00
|
|
|
#
|
|
|
|
# @example Group ID param
|
2017-06-20 15:13:42 +00:00
|
|
|
# User.role_access(1, 'read')
|
2017-06-16 20:43:09 +00:00
|
|
|
# #=> [1, 3, ...]
|
|
|
|
#
|
|
|
|
# @example Group param
|
2017-06-20 15:13:42 +00:00
|
|
|
# User.role_access(group, 'read')
|
2017-06-16 20:43:09 +00:00
|
|
|
# #=> [1, 3, ...]
|
|
|
|
#
|
|
|
|
# @example Access list
|
2017-06-20 15:13:42 +00:00
|
|
|
# User.role_access(group, ['read', 'create'])
|
2017-06-16 20:43:09 +00:00
|
|
|
# #=> [1, 3, ...]
|
|
|
|
#
|
|
|
|
# @return [Array<Integer>]
|
2017-06-20 15:13:42 +00:00
|
|
|
def role_access(group_id, access)
|
2017-06-16 20:43:09 +00:00
|
|
|
group_id = ensure_group_id_parameter(group_id)
|
|
|
|
access = ensure_group_access_list_parameter(access)
|
|
|
|
|
|
|
|
role_ids = RoleGroup.includes(:role).where(group_id: group_id, access: access, roles: { active: true }).pluck(:role_id)
|
|
|
|
join_table = reflect_on_association(:roles).join_table
|
2017-06-20 15:13:42 +00:00
|
|
|
joins(:roles).where(active: true, join_table => { role_id: role_ids }).distinct.select(&:groups_access_permission?)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Lists IDs of instances having the given access(es) to the given Group through Roles.
|
|
|
|
#
|
|
|
|
# @example Group ID param
|
|
|
|
# User.role_access_ids(1, 'read')
|
|
|
|
# #=> [1, 3, ...]
|
|
|
|
#
|
|
|
|
# @example Group param
|
|
|
|
# User.role_access_ids(group, 'read')
|
|
|
|
# #=> [1, 3, ...]
|
|
|
|
#
|
|
|
|
# @example Access list
|
|
|
|
# User.role_access_ids(group, ['read', 'create'])
|
|
|
|
# #=> [1, 3, ...]
|
|
|
|
#
|
|
|
|
# @return [Array<Integer>]
|
|
|
|
def role_access_ids(group_id, access)
|
|
|
|
role_access(group_id, access).collect(&:id)
|
2017-06-16 20:43:09 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
def ensure_group_id_parameter(group_or_id)
|
|
|
|
return group_or_id if group_or_id.is_a?(Integer)
|
|
|
|
group_or_id.id
|
|
|
|
end
|
|
|
|
|
|
|
|
def ensure_group_access_list_parameter(access)
|
|
|
|
access = [access] if access.is_a?(String)
|
|
|
|
access.push('full') if !access.include?('full')
|
|
|
|
access
|
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|