Objectifs

Ici, nous allons voir comment envoyer des mails au format texte ou au format HTML, ainsi que la façon d'y adjoindre des pièces jointes.

Envoyer un mail au format texte avec CopixTextEMail

$message = ... // une chaîne de caractères
$spam_texte = new CopixTextEmail($destinataire,
                                 $copie,
                                 $copiecachee,
                                 $sujet,
                                 $message);

Envoyer un mail au format HTML

$destinataire = "admin@copix.org"
$copie = "team@copix.org"
$copiecachee = "uncopain@ailleurs.net"
$sujet = "Je veux la version 4 dans 2 jours"

// on veut l'envoyer au format HTML
$message = ... // une chaîne de caractères au format HTML
$remplacement = ... // une autre chaîne de caractères si le mailer ne supporte pas le HTML

// le paramètre $remplacement est optionnel
$spam_html = new CopixHTMLEmail($destinataire,
                                $copie,
                                $copiecachee,
                                $sujet,
                                $message,
                                $remplacement);

Ajouter des pièces jointes

Maintenant que le courriel est fait, nous pouvons avoir besoin de pièces jointes. Pour cela, il existe la méthode addAttachment. Cette méthode prend les données, un nom de fichier, le type mime et un encodage.

// on veut envoyer des données brutes. Par défaut, addAttachement donne un nom de fichier vide, un type mime application/octet-stream et un encodage base64.
$spam_texte->addAttachement($données);

// si par contre, on veut envoyer une image
$nomFichier='toto.gif';
$mimeType = 'image/gif';
$encoding = 'base64';
$spam_texte->addAttachement($image, $nomFichier, $mimeType, $encoding);

Envoi du message proprement dit

$spam_texte->send ();

Si vous voulez envoyer le message à d'autres expéditeurs que ceux annoncés au départ lors de la création de CopixHTMLEmail ou CopixTextEMail, vous pouvez les spécifier lors de l'envoi

$spam_texte->send('le patron', // le nom de l'expéditeur
                  'jamaiscontent@direction.copix.org' // son adresse
);

Configuration de Copix Mail

Copix va récupérer les informations dont il a besoin dans le module default. Ce dernier contient dans son répertoire resources un fichier nommé parameter.properties. Ainsi, si dans la méthode send, expliquée plus haut, vous ne donnez pas le nom de l'expéditeur et/ou son adresse ne sont pas précisés, Copix va aller chercher les chercher dans ce fichier.

parameter.mailEnabled

Indique à Copix si l'envoi de courriel est autorisé depuis le site. Si il vaut 1, c'est le cas. Toute autre valeur signifie une interdiction d'envoi.

parameter.mailFrom

Indique l'adresse de l'expéditeur du courrier envoyé par l'application. Exemple

parameter.mailFrom = admin@monsite.eu

parameter.mailFromName

Indique le nom de l'expéditeur du courrier envoyé par l'application. Exemple

parameter.mailFromName = Jean Claude Dupont

parameter.mailMethod

Indique la méthode souhaitée pour l'envoi du courriel. Vous avez le choix entre 2 possibilités:

*mail: le courriel est envoyé avec la méthode <a href="http://www.php.net/function.mail">mail</a> de php. *smtp: le courriel est envoyé à travers un serveur smtp. Dans ce cas, il faut préciser aussi le paramètre mailSmtpHost.

parameter.mailSmtpHost

Indique l'adresse du serveur smtp qui servira à l'envoi du courriel si la méthode choisie dans le paramètre mailMethod est smtp.

parameter.mailAlwaysBcc

Indique une adresse email à laquelle sera envoyée une copie de chaque mail envoyé par Copix.