Redmine

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

• Version

Tests are performed through redmine_testsuites including all the plugins it supports.

The plugin version corresponds to minimum version of Redmine required. Look at dedicated branch for each Redmine version.

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.after_initialize do
        Redmine::Plugin.find(:your_plugin_name).requires_redmine_plugin :redmine_pluggable_themes, :version_or_higher => '5.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
• If your plugin's theme need to import any Redmine default stylesheet, do that using an absolute path. For example, replace the following:

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

​ with:

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

​Alternatively, you can copy and paste in your plugin the files under assets/stylesheet that you find in this plugin. Those will be addressed by a relative url and contain absolute references.

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