Pour cela, insérez simplement cette ligne de code à l’endroit où vous voulez afficher le nombre d’inscrits (prenez soin de mettre la bonne adresse vers le fichier extra.php) :

<script type="text/javascript" src="http://www.yourdomaine.com/rep/options/extra.php?liste=[ID]"></script>

Vous devez remplacer [ID] par le numéro identifiant de la liste de diffusion dont vous voulez afficher le nombre d’inscrits. Vous pouvez également indiquer plusieurs identifiants de liste en les séparant par un signe plus.

Un tel bloc de script affichera immédiatement le nombre d’inscrits en utilisant l’instruction JavaScript document.write(string);. Si vous souhaitez simplement récupérer le nombre d’inscrits pour un traitement ultérieur, ajoutez simplement le paramètre use-variable dans l’URL d’appel du script. Le nombre d’inscrits ne sera dans ce cas pas afficher mais disponible dans une variable nommée numSubscribe.

Pour être prévenu de la sortie d’une nouvelle version, ou de la découverte (improbable ? :¬) ) d’une faille de sécurité, passez de temps en temps sur le site phpCodeur ou, plus simplement, inscrivez-vous à la lettre d’informations de Wanewsletter.

Un utilitaire d’importation d’emails est disponible dans la rubrique "outils" de Wanewsletter. Il vous permettra, si vous avez les droits suffisants, d’importer des emails directement via un champ texte, en spécifiant l’adresse du fichier sur le serveur, ou via l’upload d’un fichier contenant les emails, si votre hébergeur autorise l’upload de fichiers.

L’utilitaire accepte également les fichiers au format XML tels que générés par l’outil d’exportation. Un tel fichier a la structure suivante :

	address1@example.tld
	address2@example.tld
	…
]]>

L’utilitaire d’importation a été testé avec des importations de masse allant jusqu’à 5000 emails (Ce nombre devrait être suffisant). Au pire, vous pouvez toujours découper l’importation en plusieurs fois pour assurer le succés de l’opération. Une autre solution pour importer plus de 5000 emails en une importation consiste à modifier la valeur de la constante MAX_IMPORT dans le fichier constantes.php mais ceci n’est pas recommandé !

Le script se charge de vérifier chacun des emails, ainsi que d’éliminer les éventuels doublons. Si des emails sont refusés, le script génèrera un rapport et le sauvegardera dans le répertoire de fichiers temporaires du script (tmp/ par défaut).

Le script contrib/wanewsletter, dédié à une utilisation en ligne de commande, permet également de réaliser des importations d’emails. Les limitations de durée des scripts php dans le cadre d’un serveur web ne s’appliquent pas dans ce cas.

Wanewsletter peut être géré par plusieurs utilisateurs. Vous pouvez modifier les permissions des utilisateurs via le profil de l’utilisateur en question.

Il y a deux niveaux généraux : administrateur et utilisateur. Les administateurs ont automatiquement tous les droits, quelques que soient les réglages sur les droits individuels. Un utilisateur pourra faire tout ce qui lui aura été permis (voir, editer, supprimer, envoyer des newsletter, importer, exporter, bannir, et joindre des fichiers) et ce, pour chaque liste.

Pour ajouter un utilisateur, rendez-vous dans la section "Utilisateurs" puis "ajouter un utilisateur"

Vous disposez d’un formulaire par défaut, le fichier subscribe.php (note aux possesseurs de versions 2.0.x ou 2.1.x, le nom a changé et n’est plus suscribe.php, dont l’orthographe n’était pas correcte, pensez à changer vos éventuels liens pointant sur ce fichier). Le fichier subscribe.php affiche un formulaire classique, et une liste de sélection affichant les noms de toutes les listes de diffusion publiques créées.

Le script dispose également d’un générateur de formulaire dans la section "outils". Celui ci vous permettra, pour une liste donnée, de générer le formulaire adéquat. Il ne vous restera qu’à placer ce formulaire où vous voulez sur le site, de placer le code d’inclusion de newsletter.php (code également fourni par le form. generator) et d’indiquer dans les réglages de la liste de diffusion en question l’adresse du formulaire.

Notez que vous pouvez ajouter la variable $textCharset dans le code PHP d’inclusion de newsletter.php. Cela influera sur le codage de caractères du message de réponse renvoyé par newsletter.php. Cette variable prend toute valeur acceptable par la librairie iconv.

