larger smaller normal text version of this page
Documentation » Fonctions de messages »

Paramètres de traitement des rebonds


Un des points forts de phpList est le traitement des "rebonds". Un "rebond" est un message qui est renvoyé parce qu'il ne peut pas être délivré normalement. Il y a plusieurs causes possibles : la boîte du destinataire est peut-être pleine, son adresse e-mail est peut-être inactive ou temporairement désactivé, ou mal orthographiée, 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 des rebonds


Enveloppe de message
Dans le fichier config.php vous pouvez définir une adresse de courrier électronique appelée "Enveloppe de message" (message_envelope). Cette adresse sera incluse dans l'en-tête du message en tant que "Return-Path", et c'est vers elle que seront renvoyés les rebonds. Assurez-vous de créer ce compte de messagerie. Lorsque vous définissez la valeur de $message_envelope dans votre fichier config.php, n'oubliez pas de décommenter cette ligne, c'est-à-dire de supprimer le # en début de ligne.

$message_envelope = "mybounces@yourdomain.com";

On peut vérifier si la configuration à réussi en examinant le contenu de l'en-tête de l'un des messages : selon le courrieleur utilisé, afficher ses propriétés ou son code source. Voir aussi RFC 2076 et RFC 3834.
Noter que l'adresse e-mail de l'"Enveloppe de message" n'est pas la même que l'adresse e-mail que vous fournissez lorsque vous rédigez un message, qui est l'adresse "De :" , c'est-à-dire l'adresse que vos destinataires verront dans le champ "De :" du message. L'adresse e-mail dans le champ "De :" est celui que vous demandez à vos correspondants de placer dans leur "liste sécurisée".

Bounce mailbox
Pour pouvoir traiter les rebonds, phpList doit pouvoir se connecter au serveur mail de l'adresse figurant dans le "Return-Path" ; celà se fait dans le fichier config.php ici :

$bounce_mailbox_host       = 'localhost';
$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") peut être l'adresse de messagerie complète, ou 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 treshold)
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é ; en effet phpList n'envoie les messages qu'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 "treshold". Donc si vous utilisez une ancienne version, garder ceci à l'esprit.

Note: Le traitement des rebonds 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 rebonds de phpList


Autres paramètres
En général, ce seront seulement les paramètres ci-dessus que vous devrez changer ; il est cependant recommandé de vérifier les valeurs par défaut pour les autres paramètres liés au traitement des rebonds, tels que : le protocole, le port de la boîte du courriel, le cron, etc. Ces paramètres peuvent être trouvées dans :

Ce bloc 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;


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 inutiles. Une meilleure solution est donc de les mettre sur la liste noire. De cette façon phpList n'enverra aucun message à cette adresse. Cette option est activée par défaut.
define('BLACKLIST_EMAIL_ON_BOUNCE', 1);


Pages connexes

CategoryDocumentation
Page was generated in 0.1739 seconds