PDF de programación - Mantis Guia rapida

Guía rápida de Mantis 

Por Pakolin 

Página 1 

Desempaquetar e iniciar la instalación de mantis en el servidor con:

http://localhost/mantis/admin/install.php



Requerimientos mínimos

Apache 2.0.54
PHP 4.3.11
MySQL 4.0
Servidor SMTP



Instalación en un servidor local.

Modificaciones en php.ini:



register_globals = Off
file_uploads = On
upload_tmp_dir = C:\AppServ\php5\uploads
upload_max_filesize = 8M
post_max_size = 8M
SMTP = localhost
smtp_port = 25
memory_limit = 32M

El usuario y contraseña para el login de mantis es: administrator / root.
Se recomienda deshabilitar o borrar la cuenta administrator que crea mantis.
Crear una carpeta para cargar los archivos asociados a las incidencias. Por ejemplo
en “mantis\files”.


Archivo de configuración config_defaults_inc.php

$g_window_title = 'Nombre de la empresa'; # titulo de la ventana del navegador
$g_page_title= 'Nombre de la empresa'; # titulo del encabezado de las páginas
$g_path = 'http://<dirección servidor>/mantis/';
$g_administrator_email = '<dirección de correo del administrador>'; o
$g_webmaster_email = '<direccion de correo del webmaster>'; o
$g_default_language = 'spanish';
$g_fallback_language = 'spanish';
$g_allow_file_upload = ON;
$g_file_upload_method = DISK;
$g_max_file_size = 8000000; # 8 MB
$g_phpMailer_method = 2;
$g_smtp_host = '<dirección del servidor SMTP ("localhost" para MTA local)>';
$g_smtp_username = '';
$g_smtp_password = '';
$g_short_date_format = 'd-M-Y'; #dd-mmm-yyyy



 

Guía rápida de Mantis 

Por Pakolin 

Página 2 

$g_normal_date_format = 'd-M-Y H:i'; #dd-mmm-yyyy hh:mm
$g_complete_date_format = 'd-M-Y H:i T';
Si la conexión con la base de datos falla, edita las siguientes líneas en



Archivo de configuración de base de datos config_inc.php



$g_hostname= 'localhost';
$g_db_username = 'root';
$g_db_password = '<contraseña>';
$g_database_name = 'bugtracker';
$g_db_type = 'mysql';


Zona horaria.


Para cambiar la franja horaria a la zona de Madrid/Europa, añadir la siguiente línea en el archivo
config_inc.php (Las constantes de zona horaria provienen de los valores de la funcion PHP
date_default_timezone_set):

putenv("TZ=Europe/Madrid");


Enumeraciones, correo y otras configuraciones.


Para cambiar los nombres de los estados de las incidencias hay que modificar la variable
$s_status_enum_string en todos los scripts del idioma o idiomas deseados. Esta variable es una
enumeración de parejas ‘orden:concepto’ separados por comas. En la posición definida por el
marcador ‘concepto’, podremos cambiar la descripción del estado deseado.
Estas son las enumeraciones originales después de instalar mantis:

10:new,20:feedback,30:acknowledged,40:confirmed,50:assigned,80:resolved,90:closed
10:nueva,20:se necesitan más datos,30:aceptada,40:confirmada,50:asignada,80:resuelta,90:cerrada

Para las notificaciones por correo de los cambios de estado podría tomarse como patrón las
siguientes líneas del fichero config_defaults_inc.php:

$g_enable_email_notification = ON;
$g_email_receive_own = OFF;
//New
$g_notify_flags['new']['reporter'] = OFF;
$g_notify_flags['new']['handler'] = OFF;
$g_notify_flags['new']['monitor'] = OFF;
$g_notify_flags['new']['bugnotes'] = OFF;
$g_notify_flags['new']['threshold_min'] = DEVELOPER;
$g_notify_flags['new']['threshold_max'] = ADMINISTRATOR;
// Bugnote
$g_notify_flags['bugnote']['reporter'] = OFF;
$g_notify_flags['bugnote']['handler'] = OFF;
$g_notify_flags['bugnote']['monitor'] = OFF;



 

Guía rápida de Mantis 

Por Pakolin 

Página 3 

