Extrait de la documentation du logiciel de modération modappbot v0.4.6 Nota : certaines fonctionnalités ne sont pas utilisées dans tous les forums Première Partie : Présentation, installation, configuration (...) A.4. Modappspool : réception des articles à modérer Ce module analyse chaque article reçu pour modération. Dans le cas le plus général, l'article reçu est copié dans la file d'attente du robot (spool) pour être ultérieurement affecté à un modérateur et traité par lui. Il est possible de configurer modappspool pour qu'il renvoie automatiquement un accusé de réception à tout article reçu. Il est possible d'utiliser des fonctions de filtrage des articles reçus, afin de ne traiter qu'un sous-ensemble des articles reçus. ------------------------------ A.4.1. Vérification de la syntaxe de l'article modappspool vérifie avant tout filtrage que l'article est correctement composé : * il supprime certains champs d'en-tête (Received, To, Old-To, Mail-From par défaut). * si l'article ne contient pas de champ d'en-tête Subject, il en ajoute un, qui est 'no subject' par défaut. * si l'article ne contient pas de champ d'en-tête Message-ID, il en fabrique un. * il nettoie l'article en supprimant les accents des en-têtes From:, Reply-To: et Subject:, en décodant éventuellement l'article codé en 'Quoted-Printable'. Il décode aussi les caractères faisant partie du jeu de caractères propriétaire de Microsoft Windows (apostrophes). * si l'article ne contient pas de champ d'en-tête From, ou Newsgroups, il est supprimé (sans être présenté aux modérateurs) et est archivé. Idem si l'article contient un champ Newsgroups:, mais que le groupe géré par le robot n'apparaît pas ce champ d'en-tête (ce cas est vicieux puisque de tels articles ne devraient pas arriver jusqu'au robot; il doit y avoir un problème au niveau des alias de modération sur un serveur, mais ce n'est pas au robot de détecter ce genre de problème). ------------------------------ A.4.2. Filtrage Modappspool possède les fonctions de filtrage suivantes : - liste noire contenant la liste des auteurs d'articles qui ne peuvent pas poster dans le groupe. Aucun accusé de réception n'est renvoyé dans ce cas. Si l'auteur est dans la liste noire, l'article est supprimé même si le sujet sésame est présent (voir ci-dessous). - liste blanche contenant la liste des auteurs dont les articles sont automatiquement approuvés par le robot et postés sans intervention manuelle d'un modérateur. Si l'article reçu n'est posté que dans un seul groupe modéré (géré par modappbot), aucun accusé de réception n'est renvoyé. Si l'article doit être envoyé par mail à un modérateur d'un autre groupe modéré, un accusé de réception est renvoyé. - sujet interdit (blacksubject) : si le sujet d'un article reçu correspond au sujet 'interdit', l'article est ignoré par le robot et aucun accusé de réception n'est renvoyé à l'auteur - sujet sésame (whitesubject) : si le sujet d'un article reçu ne correspond pas au sujet 'sésame', un message d'erreur est renvoyé à l'auteur et l'article est ignoré. Si le sujet de l'article correspond, l'article est soit posté directement par le robot, soit spoolé afin d'être traité par un modérateur. Si le sujet sésame est défini, une base de données contenant la liste des posteurs l'ayant utilisé au moins une fois est utilisée afin de permettre aux auteurs d'éviter de mettre le sujet sésame dans leurs articles ultérieurs s'ils l'ont utilisé une fois. ------------------------------ A.5. Modappmail : communication avec les modérateurs Ce module est chargé de traiter les articles spoolés (et uniquement ceux-ci). Le dialogue entre modappbot et l'équipe de modérateurs est fait par courrier electronique. Un exemple de session (basique) est la suivante : - le modérateur, lorsqu'il a le temps de s'occuper de quelques articles, envoie un mail à modappbot en précisant dans le corps du message la commande "available password nom.du.groupe" - si modappbot voit que le mot de passe du groupe est correct, et si l'adresse e-mail du From: est dans la liste des modérateurs pour le groupe en question, il renvoie au modérateur qui l'a demandé la liste de tous les articles en attente pour publication dans le groupe précisé. Tous les articles sont alors marqués comme affectés au modérateur. Le modérateur doit alors traiter les articles avant de pouvoir en demander d'autres pour le même groupe (par contre, il peut demander d'autres articles pour un autre groupe dont il serait modérateur). Dans le mail renvoyé par le robot au modérateur, les articles sont marqués par un identifiant unique, avec également l'adresse e-mail de l'auteur et le sujet de l'article. La liste comporte éventuellement en plus, pour chaque article, un identifiant indiquant si l'article est crossposté entre plusieurs groupes pour lequel le modérateur n'est pas responsable, ou bien un identifiant indiquant si l'article est crossposté dans plus de cinq groupes (ce nombre est configurable), un identifiant indiquant si les en-têtes MIME d'un article sont incorrects, et également un identifiant indiquant si l'article est crossposté avec des groupes inconnus du serveur. Si un article contient un champ d'en-tête References: et qu'un article précédemment approuvé par le robot est cité dans ce champ, seul le modérateur ayant approuvé l'article référencé peut approuver l'article en followup. Le robot n'affecte pas les articles en followup à un autre modérateur que celui qui a approuvé l'article initial du fil de discussion. Le robot est capable d'envoyer automatiquement les articles qui viennent d'être affectés au modérateur qui les a demandés. - traitement des articles : - le modérateur peut supprimer un article sans le publier - le modérateur peut refuser un article en donnant un motif de refus. Dans ce cas, l'article est retourné à l'auteur avec un message d'explication. - il peut également approuver un article - il peut demander que l'article complet lui soit envoyé par mail - il peut modifier l'article par mail en l'envoyant au robot avec son identifiant Le modérateur répète cette opération pour tous les articles. Il peut mettre plusieurs commandes dans un même mail pour le robot. Apres réception du mail de commandes (éventuellement multiples), modappbot effectue les actions indiquées, et apres traitement, renvoie un mail au modérateur en lui donnant la liste des articles qui lui sont toujours affectés. La liste peut d'ailleurs être vide. (...) Troisième Partie : Mode d'emploi pour l'utilisateur (...) C.5. Supprimer ou refuser un article Si vous voulez supprimer un article (qui ne sera donc pas publié dans un groupe), utilisez la commande 'delete' : delete motdepasse article1 article2 L'article est supprimé de la file d'attente et la liste des articles qui sont sont affectés. Aucun message d'explication n'est renvoyé à l'auteur de l'article si l'article est supprimé par le commande 'delete'. Vous pouvez également utiliser la commande 'refuse.noreply', qui a le même effet que 'delete'. Vous pouvez également refuser un article. Dans ce cas, l'article n'est pas publié dans le groupe, et est supprimé de la file d'attente, mais un message d'explication est renvoyé à l'auteur. Pour cela, vous pouvez utiliser une commande commençant par 'refuse.'. Les différentes commandes 'refuse.' disponibles pour votre groupe sont données dans le message d'aide renvoyé après une commande 'help' (partie 'Possible refuse commands'). Par exemple, si un message de refus est configuré dans le cas d'articles ne respectant pas la charte du groupe, ou bien d'articles sur des thèmes traités dans la FAQ du groupe, vous pouvez utiliser les commandes suivantes : refuse.charter motdepasse article1 article2 refuse.faq motdepasse article3 article4 IMPORTANT : le message de refus n'est pas envoyé à l'auteur de l'article si son adresse contient une expression 'ANTISPAM' telle que définie dans la configuration générale du robot (variable globale 'noreply'). ------------------------------ C.6. Libérer un article Vous pouvez demander au robot que certains articles soient remis en état "attente de traitement". Pour cela, envoyez un message de commandes contenant : release motdepasse article L'article est alors retiré de votre liste d'articles en attente, et il peut être demandé par un autre modérateur. Si jamais vous re-demandez des articles à traiter, et si l'article que vous avez libéré n'a pas été affecté à un autre modérateur, il vous est de nouveau attribué. ------------------------------ C.7. Transfert d'articles Si vous avez un doute sur un article, vous pouvez demander qu'il vous soit envoyé par mail. Pour cela, utilisez la commande suivante : getarticle motdepasse article Le robot vous renvoie alors l'article, de la façon suivante : Subject: Modappbot : Article xxxxxxxxx for nom.du.groupe (suit l'article complet : en-tête et corps) Lorsque vous avez récupéré l'article, vous pouvez choisir de le supprimer ou de l'approuver en connaissance de cause. Vous pouvez également le renvoyer modifié au robot. Pour cela, utilisez la commande : putarticle motdepasse article Vous devez inclure à la suite de cette commande, dans le même mail envoyé au robot, l'article que vous voulez déposer dans la file d'attente du robot, de la facon suivante : putarticle mypw 3224vdg$e From: sn@penelope.frmug.org Newsgroups: fr.announce.seminaires (...) Si vous voulez inclure d'autres commandes après cette commande putarticle, utilisez le marqueur de fin de fichier 'endput'. D'autre part, si le mail que vous envoyez au robot pour remplacer un article contient une signature (commençant par '-- '), elle est incluse à la fin de l'article remplacé (sauf si la fin de l'article est mentionnée par 'endput'). Copyright (c) 1997-1998, Sylvain Nierveze (sn à penelope.frmug.org)