El Mantis es Open Source y un gestor de proyectos orientado a Web y realizado en PHP con conexión a Base de Datos Mysql, MS SQL Server y PostgreSQL.

El Bug Tracker sirve para realizar un buen seguimiento de Proyectos, en nuestro blog de Telepieza , podéis ver uno ya configurado y montado para su explotación en un Hosting.

Las Características de Mantis son :

• Interfaz simple y fácil de usar por todos nosotros (Es muy sencillo)
• Soporta feeds RSS igual que WordPress
• Puede enviar mensajes por SMTP al ser instalado en un Hosting
• Capacidad de Chatear entre todos nosotros
• Integración con otros módulos como el SVN y CVS
• Capacidad para definir las funciones de profesionales en proyectos
• Posibilidad de exportar informes en formato CVS, Excel y Word
• No hace falta instalar ningún programa en el Ordenador Cliente, todo se realiza por Web Browser
• Facíl de personalizar tanto para el Cliente como para la empresa
• Crear Usuarios (Admin, Anónimos, Manager, Visor, Desarrollador)
• Crear Proyectos (Subproyectos, Categorías, Relises)

Para recuperar el programa ir a :


Download Mantis 1.1.6 y descargar el (mantisbt-1.1.6.zip),  dejarlo en el escritorio de vuestro PC, una vez descargado lo instalamos en nuestro Ordenador Personal.

Nos creara una carpeta en el disco con el nombre mantisbt.1.1.6 renombrar dicha carpeta a un nombre que os guste para después enviar todo su contenido al Hosting , en mí caso la he llamado issues.

Una vez que hemos descomprimido el programa y renombrado la carpeta, nos conectamos por vía ftp a nuestro Dominio y pasamos todo el contenido de la carpeta a nuestro Hosting.

NOTA : Una vez pasado toda la carpeta aún no realizar nada ………

El siguiente paso es crear una nueva Base de Datos MySql en el Hosting , la podemos llamar dbissues, con un Usuario y Contraseña que administre dicha Base de Datos, por cierto la Base de Datos tiene que estar vacía. Para crear la Base de datos en el Hosting, muchos de vosotros podéis activar los programas que están destinado a ello como el phpMyAdmin o el panel de Control del Hosting con el Plesk.

Si estás creando la Base de Datos MySql en vuestro Ordenador Personal con el Administrator MySql, recordar en asignar un usuario@localhost a dicha Base de Datos con los suficientes privilegios para poder crear tablas desde el programa de instalación Mantis.

Una vez que ya tenemos creado nuestra Base de Datos MySql con el nombre dbissues y sin tablas, vamos a configurar nuestro Mantis. Para ello activamos nuestro navegador para picar la ruta de nuestro dominio más la carpeta que hemos enviado al Hosting y la subcarpeta admin , quedara así:


Una vez dentro del programa de instalación, chequea si tenemos el PHP y activos los Script (Ver imagen Abajo), si es correcto pondrá en color verde dichas opciones para poder continuar solicitando los datos del dominio, conector de la Base de Datos, Nombre de la Base de Datos , Usuario y Contraseña que tiene privilegios para acceder y crear tablas en nuestra Base de Datos MySql creada anteriormente.

……………………………………

Una vez introducidos todos los datos, picar el botón de install, el programa chequeara y comprobara todos los programas, recursos y acceso a la Base de datos, dando una página con mucha información. Dicha información estará acompañada del color verde (GOOD) . Color Rojo o Color Rosado. Si algunas líneas tienen color ROJO, es porque ha detectado la instalación problemas y tenemos que solucionarlos antes de continuar.

………………………………………………

Si el problema radica en la indicación de no poder generar y grabar el fichero config_inc.php, no es problemático, lo crearemos a mano en nuestro ordenador y después lo pasaremos al Hosting.

Si todos los indicadores están de color VERDE, picar el link continuar y nos creará las tablas con datos en nuestra Base de Datos y por último nos saldrá la página de usuario del Mantis.

……………………………………….

Por defecto viene con el usuario : administrator y la clave o Password : root , lo picamos y vemos si podemos entrar y ver si todo es correcto.

NOTA : La instalación de Mantis es muy sencilla, ahora tenemos que configurar nuestro Bug Tracker para adaptarlo a nuestras necesidades, pero eso será en otro post.

OBSERVACIONES : SI por algún motivo no se ha creado el fichero config.inc.php, ir a la carpeta /issues del Hosting y copiar el fichero config.inc.php.sample por config.inc.php

Una vez copiado el fichero entramos en dicho fichero con un editor y cambiamos los datos de acceso por defecto de la Base de datos por nuestros datos.

Los datos a Modificar en la primera fase son (En rojo los nuestros):

# — database variables ———

# set these values to match your setup
$g_hostname      = “localhost”;
$g_db_username   = “mantisdbuser”;  “myusuario“;
$g_db_password   = “”;                        “myclave“;
$g_database_name = “bugtracker”;      “mybasedatos“;
$g_db_type       = “mysql”;                   “mysqli“;

UNA VEZ QUE HEMOS ENTRADO CON EL USUARIO : administrator, TENEMOS QUE BORRAR DE LA CARPETA /ISSUES, LA SUBCARPETA ADMIN, ES MUY IMPORTANTE QUE SEA BORRADA, POR TEMAS DE SEGURIDAD.

Saludos de Espinas.

La actualización de versión del Mantis, es fácil de hacer pero tenemos que realizar antes una serie de pasos y son :