$g_notify_flags['bugnote']['bugnotes'] = OFF;
$g_notify_flags['bugnote']['threshold_min'] = DEVELOPER;
$g_notify_flags['bugnote']['threshold_max'] = ADMINISTRATOR;
// Owner
$g_notify_flags['owner']['reporter'] = OFF;
$g_notify_flags['owner']['handler'] = OFF;
$g_notify_flags['owner']['monitor'] = OFF;
$g_notify_flags['owner']['bugnotes'] = OFF;
$g_notify_flags['owner']['threshold_min'] = DEVELOPER;
$g_notify_flags['owner']['threshold_max'] = ADMINISTRATOR;
// Reopened
$g_notify_flags['reopened']['reporter'] = OFF;
$g_notify_flags['reopened']['handler'] = OFF;
$g_notify_flags['reopened']['monitor'] = OFF;
$g_notify_flags['reopened']['bugnotes'] = OFF;
$g_notify_flags['reopened']['threshold_min'] = DEVELOPER;
$g_notify_flags['reopened']['threshold_max'] = ADMINISTRATOR;
// Assigned
$g_notify_flags['assigned']['reporter'] = OFF;
$g_notify_flags['assigned']['handler'] = OFF;
$g_notify_flags['assigned']['monitor'] = OFF;
$g_notify_flags['assigned']['bugnotes'] = OFF;
$g_notify_flags['assigned']['threshold_min'] = DEVELOPER;
$g_notify_flags['assigned']['threshold_max'] = ADMINISTRATOR;
// Relationship
$g_notify_flags['relation']['reporter'] = OFF;
$g_notify_flags['relation']['handler'] = OFF;
$g_notify_flags['relation']['monitor'] = OFF;
$g_notify_flags['relation']['bugnotes'] = OFF;
$g_notify_flags['relation']['threshold_min'] = DEVELOPER;
$g_notify_flags['relation']['threshold_max'] = ADMINISTRATOR;
// Deleted
$g_notify_flags['deleted']['reporter'] = OFF;
$g_notify_flags['deleted']['handler'] = OFF;
$g_notify_flags['deleted']['monitor'] = OFF;
$g_notify_flags['deleted']['bugnotes'] = OFF;
$g_notify_flags['deleted']['threshold_min'] = DEVELOPER;
$g_notify_flags['deleted']['threshold_max'] = ADMINISTRATOR;



 

Guía rápida de Mantis 

Por Pakolin 

Página 4 

// Closed
$g_notify_flags['closed']['reporter'] = OFF;
$g_notify_flags['closed']['handler'] = OFF;
$g_notify_flags['closed']['monitor'] = OFF;
$g_notify_flags['closed']['bugnotes'] = OFF;
$g_notify_flags['closed']['threshold_min'] = DEVELOPER;
$g_notify_flags['closed']['threshold_max'] = ADMINISTRATOR;

Cambiar la imagen empleada como logo que aparece a la izquierda en las cabeceras de
mantis:

La imagen debe guardarse con el nombre “mantis_logo.gif” en el directorio “images”.
La imagen debe tener un tamaño exacto de 242 puntos de ancho por 102 puntos de alto.
Se recomienda que la resolución sea de 72 ppp.

Para desactivar la versión de Mantis mostrada en la web, desactivar la siguiente línea de
‘config_defaults_inc.php’:

$g_show_version = OFF;

Para desactivar el numero de consultas realizadas por mantis, modificar la siguiente línea de
‘config_defaults_inc.php’;

$g_show_queries_count = OFF;

Para cambiar el enlace ‘www.mantisbt.org’ del logo por el nuestro, hay que cambiar la línea 315
del fichero `core/html_api.php´:

echo '<a href="http://www.mantisbt.org" title="Free Web Based Bug
Tracker">"><img border="0" width="242" height="102" alt="Mantis Bugtracker"
src="images/mantis_logo.gif" /></a>'

Cambiar el timeout de la session.

El fichero ‘core/constant_inc.php’ contiene lo siguiente:

define( 'TOKEN_EXPIRY', 60*60 );
define( 'TOKEN_EXPIRY_LAST_VISITED', 24*60*60 );
define( 'TOKEN_EXPIRY_AUTHENTICATED', 5*60 );

'TOKEN_EXPIRY_AUTHENTICATED' es usado para controlar el timeout de los
administradores.
'TOKEN_EXPIRY' representa el tiempo por defecto de expiración de las cookies.

Para mostrar un mensaje de que Mantis esta offline por mantenimiento:

Renombrar el fichero ‘mantis_offline.php.sample’ a ‘mantis_offline.php’.
De esta forma dejamos el sitio en mantenimiento y nos aseguramos de que ningún usuario va
a entrar.



 

Guía rápida de Mantis 



Enumeraciones en Mantis.

Por Pakolin 

Página 5 

Las enumeraciones de Mantis representan un conjunto de posibles valores para un
atributo. Las enumeraciones son utilizadas para niveles de acceso, severidad, prioridad,
estados del proyecto, reproducibilidad, resolución, etc.
El fichero que define las constantes correspondientes a las enumeraciones se
encuentra en ‘core/constant_inc.php’.

Define(‘VIEWER’, 10)
Define(REPORTER, 25)
Define(UPDATER, 40)
Define(DEVELOPER, 55)
Define(MANAGER, 70)
Define(ADMINISTRATOR, 90)

El fichero ‘config_defaults_inc.php’ contiene los valores por defecto para las
enumeraciones.

$g_access_levels_enum_string =
’10:viewer,25:reporter,40:updater,55:Developer,70:manager,90:administrator’;

Los ficheros situados en el directorio ‘lang’, proporcionan la traducción de las enumeraciones.
Los archivos de idioma son utilizados para mostrar el equivalente local de una entrada de la
lista maestra en los archivos de configuración.


Para resetar el campo id auto incrementable del proyecto a un valor concreto (por ejemplo a
150), utilizaremos phpMyAdmin sobre la base de datos de mantis, y ejecutaremos la siguiente
sentencia SQL:

ALTER TABLE mantis_bug_table AUTO_INCREMENT=150