MailNode

Current release: MailNode 0.5
Released 2008-09-04 — testé avec Plone 3.1, Plone 3.0, Plone 2.5
Amélioration du code, nouvelle fonctionnalités.
Experimental releases
There are no experimental releases available at the moment.
Project Description
- Project resources
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.
- Categories :
- Damien Levacher
- Plone 2
- Extensions
- MailNode
- Gaël Le Mignot
- contributions