README
Customization
=============

The mantis' customization provided here is part of the monolithic
visual style The CentOS Project is attached to. Once you install the
mantis' customization provided here, the visual transition between the
mantis website and other CentOS web sites already customized will be
nice and easy to recognize because of the 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
images/logo.png   | /usr/share/mantis/themes/centos/images/logo.png
images/favicon.ico| /usr/share/mantis/themes/centos/images/favicon.png
images/h2.png     | /usr/share/mantis/themes/centos/images/h2.png
images/header.png | /usr/share/mantis/themes/centosimages/header.png
------------------+-----------------------------------------------

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 	    = "themes/centos/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 is the $g_favicon_image variable, it doesn't work.
So, if you want to have a favicon different to Mantis's default, you
need to overwrite the 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).

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