• Copiar nuestra Base de Datos del Mantis (Realizar Backup)
• Copiar todo el directorio de Mantis del Hosting a una carpeta de nuestro PC
• Recuperar la última versión estable de Mantis ir a : Versión 1.1.6
• Descomprimir la versión en nuestro Ordenador Personal
• Leer en ChangeLog, para leer los cambios y bug arreglados de la versión.
• No está de más leer en la página oficial de Mantis cómo se realiza un cambio de versión

Una vez  descargado el programa de la nueva versión, realizado la copia de la Base de Datos y guardada la versión actual de Mantis, vamos a pasar toda la carpeta de la nueva relis a la carpeta actual de Mantis, en mi caso se llama issues.

NOTA de TELEPIEZA : Sobre todo tenéis que tener una copia de la versión anterior en vuestro ordenador, porque necesitaremos una serie de páginas php e imágenes para pasar después a la nueva versión.

El siguiente paso es renombrar en la carpeta del Hosting la página mantis_offline.php.sample a Mantis_offline.php, de esa forma dejamos el sitio en mantenimiento y nos aseguramos que ningún usuario va a entrar en nuestro Bug Tracker (Ver imagen abajo del mensaje que indica el Mantis).

………………………………………..

Una vez renombrado dicha página pasamos toda la carpeta de la nueva versión a la carpeta de Mantis del Hosting (en mi caso es la /issues y machacamos todo su contenido).

Sobre todo no perdáis la copía de la versión anterior de vuestro Ordenador, la vamos a necesitar.

Una vez pasada toda la información de la nueva versión, nos vamos a la carpeta salvada de la antigua versión del Mantis y en la carpeta raiz pasamos las páginas config_inc.php y config_default_inc.php a la carpeta raiz del Mantis del Hosting en mi caso es /issues.

Una vez pasados las dos páginas php, arrancamos nuestro explorador y ejecutamos el install del Mantis para que nos actualice y chequee la base de datos. http://www.mydominio/issues/admin/install.php

Nos saldrá la siguiente pantalla (picar encima de la imagen de la Izquierda), chequeando la versión del PHP y las conexiones con la Base de Datos MySql.

Los datos los coge de la página config_inc.php pasada anteriormente por nosotros, sólo tenemos que picar el botón Install/Update DataBase.

El proceso de instalación o cambio de versión del Mantis es el mismo para los tipos, por dicho motivo el botón indica Install/Update DataBase.

Al picar el botón Install/update DataBase, chequea si puede realizar las operaciones de Base de Datos, SELECT, INSERT, UPDATE y DELETE, si es correcto, podéis picar el enlace CONTINUE. (ver Imagen de la Izquierda)

Al picar CONTINUE, nos sale la página de offline de Mantis.

Pero antes de quitar dicha página para poder entrar tenemos que realizar los siguientes pasos.

• Pasar de la antigua version del Mantis el logo   /issues/images/mantis_logo.gif al Hosting misma carpeta
• Pasar de la antigua version del Mantis la página /issues/core/html_api.php          al Hosting misma carpeta
• Borrar la carpeta admin del hosting en /issues/admin
• Borrar la página mantis_offline.php del Hosting en /issues

Una vez realizado todos los pasos, entrar en vuestro Mantis y ver si todo es correcto en la instalación del cambio de Versión.

NOTA de Telepieza : Puede que tengáis que pasar más páginas php desde la versión anterior a la nueva, eso dependerá de la cantidad de cambios que vosotros habéis realizado en vuestro Mantis.

Saludos de Telepieza.

En la imagen de Abajo vemos los colores por defecto de los diferentes tipos de Mensajes que trae Mantis al ser instalado el programa.

……………………………………………

Los diferentes tipos de mensajes son : Nuevos, Se necesitan más datos, Aceptada, Confirmada, Asignada, Resulta y Cerrada.

Una de las cosas que mejor lleva Mantis es la visualización por colores de los diferentes Mensajes o Bug que se crean en su programa.

En la imagen de Abajo vemos los diferentes mensajes con sus colores asignados por defecto por parte de Mantis.

……………………………………………………………

La idea de la lección es cambiar la paleta de colores, para que sea más llamativo una serie de mensajes sobre otros y quitar el tipo de mensaje confirmada, por entender que el tipo de mensaje aceptada puede suplir perfectamente la función del tipo de mensaje confirmada.

Tenemos que conseguir, que en un sólo vistazo al conjunto de los mensajes de Mantis, podamos distinguir lo más importante de dichos mensajes para nosotros.

Por ese motivo cambiaremos los colores a Rojo los nuevos, Amarillo los aceptados por nosotros y el color Verde los resueltos. (ver imagen de Abajo) para comprobar la paleta de colores una vez  modificados.

…………………………………………………………

Una vez cambiado la paleta de colores a los diferentes mensajes, vemos en la imagen de abajo el resultado y además lo podemos comprobar con la paleta de colores por defecto del Mantis (Imagen de Arriba).

…………………………………………………………

NOTA de ESPINAS : Simplemente cambiando la paleta de colores a los diferentes mensajes o bug del Mantis el resultado visual es totalmente diferente, comprensible por nosotros y agradable a la vista.

En línea 1287

# --- status color codes ----------
$g_status_colors     = array( 'new'  => '#ffa0a0', # red,
'feedback'        => '#ff50a8', # purple
'acknowledged'    => '#ffd850', # orange
'confirmed'       => '#ffffb0', # yellow
'assigned'        => '#c8c8ff', # blue
'resolved'        => '#cceedd', # buish-green
'closed'          => '#e8e8e8'); # light gray


CAMBIAR POR :