Une dernière solution (disponible à partir de la version 2.2-RC1) consiste pour le visiteur à envoyer un email à l’adresse email d’une liste, avec comme sujet de l’email "Inscription" (insensible à la casse). Dans ce cas, vous devez avoir accès à cron (serveurs unix et équivalents) ou faire appel aux services gratuits de webcron.org pour automatiser l’appel au fichier cron.php qui se trouve dans le répertoire options/ du script. Ce script se chargera d’effectuer les tâches nécessaires (inscription, désinscription, changement de format, confirmation d’inscription..) selon les emails reçus.

Pour une désinscription, l’abonné devra envoyer un email avec pour sujet "Desinscription" (sans accents !), il recevra alors un email lui demandant de renvoyer un autre email avec le meme sujet, et le code son compte, qui lui aura été fourni (par sécurité). Pour la confirmation d’inscription (si la liste le demande), ce devra être un email avec pour sujet "confirmation", et pour le changement de format, le sujet devra être "setformat".

Si plusieurs de vos listes de diffusion utilisent la même adresse email, il risque d’y avoir conflit, le script ne sachant pas à quelle liste seront adressés les emails du compte POP. Dans ce cas, il vous faudra créer un alias de l’adresse en question avec le panneau de gestion de votre hébergement, si vous en avez la possibilité (cela exclut les hébergeurs gratuits). Exemple :

Vous avez deux listes utilisant l’adresse email mailing@domaine.com. Il vous faudra créer deux alias renvoyant sur mailing@domaine.com et indiquer ces alias dans les réglages des listes concernées. Par exemple : mailing-1@domaine.com et mailing-2@domaine.com

Dans le cas de l’option "cron", vous devrez indiquer les paramètres d’accès au compte POP de l’adresse email de la liste en question, et indiquer l’utilisation de l’option "cron" avec le bouton radio adéquat (section "listes" de l’administration).

Enfin, cron devra appeller une adresse de ce type :
http://www.yourdomain.com/rep/newsletter/options/cron.php?mode=validate&liste=[ID_de_la_liste]

Wanewsletter dispose de deux méthodes d’envoi pour pouvoir être utilisé par le plus grand nombre. En effet, certains hébergeurs limitent le nombre d’emails envoyés par jour (ex: multimania/lycos), ou n’acceptent qu’un destinataire par email (ex: online).

Il est recommandé d’utiliser la méthode d’envoi par défaut, c’est à dire l’envoi d’un email à chaque abonné.

Le répertoire temporaire du script, tmp/ par défaut, peut être utilisé par le script dans certains cas précis :

• Si le safe mode est activé sur votre serveur ou qu’il y a une restriction au niveau de open_basedir, le script doit déplacé certains fichiers uploadés dans le répertoire tmp/ avant de pouvoir les lire
• Si vous stockez les fichiers joints sur un serveur FTP distant, le script doit rapatrier les fichiers dans le répertoire tmp/ le temps de l’envoi
• Lors de l’export de fichiers joints ou de la sauvegarde des tables, si vous choisissez l’option stocker le fichier sur le serveur, le script créé le fichier dans le répertoire tmp/
• Lors de l’importation d’emails, si des emails sont refusés, le script crééra le fichier explicatif dans le répertoire tmp/
• Durant l’envoi d’une newsletter, le script garde dans un fichier la liste des identifiants des abonnés auxquels la newsletter a été envoyée. C’est une sécurité pour le cas où un problème surviendrait durant l’envoi (plantage du navigateur, timeout, etc)

Le nom du répertoire tmp/ peut être modifié, sous réserve de l’indiquer dans le fichier admin/pagestart.php (cherchez la ligne $tmp_name = 'tmp';).

Dans le cas où l’upload de fichier est autorisé sur votre serveur, cela peut être dù au fait que le script n’a pas les droits en écriture sur le répertoire de stockage des fichiers joints ou que les paramètres d’accès au serveur FTP ne sont pas corrects (si option choisie). Vérifiez donc le chmod ou les attributs de ce répertoire ou vérifiez les paramètres d’accès au FTP.

Si l’upload n’est pas autorisé, le script n’ajoute le fichier à la liste des fichiers joints que si celui ci est déja présent sur le serveur, dans le répertoire de stockage des fichiers joints. Uploadez vos fichiers joints avec votre client FTP avant d’ajouter vos fichiers joints via le formulaire.

