## Please edit system and help pages ONLY in the moinmaster wiki! For more ## information, please see MoinMaster:MoinPagesEditorGroup. ## Merci de n'éditer les pages systèmes et d'aide QUE sur MoinMaster ! ## Pour plus d'information, consultez MoinMaster:MoinPagesEditorGroup. ##master-page:HelpOnConfiguration/EmailSupport ##master-date:Unknown-Date #acl MoinPagesEditorGroup:read,write,delete,revert All:read #format wiki #language fr <> = Configuration du courrier électronique = Voir aussi l'AideDeParamétrage. == Courriels sortants == Pour activer les courriels sortants, vous devez spécifier le champ adresse `From:` avec la variable "`mail_from`". De plus vous devez choisir un mode de transport, soit par SMTP (utilisez "`mail_smarthost`" pour l'activer), soit par sendmail (dans ce cas utilisez la variable "`mail_sendmail`"). Si vous utilisez "`mail_smarthost`" et que le serveur requiert une authentification, veuillez alors aussi préciser `mail_login`". mail_from:: Cette variable est utilisée pour configurer les champs "`From:`" et "`To:`" des entêtes des courriels envoyés (le champ "`To:`" implique des considérations concernant la vie privée, le courriel n'est pas réellement envoyé à l'adresse affichée, nous ne voulons pas dévoiler l'adresse réelle du destinataire). mail_smarthost:: Ceci est l'adresse IP ou le nom de domaine d'un serveur SMTP. Sur un hôte Unix vous pouvez utiliser la valeur `localhost` ; sur une machine Windows cela identifiera sûrement une machine de votre LAN ou un hôte de votre fournisseur d'accès. mail_login:: Ceci est uniquement requis si vous utilisez `mail_smarthost` et que que serveur requiert une authentification pour envoyer des messages (SMTP AUTH) ; dans ce cas il vous faut donner le nom d'utilisateur et le mot de passe séparés par un espace, par exemple `"utilisateur mot_de_passe"`. mail_sendmail:: Ceci est une commande locale à exécuter pour envoyer des messages, par exemple '/usr/sbin/sendmail -t -i'. Ce ne sera utile que sur les machines ayant un agent de transport de mail (MTA) installé. == Courriels entrants (pour la version 1.6 uniquement) == Si vous désirez importer des message dans votre wiki [[MoinMoinVF|MoinMoin]], c'est-à-dire l'autoriser à recevoir et sauvegarder des messages, vous devez configurer un certain nombre de choses. Premièrement vous devez configurer votre serveur de mail afin de rediriger les nouveaux messages dans [[MoinMoinVF|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 [[MoinMoinVF|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. [[MoinMoinVF|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. = Fonctionnalités des courriels = [[MoinMoinVF|MoinMoin]] offre actuellement deux services différents basés sur les courriels, et qui sont décrits dans les sections suivantes. == Envoi des données de connexion == Si l'envoi de courriels est activé, la page PréférencesUtilisateur est développée avec un champ "<>" et un bouton "<>". L'utilisateur peut y entrer l'adresse qu'il a donné au moment de son incription et obtiendra en retour une fois après avoir cliquer sur le bouton un courriel avec toutes les informations nécessaire pour se reconnecter. == Notification des modifications == Tous les utilisateurs peuvent s'abonner aux pages du wiki soit en cliquant sur l'icône enveloppe <>, ou en ajoutant une expression rationnelle au champ "Abonnements" de sa page PréférencesUtilisateur. Le système lui enverra alors, chaque fois qu'une page sera modifiée et que l'auteur n'aura pas décoché la case "<>", un courriel avec le nom de l'auteur, un lien vers la page modifié, et un résumé des modifications. L'auteur lui n'est jamais notifié de ses propres modifications. == Réception des mails (version 1.6 uniquement) == [[MoinMoinVF|MoinMoin]] est capable de recevoir des courriels. Il vous suffit de connaître l'adresse électronique du wiki et de lui envoyer un message. Si vous précisez la page cible avant l'adresse du wiki (en tapant `MaPageWiki ` par exemple), vous obtiendrez assez facilemet votre message au sein du wiki. Il y a tout de même quelques règles à respecter : === From === Le système vérifie que l'entête From: contient bien l'adresse électronique d'un utilisateur valide du wiki. Ce n'est pas vraiment très sécurisé, mais c'est mieux que pas de vérification du tout. === To === To: est (en général) constitué de deux parties, comme par exemple `MODELE `. On utilise la partie "nom réel" comme nom de page cible (il peut contenir des caractères spéciaux, des espaces, etc.) et la partie adresse électronique pour envoyer le message au bon endroit. La forme la plus simple de nom de page cible et un nom de page tel que BacÀSable. Voir l'exemple pour les deux différents modes de fonctionnement. === Subject === Si `To:` n'a pas de cible MODELE, on utilise ce champ pour extraire le nom de la page cible. Par exemple : {{{ Subject: bla bla bla [NomDeLaPage/$date] }}} === Corps du message === Le nouveau contenu de la page est constitué de l'ancien contenu (si il y en a un) plus celui du courriel qui est ajouté à la suite. Le contenu des pages n'est jamais écrasé. Les mails envoyés avec le type du contenu à `alternative` sont affichés avec leur corps HTML qui aura été parcouru par un analyseur syntaxique. Les pièces jointes des courriels deviendront les pièces jointes des pages vers qui ils seront envoyé. Les pièces jointes ne sont jamais écrasées. Les pièces jointes seront liées à la page par exemple par une liste de liens en bas de page. === Contenu généré === Si la page a été générée grâce à une requête commençant par un signe `+` (par exemple `+ NomDeLaPage /`), [[MoinMoinVF|MoinMoin]] ajoutera un tableau listant les détails du courriel dans la page parente. === Génération des noms de page === Les paramètres de substitution `$from` (contenant le nom de l'expéditeur), `$date` (la date) and `$subject` (le sujet) sont disponibles. Le nom de la page est généré comme expliqué ici : 1. La présence du wiki dans un des champs adresse est vérifiée, si disponible le modèle de nom de page est obtenu à partir de là. 1. Si il n'y a pas encore de modèle de nom de page, le sujet sera examiné (voir ci-dessus). 1. Si le nom de page se termine avec un slash, on ajoute à la suite la valeur `email_subpage_template` (voir ci-dessus) au nom de la page. 1. Le modèle de nom de page est utilisé pour obtenir le nom de page réel.