Utilisation de la classe Mailer :
--> Initialisation de la classe : Mailer( [string root] )
ex : $mailer = new Mailer();
Mailer() prend un argument facultatif.
Si vous utilisez un modèle d'email et que celui ci ne se trouve dans le dossier par défaut
(défini dans le fichier mailer.php), vous pouvez indiquer le chemin vers le modèle.
-----------------------------------------------------------------------------
--> configuration des paramètres smtp : set_smtp( string hostname [,int port [,string user [,string pass]]] )
ex : $mailer->set_smtp("smtp.wanadoo.fr", 25);
Si vous voulez utiliser un autre serveur smtp que celui du serveur sur lequel vous vous trouvez,
vous devez indiquer dans ce cas les paramètres de connexions au serveur smtp de votre choix, string user et string pass
pour l'authentification.
Seul string hostname est obligatoire.
port est le port auquel se connecter, la valeur par défaut, 25, suffira la plupart du temps.
Vous pouvez également faire tous ces réglages dans le fichier directement, ce qui vous évitera de faire appel
à chaque fois à la fonction set_smtp().
--> définition de l'expéditeur : set_from( string from [, string from name] )
ex : $mailer->set_from("toto@titi.fr, "toto");
set_from() accepte deux arguments :
from correspond à l'adresse email de l'envoyeur.
Vous pouvez également spécifier from name, dans ce cas, c'est lui qui apparaitra dans le client mail
du destinataire.
-->définition du destinataire : set_to( array to[, string type] )
ex : $mailer->set_to( array("jojo@domaine.com"));
Si vous voulez envoyer le mail à plusieurs personnes :
ex : $mailer->set_to( array("jojo@domaine.com",
"copain@azerty.net"
));
Vous pouvez indiquer comme deuxieme argument cc (carbon copy) ou bcc (blind carbon copy) selon ce que vous désirez.
-->le sujet de l'email : set_subject( string subject )
ex : $mailer->set_subject("exemple de sujet");
--> le message proprement dit : set_message( string message [, array val] )
* Si vous utilisez un modèle d'email :
ex : $mailer->set_message("test.tpl", array('PSEUDO' => 'testeur',
'TEST' => 'ceci est un test'
));
test.tpl :
------------------------
Bonjour %PSEUDO%,
voici le code remplacé par le contenu de la variable qui lui est affectée :
%TEST%
------------------------
le destinataire recevra :
------------------------
Bonjour testeur,
voici le code remplacé par le contenu de la variable qui lui est affectée :
ceci est un test
------------------------
simple n'est ce pas ?
* Si vous n'utilisez pas un modèle.
ex : $mailer->set_message("voici le message que je vous envoie, simple n'est ce pas ?");
-----------------------------------------------------------------------------
Les fonctions facultatives
--> format du message : set_format( string format )
Par défaut, l'email sera envoyé au format texte brut.
Pour envoyer un email au format html, vous devez le spécifier avec set_format()
ex : $mailer->set_format("html");
ou bien $mailer->set_format("htm");
ou encore $mailer->set_format(2);
--> définir la priorité de l'email : set_priority( int priority ) ou set_priority( string priority )
ex : // pour une priorité très haute :
$mailer->set_priority("highest"); ou bien $mailer->set_priority(1);
// pour une priorité haute :
$mailer->set_priority("high"); ou bien $mailer->set_priority(2);
// pour une priorité normale (priorité par défaut si vous n'utilisez pas cette fonction) :
$mailer->set_priority("normal"); ou bien $mailer->set_priority(3);
// pour une priorité basse :
$mailer->set_priority("low"); ou bien $mailer->set_priority(4);
// pour une priorité très basse :
$mailer->set_priority("lowest"); ou bien $mailer->set_priority(5);
La fonction n'est pas case sensitive.
--> attacher des fichiers à l'email (pièces jointes) :
attachment( string path [, string filename [, string disposition [, string mime-type]]] )
Vous pouvez attacher des fichiers à votre email.
ex : $mailer->attachment("../images/fichier1.gif", "paris.gif", "inline", "image/gif");
Le nombre de fichiers et leur poids n'est pas limité (soyez quand même raisonnable), toutefois, il semble que
les emails envoyés à partir de Online soient limités à 100 Ko ! (Lu dans la FAQ de online)
--> confirmation de lecture : set_notify()
ex : $mailer->set_notify();
--> entête d'email : set_header()
Vous pouvez ajouter/modifier un entête de l'email avec cette fonction.
ex : $mailer->set_header("Return-Path", "return@domain.com");
-----------------------------------------------------------------------------
Pour finir, utiliser send()
send() ne prend pas d'argument.
La fonction send() se charge de construire les entêtes de l'email (selon les options que vous aurez choisi),
construit l'email puis l'envoie au(x) destinataire(s) désigné(s).
$mailer->send();
-----------------------------------------------------------------------------
|