# --- status color codes ----------
$g_status_colors        = array( 'new'  => '#FB6B6B', # red,
'feedback'               => '#FAB53D', # purple
'acknowledged'           => '#FDF667', # orange
'confirmed'              => '#ffffb0', # yellow
'assigned'               => '#C8C8FE', # blue
'resolved'               => '#A3E5A6', # buish-green
'closed'                 => '#ABABAB'); # light gray


Para quitar un tipo de Mensaje

En Línea 1406

$g_status_enum_string = 10:new,20:feedback,30:acknowledged,40:confirmed,

50:assigned,80:resolved,90:closed';

CAMBIAR POR

$g_status_enum_string =

'10:new,20:feedback,30:acknowledged,50:assigned,

80:resolved,90:closed';

Una vez cambiado los colores y eliminado uno de los tipos de Mensaje, salvamos el fichero y lo enviamos vía FTP al HOSTING

NOTA de ESPINAS : Los cambios de colores y eliminar un tipo de Mensaje va en función de cómo queréis configurar el Mantis en vuestro Ordenador.

Saludos y hasta pronto.

………………………………………….

A está otra imagen personalizada por nosotros al modificar los ficheros de configuración del Mantis.

………………………………………………

En la siguiente lección explicaremos cómo activar el usuario anónimo (1) y desactivar el solicitar una cuenta nueva (2), muchas empresas no desean activar el usuario anónimo y tampoco colocar el acceso a crear cuentas nuevas, por entender que su Mantis es de acceso restringido y privado.

1.- Activar Usuario anónimo en Mantis al Inicio de Sesión

Para configurar el usuario anónimo en Mantis, tenemos que crear un usuario, por ejemplo (Visitador) con los mínimos permisos en Mantis, el nivel de acceso tiene que ser “espectador” y la cuenta protegida.

Recordar que por defecto la configuración del Mantis al activar Usuarios,  es por e-mail (Si es por E-Mail el Mantis no pide password en la pantalla de crear usuarios), tenemos que desactivar de forma momentánea dicha opción para crear nuestro usuario “Visitador” y poderle colocar el password en la pantalla de creación de Usuarios.

Nos vamos al fichero de configuración de Mantis y lo editamos con un editor de texto, el fichero config_defaults_inc.php que está en la carpeta principal del Mantis, en mi caso /issues/config_defaults_inc.php

En la línea 240,

Buscar la instrucción  $g_enable_email_notification = ON;
y cambiar por                $g_enable_email_notification = OFF;

Una vez comprobado y realizado dicho cambio, pasamos el fichero vía FTP al Hosting y ya podemos crear nuestro usuario con clave que funcionará como anónimo.

Entramos con nuestro usuario Administrador y nos vamos a la opción Administración y picamos el botón de crear cuentas.

Una vez dentro de la pantalla de crear usuarios, damos de alta el usuario “Visitador”, ver imagen (Abajo), sobre todo tener cuidado con el tipo de Nivel de Acceso, tiene que ser espectador y protegido

……………………………………………………

Una vez creado el usuario en Mantis, nos vamos al fichero de configuración y lo editamos con un editor de texto, el fichero es config_defaults_inc.php que está en la carpeta principal del Mantis, en mi caso /issues/config_defaults_inc.php

En la línea 1199,

Buscar la instrucción  $g_allow_anonymous_login    = OFF;
y cambiar por                $g_allow_anonymous_login    = ON;

En la línea 1200,

Buscar la instrucción  $g_anonymous_account        = '';
y cambiar por                $g_anonymous_account        = 'visitador';

Salvar el Fichero y subirlo por vía FTP al Hosting, y veréis que ya aparece el enlace de Anónimo y podemos entrar al Mantis para visualizar los mensajes de forma anónima.

Para que salgan dichos textos, tenemos que ir al fichero de configuración de Mantis y lo editamos con un editor de texto, el fichero config_defaults_inc.php que está en la carpeta principal del Mantis, en mi caso /issues/config_defaults_inc.php

En la línea 240,

Si activamos dicha opción nos aparece el texto Solicitar una nueva cuenta en la pantalla de inicio de sesión

Buscar la instrucción  $g_enable_email_notification = OFF;
y cambiar por                $g_enable_email_notification = ON;

En la línea 191,

Si activamos dicha opción nos aparece el texto Olvidó su contraseña en la pantalla de inicio de sesión

Buscar la instrucción  $g_send_reset_password = OFF;
y cambiar por                $g_send_reset_password = ON;

NOTA : Se puede activar la notificación y no el password o activar las dos a la vez, es una elección de vosotros.

Ya tenemos los textos y enlaces de solicitar usuarios y contraseñas, ahora nos toca configurar el envio de los e-mail de alta de usuario y confirmación de claves por el Mantis para que le llegue a su destino.

La configuración de las cuentas E-mail de nuestro Mantis, se crean en otro fichero de configuración diferente, por ese motivo en las opciones que vamos a cambiar en el fichero config_defaults_inc.php, las vamos a dejar en blanco para no confundirnos.

Nos vamos al fichero de configuración de Mantis y lo editamos con un editor de texto, el fichero config_defaults_inc.php que está en la carpeta principal del Mantis, en mi caso /issues/config_defaults_inc.php

En la línea 225,

Buscar la instrucción  g_administrator_email = 'administra@example.com';
y cambiar por                g_administrator_email = '';

En la línea 226,

Buscar la instrucción  $g_webmaster_email = 'webmaster@example.com';
y cambiar por                $g_webmaster_email = '';

En la línea 229,

Buscar la instrucción  $g_from_email = 'noreply@example.com';
y cambiar por                $g_from_email = '';

En la línea 235,

Buscar la instrucción  $g_return_path_email = 'admin@example.com';
y cambiar por                $g_return_path_email = '';