Malheureusement, utiliser l’option SMTP de Wanewsletter ne permet pas d’envoyer des emails à d’autres personnes qu’au domaine du serveur SMTP choisi si vous n’êtes pas vous-même identifié comme faisant partie de ce domaine (C’est une restriction du serveur SMTP (refus du relayage), non de Wanewsletter).

Exemple :

Vous mettez smtp.wanadoo.fr comme serveur SMTP dans la configuration de Wanewsletter. Si le serveur SMTP ne vous identifie pas comme faisant partie du domaine wanadoo, vous ne pourrez envoyer d’emails qu’à des adresse de type blablabla@wanadoo.fr.

L’alternative est que le serveur SMTP que vous voulez utiliser gère l’authentification, c’est à dire, reconnaisse la commande AUTH LOGIN (cf : la RFC 2554). Dans ce cas précis, vous pourrez spécifier dans la configuration de la newsletter le login et le mot de passe d’accès au serveur.

Intégrer le formulaire d’inscription sur votre site, en l’appellant tout simplement à l’aide d’une popup, est très simple. Le code est le suivant :

  Newsletter
]]>

Et vous devez comme url absolu vers le formulaire, pour les listes concernées, l’url absolue vers le fichier subscribe.php (http://yourdomaine.com/rep/subscribe.php). Attention cependant, lorsque le nouvel inscrit cliquera pour confirmer son inscription, ou s’il se désinscrit via le lien présent dans la newsletter, subscribe.php apparaitra en pleine page.

Pour vérifier la validité des adresses emails fournies à l’inscription, le script vérifie leur validité syntaxique. Certains caractères ne peuvent être présents et l’adresse email doit contenir le signe arobase. Vous pouvez régler le script pour qu’une vérification approfondie soit effectuée (voir configuration).

Cette vérification approfondie consiste à contacter les serveurs de mail dont dépend le domaine de l’adresse email concernée et à réaliser un envoi factice. Selon la réponse renvoyée par le serveur, on peut savoir si l’adresse email concernée n’est pas valide.

Cette méthode est loin d’être infaillible. De nombreux serveurs ne renvoient pas d’erreur pour une adresse email non valide au moment où ils sont contactés. Au lieu de cela, les erreurs sont traitées ultérieurement, au niveau du serveur POP. De plus, le ou les serveurs de mail trouvés peuvent ne pas être accessibles au moment où la personne s’inscrit à votre liste de diffusion. Dans le doute, l’adresse email est alors considérée comme valide.

En bref, cette fonctionnalité ne sert pas à valider les adresses email lors des inscriptions, mais plutôt à rejeter immédiatement les adresses emails pour lesquelles on est sùr de la non-validité.

Pour changer le nom du répertoire stats/, c’est simple, éditez le fichier includes/functions.stats.php et modifiez la ligne suivante :

define('WA_STATSDIR', WA_ROOTDIR . '/stats'); 

Le script donne la possibilité de réaliser vos envois de newsletters avec cron.
C’est très simple, il suffit d’appeler l’adresse suivante : http://www.yourdomaine.com/rep/options/cron.php?mode=send&liste=[ID]
La partie du domaine et du chemin d’installation est à régler par vos soins. Vous devez là aussi remplacer [ID] par l’identifiant de la liste concernée.

À partir de Wanewsletter 2.3, un module expérimental utilisable en ligne de comande est disponible dans le répertoire contrib/. Vous devez donner les droits d’exécution sur le fichier contrib/wanewsletter (ou passer par l’exécutable PHP).

Voici la commande pour lancer un envoi pour une liste donnée :

$ /path/to/contrib/wanewsletter --process-send=1

Avec 1 l’identifiant de la liste concernée dans cet exemple.

Par défaut, le script enverra tous les emails en faisant une pause de 10 secondes tous les 400 emails pour éviter d’engorger le serveur de mail. Ces deux valeurs (10 et 400) sont modifiables en ligne de commande avec respectivement les paramètres --delay et --packet. Ces valeurs peuvent être modifiées également en éditant le fichier contrib/wanewsletter.

Si vous ne souhaitez pas envoyer tous les emails à la suite, vous pouvez utiliser le paramètre --limit pour indiquer le nombre d’emails maximum à envoyer.

Pour utiliser les tags personnalisés (à l’instar de {LINKS} ou {NAME}), éditez le fichier tags.inc.php avec un simple éditeur de texte. Vous devriez trouver ceci au début du fichier :

//$other_tags[$t]['column_name'] = '';
//$other_tags[$t]['field_name']  = '';
//$other_tags[$t]['tag_name']    = '';
//$t++;

Wanewsletter ne gère pas automatiquement les tags personnalisés. C’est à dire que c’est à vous de rajouter le champs voulu dans la table prefixe_abonnes, puis de spécifier le tag dans includes/tags.inc.php pour que le script effectue le remplacement du tag par sa valeur lors de l’envoi.

Exemple :
Vous souhaitez pouvoir mettre un tag {ADDRESS} dans vos newsletters, lequel sera remplacé par l’adresse de l’abonné. Après avoir ajouté un champs nommé par exemple abo_address dans la table prefixe_abonnes, vous placerez les données du tag dans includes/tags.inc.php (en ayant décommenté les lignes que j’ai données plus haut), comme ci dessous :

$other_tags[$t]['column_name'] = 'abo_address';
$other_tags[$t]['field_name']  = ''; 
$other_tags[$t]['tag_name']    = 'ADDRESS';
$t++;

Vous souhaitez maintenant ajouter un autre tag ? Reproduisez simplement la même opération.

Pour que vos abonnés puissent ajouter ces données dans leur profil, le panneau de gestion de profil doit être activé (voir configuration générale). Vous devez modifier le template editprofile_body.tpl présent dans le répertoire templates/ du script.
Ajoutez les champs text nécessaires en prenant soin de leur donner le nom de la colonne à laquelle il se rapporte.
Exemple en se basant sur les tags des exemples précédents :

	
		{L_EMAIL} :
		{EMAIL}
	
	
		{L_PSEUDO} :
		
	
	
		Votre adresse :
		{ADDRESS}
	
	
		Anniversaire :
		
	
	
		{L_LANG} :
		{LANG_BOX} 
	
	
	
		{password.L_PASS} :
		
	
	
	
		{L_NEW_PASS} :
		
	
	
		{L_CONFIRM_PASS} :
		
	
]]>

