Module NEWSLETTER pour Versions 1.5 et supérieures par Eolia (Mise à jour du 6/10/2013)

Transcription

1 Module NEWSLETTER pour Versions 1.5 et supérieures par Eolia (Mise à jour du 6/10/2013) Suite à différentes demandes, voici une aide pour l installation et l utilisation de ce module: Installation : (pour ceux qui n ont pas la dernière version auto-update) Télécharger le module sur le forum ou ici : Module newsletteradmin Version Prestashop >1.5 Vous pouvez l'installer à partir de l'onglet "Modules" du BO (Ajouter un module depuis mon ordinateur) ou le transférer manuellement. La méthode manuelle est conseillée dans les cas où vous avez des problèmes de droits ftp (user www-data du script différent de votre connexion) Donc, Méthode manuelle: Dézippez-le et copiez-le par ftp (mode passif, binaire) dans votre répertoire «modules». Allez dans votre onglet «modules», sous-rubrique Envoi d' s. Cliquez sur «installer», puis vous arrivez ici: Clients -> Envoyer une newsletter

2 La copie et la configuration de votre module se déroule alors en vous donnant différentes informations dont, les fichiers copiés, l emplacement de votre fichier de traductions internes. Si vous avez des erreurs (souvent un problème de droits en copie), regardez bien les messages et faites les copies manuellement. Voir FAQ plus bas. Ensuite un clic sur le bouton "Allez au module". Note: Vous aurez cet avertissement si vous êtes en multiboutique et que vous n'en n'avez pas choisi une au préalable: Une fois la boutique choisie (si vous êtes en mono-boutique cette vous n'aurez pas d'avertissement) vous aurez ceci:

3 Utilisation : Commençons par un test : Choisissez un sujet. Comme il est pré-rempli à la date du jour, on le laisse comme ça, mais libre à vous de le modifier. Évitez juste les caractères exotiques qui risquent de ne pas être lisibles dans certaines messageries. Les variables dont nous parlerons + bas peuvent être insérées dans le sujet (%TITRE% - %PRENOM% - %NOM%). On continue Rédigez votre mail, vous pouvez importer vos templates (créés par vous-même ou récupérés sur le web) dans le répertoire /templates du module et les insérer ensuite grâce au bouton intégré dans l'éditeur. Si vous devez ajouter un fichier css en en-tête copiez son contenu dans la fenêtre de droite. Pour que le test soit intéressant, inscrivez-vous à la newsletter, vous allez comprendre pourquoi. Insérez ces variables pour saisir leur utilité dans le mail : %CIVILITE% - %PRENOM% - %NOM% - % % %LIEN% - %SUB% - %UNSUB% Voici un exemple pour ceux qui n auraient pas compris : %LIEN% Bonjour %CIVILITE% %PRENOM% %NOM%! Votre % % a été tiré au sort pour gagner 50% de réduction cette semaine, alors n hésitez plus! %UNSUB%

4 Vous pouvez copier/coller dans l éditeur, c est fait pour. Ce qui va vous donner à la réception : Cliquez ici pour voir ce mail dans votre navigateur Bonjour Mr John DOE! Votre pub@prestashop.com a été tiré au sort pour gagner 50% de réduction cette semaine, alors n hésitez plus! Se désinscrire Pour ceux qui veulent personnaliser l'entête et/ou le bas de page du mail vous pouvez éditer les 2 fichiers situés dans le répertoire newsletteradmin/mails/fr/ newsletter.txt et newsletter.html. Pour rajouter le logo de votre boutique par exemple, insérez cette ligne: <td align="left"><a title="{shop_name}" href="{shop_url}"><img style="border: none;" src="{shop_logo}" alt="{shop_name}" /></a></td> NE PAS SUPPRIMER LES VARIABLES {css}, {message}, autrement votre mail sera vide ou incomplet Pour info le fichier txt sert aux envois en mode texte. Ce module utilise une classe qui permet d'avoir un rendu correct en mode texte pur (plain text) en conservant l'aspect général du mail et permettant de visualiser les liens. Je vous déconseille d'ajouter quoique ce soit dans ce dernier et surtout, ne supprimez pas la variable {message2}. A présent vous allez définir vos paramètres d'envoi. Cliquez ici: Et entrez vos paramètres d'envoi:

