Customization

=============

This customization modifies Mantis default visual style to use The

CentOS Project visual style. Once you install the customization

provided here, the visual transition between your mantis website and

other web sites customized the same way will be easy to recognize

because the implementation of common visual patterns (e.g.,

background, header, logo, favicon and footer).

How To Install 

--------------

1. yum install mantis-1.1.8-5.el5

   NOTE: This require you to have EPEL repository installed in your

   CentOS distribution. To know how to install the EPEL repository

   read http://wiki.centos.org/AdditionalResources/Repositories

2. Configure mantisBT application and be sure it works as you expect.

In this step you create the database you'll use to store data, connect

the mantis application with it and install the tables using the web

interface.

3. Copy the theme files provided in this customization into your

system's mantisBT tree, as root user.  The source-target relation

between files is shown in the following table:

------------------+-----------------------------------------------

SOURCE            | TARGET

------------------+-----------------------------------------------

bottom.html       | /usr/share/mantis/themes/centos/bottom.html

top.html          | /usr/share/mantis/themes/centos/top.html

stylesheet.css    | /usr/share/mantis/themes/centos/stylesheet.css

------------------+-----------------------------------------------

This theme also provides a customized version of mantis_offline.php

file that you can copy into /etc/mantis/ directory when you want to

get mantis' site off-line for maintenance.

4. Check file permissions. Be sure these files are readable by apache

web server. For example, if both user and group for these files are

set to `root', then the `-rw-r--r--' rights are ok for all these

files.

5. Update your configuration file. Be sure it has the following

information:

	# --- html variables --------------

	$g_window_title 	    = "The CentOS Bugs";

	$g_top_include_page 	= "themes/centos/top.html";

	$g_bottom_include_page 	= "themes/centos/bottom.html";

	$g_css_include_file 	= "themes/centos/stylesheet.css";

	$g_favicon_image 	    = "/webenv/images/favicon.ico";

6. Point your browser to mantisBT install and reload it to see the

changes.

Package Updates

---------------

An important characteristic of this theme is that all modifications

take place in the configuration file and CSS files. No PHP files

inside the mantis package needs to be modified (except the

configuration file, of course.). This way you can update the mantis

package without loosing the visual style you already set for it.

The only problem I've found is the $g_favicon_image variable, which

doesn't work.  So, if you want to have a favicon different from

Mantis's default, you need to overwrite Mantis' images/favicon.ico

file with the one you want to use. This is something you need to do

the next time you update the matnis package (unless the

$g_favicon_image variable gets alive).

Images affecting Mantis visual style were moved from images directory

inside the Mantis directory structure to /var/www/webenv/images

directory outside Mantis directory structure and made accessible

through /webenv http alias. Using images this way let us to re-use

them with other web applications that share the same visual style.

When a visual style update is required, we only need to change images

in a single place to propagate the new visual style to all

applications.

Feedback

--------

Your comments and suggestions are very welcome. In fact, we need them

to make this work better. Thus, feel free to send e-mails to

centos-devel@centos.org mailing list or fill a ticket at

https://projects.centos.org/trac/artwork/newticket page.

Authors

-------

The following people have contributed efforts to this theme:

    * Alain Reguera Delgado <alain.reguera@gmail.com>, 2013