Il vous est possible d’ajouter des champs au formulaire d’inscription pour réceptionner des données et remplir vos champs personnalisés. Il suffit que ces champs portent le nom donné dans l‘entrée 'column_name', ou 'field_name' si vous souhaitez utiliser un nom différent de celui de la colonne dans la base de données.

Le script de traitement de l’inscription sauvegardera automatiquement ces données supplémentaires dans leur champ respectif.

Cette fonctionnalité était demandée par plusieurs utilisateurs de Wanewsletter.
Pour définir une langue à utiliser avec le formulaire (sous réserve que cette langue soit installée dans Wanewsletter), il vous suffit d’ajouter la ligne suivante dans le code d’inclusion de newsletter.php qui est fourni par le générateur de formulaire : $language = 'francais';

Additionellement, vous pouvez également définir l’adresse URL à utiliser pour forger le lien de confirmation d’inscription ou désinscription.
Voici un exemple de code PHP intégrant ces deux ajouts.

]]>

Wanewsletter peut fonctionner avec les bases de données SQLite à partir de sa version 2.3.0.

Vous devez vous assurer avant de débuter l’installation que le répertoire sql/ de Wanewsletter lui est accessible en lecture et écriture. En effet, c’est dans ce répertoire que sera créé par défaut la base de données sqlite de Wanewsletter.

Libre à vous de choisir par la suite un emplacement plus adapté. Il vous suffira de déplacer le fichier wanewsletter.sqlite du répertoire sql/ vers son nouvel emplacement et d’indiquer celui-ci dans le fichier includes/config.inc.php.

Consultez le fichier readme du script.

Cela peut être dù à des restrictions au niveau de la configuration de PHP. C’est typiquement le cas lorsque le safe_mode est activé.

Dans cette configuration, Wanewsletter ne peut renseigner le cinquième argument de la fonction mail() de PHP et donc préciser clairement au programme d’envoi l’adresse email à utiliser pour les retours d’erreurs.

Oui, c’est possible. Vous devez pour cela éditer le fichier admin/envoi.php et remplacer FALSE par TRUE à la ligne 54 :

define('DISABLE_CHECK_LINKS', FALSE);

N’oubliez pas que permettre aux abonnés à vos listes de se désinscrire simplement et rapidement si tel est leur souhait est une obligation légale (1).
Aussi, et sauf cas particuliers, vous ne devriez pas retirer ces liens des lettres que vous envoyez, et donc changer la valeur de cette constante.