5 Définissez le nombre d'envois par minute (certains hébergeurs brident à 400 mails/heure) cette valeur peut être augmentée si vous utilisez la méthode SMTP plutôt que phpmail(). A vous de faire des tests, suivant vos hébergements et serveurs. Des utilisateurs qui tournent à abonnés avec ce module. La seule contrainte vient de l initialisation de la liste de départ. En effet le script doit sélectionner l ensemble des adresses mails, vérifier leur validité et supprimer tous les doublons. Si vous avez adresses à traiter votre max_execution_time risque d être dépassé. Dans ce cas créez des groupes de 1 à 2000 clients et envoyez-les les un après les autres ou utilisez les tâches cron qui sont idéales pour les envois en masse. Choisissez le nom de l'expéditeur, l'adresse de réponse si vous le souhaitez et le nom de la liste d'envoi. Si vous laissez ces champs vides (enfin les 2 premiers), ceux-ci seront remplis par défaut pour éviter de vous retrouver blacklisté pour spam. Choisissez le ou les destinataires (comme vous faites un test, vous cochez «Tester l envoi sur une adresse» et vous mettez la votre). Choisissez, ou non, de sauvegarder vos campagnes sur votre serveur (utile si vous utilisez le lien %LIEN% dans le mail qui permet, à ceux qui le reçoivent en mode texte, de le voir dans leur navigateur internet) Choisissez d'enregistrer votre mail comme futur template (Modèle).Cela va vous permettre de le réutiliser. Si vous avez créé un fichier css pour ce modèle, celui-ci sera sauvegardé avec le même nom et l'extension css. Cliquez sur "Continuer". Cette nouvelle page vous permet d'avoir un aperçu réel de votre newsletter et de modifier, si nécessaire, votre liste d'envoi définitive.

6 Envoyez vos mails et regardez l avancement. Comme il y en qu un, c est assez rapide. Au premier mail vous avez un aperçu du mail, ensuite une barre de progression jusqu'au dernier mail. Vous aurez peut-être un warning: Si vous avez envoyé 2 newsletters de suite, sans changer le sujet, la sauvegarde (qui prend le nom du sujet) écrasera la précédente. Ne fermez pas la fenêtre de votre navigateur (fonctionne par rafraichissement de la page) et empêchez votre PC de se mettre en veille tant que vous n êtes pas à 100% des envois. Si vous avez besoin de travailler dans votre BO, il suffit d ouvrir un deuxième onglet. Si vous devez envoyer plus de 2000 mails, utilisez les tâches cron qui sont faites pour cela. Vous aurez un rapport par mail en fin d'envoi et l'historique sera consultable dans les logs. Le résultat s affiche avec SUCCES ou ECHEC. Succès ne veut pas dire que le destinataire l a reçu, mais que le mail est bien parti. Après, où il va atterrir, nul ne le sait Une fois la newsletter envoyée vous voici revenu à la page principale du module où vous pouvez gérer vos newsletters envoyées, vos logs et vos templates. Pour voir ces onglets cliquez sur la flèche verte ou sur le titre: Une nouvelle partie est apparue qui va vous permettre de suivre le taux d'ouverture des mails (pas fiable à 100% car il ne faut pas que les scripts ou l'affichage d'image soient bloqués par les utilisateurs ou les messageries) ainsi que l historique de vos campagnes (les 10 dernières, on ne va pas encombrer le serveur avec des trucs inutiles). L option effacer les statistiques permet de repartir à zéro en cas de tests ou d erreurs.

7 Vous pouvez également importer une liste d' s (avec Nom et Prénom si vous le désirez) au format csv. Un fichier exemple.csv est fourni dans le répertoire du module pour vous permettre de faire le test, ce que vous faites maintenant : ->Choix du fichier -> Enregistrer Une nouvelle fenêtre s ouvre avec différentes informations et vous pouvez contrôler la liste importée. Si une erreur de syntaxe apparait le script s arrête, à vous de contrôler votre fichier. Le format est sur 3 colonnes mail ;Nom ;Prénom Si vous n'avez aucun nom/prénom ne mettez qu'un par ligne, les ; sont inutiles Vous pouvez importer une liste provisoirement (le prochain import la remplacera) ou vouloir la conserver pour plus tard. Dans ce cas, choisissez "Enregistrer en tant que groupe", donnez-lui un nom pour la retrouver plus tard. Vous avez juste le temps de voir que tout s est bien déroulé (3 sec) et vous êtes de retour sur votre page principale. Un chiffre a changé, celui de la dernière ligne des choix : Liste d' s importés depuis une liste csv (2824) Groupes importés (CSV) (16887) : Vous pourrez donc le sélectionner pour votre prochain envoi (clic!).comme on est paresseux on reprend le modèle fait lors du dernier envoi en cliquant sur l icône J avoue la flèche est un peu grosse mais on m a demandé tellement de fois où se trouvait cette icône

8 Pensez à changer le sujet de votre mail pour ce nouvel envoi. On peut ne rien mettre, mais pour ne pas être reconnu comme spammeur vous aurez ceci : Nous avons 2 solutions : Modifier le sujet, oui mais c est dommage, il était bien, j avais mis 3 plombes à le trouver, ou alors plus simple : Cliquer ici : Et dans la liste cliquer sur la poubelle correspondant au dernier mail envoyé. Une fois la dernière sauvegarde supprimée vous envoyez le mail à la liste importée par csv (cliquée précédemment). Vous ne risquez rien les adresses sont fausses. Et le résultat final :

