Plugin for redmine to show site-wide banner message.
Clone or download
akiko-pusu Merge pull request #92 from akiko-pusu/dev
Prevent run rake task without test env and specifying task name.
Latest commit 5ae2241 Jul 2, 2017

Redmine Banner Plugin

Plugin to show site-wide message from site administrator, such as maintenance information or notifications.

Build Status: wercker status

Plugin installation

For Redmine 2.x:

For Redmine 2.1 or later, please use Version 0.0.8 or later. For Redmine 2.0, please use Version 0.0.7.

  1. Copy the plugin directory into the plugins directory.
  2. Run the migration task. e.g. rake redmine:plugins:migrate RAILS_ENV=production (For Redmine 2.x)
  3. (Re)start Redmine.

Version 0.0.5 later, migration is required.

For Redmine 1.x:

For Redmine 1.x, please use version 0.0.6.

  1. Copy the plugin directory into the vendor/plugins directory.
  2. Run the migration task. e.g. rake db:migrate_plugins RAILS_ENV=production (For Redmine 1.x)
  3. (Re)start Redmine.


For Redmine 2.x, use the following command:

  • rake redmine:plugins:migrate NAME=redmine_banner VERSION=0 RAILS_ENV=production

For Redmine 1.x, use the following command:

  • rake db:migrate_plugins NAME=redmine_banner VERSION=0 RAILS_ENV=production

Usage for site wide banner

  1. Go to plugin's page and click "Settings" link of Redmine Banner Plugin. You can edit banner message and select style for message. Also you can access setting page from administration menu, click "banner" icon.

Usage for project scope banner

  1. Banner can be used as project module. If you want to manage the banner for your project, "Manage Banner" permission is required to your role.

  2. Go to project settings tab and check "Banner" as project module.

  3. Then you can see "Banner" tab on project settings page.

Current limitations

  1. Banner for each project does not support timer.
  2. Banner for each project is located at the top of the project only. (Not support footer)
  3. To render banner, javascript (prototype.js) is required and banner will not be shown correctly if you does not use modern browser.


To use this plugin with older Redmine versions (1.xx, 1.0.x...), please see this instruction.,-1.0.x...)



  • Fix style and css selector. (Github: #45)
  • Change global banner style for responsive mode. (Github: #68)
  • Code refactoring.
  • Fix: Prevent deprecation warning. (Github PR: #60) Thanks, Wojciech.
  • Refactor: Rename file to prevent conflict (Github #63 / r-labs: 54).
  • i18n: Update Italian translation file. (Github: #61 / r-labs: 57) Thanks, R-i-c-k-y.
  • i18n: Add Spanish translation file. (Github: #61 / r-labs: 52) Thanks Picazamora!
  • i18n: Update Turkish translation file. (Github: #64) Thank you so much, Adnan.
  • i18n: Update Portuguese translation file. (Github: #50) Thanks, Guilherme.


  • Support Redmine 3.x.
  • Update some translation files. Bulgarian, German. Thank you so much, Ivan Cenov, Daniel Felix.
  • Change column type of banner_description from string to text.Thank you so much Namezero. (#44)


  • Fixed bug: Global banner timer does not work. (r-labs: #1337)
  • Feature: Add related link field for more information to Global Banner. (r-labs: #1339)
  • i18n: Update Korean translation file. (r-labs: #1329) Thank you so much, Ki Won Kim.


  • Authenticated users can turn off global banner in their session.
  • Add option to show global banner only for authenticated users.
  • Add option to show only at the login page.
  • Code refactoring.
  • Italian translation was contributed by @R-i-c-k-y.
  • French translation was contributed by Laurent HADJADJ.


  • Support Redmine 2.1. (Redmine 2.0.x is no longer supported. Please use version 0.0.7 for Redmine 2.0.x)


  • Compatible with Redmine 2.0.0


  • Fixed bug: Project banner should be off when module turned disabled.
  • Fixed bug: In some situation, "ActionView::TemplateError undefined method is_action_to_display" is happened.
  • Update Russian Translation. Thank you so much, Александр Ананьев.


  • Support banner for each project. Thank you so much, Denny Schäfer, Haru Iida.


  • Support timer function.
  • Add links to turn off or modify banner message quickly. (Links are shown to Administrator only)


  • Code refactoring. Stop to override base.rhtml and use javascript. Great thanks, Haru Iida-san. Also, remove some "To-Do" section of README.

  • Add translations. Russian, German, Brazilian Portugues. Thank you so much, Александр Ананьев, Denny Schäfer, Maiko de Andrade!


  • Support i18n.


  • First release




This software is licensed under the GNU GPL v2. See COPYRIGHT and COPYING for details.