(1) Au moins en France, en application de l’article 22 de la loi n° 2004-575 du 21 juin 2004 pour la confiance dans l’économie numérique (LCEN).

Vous les trouverez dans le répertoire language/email_{votre_langue}/.

Cette fonctionnalité a fait l’objet d’une forte demande par les utilisateurs de Wanewsletter et a donc été implémentée dans Wanewsletter 2.3.

Le chargement de modèles de newsletters par URL est très simple à utiliser. Indiquez simplement l’adresse du modèle au format texte et/ou celle du modèle au format HTML dans les champs correspondants lorsque vous êtes sur la page de chargement des newsletters (lien charger une newsletter dans la page d’envoi).

Le script rapatriera alors le contenu de chacune des URLs fournies et effectuera une conversion automatique vers le jeu de caractère de Wanewsletter si les données sont encodées en UTF-8.

Dans le cas d’un modèle au format HTML, Wanewsletter récupèrera le contenu d’un éventuel élément <title/> présent dans l’en-tête de la page et l’utilisera comme sujet du modèle. Une balise <base> sera également ajoutée dans l’en-tête du modèle pour assurer le bon fonctionnement des URLs relatives.

Rendez-vous sur la page de téléchargement de Wanewsletter. Le paquet de langue vous concernant y est peut-être disponible.

Consultez également le fichier readme du script.

Les modifications doivent être faites dans le fichier templates/subscribe_body.tpl.

Cette fonctionnalité de Wanewsletter nécessite la présence sur le serveur d’une librairie tierce, Archive_Tar, disponible dans PEAR.

Vérifiez (éventuellement avec votre hébergeur) que PEAR est correctement installé sur le serveur (Archive_Tar fait partie des librairies requises pour le bon fonctionnement de PEAR donc pas de souci de ce coté là) et que le chemin d’inclusion de PHP (include_path) contient bien le chemin du répertoire d’installation de PEAR.

Si vous n’avez pas la main sur le serveur et que votre hébergeur ne souhaite pas installer PEAR, rendez-vous sur le site pear.php.net et récupérez les paquets PEAR et Archive_Tar. Ouvrez-les et récupérez dans le premier le fichier PEAR.php et dans le second le fichier Tar.php. Placez le fichier PEAR.php dans le répertoire admin/ de Wanewsletter et le fichier Tar.php dans le répertoire admin/Archive/ que vous aurez préalablement créé.

Vous avez dù oublier de configurer correctement votre liste de diffusion. Indiquez une valeur correcte pour l’option "URL absolue de la page où se trouve le formulaire" dans les réglages de votre liste de diffusion.

Parfois, le répertoire d’installation de Wanewsletter peut se trouver dans une partie du site déjà protégée par une authentification HTTP. Dans ces cas-là, il est fastidieux de devoir s’authentifier à nouveau lorsque l’on arrive dans l’administration de Wanewsletter.

Wanewsletter tient compte de ce fait et détecte désormais une éventuelle session HTTP en cours lorsque vous arrivez la première fois sur l’administration. Si une telle session existe, Wanewsletter tentera de vous connecter automatiquement à l’administration avec la paire login/mot de passe ayant servi à démarrer la session HTTP. Bien entendu, ce mécanisme ne peut aboutir que si un administrateur avec le même couple login/mot de passe existe dans Wanewsletter.

Attention, PHP, installé en mode CGI, ne gère pas correctement l’authentification HTTP et les variables PHP_AUTH_USER et PHP_AUTH_PW ne sont pas disponibles. Pour remédier à cela, placez le bloc suivant dans un fichier .htaccess (nécessite le module apache mod_rewrite) :

RewriteEngine on
RewriteRule .* - [E=REMOTE_USER:%{HTTP:Authorization},L]

Wanewsletter propose aussi l’utilisation de tags spéciaux dits tags d’inclusion. Le principe est d’indiquer une url ou un chemin de fichier, le contenu du fichier ciblé étant ajouté à la newsletter lorsque celle-ci est mise en attente d’envoi.

fin de newsletter...]]>

Ce mécanisme prend tout son sens par exemple lorsque l’URL indiquée cible un script serveur générant du contenu.

Si vous souhaitez que l’inclusion soit faite dès la sauvegarde suivante, utilisez l’attribut "tds" avec "true" pour valeur :

fin de newsletter...]]>

Consultez l’entrée Utilisation de tags personnalisés de la FAQ.