Class: Spree::RoleConfiguration

Inherits:
Object
  • Object
show all
Defined in:
lib/spree/core/role_configuration.rb

Overview

A class responsible for associating Role with a list of permission sets.

Examples:

Adding order, product, and user display to customer service users.

Spree::RoleConfiguration.configure do |config|
  config.assign_permissions :customer_service, [
    Spree::PermissionSets::OrderDisplay,
    Spree::PermissionSets::UserDisplay,
    Spree::PermissionSets::ProductDisplay
  ]
end

See Also:

Defined Under Namespace

Classes: Role

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#roles ⇒ Object

Returns the value of attribute roles.



32
33
34
 
# File 'lib/spree/core/role_configuration.rb', line 32

def roles
  @roles
end

Instance Method Details

#activate_permissions!(ability, user) ⇒ Object

Given a CanCan::Ability, and a user, determine what permissions sets can be activated on the ability, then activate them.

This performs can/cannot declarations on the ability, and can modify its internal permissions.

Parameters:

  • ability (CanCan::Ability) —

    the ability to invoke declarations on

  • user (#spree_roles) —

    the user that holds the spree_roles association.



42
43
44
45
46
47
48
49
50
51
52
53
 
# File 'lib/spree/core/role_configuration.rb', line 42

def activate_permissions!(ability, user)
  spree_roles = ['default'] | user.spree_roles.map(&:name)
  applicable_permissions = Set.new

  spree_roles.each do |role_name|
    applicable_permissions |= roles[role_name].permission_sets
  end

  applicable_permissions.each do |permission_set|
    permission_set.new(ability).activate!
  end
end

#assign_permissions(role_name, permission_sets) ⇒ Object

Assign permission sets for a Spree::Role that has the name of role_name

Parameters:



67
68
69
70
71
72
 
# File 'lib/spree/core/role_configuration.rb', line 67

def assign_permissions(role_name, permission_sets)
  name = role_name.to_s

  roles[name].permission_sets.concat permission_sets
  roles[name]
end