Documentation » Fonctions de messages »
Paramètres de traitement de rebonds
Voir aussi:
Un des points fort de phpList est le traitement de "rebonds". Un "rebond" est un message qui a été renvoyé parce qu'il n'a pas pu être livré pour un certain nombre de raisons: La boîte du destinataire peut être complete, l'adresse e-mail du destinataire peut être inactive ou temporairement désactivé, l'adresse e-mail peut-être mal orthographiés, etc. Un rebond n'est pas la même chose qu'une réponse "out-of-office". Pour plus d'informations, voir Wikipedia.
Configuration du traitement de rebonds
Enveloppe de message
Dans le fichier config.php vous pouvez définir une adresse de courrier électronique appelée adresse "Enveloppe de message" (message_envelope). Cet adresse est inclus dans la tête de message comme adresse du "Return-Path" et sera utilisé pour recevoir les rebonds. Assurez-vous de créer ce compte de messagerie. Vous pouvez définir la valeur de $message_envelope dans votre fichier config.php. N'oubliez pas de décommenter cette ligne, c'est-à-dire supprimer le # au début de cette ligne.
$message_envelope = "mybounces@yourdomain.com";
Vous pouvez vérifier si cela a été correctement configuré par l'affichage des informations d'en-tête de l'un de vos messages, et en regardant ses propriétés et le code source. Voir aussi RFC 2076 et RFC 3834.
Noter que l'adresse de l'enveloppe de message n'est pas la même chose que l'adresse e-mail que vous fournissez lorsque vous rédigez un message, qui est l'adresse "De:", c'est-à-dire, l'addresse que vos destinataires voiront dans le champ "De:" du message. L'adresse e-mail dans le champ "De:" est celui que vous demander aux utilisateurs de placer sur leur "liste sécurisée".
Bounce mailbox
Ainsi, l'adresse du "Return-Path" est celle que les systèmes de messagerie de vos destinataires utiliseront pour envoyer les rebonds. Il est donc nécessaire de configurer la connexion de ce compte dans le fichier config.php:
$bounce_mailbox_host = 'localhost';
$bounce_mailbox_user = 'mybounces@domain.com';
$bounce_mailbox_password = 'super-secret';
$bounce_mailbox_user = 'mybounces@domain.com';
$bounce_mailbox_password = 'super-secret';
Les valeurs que vous devrez mettre pour ces paramètres peuvent varier selon la façon dont le serveur a été configuré. En général, les valeurs que vous utilisez pour votre client de messagerie normal, devraient aussi fonctionner ici. Cependant, le paramètre "$bounce_mailbox_host" qui definie le nom du serveur qui reçoit les rebonds, peut dans certains cas être 'localhost', ou bien 'votre_serveur_pop.votredomaine.com', ou une adresse IP par exemple. Le paramètre pour le nom de l'utilisateur du serveur POP3 ("$bounce_mailbox_user") pourrait être l'adresse de messagerie complète, juste le préfixe, ou un autre nom d'utilisateur. Si vous êtes sur un hébergement partagé, vous pouvez également vous communiquer avec votre hôte.
Seuil de rebonds (Bounce treshhold)
Il existe un paramètre supplémentaire qui détermine le nombre de rebonds consécutifs que phpList acceptera avant de marquer l'utilisateur comme étant non-confirmé. Bien entendu, phpList n'envoira que des messages aux utilisateurs confirmés. Il s'agit du paramètre suivant:
$bounce_unsubscribe_threshold = 5;
Note : dans les versions anciennes de phplist (< v2.10.3), il manqait le «h» de "treshhold". Donc si vous utilisez une ancienne version, garder ceci à l'esprit.
Note: Le traitement de rebond de phpList se connecte à votre serveur mail via un module de PHP connu comme extension IMAP (qui ne doit pas être confondu avec le protocole IMAP). Votre serveur PHP doit avoir ce module installé pour pouvoir utiliser les fonctionnalités de manipulation de rebond de phpList
Autres paramètres
Bien que, en generale, ce seront les paramètres ci-dessus que vous devrez changer, il est recommendé de réviser les valeurs par défaut pour les autres paramètres liés au traitement de rebonds, comme le protocole, port de la boîtes du courriel, cron, etc. Ces paramètres peuvent être trouvées dans:
ce block dans config.php
# Enveloppe du message. Ceci est l'adresse email that system messages come from
# Il est recommendé d'utiliser cette adresse pour recevoir les rebonds.
# Il est probable que vous obtiendrez des avis X-Authentication dans votre message
# si vous l'utilisez avec sendmail.
# NOTE: cet adresse n'est pas du tout la même chose que l'adresse "De:" d'un couriel.
# Pour utilisez ce paramètre, il faut décommenter (eliminer le #) la ligne suivante,
# et changer l'adresse email pour une qui existe sur votre système.
# Nécessite PHP version > "4.0.5" et "4.3.1+" sans safe_mode
$message_envelope = 'listbounces@yourdomain.com';
# Traitement de rebonds. Voyez le fichier README.bounces pour info supplementaire.
# Ce paramètre peut être 'pop' ou 'mbox'
$bounce_protocol = 'pop';
# Mettez ce paramètre à 0, si vous utilisez un 'cron job' pour récupérer les rebonds a intervals regulier
# en utilisant la ligne de commande. Ce ceci est mis à 0, les administrateurs ne pouront pas exécuter la page web
# Voyez README.commandline pour plus d'information comment metre ceci en place pour la ligne de commande.
define ("MANUALLY_PROCESS_BOUNCES",1);
# Si le protocole est pop, specifier les trois paramètre suivants:
$bounce_mailbox_host = 'localhost';
$bounce_mailbox_user = 'popuser';
$bounce_mailbox_password = 'password';
# Le "port" est le port distant de la connexion pour récupérer les rebonds.
# La valeur par défaut devrait être bonne, mais si cela ne fonctionne pas, vous pouvez essayer la deuxième valeur
# Pour faire ceci, ajoutez un # devant la première ligne et eliminez le # de la
# deuxième ligne.
$bounce_mailbox_port = "110/pop3/notls";
#$bounce_mailbox_port = "110/pop3";
# Si le protocole est mbox spécifier le paramètre suivant.
# Ceci doit être un fichier locale en format mbox, accessible à votre utilisateur de serveur web.
$bounce_mailbox = '/var/spool/mail/listbounces';
# Mettez le paramètre suivant à 0 si vous voulez garder les rebonds dans votre boite de couriel.
# Ceci peut representer un problème, parce que les rebonds seront comptés plusieurs fois. Donc, utilisez ce
# paramètre seulement vous voulez fair des essais.
$bounce_mailbox_purge = 1;
# set this to 0 if you want to keep unprocessed messages in the mailbox. Unprocessed
# messages are messages that could not be matched with a user in the system
# messages are still downloaded into PHPlist, so it is safe to delete them from
# the mailbox and view them in PHPlist
$bounce_mailbox_purge_unprocessed = 1;
# Combien de rebonds consécutifs doivent avoir eu lieu pour qu'un utilisateur soit marqué non-confirmé
$bounce_unsubscribe_threshold = 5;
# Il est recommendé d'utiliser cette adresse pour recevoir les rebonds.
# Il est probable que vous obtiendrez des avis X-Authentication dans votre message
# si vous l'utilisez avec sendmail.
# NOTE: cet adresse n'est pas du tout la même chose que l'adresse "De:" d'un couriel.
# Pour utilisez ce paramètre, il faut décommenter (eliminer le #) la ligne suivante,
# et changer l'adresse email pour une qui existe sur votre système.
# Nécessite PHP version > "4.0.5" et "4.3.1+" sans safe_mode
$message_envelope = 'listbounces@yourdomain.com';
# Traitement de rebonds. Voyez le fichier README.bounces pour info supplementaire.
# Ce paramètre peut être 'pop' ou 'mbox'
$bounce_protocol = 'pop';
# Mettez ce paramètre à 0, si vous utilisez un 'cron job' pour récupérer les rebonds a intervals regulier
# en utilisant la ligne de commande. Ce ceci est mis à 0, les administrateurs ne pouront pas exécuter la page web
# Voyez README.commandline pour plus d'information comment metre ceci en place pour la ligne de commande.
define ("MANUALLY_PROCESS_BOUNCES",1);
# Si le protocole est pop, specifier les trois paramètre suivants:
$bounce_mailbox_host = 'localhost';
$bounce_mailbox_user = 'popuser';
$bounce_mailbox_password = 'password';
# Le "port" est le port distant de la connexion pour récupérer les rebonds.
# La valeur par défaut devrait être bonne, mais si cela ne fonctionne pas, vous pouvez essayer la deuxième valeur
# Pour faire ceci, ajoutez un # devant la première ligne et eliminez le # de la
# deuxième ligne.
$bounce_mailbox_port = "110/pop3/notls";
#$bounce_mailbox_port = "110/pop3";
# Si le protocole est mbox spécifier le paramètre suivant.
# Ceci doit être un fichier locale en format mbox, accessible à votre utilisateur de serveur web.
$bounce_mailbox = '/var/spool/mail/listbounces';
# Mettez le paramètre suivant à 0 si vous voulez garder les rebonds dans votre boite de couriel.
# Ceci peut representer un problème, parce que les rebonds seront comptés plusieurs fois. Donc, utilisez ce
# paramètre seulement vous voulez fair des essais.
$bounce_mailbox_purge = 1;
# set this to 0 if you want to keep unprocessed messages in the mailbox. Unprocessed
# messages are messages that could not be matched with a user in the system
# messages are still downloaded into PHPlist, so it is safe to delete them from
# the mailbox and view them in PHPlist
$bounce_mailbox_purge_unprocessed = 1;
# Combien de rebonds consécutifs doivent avoir eu lieu pour qu'un utilisateur soit marqué non-confirmé
$bounce_unsubscribe_threshold = 5;
Depuis la version 2.11.4
# Si l'utilisateur est seulement marqué comme non-confirmé quand le seuil de rebonds consecutifs est atteint, l'option 'marquer tous les utilisateurs confirmé' causera des rebonds innecessaires. Une meilleur solution est donc de les mettres sur la liste noir. De cette façon phpList n'enverra aucun message à cette addresse. Cette option est activée par default.
define('BLACKLIST_EMAIL_ON_BOUNCE', 1);
define('BLACKLIST_EMAIL_ON_BOUNCE', 1);
Pages connexes
CategoryDocumentation
