Project

General

Profile

Themes » History » Version 17

Kelvin Quee, 2024-11-18 09:52

1 1 Mischa The Evil
h1. Themes
2
3 11 Jean-Philippe Lang
Redmine provides basic support for themes. Redmine themes can override stylesheets only (like @application.css@).
4 1 Mischa The Evil
5
h2. Installing a theme
6
7 17 Kelvin Quee
1. If you are on Redmine version 5 or below: First, copy the theme-directory into @../public/themes/@. This would result in a directory-path to @application.css@ like: <pre>
8 1 Mischa The Evil
../public/themes/<themename>/stylesheets/application.css</pre>
9 17 Kelvin Quee
10
If you are on Redmine version 6.0 or above: Please copy the theme-directory into @/themes/@ instead. This would result in a directory-path to @application.css@ like: <pre>
11
/themes/<themename>/stylesheets/application.css</pre>. This is consistent with the requirements (breaking change) as document here: https://www.redmine.org/issues/39111
12 1 Mischa The Evil
13 4 Mischa The Evil
2. You now may need to restart Redmine so that it shows the newly installed theme in the list of available themes.
14 1 Mischa The Evil
15 13 Mihaly Bak
2. Go to "Administration -> Settings" -> "Display" and select your newly created theme in the "Theme" drop-down list. Save your settings.
16 1 Mischa The Evil
17 4 Mischa The Evil
Redmine should now be displayed using the selected theme.
18 1 Mischa The Evil
19
h2. Theme list
20
21 10 Mischa The Evil
A list of available Redmine themes can be found at the [[Theme List|Redmine theme list]].
22 7 Shane Pearlman
23 1 Mischa The Evil
h2. Creating custom themes
24
25 9 Mischa The Evil
There is a howto ([[HowTo create a custom Redmine theme]]) which explains how to create a custom Redmine theme.