Redmine plugin for per-project role replacements.
Ruby HTML
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app
config
db/migrate
lib/redmine_role_replacements
test
.travis.yml
LICENSE.txt
README.md
init.rb
role_replacement_1.PNG
role_replacement_2.PNG
role_replacement_3.PNG
role_replacement_4.PNG
role_replacement_5.PNG
role_replacement_6.PNG

README.md

Redmine Role Replacement Plugin

Build Status Code Climate

This plugin enables replacement of roles in Redmine projects.

Compatibility

This plugin is compatible with Redmine 2.x only.

Installation

  1. To install the plugin

    • Download the .ZIP archive, extract files and copy the plugin directory into #{REDMINE_ROOT}/plugins.

    Or

    • Change you current directory to your Redmine root directory:

      cd {REDMINE_ROOT}
      

      Copy the plugin from GitHub using the following command:

        git clone https://github.com/Undev/redmine_role_replacements.git plugins/redmine_role_replacements
      
  2. Update the Gemfile.lock file by running the following commands:

     rm Gemfile.lock  
     bundle install
    
  3. This plugin requires a migration. Run the following command to upgrade your database (make a database backup before):

    bundle exec rake redmine:plugins:migrate RAILS_ENV=production
    
  4. Restart Redmine.

Now you should be able to see the plugin in Administration > Plugins.

Usage

The plugin adds the Role replacements section to the Roles and permissions tab of the Administration menu. role replacements

You can select the Manage role replacements check box for the roles which should be allowed to replace roles in the project. By default, Manage role replacement is enabled for managers only. We recommend creating a special role for role replacement management.

To replace roles in a project, you should enable the Role replacements module in the project settings.
role replacement module

If you have the Manage role replacements permission, you will see a new Role replacements tab, where you can add, edit and delete the project role replacement rules. role replacements tab

To add a role replacement rule, click New role replacement.
add role replacement

In private projects, replacement of Anonymous and Non member roles is prohibited. role replacement

In public projects, all role replacement variants are possible. role replacement

The table below shows all possible role replacement variants and their results:

Role After
Anonymous Non Member Member
Role Before Private Project Anonymous N/A N/A N/A
Non Member N/A N/A N/A
Member N/A N/A L J V
Public Project Anonymous N/A L V L V
Non Member L V N/A L V
Member L J V L J V L J V
  • N/A — replacement is not valid and cannot be applied
  • L — the project is visible in the project list
  • J — the project is visible in the Jump to a project drop-down list
  • V — the project can be accessed according to permissions of the target role (Role After)

Maintainers

Danil Tashkinov, github.com/nodecarter

License

Copyright (c) 2015 Undev

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.