Plugins Directory » Configurable Applications Space

10600 Author: Massimo Rossello
Website: https://github.com/maxrossello/redmine_app__space
Code repository: https://github.com/maxrossello/redmine_app__space
Registered on: 2013-10-11 (about 4 years ago)
Current version: 0.0.2
Compatible with: Redmine 2.4.x, 2.3.x, 2.2.x, 2.1.x, 2.0.x
User ratings:   (0)

Redmine Configurable Applications Space

Tested with redmine 2.3.2, compatible with 2.x

Enhance Redmine application menu (the one that is displayed when browsing outside of projects) with dynamic configurability options.

  • Administrators can select the set of applications available, and optionally enable them to just some user group
  • Enabled users can select the applications they will see listed in the application menu

Both full controllers and partials (e.g. the my/blocks views) can be made an application.

Usage

As an administrator, enter the plugin configuration page and flag the applications you want to let the users use. You can optionally select a group of authorized users per each application.

As an user, you can find a new 'Applications' entry in the top-left menu, which allows to select applications wanted into the application menu.

Plugins that add entries into the application menu in the standard Redmine way keep a fixed, non configurable entry.

How to create a new managed app

  1. name your plugin 'redmine_app_<appname>'.
    Note that this plugin is named with a double underscore between 'app' and 'space', so your plugin will be always loaded after this, which is mandatory.
  2. this plugin creates two new routing verbs, 'application' for apps with a controller, and 'block' for simple partials to display as apps.
    These verbs create routes from 'apps/<name>' that must be loaded before this plugin load 'apps/:tab' in order not to be ignored.
    Therefore, you must declare your app routing within init.rb into a section like the following examples:
         RedmineApp::Application.routes.prepend do
            application 'name_of_app', :to => 'controller#method', :via => get
            block 'name_of_app', 'partial_path'
         end
    

    The syntax is similar to that of the 'match' verb, with some simplifications. Blocks restrict to the get method as default if :via is not specified.
  3. create translations:
    label_<name_of_app> is the applications menu entry
    label_<name_of_app>_description is the help text displayed in the app selection pages

Changelog

0.0.2 (2013-11-08)

Compatible with Redmine 2.4.x, 2.3.x, 2.2.x, 2.1.x, 2.0.x.

Now it is possible to optionally define the authorized users group per each application.

redmine_app__space-0.0.2.zip (128 KB) Massimo Rossello, 2013-11-08 14:42

0.0.1 (2013-10-11)

Compatible with Redmine 2.4.x, 2.3.x, 2.2.x, 2.1.x, 2.0.x.