9 Bonnes campagnes et à vous de jouer! Ce module est gratuit mais n'hésitez pas à faire un don (lien en bas du module) Eolia PS : Certains vont me demander l utilité de ceci : Pour info cela vous permet de modifier vos traductions dans l admin du BO d une part et pour les fichiers internes au module qui ne sont pas gérés par Prestashop d autre part. Système perso qui ne fonctionne pas trop mal. Si certains ont des connaissances en langues étrangère, leur contribution sera grandement appréciée et les fichiers de traductions intégrés dans les prochaines mises à jour. L option réinstallation recopie les fichiers en cas de bug ou de blocage après une fausse manip. FAQ: 1) LE MODULE NE S'INSTALLE PAS CORRECTEMENT Dézipper l'archive, copier l'ensemble du répertoire newsletteradmin dans votre répertoire modules. Copier le fichier track.php (contenu dans scripts/files) à la racine de votre site. Copier le répertoire newsletters (contenu dans scripts/manage) à la racine de votre site et donnez-lui des droits en 755 ou 777 suivant votre hébergement. Téléchargez tiny.zip, dézippez-le et copiez tiny_mce dans votre répertoire /js (supprimez l'ancien tiny_mce s'il existe). Allez dans l'onglet modules -> Envoi d' s et installez le module sans vous occuper des erreurs éventuelles. Modifiez éventuellement les droits des dossiers cron, log, mails et translations en 777, si vous rencontrez des problèmes en écriture.

10 2) LE MODULE A L'AIR DE FONCTIONNER MAIS TOUS LES MAILS SONT EN ECHEC Vérifiez que la fonction mail fonctionne sur votre serveur en envoyant un mail de test via l'onglet "Paramètres avancés" -> s. Si cela fonctionne, vérifiez que le sous-répertoire /fr a bien été créé dans le répertoire /mails du module et qu'il n'est pas vide (il doit contenir 3 fichiers: index.php, newsletter.txt et newsletter.html). Si ce répertoire n'existe pas copier et renommer le répertoire /en en /fr. 3) LES TAUX DE RECEPTION SONT BAS Le tracking n'est pas fiable à 100%, loin de là. Explications: Pour savoir qui a ouvert un mail il faut forcément une requête vers votre serveur, pour initier cette requête un lien (sur une image vide) est inséré au mail qui renvoie les infos d'ouverture. Certains fournisseurs d'accès bloquent ce type de requêtes, certains utilisateurs bloquent le téléchargement des images, d'autres ne reçoivent qu'en mode texte et enfin certains vous classent en spam ou indésirables directement( adresse non reconnue, sujet non conforme, mots interdits, expéditeur blacklisté, etc. ). 4) LE LOGO DE MA BOUTIQUE S'AFFICHE EN PIECE-JOINTE Il faut modifier la classe mail.php dans le dossier /classes de votre boutique. Voir ce post: Ligne 145 (Prestashop version 1.4.1) remplacer: $templatevars['{shop_logo}'] = (file_exists(_ps_img_dir_.'logo_mail.jpg'))? $message- >attach(new Swift_Message_Image(new Swift_File(_PS_IMG_DIR_.'logo_mail.jpg'))) : ((file_exists(_ps_img_dir_.'logo.jpg'))? $message->attach(new Swift_Message_Image(new Swift_File(_PS_IMG_DIR_.'logo.jpg'))) : ''); par: $templatevars['{shop_logo}'] = Tools::getShopDomain(true, true). PS_BASE_URI.'img/logo_mail.jpg' ; Edit du 04/10/2012 Pour Presta 1.5 (jusqu'à 1.5.1) remplacer: Swift_Message_Image(new Swift_File(_PS_IMG_DIR_.Configuration::get('PS_LOGO_MAIL')))) : ((file_exists(_ps_img_dir_.'logo.jpg'))? $message->attach(new Swift_Message_Image(new Swift_File(_PS_IMG_DIR_.Configuration::get('PS_LOGO')))) : ''); par: Swift_Message_Image(new Swift_File(_PS_IMG_DIR_.Configuration::get('PS_LOGO_MAIL')))) :

11 Tools::getShopDomain(true, true). PS_BASE_URI.'img/logo_mail.jpg' ; Pour la (ben oui autant garder ce bug, même si on met à jour les fichiers...) commenter cette partie: else if (file_exists(_ps_img_dir_.'logo.jpg')) $template_vars['{shop_logo}'] = $message->attach(new Swift_Message_Image(new Swift_File(_PS_IMG_DIR_.Configuration::get('PS_LOGO')))); Pour la et (vraiment têtus les zozos!) remplacez ces lignes ( ) /* don't attach the logo as */ if (isset($logo)) $template_vars['{shop_logo}'] = $message->attach(new Swift_Message_EmbeddedFile(new Swift_File($logo), null, ImageManager::getMimeTypeByExtension($logo))); et remplacer le paragraphe précédent par: /* don't attach the logo as */ if (isset($logo)) $template_vars['{shop_logo}'] = Tools::getShopDomain(true, true). PS_BASE_URI.'img/'.Configuration::get('PS_LOGO', null, null, $id_shop);