Installation of plugin on the server with «Redmine» | RM+

Instructions for installing the plugin «Luxury buttons»

Before installation

  1. Make sure that your server meets the system requirements for plugin «Luxury Buttons».

Redmine Ruby Rails Database The Browser
Guaranteed 3.4 - 4.0 1.9.3, 2.0 - 2.5 4.2, 5.2 MySQL Chrome, Firefox, Opera, Internet explorer 9, 10
Should work > 4.0 > 2.5 x ActiveRecord compatible DB Any modern browser

2.  Make sure that you transfer files to the server in the binary mode if copying files via ftp or ssh-client.
3.   You can also read our instructions on the use of the plugin Luxury Buttons


  1. All the files used in the instructions, you can download in your personal account page.
  2. Download version of plugin that match to your Redmine version.
  3. Unzip the archive with the plugin «Luxury buttons».
  4. Copy the folder with the plugin «Luxury buttons» in the plugins folder of «Redmine» — «plugins».
  5. Download archives «a_common_libs», «global_roles», «redmine_sender».
  6. Open archives with plugins and select folders that match to your Redmine version.
  7. Copy contents of selected folders to the folder «Redmine» — «plugins».
  8. Copy folder «rgloader» to the root directory of «Redmine».
  9. Ensure that the user, under which you run the web-server, has access to the root installation folder of «Redmine». As possible solution for UNIX operating systems, run the following commands:
  sudo chmod 775 -R your_redmine_root_folder
  sudo chown -R your_web_server_user:your_web_server_group your_redmine_folder
  1. Run `bundle install` to install missing gems (make sure performing command in the root installation folder of «Redmine»)
  1. Perform plugin migrations (make sure performing command in the root installation folder of «Redmine»):

  rake redmine:plugins:migrate RAILS_ENV=production

  1. Fill in the database with the necessary data (specify the language correctly)

for Redmine 3.4

  rake redmine:lb:fill_button_types LANG=ru RAILS_ENV=production

for Redmine 3.0-3.3

  rake redmine:fill_button_types LANG=ru RAILS_ENV=production

  1. Restart your web-server.
  2. Go to the «A common libs» plugin settings and make sure that libraries «Select2» and «Bootstrap» are enabled. Also include settings Enable patches to core redmine javascript and Enable tiny modals

After installation

For proper work of plugin it is required to enable the module «Luxury Buttons» in settings of each project where you will use buttons.

We do not recommend to use the permission settings of the status transition and rights of the fields visibility that are available in the standard «Redmine». Such settings may lead to conflicts that are difficult to track.

To disable this settings:

  1. Go to «Luxury Buttons» module settings.
  2. Enable options Ignore limitation in «Transitions» settings section and Ignore limitation in «Field permissions» settings section. This eliminates the need to prescribe permission status-transitions in default Redmine settings. Exceptions work only for projects where the module Luxury Buttons is enabled.

Plugin «Luxury buttons» sets restrictions on the creation of issues with specific tracker by roles . Therefore , it is necessary to specify which roles can create issues with a specific tracker. Otherwise, your users will not be able to create an issue.

To perform these settings:

  1. Go to the menu item «Administration → Trackers».
  2. Choose a specific tracker.
  3. Select the roles who can create issues with this tracker.
  4. Repeat this procedure for all the trackers.

Upgrading to new version

In order to upgrade to new version of the plugin, please do the following steps:

  1. Download new version of the plugin from this site.
  2. Remove "luxury_buttons" plugin directory from the redmine/plugins.
  3. Copy "luxury_buttons" directory of the downloaded latest version of the plugin to redmine_root_directory/plugins as usual.
  4. Perform plugin migrations (make sure performing command in the root installation folder of «Redmine»):
  5.   rake redmine:plugins:migrate RAILS_ENV=production

  6. Restart your web-server.