14.2 EMailings
Créer un nouvel emailing
Les fonctions de mailing sont accessibles depuis le menu Outils. Dans le menu de gauche, sous EMailings, choisissez Nouvel emailing.
Figure 14.6 – Formulaire de création d’un emailing

Renseignez :
- Description — titre qui apparaîtra dans la liste des emailings (ex. Renouvellement cotisation)
- De et Errors-to — pré-remplis si vous avez configuré les adresses dans l’administration
- Sujet du mail
- Couleur de fond — personnalisable via l’outil Color Picker
- Contenu de l’email — rédigez avec l’éditeur CKEditor en utilisant les variables de substitution (__LASTNAME__ pour le Nom, __FIRSTNAME__ pour le Prénom, etc.)
Cliquez sur Créer emailing.
Figure 14.7 – Choix des destinataires

Allez ensuite sur l’onglet Destinataires et cliquez sur les boutons Ajouter des listes prédéfinies. Exemple : module Adhérents, filtre validé (non à jour), Date fin adhésion entre deux dates, puis Ajouter.
Depuis l’onglet Fiche emailing :
- Cliquez sur Tester emailing pour un test vers une adresse personnelle
- Ou cliquez sur Valider emailing puis sur Envoi emailing pour l’envoi en masse
Figure 14.8 – Envoi de l’emailing
Avertissement : Seul un mail au statut validé peut être envoyé en masse. Pour des raisons de sécurité, l’envoi en masse depuis la ligne de commande est recommandé : php ./scripts/emailings/mailing-send.php
Le statut global du mailing et le résultat de l’envoi pour chaque destinataire sont mis à jour et consultables.
Modifier un emailing
Il est possible de cloner un emailing existant depuis la liste des emailings déjà créés et envoyés. Cliquez sur la référence (lien cliquable) puis sur Cloner. Seuls les emailings non validés sont encore modifiables. Le clone d’un emailing peut lui aussi être modifié.
Supprimer un emailing
Cliquez sur Supprimer emailing et confirmez. Un emailing peut être supprimé qu’il soit validé ou non.
Options cachées
Constante Effet
MAILING_LIMIT_SENDBYWEB Nombre de mails à envoyer directement
sans passer par la ligne de commande
MAIN_MAIL_DEBUG Écrit le contenu et l’en-tête du dernier
courriel dans dolibarr_mail.log
MAIN_SMS_DEBUG Écrit le contenu des SMS envoyés dans
dolibarr_sms.log
MAIN_MAIL_ALLOW_SENDMAIL_F Ajoute l’option -f à la commande
sendmail pour forcer l’expéditeur
MAIN_MAIL_SENDMAIL_FORCE_BA Ajoute le paramètre -ba à sendmail
pour que le destinataire soit fourni dans
le contenu du mail
MAIN_MAIL_NO_FULL_EMAIL Nettoie les adresses email au format
<email> au lieu de Name <email>
MAIN_FIX_FOR_BUGGED_MTA Corrige les problèmes d’agents MTA qui
ajoutent des CR supplémentaires (utile
pour Orange, Hotmail…)
MAIN_MAIL_DO_NOT_USE_SIGN N’ajoute pas la signature utilisateur à la
fin des emails
MAIL_FORCE_DELIVERY_RECEIPT_INVOICE / _ORDER / _PROPAL Force la réception de livraison à « Oui »
sur le formulaire d’envoi
MAIN_EMAIL_USECCC Affiche le champ BCC dans les
formulaires d’email
MAIN_MAIL_AUTOCOPY_PROPOSAL_TO / _ORDER_TO / Email à utiliser en BCC lors de l’envoi
_INVOICE_TO d’une proposition, commande ou facture
Constante Effet
MAIN_EMAIL_ADD_TRACK_ID Ajoute un identifiant de suivi dans
l’en-tête SMTP pour tracer l’origine des
emails
MAIN_INFO_SOCIETE_MAIL_ALIASES Permet d’utiliser plusieurs identités dans
l’origine des emails
MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL Limite le nombre de destinataires par
message (défaut : 10)
MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML Force tous les emails en format HTML
MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS Remplace les images stockées dans
/medias par des images inline dans les
emails (attention au risque SPAM)
MAIN_COPY_FILE_IN_EVENT_AUTO Ajoute le document en pièce jointe sur
les événements générés automatiquement
(v6.0+)
MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS Adresse IP publique du serveur, affichée
dans l’aide de configuration
MAIN_MAIL_ENABLED_USER_DEST_SELECT Affiche également les utilisateurs
internes dans la liste des destinataires
(v8.0+)
MAIN_EMAIL_SUPPORT_ACK Restaure la case à cocher accusé de
lecture (fonctionnalité abandonnée)
Constantes de substitution
Figure 14.9 – Liste des constantes de substitution disponibles

Constante Valeur substituée __USER_SIGNATURE__ Signature de l’utilisateur expéditeur __USER_ID__ Identifiant de l’utilisateur __USER_LOGIN__ Login de l’utilisateur __USER_LASTNAME__ Nom de l’utilisateur __USER_FIRSTNAME__ Prénom de l’utilisateur __USER_FULLNAME__ Nom complet de l’utilisateur __MYCOMPANY_NAME__ Nom de votre société __MYCOMPANY_EMAIL__ Email de votre société __MYCOMPANY_FULLADDRESS__ Adresse complète de votre société __DAY__ / __DAY_TEXT__ Jour (numérique / texte) __MONTH__ / __MONTH_TEXT__ Mois (numérique / texte) __YEAR__ Année __PREVIOUS_DAY__ / Jour/mois/année précédent __PREVIOUS_MONTH__ / __PREVIOUS_YEAR__ __NEXT_DAY__ / __NEXT_MONTH__ / Jour/mois/année suivant __NEXT_YEAR__ Constante Valeur substituée __DOL_MAIN_URL_ROOT__ URL racine de Dolibarr __(AnyTranslationKey)__ Traduction de la clé __[AnyConstantKey]__ Valeur de la constante __ID__ Identifiant de l’enregistrement __EMAIL__ Email du destinataire __LASTNAME__ / __FIRSTNAME__ Nom / Prénom du destinataire __CHECK_READ__ Lien de suivi d’ouverture de l’email __UNSUBSCRIBE__ Lien de désinscription __ONLINE_SIGN_URL__ Lien de signature en ligne d’une proposition commerciale