https://github.com/para-cms/para-acl
Para plugin to manage admin panel components access authorizations
https://github.com/para-cms/para-acl
Last synced: 9 months ago
JSON representation
Para plugin to manage admin panel components access authorizations
- Host: GitHub
- URL: https://github.com/para-cms/para-acl
- Owner: para-cms
- License: mit
- Created: 2015-12-16T18:56:08.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2017-10-08T18:15:38.000Z (over 8 years ago)
- Last Synced: 2025-03-31T08:43:40.312Z (12 months ago)
- Language: Ruby
- Size: 30.3 KB
- Stars: 0
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Para::Acl
This [Para](https://github.com/para-cms/para/) plugin adds a simple admin roles
management system which allows you to change which kind of admins have access
to which components.
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'para-acl', github: 'para-cms/para-acl'
```
And then execute:
$ bundle
Or install it yourself as:
$ gem install para-acl
## Usage
Use the install generator to copy the migrations, create the super admin role.
_Note : the generator needs to update the database schema and insert data in
your database to make all existing admins have the defaul Super Admin role.
So migrations will be copied and automatically run._
$ rails g para:acl:install
Add the plugin to your `config/initializers/para.rb` file :
```ruby
config.plugins += [:acl]
```
Add a `:acl_roles` component in your `config/components.rb` :
```ruby
component :acl, :acl_roles
```
Restart your server and access your new "Acl" component to manage roles and
authorizations.
### Deployment
When you deploy your app, you may need to reset admins privileges and reassign
roles on your deployment environment.
All you need is to run the `para:acl:authorize_admins` rake task, that'll
create the "Super Admin" role if it doesn't exist and assign that role to
all existing admin users.
For a production deployment, you'll run the following on your server :
```bash
rake RAILS_ENV=production para:acl:authorize_admins
```
Alternatively, you can manually create that role and assign the desired
admin users to it from a remote rails console.
### Disable authorization to debug or fix an error
You can disable the whole authorization system and allow for anybody to
access any component by configuring the following setting in your `config/initializers/para.rb` :
```ruby
config.acl.bypass_admin_authorization = true
```
## Contributing
1. Fork it ( https://github.com/para-cms/para-acl/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request