N'hésitez pas à consulter aussi l'AideDeParamétrage.
Courriers électroniques sortants
Pour activer l'envoi de courriers électroniques, vous devez définir la variable « mail_from », qui sera utilisée comme adresse de l'expéditeur pour les messages envoyés (en-tête « From: »). Vous devez également choisir le transport utilisé, qui peut être soit le protocole SMTP (utilisez « mail_smarthost » pour l'activer), soit l'exécutable sendmail (dans ce cas, activez-le en utilisant la variable « mail_sendmail »). Si vous utilisez « mail_smarthost » et que le serveur requiert une authentification, vous devrez alors également définir la variable « mail_login ».
- mail_from
Cette variable est utilisée pour les en-têtes « From: » (De :) et « To: » (À :) des courriers électroniques envoyés (l'en-tête « To: » est ainsi défini pour protéger la vie privée des destinataires. Les courriers ne sont pas vraiment envoyés à cette adresse, mais cela permet de ne pas dévoiler les noms des destinataires).
- mail_smarthost
Indiquez l'adresse IP ou le nom de domaine d'un serveur SMTP. Sur un hôte Unix, vous pouvez essayer d'utiliser la valeur localhost ; sur une machine Windows, la machine à indiquer sera en général une machine de votre réseau local ou de votre fournisseur d'accès.
- mail_login
Il n'est nécessaire de modifier cette variable que si vous utilisez « mail_smarthost » et que le serveur nécessite une authentification pour l'envoi de messages (SMTP AUTH) ; dans ce cas il vous faudra indiquer le nom d'utilisateur et le mot de passe, séparés par une espace, par exemple "utilisateur mot_de_passe".
- mail_sendmail
- C'est la commande locale à exécuter pour envoyer un courrier, par exemple '/usr/sbin/sendmail -t -i'. Cela ne sera utile que sur une machine disposant d'un agent de transport de courrier (MTA).
Courriers entrants (pour la version 1.6 uniquement)
Si vous désirez importer des message dans votre wiki MoinMoin, c'est-à-dire l'autoriser à recevoir et sauvegarder des messages, vous devez paramétrer un certain nombre de choses.
Vous devez d'abord paramétrer votre serveur de messagerie afin de rediriger les nouveaux messages vers MoinMoin. La commande à utiliser est moin xmlrpc mailimport. Notez qu'il vous est possible d'utiliser le paramètre --config /chemin/du/répertoire pour fournir le chemin d'accès à un répertoire contenant un fichier de configuration de MoinMoin adéquat. Vous devrez alors vous assurer de la présence dans ce répertoire du fichier mailimportconf.py. Il devrait ressembler à ce qui suit (il y a un fichier exemple dans wiki/config) :
# Le mot de passe doit être connu du wiki mailimport_secret = u"foo" # L'URL cible mailimport_url = u"http://localhost:81/?action=xmlrpc2"
Le mot de passe est utilisé pour permettre au script de s'authentifier auprès du wiki. L'URL est consituté de l'URL normale du wiki et de ?action=xmlrpc2.
Vous pouvez désormais configurer le wiki. Les options de configuration suivantes sont disponibles :
- mail_import_subpage_template
- C'est le modèle des noms de page générés par le code important les courriels. Voir plus bas pour connaître les paramètres de substitution disponibles.
- mail_import_wiki_address
L'adresse de destination pour les messages qui doivent être inclus au wiki. MoinMoin examine cette adresse pour connaître le nom de la page cible, elle devrait correspondre à une adresse connu du serveur de mail.
- mail_import_secret
Le mot de passe qui correspond à celui décrit dans le fichier mailimportconf.py. Voir ci-dessus.
Après avoir attribué les valeurs des options décrites ci-dessus, vous devriez être capable de vous envoyer des courriels. L'utilisation est décrite plus bas.