# Foreword
============
First of all, thank you for purchasing the Abacus theme and making the continuous development possible. Since this is a theme and not a plugin, some changes to the theme are possible, but just by editing the code itself, and not using a GUI in Redmine. 


# Contents
============
1.  Installation
2.  Sub-folder Problem
3.  Translation
5.  Fixed Menu
6.  Home Item
7.  Jump-to-project select
8.  Project Tree
9.  My Issues
10. Content Too Wide
11. Use a Company Logo
    
## Installation
============

1.  Upload the theme unzipped folder into public/themes on your Redmine server. Then login to Redmine, go to Administration \> Settings \> Display tab and select the uploaded Abacus theme. No need to restart apache.

2.  If a previous version of the theme exists, just follow step 1. The theme versions are numbered so you will not override any existing theme version.

3.  If you want to make any changes to the theme, use the
    overrides/overrides.css file. Also, make sure to backup the overrides.css file in case you make an update of the theme in the future. The LESS files are compiled using [Prepros](<https://prepros.io>).

## Subfolder Problem (menu links not working)
=========

If you have your Redmine in a **subfolder**, 3 links in the main menu will not work - Issues, Spent time and the logo link. To make it work, open javascripts/theme.js and locate:

\* line 7 which looks like this:

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
subFolder = ""; //Leave it empty "" or add the name of your subfolder, e.g. "/redmine"
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

and change it according to the commented instructions. In Bitnami, the subfolder is
`/redmine`.

## Translation
===========

If you want to translate top menu items that are in English (Issues, Spent time) and the "Toggle descriptions" feature into your language, go to javascripts/theme.js and locate lines 8, 9 & 10. These items are added in this file. There you can translate them into your language or simply change them: Example:

\* line 8:

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
issues = "Issues"; //Top menu - translation for Issues
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

\--\> translate/change "Issues" so it looks for example like this:

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
issues = "Tickets"; //Top menu - translation for Issues
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Follow the same procedure with line 9 & 10. 
 

**Note 1**: maintain the quotation marks where they are otherwise it will not work

**Note 2**: the example is in English-to-English so everyone can understand but you can change the words into any language you need


## Fixed Menu
==========

If you do not like the fixed menu, just locate `your_theme/stylesheets/application.css` and either comment or delete line 4 which says: 

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@import "css/fixed_menu.css";
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

. The mobile version of the menu run on Redmine 3.2+ is not fixed.


## Home Item
==========

If you want to hide the "Home" top menu item, just go to
`your_theme/stylesheets/css/overrides/overrides.css` and uncomment (delete) lines 4 & 9.

## Jump-to-project select
==========

If you want to adjust the "jump to project select" width, just go to `your_theme/stylesheets/css/overrides/overrides.css` and adjust the particular number at line 12.
 

## Project Tree
==========
If you wish to display the project tree uncollapsed (e.i. open) in order to see subprojects, just go to `javascripts/theme.js`, locate line 10 and change `false` to `true`. This will show the subprojects by default. 

## Content Too Wide
==========
If you are using a very large screen, things can get too wide. If you want to limit width of the content area, just go to `your_theme/stylesheets/css/overrides/overrides.css` and delete lines 15 and 27. You will get rid of the `/* */` symbols and uncomment the styles. Then just set the `max-width` property to the number you like. 

## Use a Company Logo
==========
If you want to brand your Redmine, there are 2 logo images you will need to replace: `logo-top.png` which is in the top menu and `logo.png` which appears at the login page. The space in the top menu is limited so be sure to keep the propirtions close to a square. If your logo is too wide, we suggest to use just the graphic part of it and remove the text part. If you don't have any pictogram / image in your logo, try using just the first letter. 

Enjoy!