Ces dernières semaines, j’ai perdu pas mal de temps avec mantis bugtracker et la gestion des pièces jointes, c’est pourquoi après la réalisation d’un plugin d’upload multiple Drag & Drop , voici encore un nouveau plugin qui vous fera gagner du temps dans la gestion des pièces jointes et des bugs.

Le principe de fonctionnement du plugin EmailFile est très simple :

Il suffit d’envoyer un email pour que  les pièces jointes et les captures d’écrans de cet email  soient automatiquement ajoutées au bug souhaité.

L’association des pièces jointes au bug est gérée via l’objet de votre email.
Si vous souhaitez par exemple , ajouter des pièces jointes au bug : 355
l’objet de votre email pourrait être le suivant “355 a la suite le texte que vous voulez”

Installation et configuration du module

Pour commencer télécharger la dernière version du module : MantisEmailFile
Ce module est dépendant du plugin “Jquery” que vous pouvez télécharger depuis l’adresse suivante : https://github.com/mantisbt-plugins/jquery

Déposer les fichiers des plugins téléchargés via ftp dans le dossier “plugins” de votre bugtracker.
Procéder à l’installation des 2 plugins, via l’administration de mantis ( “Gestion des plugiciels” )

Une fois le plugin installé, cliquer sur le texte “Pièces jointes par email 0.1.0” pour accéder à sa configuration

Mantis EmailFile

Vous accéder ensuite à la page de configuration

Mantis Email Upload Config

Il vous est demandé de renseigner :

  • L’hôte email ( serveur qui héberge vos emails )
  • Le compte email
  • Le mot de passe du compte email

Libre à vous ensuite de choisir le mode de récupération des emails souhaités :

Si la fréquence d’envoi de pièces jointes par email est faible, et qu’elle est principalement du fait des développeurs, la solution manuelle est la solution qui conviendra le mieux.
Dans ce cas lorsque vous souhaitez vérifier si des pièces jointes ont été envoyées, il faut cliquer sur le lien “Cliquer ici pour lancer le script de récupération des pièces jointes par email”.
Celui-ci sera disponible sous chaque bug, dans un bloc en dessous du formulaire d’ajout de notes.

EmailFile récupération manuelle

Si la fréquence d’envoi est moyenne, ou que vous ne souhaitez pas avoir a y penser manuelle, la solution ajax conviendra tout à fait.
Lors de chaque chargement de bug, la page de récupération des emails va être appellée via une fonction ajax.
Le résultat de la récupération affiché dans le même bloc que la solution manuelle, et peut etre de différentes formes :

Dans le cas ou il n’y pas pas de mails à traiter

EmailFile Ajax no mail

Dans le cas ou il y’a des emails à traiter :

EmailFile ajax file

Si la fréquence de pièces jointes est importante, ou que vous ne souhaitez pas qu’il y ait d’impacts visuels.
La programmation d’une tâche cron à la fréquence que vous jugerez nécessaire sera la meilleure solutionProgrammer la tâche via la commande suivante :
wget http://www.example.com/mantisDirectory/plugin.php?page=EmailFile/get_emails.php -O /dev/null

( Il est important de bien l’appeller via cette url pour que mantis puisse charger les paramètres du plugin )

 

N’hésitez pas à me signaler si vous trouvez des problèmes ou si vous avez des idées d’optimisations de ce module.