Una vez que hemos blanqueado los campos de e-mail de administrador, webmaster, reply y return, vamos a configurar el texto del Asunto del correo, va a vuestra elección, en mí caso es “Telepieza Bug Tracker”.

En la línea 232,

Buscar la instrucción  $g_from_name = 'Mantis Bug Tracker';
y cambiar por                $g_from_name = 'Telepieza Bug Tracker';

El siguiente paso es indicar al Mantis que envie la información por 0-mail,1-sendmail,2-SMTP.

Para los HOSTING la opción es la 2, para los PC la opción es la 0:

En línea 328,

# select the method to mail by:
# 0 – mail()
# 1 – sendmail
# 2 – SMTP
$g_phpMailer_method  = 0;

Buscar la instrucción  $g_phpMailer_method = 0;
y cambiar por                $g_phpMailer_method = 2;

En la línea 335, 

NOTA : Colocar vuestro SMTP del HOSTING, generalmente es mail.mydominio.com.

Buscar la instrucción   $g_smtp_host = 'localhost';
y cambiar por                $g_smtp_host = 'mail.mydominio.com';

En la línea 340,

NOTA : Colocar un usuario de correo creado anteriormente en el Hosting para poder enviar los e-mail por SMTP.

Buscar la instrucción    $g_smtp_username = ”;
y cambiar por                 $g_smtp_username = ‘myusuario_SMTP’;

En la línea 341,

NOTA : Colocar el password del usuario de correo creado anteriormente en el Hosting para poder enviar los e-mail por SMTP.

Buscar la instrucción     $g_smtp_password = ”;
y cambiar por                   $g_smtp_password = ‘mypassword_usuario_SMTP’;

Con estos pasos ya hemos terminado de configurar el envío de información por correo electrónico, salvamos y enviamos el fichero vía FTP al Hosting.

Ahora nos toca configurar las cuentas e-mail master para que el Mantis se comunique con nosotros.

Al instalar Mantis, tenemos un fichero llamado config_inc.php.sample y nos ha creado al configurar el Mantis un fichero llamado config_inc.php, con los datos de conexión a la Base de Datos, lo que haremos es imprimir y realizar una copia de dicho fichero para después borrarlo.

Una vez realizada la copia del fichero config_inc.php , renombramos el fichero config_inc.php.sample como config_inc.php

Editamos el fichero config_inc.php con un editor de textos y cambiamos los datos de acceso a la base de datos por los datos impresos anteriormente del fichero config_inc.php (Borrado y copiado anteriormente).

# set these values to match your setup
$g_hostname      = “localhost”;
$g_db_username   = “myusuariodb”;
$g_db_password   = “myclaveacceso”;
$g_database_name = “mybasedatos”;
$g_db_type       = “mysql”;

NOTA : Todo esto se realiza porque el fichero config_inc.php.sample tiene todos los parámetros globales de la base de datos y recepción de información por e-mail, es aconsejable que toda esa información no este en el fichero config_defaults_inc.php

Los parámetros a cambiar para recibir información del Mantis por e-mail son :

# — email variables ————-
$g_administrator_email  = ‘myadmin@mydominio.com’;
$g_webmaster_email      = ‘mywebmaster@mydominio.com’;
# — the “From: ” field in emails —————
$g_from_email  = ‘myusuario@mydominio.com’;
# — the return address for bounced mail ——
$g_return_path_email    = ‘myusuario@mydominio.com’;

Una vez cambiado todos los parámetros de los e-mail, salvar la información y enviar vía FTP el fichero config_inc.php al HOSTING.

OBSERVACIONES : En está lección hemos aprendido a configurar el usuario anónimo, activar las cuentas de usuario por e-mail y configurar el envío de correo por SMTP.

Saludos de Espinas.

Recordar que en la lección anterior, hemos explicado los puntos 1 a 3 y en está lección explicaremos los puntos 4 , 5 y 6.

• 1.- Cambiar el logo de Mantis por nuestro logo de empresa
• 2.- El lenguaje Español y no Ingles
• 3.- Eliminar los mensajes WARNING de la página inicial
• 4.- Quitar el Texto Mantis 1.1.5
• 5.- Quitar el logo pequeño de Mantis Bugtracker System y otras opciones
• 6.- Cambiar el enlace www.mantisbt.org de la imagen grande por nuestro dominio
  

…………………………………………….

4.- Quitar el Texto Mantis 1.1.5 y otras opciones

El motivo de quitar el texto Mantis 1.1.5, es para no dar pistas de la versión a los hacker, recordar que estamos con programas open source de dominio público. Siempre dichos programas (Mantis) sacan versiones para solucionar bug de seguridad, por ese motivo no es recomendable dar la versión de los programas que estamos utilizando en nuestro Ordenador.

Para desactivar la versión, tenemos que editar con un editor de texto, el fichero config_defaults_inc.php que está en la carpeta principal del Mantis, en mi caso /issues/config_defaults_inc.php

NOTA : Realizar una copia de dicho fichero por si cometemos errores, poder recuperar la información de la copia realizada.

En la línea 365,

Buscar la instrucción   $g_show_version = ON;
y cambiar por                 $g_show_version = OFF;

Ya que estamos en el fichero config_defauls_inc.php, vamos a realizar otro pequeño cambio para que no salga la información de los queries realizados por el Mantis.

En la línea 1512,

Buscar la instrucción   $g_show_queries_count = ON;
y cambiar por                 $g_show_queries_count = OFF;

La fecha del Mantis o Bug Tracker está en orden Año/Mes/Día, la vamos a cambiar a Día/Mes/Año, a estilo Español.

En la línea 630,

