fengyibo / redmine_pluggable_themes

Allows Redmine plugins to export themes in assets

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);