This spree extension is built on CanCan to dynamically add new roles and define its access through permissions.
Try Spree Admin Roles and Access for Spree master with direct deployment on Heroku:
Try Spree Admin Roles and Access for Spree 4-1 with direct deployment on Heroku:
Try Spree Admin Roles and Access for Spree 3-4 with direct deployment on Heroku:
Try Spree Admin Roles and Access for Spree 3-1 with direct deployment on Heroku:
Add spree_admin_roles_and_access to your Gemfile:
#### Spree >= 3.2
gem 'spree_admin_roles_and_access', github: 'vinsol-spree-contrib/spree_admin_roles_and_access'
#### Spree < 3.2
gem 'spree_admin_roles_and_access', github: 'vinsol-spree-contrib/spree_admin_roles_and_access', branch: 'X-X-stable'
Note Please use 3-1-stable-updated branch for spree-3-1
Bundle your dependencies and run the installation generator:
bundle exec rails g spree_admin_roles_and_access:install
bundle exec rake spree_roles:permissions:populate # To populate user and admin roles with their permissions
bundle exec rake spree_roles:permissions:populate_permission_sets # To set up some convenient permission sets.
From Admin end, There are three menu's in the configuration Tab:
admin_accessible in the role edit page.
A role marked as such will get a default admin dashboard page in case they land on an admin page on which they do not have access.
Once permissions are created you can organize groups of them into permission sets, These permission sets can then be assigned to the user's role which requires them.
Points to remember
If the controller doesn't have any model associated with it, then we will provide the full controller path like :- can-read-spree/admin/pos
Every Role should also have admin permission of that particular controller. For eg:- To create a product, can-admin-spree/product is also needed along with can-create-spree/product.
To define custom cancan permissions, which can not be made with the pattern adopted.
Override the module Permission. And define the permission in a method, and create a permission in the database. See example of
v3.2.1 introduces some breaking changes.
After updating the gem version. Run
rails g spree_admin_roles_and_access:install to get the latest migrations. This includes a migration that generates a permission set per user role. With this, you should be able to continue using the original roles as you were earlier.
Additionally you may want to run the rake task
populate_permission_sets to seed some initial permission sets. You can now gradually opt into seperating user role permissions into appropriate permission sets.
The original relationship between roles and permissions can be accessed via,
legacy_permissions. They are not supported or editable via the admin interfaces and are only mantained for use in our migration task.
Note in the previous version read action was only for show. That has been superseded by read action now implying both show and index.
Be sure to bundle your dependencies and then create a dummy test app for the specs to run against.
bundle exec rake test_app
bundle exec rspec spec
If you are using older version of spree. You can use the following version, please check the relavent readme for version specific installation guide.
# Spree 2.4.0-rc3
gem 'spree_admin_roles_and_access', '1.3.0'
# Spree 2.1.x
gem 'spree_admin_roles_and_access', '1.1.0'
# Spree 2.0.x
gem 'spree_admin_roles_and_access', '1.0.0'
bundle exec rake test_app to create the test application in
bundle exec rspec spec.
Copyright (c) 2017 vinsol.com, released under the New MIT License