Module Mailing
| Mailing | |
|---|---|
| Numéro/ID du module | 22 |
| Doc utilisateur du module | Cette page |
| Doc développeur du module | Module Mailing (développeur) |
Introduction
Ce module permet d'envoyer des emails en masse à tous ou partie de vos clients, fournisseurs, prospects, adhérents, utilisateurs...
Installation
Ce module est livré en standard avec la distribution de Dolibarr, aussi il est déjà installé.
Configuration
Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, aller sur la page "Accueil - Configuration - Modules".
Choisissez l'onglet dans lequel apparaît le module puis cliquez sur "Activer".
Le module est alors activé.
Si un pictogramme 
apparaît sur la vignette ou à la fin de la ligne du module, cliquez dessus pour accéder à la page de paramétrage spécifique à ce module.
Vérifiez aussi que la configuration globale de Dolibarr pour l'envoi de mail est correcte: Paramétrage_EMails
Utilisation
Les fonctions de mailings sont accessibles depuis le menu (sous condition que le Module Mailing ait été activé). On trouve le lien Mailing dans le menu "Outils" avec le gestionnaire de menu "Eldy".
Cycle de vie / Règles de gestion
Le processus complet des emailings est le suivant :
- Le principe est de créer un mailing avec un titre, un sujet, un email expéditeur (Pour cela, cliquer sur le menu "Outils - EMailings - Nouveau", saisir le contenu de l'email avec les éventuelles variables de substitution et valider en cliquant sur "Créer emailing". L'autre solution est d'aller sur un emailing existant et cliquer sur "Cloner").
- Choisir ensuite les destinataires, dans des listes prédéfinies (Pour cela, aller sur l'onglet "Destinataires" et cliquer sur les boutons "Ajouter" des listes prédéfinis de destinataires).
- Affiner le choix issu de ces listes pour supprimer un ou deux destinataires par exemple.
- Le responsable validation valide le contenu du mailing et sa liste de destinataires. Il peut effectuer un test vers sa propre adresse e-mail pour en vérifier le rendu sur son logiciel de messagerie. Si le résultat et la liste des destinataires lui conviennent, il passe le mailing au statut validé (Pour cela, cliquer sur le bouton "Valider").
- L'envoi du mail en masse se fait ensuite, soit depuis l'écran (Pour cela cliquer sur "Envoyer" ou en ligne de commande via le Script mailing-send.php. Seul un mail au statut validé, peut être envoyé en masse.
Voir la page Script mailing-send.php pour plus d'information sur le lancement du script en ligne de commande.
- Le statut global du mailing, ainsi que de le résultat de l'envoi pour chaque destinataire, sera mis à jour est consultable.
Personnaliser le mail : __OTHER1__ à __OTHER5__
En plus de __EMAIL__, __LASTNAME__ et __FIRSTNAME__, on peut utiliser __OTHER1__ à __OTHER5__ dans l'objet et le message de l'emailing.
Leur contenu vient de la colonne « Autre information » de l'onglet « Destinataires » (format Clé1=valeur1;Clé2=valeur2;...) : __OTHER1__ est la 1re valeur, __OTHER2__ la 2e, etc. La clé avant le « = » n'est pas utilisée.
| Liste de destinataires | __OTHER1__ | __OTHER2__ | __OTHER3__ | __OTHER4__ |
|---|---|---|---|---|
| Contacts of thirdparties (contacts des tiers) | Nom du tiers | Civilité (libellé, ex. « Monsieur ») | Poste/fonction | |
| Membres de l'association | Identifiant | Civilité (libellé, ex. « Monsieur ») | Date de fin d'adhésion | Société |
| Utilisateurs de l'application | Identifiant | Civilité (code, ex. « MR ») | Téléphone pro |
Exemple : Bonjour __OTHER2__ __LASTNAME__, donne Bonjour Monsieur Legrand, pour un contact.
E-mails à partir d'un fichier : chaque ligne est au format email;nom;prénom;autre, et tout ce qui suit le 3e « ; » est conservé. La ligne jean@exemple.fr;Dupont;Jean;Monsieur;VIP donne __OTHER1__ = Monsieur et __OTHER2__ = VIP.
E-mails entrés par l'utilisateur : même format, mais seul le 4e champ est conservé (__OTHER1__ uniquement).
Pour les autres listes (Tiers, etc.), le contenu dépend de la liste et des filtres choisis : regarder la colonne « Autre information » avant d'utiliser ces variables.
Les valeurs sont enregistrées au moment de l'ajout des destinataires, dans la langue de l'utilisateur qui les ajoute. Si un contact est modifié ensuite, retirer le destinataire et l'ajouter à nouveau.
Vérifié de Dolibarr v14 à v24.
Mise en page : les patrons
Depuis Dolibarr v20, à la création d'un emailing, le lien « Remplir le message avec un patron » (icône au-dessus du message) propose des mises en page toutes prêtes. Choisir un patron remplace le message par le contenu du patron, que l'on modifie ensuite librement. Il n'existe pas d'écran pour créer ou modifier les patrons.
- v20 : liste fixe (Empty, Basic, News, Commerce), définie dans le code.
- À partir de v21 : chaque patron est un fichier HTML du dossier htdocs/install/doctemplates/maillayout/. La liste contient « Empty » (« Aucun » à partir de v23) puis un patron par fichier. À partir de v22, News n'apparaît que si le module Sites web est activé, et Products (Product en v23+) que si le module Produits ou Services est activé.
Ajouter son propre patron (v21 et suivantes) :
- Copier basic.html sous un autre nom dans le même dossier, par exemple association.html, et modifier la copie. Le patron apparaît dans la liste sous le nom du fichier (« Association »).
- Pour la vignette, ajouter une image du même nom (association.png) dans htdocs/theme/common/maillayout/.
Les variables de l'emailing (__LASTNAME__, __OTHER1__…) peuvent être écrites dans le fichier : elles restent telles quelles dans le message et sont remplacées à l'envoi. Ne pas modifier basic.html lui-même (il est remplacé à chaque mise à jour) et garder une copie de ses fichiers : ils sont dans le dossier du logiciel, pas dans les documents.
Sans toucher aux fichiers : préparer un emailing avec la mise en page voulue, puis, pour chaque nouvel envoi, l'ouvrir et cliquer sur « Cloner » en cochant « Cloner message ».
Testé en v20, v21, v22 et v24 (code identique en v23).