Buscar la instrucción    $g_short_date_format = 'Y-m-d';
y cambiar por $g_short_date_format = 'd-m-Y';

En la línea 631,
Buscar la instrucción    $g_normal_date_format  = 'Y-m-d H:i';
y cambiar por                  $g_normal_date_format = 'd-m-Y H:i';
En la línea 632,
Buscar la instrucción      $g_complete_date_format = 'Y-m-d H:i T';
y cambiar por                    $g_complete_date_format = 'd-m-Y H:i T';

………………………………………
5.- Quitar el logo pequeño de Mantis Bugtracker System

Para desactivar el logo, tenemos que editar con un editor de texto, el fichero html_api.php que está en la carpeta core del Mantis, en mi caso /issues/core/html_api.php

NOTA : Realizar una copia de dicho fichero por si cometemos errores, poder recuperar la información de la copia realizada.

Para quitar el logo pequeño de Mantis System tenemos que añadir el caracter # al principio de la instrucción echo de las líneas 469, 470 y 471, un ejemplo de cómo añadir el caracter #

En la línea 469
buscar la instrucción      echo '</td><td><div align="right">';
cambiar por                  # echo '</td><td><div align="right">';
En la línea 470
buscar la instrucción       echo '<a href="http://www.mantisbt.org" title="Free Web Based Bug Tracker"><img src="images/mantis_logo_button.gif" width="88" height="35" alt="Powered by Mantis Bugtracker" border="0" /></a>';
Cambiar por                    # echo '<a href="http://www.mantisbt.org" title="Free Web Based Bug Tracker"><img src="images/mantis_logo_button.gif" width="88" height="35" alt="Powered by Mantis Bugtracker" border="0" /></a>';

En la línea 471
buscar la instrucción         echo '</div></td></tr></table>';
cambiar por                      # echo '</div></td></tr></table>';

6.- Cambiar el enlace de Mantisbt por nuestro dominio

La imagen grande al picarla va a www.mantisbt.org , para poder cambiar dicho enlace, tenemos que ir a la línea 317 y cambiar el www.mantisbt.org por nuestro dominio y el title junto con alt poner nuestro texto.

En Mantis es :

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>';

En Telepieza es :

echo '<a href="http://www.telepieza.com" title="Telepieza Bug Tracker"><img border="0" width="242" height="102" alt="Telepieza Bugtracker" src="images/mantis_logo.gif" /></a>';

Una vez realizados todos los cambios, salvar el fichero y enviar por FTP al Hosting.

OBSERVACIONES : No hemos terminado aún de configurar nuestro Mantis, pero ya podemos ir viendo los cambios realizados por nosotros en el Bug Tracker de nuestro Hosting o PC

Saludos de Telepieza.

Lo primero que vamos a personalizar del Mantis es la pantalla de inicio de sesión (Ver imagen de Abajo), he numerado las opciones que vamos a tocar (En la primera parte veremos las opciones 1 , 2 y 3).

• 1.- Cambiar el logo de Mantis por nuestro logo de empresa
• 2.- El lenguaje Español y no Ingles
• 3.- Eliminar los mensajes WARNING de la página inicial
• 4.- Quitar el Texto Mantis 1.1.5
• 5.- Quitar el logo pequeño de Mantis Bugtracker System

………………………………………………………

NOTA de Telepieza : Telepieza ha instalado en Mantis en el Hosting en la carpeta issues , cuando veaís dicha carpeta es porque su instalación se ha realizado con ese nombre, vosotros tenéis que poner el nombre de la carpeta que habéis instalado el mantis en vuestro ordenador.

Simplemente tenéis que cambiar el nombre issues por vuestro nombre de la carpeta del Mantis instalada en el Hosting o PC.

1.- Cambiar el logo de Mantis por nuestro logo de empresa

El logo de Mantis está en la ubicación /issues/images/mantis_logo.gif , sus dimensiones (ver imagen izquierda), 242×102 píxeles en transparente.

Vosotros tenéis que coger nuestro logo de empresa y darle la mismas dimensiones, nombre y formato de imagen, una vez conseguido todo ello, enviar por ftp al Hosting vuestra imagen (mantis_logo.gif) machacando la existente.

NOTA : La idea es colocar nuestro logo de empresa, en mí caso TELEPIEZA, con el mismo nombre , dimensiones y formato que el existente de mantis_logo.gif y cambiarlo. Todo esto se realiza para no cambiar ninguna página .php y nos garantizamos de un cambio de imagen rápido, limpio y sin errores.

2.- El lenguaje Español y no Ingles

Para cambiar el idioma del ingles al castellano, tenemos que editar con un editor de texto, el fichero config_defaults_inc.php que está en la carpeta principal del Mantis, en mi caso /issues/config_defaults_inc.php

NOTA : Realizar una copia de dicho fichero por si cometemos errores, poder recuperar la información de la copia realizada.

En la línea 376,

Buscar la instrucción  $g_default_language = 'english';
y cambiar por                $g_default_language = 'spanish';

En la línea 459,

Buscar la instrucción  $g_fallback_language = 'english';
y cambiar por                $g_fallback_language = 'spanish';

Una vez realizados los cambios, procedemos a salvar el fichero y enviarlo por FTP al Hosting para ver si nos ha cambiado el idioma al Español.

3.- Eliminar los mensajes WARNING de la página inicial

El Mensaje : WARNING: Admin directory should be removed.

Tenemos que borrar la carpeta admin, es muy fácil de quitar, simplemente tenemos que borrar del Hosting la carpeta admin que está en la raíz de Mantis : /issues/admin.

NOTA : BORRAR LA CARPETA admin  SIN MIRAMIENTOS.

