Project

General

Profile

Themes » History » Revision 19

Revision 18 (Kelvin Quee, 2024-11-19 02:54) → Revision 19/20 (Kelvin Quee, 2024-11-19 02:56)

h1. Themes 

 Redmine provides basic support for themes. Redmine themes can override stylesheets only (like @application.css@). 

 h2. Installing a theme 

 # 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> 
 ../public/themes/<themename>/stylesheets/application.css</pre> 

 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> 
 /themes/<themename>/stylesheets/application.css</pre> /themes/<themename>/stylesheets/application.css</pre>. This is consistent with the requirements (breaking change) as document here: https://www.redmine.org/issues/39111 

 Additionally, for Redmine 6 or above, you will need to serve another directory on your chosen web server. For Apache2, you may consider adding the following config to your current site: 

 <pre><code class="xml"> 
     Alias /assets/themes /themes 
     <Location /themes> 
         Allow from all 
         Options -MultiViews 
         Require all granted 
     </Location> 
 </code></pre> 

 # You now may need to restart Redmine so that it shows the newly installed theme in the list of available themes. 

 # Go to "Administration -> Settings" -> "Display" and select your newly created theme in the "Theme" drop-down list. Save your settings. 

 Redmine should now be displayed using the selected theme. 

 h2. Theme list 

 A list of available Redmine themes can be found at the [[Theme List|Redmine theme list]]. 

 h2. Creating custom themes 

 There is a howto ([[HowTo create a custom Redmine theme]]) which explains how to create a custom Redmine theme.