Mastering Redmine

Mastering Redmine is a comprehensive guide with tips, tricks and best practices, and an easy-to-learn structure.

Check the book project on this site and/or

Buy the book

By buying this book you will also be donating to Redmine (see this page).

Project alias plugin

The name of this plugin should be "Project identifier rename"... But project identifier aliases are what makes the renaming possible! They allow to access project pages using different identifiers in URL thus any of such identifiers can be made a project identifier. All that is needed for this is to move the previous identifier to aliases (this is done by replacing the alias which has been made a project identifier). That’s how this plugin does the trick!

Using

New menu item in Administration panel

Project identifier aliases can be managed only by administrators. To add an alias, remove an alias or rename a project identifier one should open "Administration" » "Project aliases".

This menu item will open aliases listing:

Project aliases listing

Notice the link "Use as identifier". By clicking on this link you put the alias into the project as an identifier and save the previous identifier as an alias... So visually nothing changes except the project’s links which now contain the new identifier. The old links are still accessible too.

By clicking on the "New project alias" link one gets the form:

New project alias form

Known issues

Many things rely (or can rely) on the fact that project identifiers cannot be changed! So this plugin can break such things... To provide a solution for them the plugin adds the :controller_project_aliases_rename_after hook which can be used to fix things when project identifier is changed. But till the moment all of such issues are fixed here will be put things (e.g. plugins) which are known to conflict with this plugin or get broken by this plugin.

If you found some other Redmine/ChiliProject functions or plugins which conflict with the Project Alias plugin please feel free to list them on this page or email me directly using this contact form.

Check this page for information on how to use the hook.

Redmine

  • Redmine.pm does not support aliases and if a project identifier is changed Redmine authentication for a SCM will stop to work!

Install

To install the plugin:

  • Copy project_alias directory to #{RAILS_ROOT}/vendor/plugins.
  • Run: rake db:migrate:plugins RAILS_ENV=production.
  • Restart Redmine/ChiliProject.

aliases-menu.png - New menu item in Administration panel (9.4 KB) Andriy Lesyuk, 02 Oct 2011 09:47

aliases-listing.png - Project aliases listing (75.6 KB) Andriy Lesyuk, 02 Oct 2011 09:47

aliases-new.png - New project alias form (33.3 KB) Andriy Lesyuk, 02 Oct 2011 09:47