El Mensaje :WARNING: You should disable the default “administrator” account or change its password.

El Mantis viene configurado por defecto que las claves de los usuarios se cambien por e-mail y no por pantalla de usuario, eso significa que nosotros no podemos cambiar la clave del administrator o cuando creamos nuevos usuarios, tampoco podemos asignarle las claves de acceso.

Para solucionar el problema , tenemos que editar con un editor de texto, el fichero config_defaults_inc.php que está en la carpeta principal del Mantis, en mi caso /issues/config_defaults_inc.php

En la línea 240,

Buscar la instrucción  $g_enable_email_notification = ON;
y cambiar por                $g_enable_email_notification = OFF;

Por temas de seguridad, tenemos que entrar al mantis como usuario administrator y clave : root y crear otro usuario administrador (Con las mismas características que el usuario administrator) o cambiar la clave root.

Una vez creado probar dicho usuario y ver si os enseña las mismas opciones de menú que el usuario administrator. Si es así, ya podéis borrar el usuario administrator de mantis o cambiar su clave.

NOTA : Antes de borrar el usuario administrator, sobre todo comprobar que el nuevo usuario (Administrador) funciona correctamente.

Personalmente os aconsejo eliminar el usuario administrator, creando anteriormente un usuario administrador nuevo en mantis, pero si no estáis muy seguros, con cambiar la clave del administrator ya es suficiente.

Una vez creados todos los usuarios nuestros y cambiado todas las claves, más adelante si queremos que los propios usuarios se creen ellos mismos las cuentas, tenemos que cambiar el parámetro a $g_enable_email_notification = ON; y configurar el SMTP de correo para que les llegue las notificaciones y cambios de clave por correo.

NOTA : Para cambiar la clave de un usuario con el parámetro   $g_enable_email_notification = OFF; tenemos que entrar con dicho usuario y después picar el  link de mi cuenta, para poder cambiar la clave de acceso al mantis.

En el próximo post explicaremos las opciones 4 y 5.

Saludos de Telepieza.

El Mantis es Open Source y un gestor de proyectos orientado a Web y realizado en PHP con conexión a Base de Datos Mysql, MS SQL Server y PostgreSQL.

El Bug Tracker sirve para realizar un buen seguimiento de Proyectos, en nuestro blog de Telepieza , podéis ver uno ya configurado y montado para su explotación en un Hosting.

Las Características de Mantis son :

• Interfaz simple y fácil de usar por todos nosotros (Es muy sencillo)
• Soporta feeds RSS igual que WordPress
• Puede enviar mensajes por SMTP al ser instalado en un Hosting
• Capacidad de Chatear entre todos nosotros
• Integración con otros módulos como el SVN y CVS
• Capacidad para definir las funciones de profesionales en proyectos
• Posibilidad de exportar informes en formato CVS, Excel y Word
• No hace falta instalar ningún programa en el Ordenador Cliente, todo se realiza por Web Browser
• Facíl de personalizar tanto para el Cliente como para la empresa
• Crear Usuarios (Admin, Anónimos, Manager, Visor, Desarrollador)
• Crear Proyectos (Subproyectos, Categorías, Relises)

Para recuperar el programa ir a : Download Mantis 1.1.5 y descargar el (mantisbt-1.1.5.zip),  dejarlo en el escritorio de vuestro PC, una vez descargado lo instalamos en nuestro Ordenador Personal.

Nos creara una carpeta en el disco con el nombre mantisbt.1.1.5 renombrar dicha carpeta a un nombre que os guste para después enviar todo su contenido al Hosting , en mí caso la he llamado issues.

Una vez que hemos descomprimido el programa y renombrado la carpeta, nos conectamos por vía ftp a nuestro Dominio y pasamos todo el contenido de la carpeta a nuestro Hosting.

NOTA : Una vez pasado toda la carpeta aún no realizar nada ………

El siguiente paso es crear una nueva Base de Datos MySql en el Hosting , la podemos llamar dbissues, con un Usuario y Contraseña que administre dicha Base de Datos, por cierto la Base de Datos tiene que estar vacía. Para crear la Base de datos en el Hosting, muchos de vosotros podéis activar los programas que están destinado a ello como el phpMyAdmin o el panel de Control del Hosting con el Plesk.

Si estás creando la Base de Datos MySql en vuestro Ordenador Personal con el Administrator MySql, recordar en asignar un usuario@localhost a dicha Base de Datos con los suficientes privilegios para poder crear tablas desde el programa de instalación Mantis.

Una vez que ya tenemos creado nuestra Base de Datos MySql con el nombre dbissues y sin tablas, vamos a configurar nuestro Mantis. Para ello activamos nuestro navegador para picar la ruta de nuestro dominio más la carpeta que hemos enviado al Hosting y la subcarpeta admin , quedara así:

http://www.midominio.com/issues/admin/install.php

Una vez dentro del programa de instalación, chequea si tenemos el PHP y activos los Script (Ver imagen Abajo), si es correcto pondrá en color verde dichas opciones para poder continuar solicitando los datos del dominio, conector de la Base de Datos, Nombre de la Base de Datos , Usuario y Contraseña que tiene privilegios para acceder y crear tablas en nuestra Base de Datos MySql creada anteriormente.

……………………………………

Una vez introducidos todos los datos, picar el botón de install, el programa chequeara y comprobara todos los programas, recursos y acceso a la Base de datos, dando una página con mucha información. Dicha información estará acompañada del color verde (GOOD) . Color Rojo o Color Rosado. Si algunas líneas tienen color ROJO, es porque ha detectado la instalación problemas y tenemos que solucionarlos antes de continuar.

………………………………………………

