Personnaliser le message d'envoi de mail

Si vous cherchez comment personnaliser les messages créés automatiquement à l'envoi d'une facture, une relance ou une proposition par mail, voici quelques notes d'un utilisateur de Dolibarr qui devraient vous faciliter la tâche :

Personnaliser les envois de documents par E-mail

Avec Dolibarr, il est possible d’envoyer directement les pièces par E-mail avec le bouton Envoyer par mail. Un formulaire se présente permettant de choisir les destinataires et un message automatique est ajouté dans la zone message. Le message prédéfinis est enregistré dans le dossier des langues de dolibarr /htdocs/langs/fr_fr/other.lang

Pour personnaliser ce message, il faut modifier les lignes suivantes :

PredefinedMailContentSendInvoice=Veuillez trouver ci-joint la facture __FACREF__\n\nCordialement\n\n

PredefinedMailContentSendInvoiceReminder=Nous apportons à votre connaissance que la facture __FACREF__ ne semble pas avoir été réglée. La voici donc, pour rappel, en pièce jointe.\n\nCordialement\n\n

PredefinedMailContentSendProposal=Veuillez trouver ci-joint la proposition commerciale __PROPREF__\n\nCordialement\n\n

PredefinedMailContentSendOrder=Veuillez trouver ci-joint la commande __ORDERREF__\n\nCordialement\n\n

PredefinedMailContentSendSupplierOrder=Veuillez trouver ci-joint notre commande __ORDERREF__\n\nCordialement\n\n

PredefinedMailContentSendSupplierInvoice=Veuillez trouver ci-joint la facture __FACREF__\n\nCordialement\n\n

Les messages peuvent être rédiger soit en HTML, soit en texte simple. Si vous optez pour un format texte simple, vous devez écrire \n pour effectuer un retour à la ligne. Si vous préférez un message formater en HTML il vous suffit d’utiliser les balises HTML standard pour formater votre message (
 : retour chariot, mon texte pour le gras etc ...)

Personnaliser les variables

Lorsque l’on regarde les message prédéfinis on voit que le numéro des pièces est remplacer par une variable __FACREF__ __ORDERREF__

Pour l’envoie de mes factures, j’utilise le message suivant :

Messieurs,

Veuillez trouver ci-joint la facture 2011-090

Facture : 2011-090 Date : 27/07/2011 Montant : 85.00 €

Merci de bien vouloir effectuer le règlement par virement bancaire sur le compte dont les coordonnées bancaire figurent au bas de la facture.

Cordialement

Ordi 81

Ordi 81 – 16, rue Portal – 81600 Gaillac – France Tel : 05.81.31.48.00 – 06.47.94.52.38 – Email : contact@ordi81.com Web : www.ordi81.com

Pour arriver à ce résultat de manière automatique, nous allons ajouter les variables __FACDATE__ et __FACTOTALTTC__ Pour cela il nous faut modifier le fichier suivant :

/htdocs/compta/facture.php

faites une recherche de «__FACREF__» dans votre editeur et vous allez trouver la ligne suivante :

// Tableau des substitutions

$formmail->substit['__FACREF__']=$object->ref;

Pour ajouter les variables insérer les 2 lignes suivantes : 


$formmail->substit['__FACDATE__']=date('d/m/Y',$object->date);

$formmail->substit['__FACTOTALTTC__']=number_format($object->total_ttc,2,',',' ');

Vous pouvez maintenant insérer la date et le montant TTC de la facture dans votre message automatique.

Si vous avez besoins d’autre variable pour rédiger votre message, allez faire un tour dans le fichier

htdocs/compta/facture/class/facture.class.php

Vous aurez la liste des variable que vous pourrez utiliser avec l’objet $object Par exemple pour la date limite de règlement vos trouverez dans ce fichier la ligne suivante : var $date_lim_reglement; Pour l’utiliser ajouter dans votre tableau des substitutions

$formmail->substit['__FACDATELIMREG__']=date('d/m/Y',$object->date_lim_reglement);

Variables de substitution disponibles dans les emails

