[tuto] Creation de template pour les emails

Afin de faciliter l’utilisation , la traduction et la gestion des emails envoyés par la boutique, dans la version oscss-Rv, une centralisation complète des emails à été effectué.

Généralité

La totalité des emails, de leurs mise en formes et de leurs contenus ce trouve dans modules/template_email

Il sont stocké dans des fichiers en .tpl, et utilise la class class.template pour leurs traitements.Cette class permet de faire disparaître toute trace de php dans les emails.

Utilisation

La class de template autorise encore la prise en  charge de clause , aussi , les templates d’email contiennent leurs codes pour les mails au format html et au format texte

ex

{if $myarray.email_use_html}
{include « header.inc »}
<div id= »content »>
<p>{$lg.ADMIN_EMAIL_TEXT_BONOUR} : {$myarray.admin_firstname}</p>
<br />
<p>{$lg.ADMIN_EMAIL_TEXT} </p>
<br />
<a href= »{$myarray.links} »>{$lg.ADMIN_EMAIL_TEXT_WWW}</a>
<br />
<br />
<p>{$lg.ADMIN_EMAIL_TEXT_LOGIN} : {$myarray.admin_firstname}</p>
<p>{$lg.ADMIN_EMAIL_TEXT_MDP} : {$myarray.hiddenPassword}</p>
<p>{$lg.ADMIN_EMAIL_TEXT_EMAIL} : {$myarray.admin_email_address}</p>
{$TPL_CONTENT}
</div>
{include « footer.inc »}

{else}

{$lg.STORE_NAME}

{$lg.EMAIL_SEPARATOR}
{$lg.ADMIN_EMAIL_TEXT_BONOUR} : {$myarray.admin_firstname}

{$lg.ADMIN_EMAIL_TEXT}

{$lg.ADMIN_EMAIL_TEXT_WWW} : {$myarray.links}

{$lg.ADMIN_EMAIL_TEXT_LOGIN} : {$myarray.admin_firstname}
{$lg.ADMIN_EMAIL_TEXT_MDP} : {$myarray.hiddenPassword}
{$lg.ADMIN_EMAIL_TEXT_EMAIL} : {$myarray.admin_email_address}
{$TPL_CONTENT}
{$lg.EMAIL_SEPARATOR}

{/if}

Vous remarquerez que la partie header et footer des emails sont centralisées dans leurs version html, en un header.inc et footer.inc

cf:

{include « header.inc »}

Vous pouvez  ainsi intégrer tout élement répétitif.

Si vous nommez votre fichier à inclure en « .tpl », alors celui ci sera listé dans la liste de choix des gabarits, lors de l’envoi d’email

Les constantes et variables php accessibles dans les template, doivent avoir étés préalablement chargées dans le constructeur. Sous cette forme, vous aurez accès aux éléments du fichier de langue, par exemple.

$lg.ADMIN_EMAIL_TEXT_BONJOUR, renverra le contenu de ADMIN_EMAIL_TEXT_BONJOUR

Les variables

Comme nous l’avons vu précédement les variables doivent être chargées  avant leurs appels dans le constructeur. A cette fin les fichiers de langues sont systématiquement inclus dans la variable $lg, Pour les variables autres, il est possible d’utiliser n’importe quel nom, cependant pour faciliter l’utilisation. Toutes les éléments ponctuel sont chargée dans la variable $myarray.  Il suffit pour appeler le contenu de la variable, d’utiliser le code suivant

{$myarray.admin_email_address}

Ce code permet de renvoyer la valeur admin_email_address, palcé dans le tableau myarray, avec pour clef admin_email_address.

Tags : ,

Les commentaires sont fermés.