/redmine_pluggable_themes

Allows Redmine plugins to export themes in assets

Primary LanguageRubyMIT LicenseMIT

Redmine Pluggable Themes

Tested with Redmine 3.4.6, 3.4.7.

Allows Redmine plugins to provide themes just like other assets.

Possible use cases:

  • Easier installation of themes
  • Theme enhancements integrated with code extensions
  • Deployment of customer-specific customizations including theme, in a single package

Installation

Place the plugin code under the plugins directory.

cd {redmine root}
git clone https://github.com/maxrossello/redmine_pluggable_themes.git plugins/redmine_pluggable_themes

How to export a theme

  • Set a dependency of your plugin to this plugin in your init.rb. The following code checks the dependency without need of particular care to the plugin names.
    Rails.configuration.to_prepare do
        Redmine::Plugin.find(:your_plugin_name).requires_redmine_plugin :redmine_pluggable_themes, :version_or_higher => '1.0.0'
    end
  • Create a folder assets/themes
  • Put a Redmine theme in the created folder, just as you would do into Redmine root's public/themes folder
  • Edit stylesheets/application.css and change the line (if present)
    @import url(../../../stylesheets/application.css);

to

  
    @import url(/stylesheets/application.css);