__USER_SIGNATURE__ -> __USER_SIGNATURE__ __USER_ID__ -> 1 __USER_LOGIN__ -> doli9 __USER_LASTNAME__ -> SuperAdmin __USER_FIRSTNAME__ -> __USER_FIRSTNAME__ __USER_FULLNAME__ -> SuperAdmin __USER_SUPERVISOR_ID__ -> __USER_SUPERVISOR_ID__ __USER_REMOTE_IP__ -> 62.210.73.237 __MYCOMPANY_NAME__ -> doli9 __MYCOMPANY_EMAIL__ -> __MYCOMPANY_EMAIL__ __MYCOMPANY_PROFID1__ -> __MYCOMPANY_PROFID1__ __MYCOMPANY_PROFID2__ -> __MYCOMPANY_PROFID2__ __MYCOMPANY_PROFID3__ -> __MYCOMPANY_PROFID3__ __MYCOMPANY_PROFID4__ -> __MYCOMPANY_PROFID4__ __MYCOMPANY_PROFID5__ -> __MYCOMPANY_PROFID5__ __MYCOMPANY_PROFID6__ -> __MYCOMPANY_PROFID6__ __MYCOMPANY_CAPITAL__ -> __MYCOMPANY_CAPITAL__ __MYCOMPANY_FULLADDRESS__ -> France __MYCOMPANY_ADDRESS__ -> __MYCOMPANY_ADDRESS__ __MYCOMPANY_ZIP__ -> __MYCOMPANY_ZIP__ __MYCOMPANY_TOWN__ -> __MYCOMPANY_TOWN__ __MYCOMPANY_COUNTRY__ -> France __MYCOMPANY_COUNTRY_ID__ -> 1 __MYCOMPANY_CURRENCY_CODE__ -> EUR __ID__ -> __ID__ __REF__ -> __REF__ __REF_CLIENT__ -> __REF_CLIENT__ __REF_SUPPLIER__ -> __REF_SUPPLIER__ __EXTRAFIELD_XXX__ -> __EXTRAFIELD_XXX__ __THIRDPARTY_ID__ -> __THIRDPARTY_ID__ __THIRDPARTY_NAME__ -> __THIRDPARTY_NAME__ __THIRDPARTY_NAME_ALIAS__ -> __THIRDPARTY_NAME_ALIAS__ __THIRDPARTY_EMAIL__ -> __THIRDPARTY_EMAIL__ __PROJECT_ID__ -> __PROJECT_ID__ __PROJECT_REF__ -> __PROJECT_REF__ __PROJECT_NAME__ -> __PROJECT_NAME__ __CONTRACT_HIGHEST_PLANNED_START_DATE__ -> Highest date planned for a service start __CONTRACT_HIGHEST_PLANNED_START_DATETIME__ -> Highest date and hour planned for service start __CONTRACT_LOWEST_EXPIRATION_DATE__ -> Lowest data for planned expiration of service __CONTRACT_LOWEST_EXPIRATION_DATETIME__ -> Lowest date and hour for planned expiration of service __ONLINE_PAYMENT_URL__ -> UrlToPayOnlineIfApplicable __ONLINE_PAYMENT_TEXT_AND_URL__ -> TextAndUrlToPayOnlineIfApplicable __SECUREKEYPAYMENT__ -> Security key (if key is not unique per record) __SECUREKEYPAYMENT_MEMBER__ -> Security key for payment on a member subscription (one key per member) __SECUREKEYPAYMENT_ORDER__ -> Security key for payment on an order __SECUREKEYPAYMENT_INVOICE__ -> Security key for payment on an invoice __SECUREKEYPAYMENT_CONTRACTLINE__ -> Security key for payment on a a service __DIRECTDOWNLOAD_URL_PROPOSAL__ -> Direct download url of a proposal __DIRECTDOWNLOAD_URL_ORDER__ -> Direct download url of an order __DIRECTDOWNLOAD_URL_INVOICE__ -> Direct download url of an invoice __SHIPPINGTRACKNUM__ -> Shipping tacking number __SHIPPINGTRACKNUMURL__ -> Shipping tracking url __DATE_YMD__ -> __DATE_YMD__ __DATE_DUE_YMD__ -> __DATE_DUE_YMD__ __AMOUNT__ -> __AMOUNT__ __AMOUNT_EXCL_TAX__ -> __AMOUNT_EXCL_TAX__ __AMOUNT_VAT__ -> __AMOUNT_VAT__ __AMOUNT_FORMATED__ -> __AMOUNT_FORMATED__ __AMOUNT_EXCL_TAX_FORMATED__ -> __AMOUNT_EXCL_TAX_FORMATED__ __AMOUNT_VAT_FORMATED__ -> __AMOUNT_VAT_FORMATED__ __DAY__ -> 12 __DAY_TEXT__ -> Mardi __DAY_TEXT_SHORT__ -> Ma __DAY_TEXT_MIN__ -> M __MONTH__ -> 3 __MONTH_TEXT__ -> Mars __MONTH_TEXT_SHORT__ -> Mars __MONTH_TEXT_MIN__ -> M __YEAR__ -> 2019 __PREVIOUS_DAY__ -> 11 __PREVIOUS_MONTH__ -> 2 __PREVIOUS_YEAR__ -> 2018 __NEXT_DAY__ -> 13 __NEXT_MONTH__ -> 4 __NEXT_YEAR__ -> 2020 __DOL_MAIN_URL_ROOT__ -> http://mondolibarr/htdocs __(AnyTranslationKey)__ -> Translation __[AnyConstantKey]__ -> Valeur de constante