NOTE : Cette page, et les modules seront amené à changer dans les versions suivante. Ces informations sont valable pour les versions en cours avant le 2.1.5
Les templates utilise un class template, présente dans common .
Cette class, est proche de la class de type smarty, toutefois, prévu pour php4, elle est amené à être remplacé.
Arborescence
- modules/template_email/xxx.tpl gabarit html
- languages/xxx/modules/template_email/xxx.txt fichier de langue correspondant
Utilisation
Fichier de gabarit HTML
Ces fichiers sont, parsé, et ne contiennent aucune référence en php, mais uniquement l’équivalent smarty
D’autre part, les donnée founis, sont passé sous forme de tableau, et accessible dans le gabarit a l’intérieur du tableau myarray, et les éléments de langue dans le tableau lg.
{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}Chaque gabarit doit fournis un gabarit pour des envoi au format html, et l’autre au format texte.
Il est donc necessaire d’intégrer un clause de type :
{if $myarray.email_use_html}
//partie HTML
{else}
Partie TEXT
{/if}Les donnée accessible tableau myarray et lg
Pour accéder au valeur des tableaux, il est necessaire d’utiliser la syntaxe suivante :
L’ensemble des contenu du tableau myarray, sont toute les valeur récupérer dans la page d’exécution, et dont la mise en forme prépare leur utilisation a l’intérieur des emails. Aucun traitement de forme ne doit avoir lieux a ce niveau
Non du fichier de template, convention de nommage Les fichiers sont nommé, avec comme base le nom du fichier php qui l’exploite, ou le nom de l’action qui le représente le mieux. Aussi , coté front, les envoi de commande sont nommé checkout_process, du nom du fichier qui l’exécute, et dans le backoffice, on va trouver admin_members_new, pour l’ajout d’un compte utilisateur au backoffice.