Si el problema radica en la indicación de no poder generar y grabar el fichero config_inc.php, no es problemático, lo crearemos a mano en nuestro ordenador y después lo pasaremos al Hosting.

Si todos los indicadores están de color VERDE, picar el link continuar y nos creará las tablas con datos en nuestra Base de Datos y por último nos saldrá la página de usuario del Mantis.

……………………………………….

Por defecto viene con el usuario : administrator y la clave o Password : root , lo picamos y vemos si podemos entrar y ver si todo es correcto.

NOTA : La instalación de Mantis es muy sencilla, ahora tenemos que configurar nuestro Bug Tracker para adaptarlo a nuestras necesidades, pero eso será en otro post.

OBSERVACIONES : SI por algún motivo no se ha creado el fichero config.inc.php, ir a la carpeta /issues del Hosting y copiar el fichero config.inc.php.sample por config.inc.php

Una vez copiado el fichero entramos en dicho fichero con un editor y cambiamos los datos de acceso por defecto de la Base de datos por nuestros datos.

Los datos a Modificar en la primera fase son (En rojo los nuestros):

# — database variables ———

# set these values to match your setup
$g_hostname      = “localhost”;
$g_db_username   = “mantisdbuser”;  “myusuario“;
$g_db_password   = “”;                        “myclave“;
$g_database_name = “bugtracker”;      “mybasedatos“;
$g_db_type       = “mysql”;                   “mysqli“;

NO OLVIDES DE BORRAR LA CARPETA ADMIN:

UNA VEZ QUE HEMOS ENTRADO CON EL USUARIO : administrator, TENEMOS QUE BORRAR DE LA CARPETA /ISSUES, LA SUBCARPETA ADMIN, ES MUY IMPORTANTE QUE SEA BORRADA, POR TEMAS DE SEGURIDAD.

Saludos de Espinas.

…………………………………………………………………

Dicho mensaje aparece cuando creamos Incidencias, Notas o contestamos el correo de solicitud de clave que nos envía el Servidor de Correo para terminar de crear nuestra cuenta en Mantis.

Dicho error es aleatorio, algunas veces lo da y otras no, es cómo si nos tomara el pelo el dichoso Mantis (Bug Tracker).

El PHP, tiene diferentes opciones para garantizar la integridad de los datos enviados vía formulario por web, uno de ellos puede ser el código captcha y otro más sofisticado es el token.

Siempre que da dicho error es porque hemos enviado en muy poco espacio de tiempo dos formularios a la vez y por ese motivo el sistema nos da el error 2800.

Cuando da dicho error, hay que tener un poco de paciencia, volver hacia atrás y esperar un poco (Dependerá de la carga del Servidor) y volver a intentarlo.

Los de Mantis han sacado las siguientes versiones después de la versión 1.1.4 para arreglar el error 2800 y muchos bug mássssss.

• Download Mantis 1.1.5 , ver cambios en  Changelog de Mantis
• Download Mantis 1.1.6 , ver cambios en  Changelog de Mantis

Recomiendo el cambio de la versión 1.1.4 a la versión 1.1.6.

Saludos de Telepieza.

En la parte Derecha de la pantalla de incidencias (ver imagen abajo) he numerado las opciones en :

• 8.- Estado
• 9.- Fecha Actualizada
• 10.- Resumen de la Incidencia
• 11.- Consultar Proyectos o Incidencias.

……………………………………………………………………

8.- Estado

Recordar que Mantis se comunica con nosotros por colores, el estado está asociado al color y  puede ser :

• Color Rojo = Nueva Incidencia,
• Color Naranja = Se necesitan más datos o incidencia reabierta,
• Color Amarillo = Aceptada por los técnicos,
• Color violeta = Asignada a un técnico (En cola de Solución),
• Color Verde = Incidencia resuelta,
• Color Gris = Incidencia Cerrada por estar resuelta.

Los colores de los diferentes estados de las incidencias son parametrizables en la configuración de Mantis, los técnicos que han configurado Mantis en Telepieza,  han elegido los colores descritos anteriormente para los diferentes estados de las incidencias,  por la experiencia profesional acumulada en muchos años.

9.- Fecha Actualizada

Cada vez que introducimos una nota, se modifica la fecha de actualización, dicha fecha es interesante cuando deseamos ordenar la columna de Actualizada de Mayor a Menor.

Para realizar dicha clasificación tenemos que picar con el ratón la columna Actualizada y nos aparecerá un triangulo en negro (ver imagen)

………………………………………………………………

NOTA : La clasificación de las incidencias se puede realizar por cualquier columna de las incidencias, sólo tenemos que picar en el texto de cualquier columna de la primera fila (ver imagen de Arriba) y nos saldrá un triangulo negro indicando el orden del campo por el cual se visualizan las Incidencias.

10.- Resumen de la Incidencia

El resumen de la incidencia tiene que ser corto, claro y conciso, para que todos podamos entender cual es la incidencia en un solo vistazo.

11.- Consultar Proyectos o Incidencias.

Si tenemos muchas incidencias en la pantalla de incidencias o simplemente queremos visualizar incidencias de un proyecto o subproyecto en concreto, podemos elegir en está opción la incidencia deseada o todos las incidencias.

Un error típico de muchos usuarios es que seleccionan un proyecto para ver sus incidencias y después se vuelven locos buscando las incidencias que le faltan, y es porque no han seleccionado todos los proyectos en dicha opción.

En la ventana de ir a incidencias, es poner el número de incidencia y picar el botón de ir a incidencias.

En la imagen de la izquierda hemos colocado la incidencia nº 7

