Accueil > Documentation > Les balises XPX > MAIL

MAIL

Le xpx permet également d’envoyer des mails avec un contenu dynamique et adapté à chaque contact.

<mail from="sender" to="receiver" [msg="..." | file="..."]>

Pour envoyer un e-mail, il faut préciser au minimum ces 3 arguments.

FROM = adresse e-mail de l'expéditeur

TO = adresse e-mail du ou des destinataires séparées par des virgules ou des points virgules

Les adresses email peuvent être de la forme "x@domain.ext" ou "nom <x@domain.ext>"

Le contenu du mail est spécifié dans l'attribut MSG ou FILE.

MSG = texte à envoyer

FILE = nom du fichier qui contient le texte à envoyer. Dans ce fichier, vous pouvez utiliser les balises XPX pour créer un contenu dynamique

NB :

Depuis la version 3.8-rc19, les adresses, si elles contiennent des caractères non ASCII sont encodées automatiquement selon la RFC 2047.

Exemple:

ATÉLIS <atelis@infocosme.com>

Sera encodé de manière transparent en :

=?iso-8859-1?Q?AT=C9LIS=? <atelis@infocosme.com>

Attention : pour que cela fonctionne, l'adresse entre <...> doit bien être séparée du texte précédent par un espace.

<mail from="contact@xpx-technologies.com" to="$mail$, another <$mail2$>" subject="Test" type="text" msg="Un mail d'exemple.">

<mail subject="..." >

Préciser dans l'attribut subject le sujet du message. Ce n'est pas un champ obligatoire, mais s'il n'est pas complété, le message n'aura pas de sujet.

NB :

Depuis la version 3.8-rc18, le sujet, si il contient des caractères non ASCII est encodé automatiquement selon la RFC 2047.

<mail type="[text | html | multipart]">

Le type permet de préciser le format du contenu du message. Il peut être de type TEXT ou HTML. La valeur par défaut est TEXT.

Nous vous conseillons d'utiliser le type MULTIPART qui permet d'envoyer un message contenant une partie HTML et une partie texte ce qui est recommandée par la norme.

<mail from="expediteur" to="destinataire" subject="sujet" file="/monfichier.xpx" join="/mapiecejointe.pdf" type="multipart">

monfichier.xpx sera interprété 2 fois avec un argument $phcmailpart$ valant sucessivement "text" et "html"

Dans monfichier.xpx:

<cond expr="$phcmailpart$=text">     
 J'envoie du texte
 <else expr="$phcmailpart$=html">
     <html><body>j'envoie du html</body></html>
 </cond>

<mail join="file1 [,file2,...]" >

Préciser dans l'attribut "join", le chemin d'accès du fichier joint au mail. Ce n'est pas un champ obligatoire.

On peut préciser plusieurs fichiers en les séparant par des virgules ou des |.

On peut aussi changer le nom du fichier joint en utilisant le format :

nom <chemin>

où nom est le nom qui apparaîtra dans le mail et chemin, le chemin d'accès au fichier.

<mail from="toto@infocosme.com" to="titi@infocosme.com" subject="Document" type="text" msg="Fichier joint." join="exemple.pdf </Public/doc/sample-1456.pdf>">

<mail cc="receiver copy" cci="receiver invisible copy" reply="reply-to email">

Permet de préciser des destinaires en copie ou copie invisible, ainsi que l'email de réponse.

Les emails peuvent être séparés par des virgules ou des points-virgules.

Le format suivant est aussi accepté : Nom <email>

<mail smtp="[usesendmail | smtp server]">

La balise SMTP permet de préciser l'adresse du serveur SMTP d'envoi. Par exemple: smtp.free.fr, localhost, etc...

La valeur par défaut est "usesendmail" qui signifie d'utiliser le programme "/usr/sbin/sendmail" installé sur le serveur Linux ou Mac OSX. Sous Windows, on ne peut pas utiliser "usesendmail".

La valeur de l'attribut SMTP peut permettre l'authentification, la syntaxe est :

serverName[[:portNum][:protocol]|username,password].

Avec:

serverName : nom du serveur SMTP
portNum : numéro de port à utiliser (25, 465, 587)
protocol : valeur SSL ou STARTTLS (à préciser si un port ésotérique est requis. Par défaut 465 implique SSL et 587 implique STARTTLS)
username : nom de l'utilisateur sur le serveur
password : mot de passe de l'utilisateur

Exemples :

smtp.monserveur.com|glagaffe,monPassw
smtp.gmail.com:465|b.gates,myPassw
smtp.gmail.com:587:STARTTLS|m.zuckerberg,facebook

<mail charset="">

Permet de préciser l'encodage des caractères du mail. Si l'attribut CHARSET n'est pas précisé, la valeur de $phccharset$ sera utilisée et vaut par défaut: iso-8859-1