root/alternc-doc/trunk/admin/alternc-procmail.xml

<?xml version="1.0" encoding="iso-8859-1"?>

<!-- $Revision$ -->

<sect1 id="admin.alternc-webalizer">
<title>AlternC-Procmail : Plugin de filtrage de mail</title>

<para>
  Le plugin <command>alternc-procmail</command> permet de filtrer les mails recus sur une boite pop ou imap pour trier les mails à l'arrivée selon des critères multiples. Se basant sur le langage de filtre du logiciel <command>procmail</command> dont il dépend, ce plugin fournit une interface web d'administration pour Squirrelmail qui permet aux utilisateurs de créer des filtres de mails sans avoir besoin d'apprendre le langage de filtrage de procmail.
</para>
<para>
Les différents filtres permettent, sur des critères de sujet, expéditeur, destinataire ou autres entêtes, de déplacer le message dans un autre dossier, d'envoyer une copie à quelqu'un d'autre, de répondre automatiquement ou de supprimer le message. Il est aussi possible de filtrer sur l'entête d'identification des spams de Spamassassin.
</para>

<sect2><title>Installation d'AlternC-procmail</title>
<para>
  Ce plugin s'installe tout simplement en tapant la command <command>apt-get install alternc-procmail</command> sur un AlternC installé ET CONFIGURÉ ! Le plugin vous rappelle alors qu'il s'agit d'un plugin pour Squirrelmail aussi, et que ce dernier doit donc être reconfiguré pour activer le plugin de gestion des filtres par le web.
</para>
<para>
  La configuration de Squirrelmail s'effectue en lançant le script de configuration situé dans <filename>/etc/squirrelmail/conf.pl</filename> et en allant dans le menu 8 : Plugins pour y activer le filtre "alternc-procmail". 
</para>
<para>
  Une fois ce plugin de Squirrelmail installé, vous pouvez utiliser le filtrage de mail depuis le webmail de tout compte pop disponible sur le serveur.
</para>
</sect2>

<sect2><title>Fonctionnement d'AlternC-procmail</title>
<para>
  Le plugin AlternC-procmail fonctionne de la manière suivante : Lorsque l'utilisateur souhaite activer son filtrage, le plugin crée un fichier dans ~/.procmailrc où ~ est le répertoire racine de son compte email (par exemple <filename>/var/alternc/mail/f/foo@example.com/</filename>). Ce fichier ne filtre rien par défaut et laisser juste passer le courrier. Ensuite, le plugin appelle l'API d'AlternC pour dérouter le mail entrant sur la boite concernée via procmail grace à un Wrapper de mail.
</para>
<para>
Ensuite, l'interface web proposant les filtres dispose d'un moteur de génération de fichier <filename>.procmailrc</filename> standardisé et non dangereux (les commandes | de procmail sont, par exemple, non accessibles.) et d'un moteur de lecture de fichier .procmailrc. Ainsi, il permet à l'internaute non initié de créer des filtres basiques utilisant le langage de filtrage de procmail.
</para>

<para><command>Multilinguisme : </command> Le plugin est fourni avec les langues d'AlternC par défaut, et utilise gettext comme tout plugin de Squirrelmail disposant de sa propre traduction. Il pourrait donc idéalement être traduit dans l'ensemble des langues supportées par Squirrelmail.
</para>

<note><title>Fonctionnement en cluster</title>
<para>
AlternC existe de manière expérimentale en mode Cluster, notamment chez Metaconsult et Lautre Net, et ce plugin est prévu pour fonctionner dans ce mode sachant que le bureau n'est exécuté que sur un des éléments du cluster, et que les serveurs de mails sont tous configurés pareil. Enfin, Le package <command>procmail</command> doit être installé sur tous les éléments du cluster susceptibles de traiter du mail.
</para>
</note>

<para><command>Quelques liens utiles : </command> Ce plugin utilise le logiciela Squirrelmail disponible à l'adresse <ulink url="http://www.squirrelmail.org/">http://www.squirrelmail.org/</ulink>. Il utilise aussi Procmail : <ulink url="http://">http://</ulink>
</para>

</sect2>

</sect1>