Entiendo (Espinas) que con las explicaciones de las dos entradas 1ª y 2ª parte de la pantalla de incidencias de Mantis, todos vosotros tenéis los suficientes conocimientos para investigar por vuestra cuenta y aprender los enlaces que no he explicado, por entender que no son importantes en la primera fase de aprendizaje del Mantis (Bug Tracker).

INFORMACION de INTERES  : A nivel profesional (ESPINAS), nuestro Dpto de Informática trabaja con Mantis en toda la Organización y es una las herramientas imprensindibles para todo el Dpto.

Sin Mantis todos nuestro personal técnico y consultor no sería ni la mitad de eficaz de lo que es en la actualidad.

Un Saludo de Espinas.

En el anterior post me quede a las puertas de explicar la pantalla de incidencias una vez picado la opción de menú “VER INCIDENCIAS”.

Dicha pantalla tiene un montón de opciones y menús, para poder explicar su funcionamiento, voy a partir en 2 trozos (Izquierda y Derecha) la pantalla y numerar las opciones para su explicación.

En la parte Izquierda de la pantalla (ver Imagen Abajo) he numerado las opciones en

• 1.- Reportar Incidencias
• 2.- Búsquedas avanzadas
• 3.- Informes (Impresión)
• 4.- Nº de Incidencia
• 5.- Nº de Notas introducidas en la Incidencia
• 6.- Proyecto y categoría de la Incidencia
• 7.- Severidad

……………………………………………………………………

NOTA : Para ver las imágenes en miniatura picar encima de ellas para visualizar y agrandar la imagen.

1.- Reportar Incidencias

La forma de poderse comunicar en Mantis a todos los usuarios, es escribiendo una Incidencia por la opción de menú Reportar Incidencias.

Al picar dicha opción nos sale una pantalla (Ver imagen Izquierda Nº 1), solicitando al usuario la selección del proyecto donde va dicha incidencia, una vez seleccionado picar el botón Selección Proyecto.

Una vez seleccionado el proyecto, nos sale otra pantalla (ver imagen izquierda nº2). Los campos obligatorios a rellenar son los que están marcados con un * en rojo.Voy a explicar de forma breve el significado de cada campo :

Categoría : Cada Proyecto o Subproyecto tiene que tener asignados por configuración del Mantis, una serie de categorías y nosotros tenemos que seleccionar una.

Reproducidad : La incidencia o la Duda cuantas veces se reproduce (siempre, A veces, Aleatorio, Desconocido). El campo no es obligatorio.

Severidad : Indicar la gravedad de la incidencia (Funcional, menor, mayor, fallo, bloqueo, alta, baja ,,,. El campo no es Obligatorio.

Resumen : Indicar de forma muy clara y resumida la duda o incidencia a grabar en el Mantis. El campo es obligatorio.

Descripción : Explicar de forma detallada la incidencia o duda, es aconsejable escribir con todo detalle dicha incidencia, duda o petición de información.

Subir Archivos : Podemos enviar archivos para documentar nuestra incidencia. Ejemplo Excel, Word, Imágenes.

Visibilidad : La incidencia puede ser pública o Privada.

Una vez terminada de rellenar los datos, picar el botón de Reporte y la incidencia se pone de color ROJO por ser NUEVA.

2.- Búsquedas avanzadas

La búsquedas en Mantis pueden ser filtradas y a la vez guardar dichos filtros por cada uno de los campos de la incidencia. Para poder llegar a todos los campos, tenemos que picar el signo + que esta al lado de la palabra buscar.

En cada fila podemos picar el link (por ejemplo visibilidad) y justo abajo nos salen todos los conceptos de visibilidad que existen en Mantis. El ejemplo que he expuesto con el campo visibilidad, sirve para todos los campos de color azul por ser selectores.

Una vez configurado nuestra selección podemos grabar el filtro con un nombre en el botón (crear enlace permanente) para después utilizar dicha selección todas las veces que sean necesarias.

3.- Informes (Impresión)

Podemos seleccionar nuestras incidencias para ser visualizadas o impresas con los programas :

Word, Excel o Explorer.

4.- Nº de Incidencia

Una vez creada la incidencia, los Usuarios, técnicos o responsables del proyecto pueden escribir las contestaciones mediante notas. Si picamos el nº de Incidencia, son saldrá una pantalla con toda la información y el histórico de dicha incidencia, con la posibilidad de añadir notas aclaratorias de la incidencia.

Según la categoria del Usuario en Mantis, en dicha pantalla podemos asignar técnicos y modificar el estado de la incidencia (Colores).

5.- Nº de Notas introducidas en la Incidencia

Nos indica la cantidad de notas escritas en dicha incidencia, para verlas todas y además escribir otra posible nota, tenemos que picar encima del número de notas.

Es una de las opciones más interesantes por parte de la persona que contesta la incidencia a la hora de escribir la ayuda solicitada por el Usuario.

6.- Proyecto y categoría de la Incidencia

Cuando entramos la incidencia, es obligatorio seleccionar el Proyecto o Subproyecto y la sección dentro del proyecto. Dicha opción nos visualiza en donde está ubicada la incidencia para su posterior control y selección.

7.- Severidad

El campo de Severidad es configurable en Mantis, en la imagen de la izquierda, tenemos un ejemplo de las diferentes opciones que vienen por defecto.

Por supuesto al crear una incidencia, tenemos que asignar un  tipo de severidad para informar a los usuarios y técnicos el grado de importancia que tiene dicha incidencia.

NOTA : Los que ya tienen usuario registrado o quieren entrar en Mantis (Bug Tracker), pueden realizar pruebas de crear Incidencias y notas en  Bug Tracker de Telepieza

Un Saludo de Espinas