A partir de Ametys 4.8.0
A partir de la version 4.8.0 les mails envoyés par l'application Ametys sont des mails au format HTML composés de divers éléments de présentation, dont voici un exemple:
L'entête et le pied de page ainsi de la police, couleur du texte peuvent être personnalisés au niveau applicatif ou au niveau de la charte graphique.
Pour surcharger un ou plusieurs éléments graphiques des mails, commencez par ajouter un fichier stylesheets/mail/standard/template.xsl :
- soit au niveau applicatif dans le dossier WEB-INF/params/view pour que la surcharge soit appliquée à tous les mails envoyés par l'application
- soit au niveau de la charte graphique dans le dossier skins/[SKIN_NAME] pour que la surcharge soit personnalisée en fonction du site
Ce fichier devra contenir à minima:
- pour une surcharge au niveau applicatif
<xsl:import href="plugin:core-ui://stylesheets/mail/standard/template.xsl"/>
- pour une surcharge au niveau d'une charte
<xsl:import href="plugin:web://stylesheets/mail/standard/template.xsl"/>
- pour une charte étendant la charte des espaces projets (workspaces)
<xsl:import href="skin:workspace://stylesheets/mail/standard/template.xsl"/>
Le fichier contiendra ensuite les éléments surchargés.
NOTE
Si votre charte est une déclinaison d'une charte Ametys Intranet ou Ametys Workspace, toute surcharge pour la personnalisation des mails doit nécessairement être faite dans la charte et non dans WEB-INF/params/view . En effet les chartes Ametys Intranet et Ametys Workspaces ayant déjà leur propre surcharge, c'est celle-ci qui sera toujours préférée à WEB-INF/params.
Pensez à importer le template de mail de la charte déclinée plutôt que celui du plugin web, par exemple <xsl:import href="skin:intranet://stylesheets/mail/standard/template.xsl"/>
Mail envoyés par l'application site
L'application front-office envoie peu de mails mais cela peut arriver, notamment si l'authentification multifacteur est activée.
Pensez également à personnaliser le template de mail pour l'application site, au niveau applicatif du coup, c'est à dire WEB-INF/params/view.
Les mails envoyés par l'application site ne peuvent pas tenir compte de la charte graphique.
Vous trouverez un exemple de surcharge spécifique pour une application site dans le paragraphe "Exemple de surcharge"
Surcharge du logo d'entête
Pour surcharger le logo d'entête, le template "header-logo-img" doit être surchargé.
Par exemple:
<xsl:template name="header-logo-img">
<img width="164" height="37" src="{ametys:skinImageBase64('img/mail/logo-mail.png')}" alt="My company"/>
</xsl:template>Attention !
L'image doit être résolue en base64 avec ametys:skinImageBase64(String path) ou pluginImageBase64(String plugin, String path)
Surcharge du logo du pied de page
Pour surcharger le logo du pied de page, le template "footer-logo-img" doit être surchargé.
Par exemple:
<xsl:template name="footer-logo-img">
<img width="164" height="37" src="{ametys:skinImageBase64('img/mail/logo-mail.png')}" alt="My company"/>
</xsl:template>Attention !
L'image doit être résolue en base64 avec ametys:skinImageBase64(String path) ou pluginImageBase64(String plugin, String path)
Surcharge des couleurs / polices
Pour surcharger les couleurs et/ou polices utilisées, vous pouvez surcharger les variables de styles définies par défaut dans 01_Runtime\master\main\plugin-core-ui\stylesheets\mail\standard\components\styles.xsl
Par exemple pour simplement changer la police de tous les textes et la couleur primaire:
<xsl:variable name="font-family">Trebuchet MS, Arial, sans-serif</xsl:variable> <xsl:variable name="primary">#e8590c</xsl:variable> <xsl:variable name="primary-light">#fceee6</xsl:variable>
La police utilisée par défaut est "Tahoma".
Si vous souhaitez la changer, prenez garde de choisir une police qui sera supportée par tous les clients mail.
Voici une liste de police pouvant être utilisées dans les mails sans risque : https://www.w3schools.com/cssref/css_websafe_fonts.php
Il est possible d'aller plus loin dans la personnalisation du template de mail.
Cependant le format des mails étant très sensible, il est vivement recommandé de ne pas chercher à personnaliser autre chose que le logo, couleur et police, texte de pied de page.
Exemple de surcharge
Vous pouvez télécharger le fichier mail.zip et le décompressez dans le répertoire racine de votre charte graphique pour débuter votre surcharge.
Pour l'application site vous pouvez télécharger le fichier mail-fo.zip et le décompressez dans le répertoire WEB-INF/param/view de votre application site.
Le ZIP comprends une simple surcharge du template de mail pour le logo et la couleur primaire utilisés.
Modifiez les codes couleur du fichier stylesheets/mail/standard/components/styles.xsl et le fichier resources/img/mail/logo-mail.png.
Pensez également à personnaliser le texte alternatif (alt) du logo.
Ci dessous un rendu des mails HTML avec cette surcharge:
Retour en haut