MailNode

Project Description

Project resources

• Releases
• Contact address
• Issue tracker
• Code repository

Présentation

MailNode est un produit Zope simple qui fournit :

• Un module python pour envoyer des mails avec pièces jointes ;
  
• Le support du format HTML pour l'envoi de mails, avec génération automatique d'une version alternative en plain-text (texte brut) ;
  
• Un autre module python qui peut, au travers d'une boîte mail dédiée à la réception d'erreurs, vérifier la bonne transmission des mails et notifier l'application si un envoi est défectueux.
  

Configuration

Dans l'onglet propriétés (properties) de l'objet Zope MailNode :

• from_adress : adresse email de l'expéditeur ;
  
• charset : encodage de caractères ;
  
• pop_server, pop_username, pop_password : informations relatives à la boîte mail d'erreurs ;
  
• error_callback : nom de la fonction appelée en cas d'erreur (par acquisition).
  

Synopsis

Appel de la structure dans Zope (retourne un msg-id) :

parameters = {
 'to': 'receiver@mail.com',
 'subject': 'Sujet du mail',
 'body': """Le corps du mail
            sur plusieurs lignes""",
 'attachment': ['/home/user/document.pdf', fd2, 'fichier3.pdf', ...]
}
context.Mailnode.sendMail(parameters)

Vous pouvez soit fournir un dictionnaire soit utiliser des mots-clés en arguments. Il est également possible de créer un objet mail (non-persistent), le remplir par l'appel d'une méthode, puis l'envoyer. 

Installation

1. Décompressez l'archive ".tar" dans le répertoire Products/ de votre instance Zope.

2. Redémarrez votre instance Zope.

3. Installez le produit grâce à la fonction Installer/Désinstaller des produits de Plone, ou avec l'installateur rapide.

Configuration

L'outil dispose de plusieurs propriétés paramétrables. Leurs noms sont suffisamment explicites pour ne pas nécessiter de documentation dédiée. 

Contrôle des erreurs

Dans un second temps, MailNode peut vérifier périodiquement une boîte mail POP "d'erreurs", pour gérer et résoudre les problèmes relatifs à l'envoi de mails.

Concept :

• périodiquement, un programme externe appelle la méthode de vérification ('check') de l'objet MailNode, dans Zope (cron + wget) ;
• cette méthode se connecte au serveur de mails ('mailserver') et relève les messages d'erreur ;
• pour chaque message, l'identité ('msg-id') est déterminée par analyse de texte ;
• la méthode 'check' déclenche la méthode définie dans les propriétés du champ 'error_callback', avec la msg-id comme argument.

Crédits

Ce produit a été sponsorisé par Provexi et développé par Pilot Systems

Auteurs :

• Damien Levacher,
  
• Gaël Le Mignot <gael@pilotsystems.net>  

Licence

Ce produit est publié sous licence GPL v2. Pour plus d'informations, consultez le texte officiel (en anglais) ou sa traduction non officielle en français.