effective_roles 2.5.0 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5863e0c337f0188827f98f64036bfc3750a722756922e1bba2e78e560a3f3c86
-  data.tar.gz: 856fdc2b51de291936a16b593a538d77b419b9fb1a18cdbb0c4f432cabf884e7
+  metadata.gz: 43ff04eb475329ae2001305352cb8131942fd2f598a5273868720aeede0ca553
+  data.tar.gz: 100d76c0b230bd759fbc222714de32f443e42e5ef21dc00495bd7e4c1a4ad684
 SHA512:
-  metadata.gz: f3a4376eefee3efc1479fe86480b0b80196b45e57a173db955d3bb8d2ea32566a9b541be765de98005a6d0c96c40aaba16b59ef5e66d9e852a315298f59d377f
-  data.tar.gz: c0f838015be8b4ea637557be7abcebbd5cc0ab5220a1e776fc2a4520c12971fd7d92a9dfbbb0ad556c5a53989345676984c5a1dcdc4a488c0d08a2e9cac99bfa
+  metadata.gz: 54b6b93166130c94368c9d39505d24181d66ec7b8c63dd5c0a2488672ef9fbab7e00658558c45e99d49d58cfdef6bc4c7f5918129af4a90cd5ce7666348025fd
+  data.tar.gz: 90bb9ab5d3b7d86efbfafdeef445d8a94bae9352ad199173b6e3a96d551a4d77a3fffb13a7e858aa35c836583ea0d0852b462af226cc31e66af252137a8f1ee3

data/app/helpers/effective_roles_helper.rb

@@ -1,4 +1,21 @@
 module EffectiveRolesHelper
+
+  def roles_badges(obj)
+    roles = Array(obj.try(:roles) || obj) - [nil, '']
+
+    if (unexpected = roles - EffectiveRoles.roles).present?
+      raise "Unexpected value: #{unexpected}. Expected an acts_as_roleable object or an array of roles."
+    end
+
+    badges = roles.map do |role|
+      color = EffectiveRoles.color(role)
+
+      content_tag(:span, role, class: ("badge badge-#{color}" if color.present?), title: role.to_s.titleize)
+    end
+
+    badges.join(' ').html_safe
+  end
+
   def effective_roles_summary(obj, options = {}) # User or a Post, any acts_as_roleable
     raise 'expected an acts_as_roleable object' unless obj.respond_to?(:roles)
 

data/config/effective_roles.rb

@@ -23,11 +23,17 @@ EffectiveRoles.setup do |config|
   # Or just keep it simple, and use this Hash syntax of permissions for every resource
   #
   config.role_descriptions = {
-    :superadmin => 'full access to everything. Can manage users and all website content.',
-    :admin => 'full access to website content.  Cannot manage users.',
-    :member => 'cannot access admin area.  Can see all content in members-only sections of the website.'
+    superadmin: 'full access to everything. Can manage users and all website content.',
+    admin: 'full access to website content.  Cannot manage users.',
+    member: 'cannot access admin area.  Can see all content in members-only sections of the website.'
   }
 
+  # config.role_colors
+  # ========================
+  # Assign a bootstrap color to a role. Optional.
+  # Used by the roles_badges() helper to display this role as a badge
+  # config.role_colors = { superadmin: :primary, admin: :secondary, member: :light }
+
   # config.assignable_roles
   # Which roles can be assigned by whom
   # =======================

data/lib/effective_roles/version.rb

@@ -1,3 +1,3 @@
 module EffectiveRoles
-  VERSION = '2.5.0'.freeze
+  VERSION = '2.6.0'.freeze
 end

data/lib/effective_roles.rb

@@ -5,7 +5,7 @@ require 'effective_roles/version'
 module EffectiveRoles
 
   def self.config_keys
-    [:roles, :role_descriptions, :assignable_roles, :layout]
+    [:roles, :role_descriptions, :role_colors, :assignable_roles, :layout]
   end
 
   include EffectiveGem
@@ -39,6 +39,11 @@ module EffectiveRoles
     roles_for(roles).map { |r| 2 ** config.roles.index(r) }.sum
   end
 
+  def self.color(role)
+    raise('expected a role') unless role.kind_of?(Symbol)
+    (role_colors || {})[role]
+  end
+
   def self.roles_collection(resource, current_user = nil, only: nil, except: nil, multiple: nil, skip_disabled: nil)
     if assignable_roles.present?
       raise('expected object to respond to is_role_restricted?') unless resource.respond_to?(:is_role_restricted?)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: effective_roles
 version: !ruby/object:Gem::Version
-  version: 2.5.0
+  version: 2.6.0
 platform: ruby
 authors:
 - Code and Effect
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-08-24 00:00:00.000000000 Z
+date: 2024-04-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails