Personnalisation des mails de notification Ametys Workspaces (version 2.10.x ou inférieure)


Ametys Workspaces fournit un template de mail pour les notifications espaces projets.

Ce template peut être surchargé dans votre charte afin de personnaliser le logo, les couleurs, la police, ...

Le format des mails étant très sensibles, il est vivement recommandé de ne pas chercher à personnaliser autre chose que le logo, couleur et police.

Mise en place

Référez-vous à la mise en place de la charte (voir Personnalisation de la charte Ametys Workspaces).

Le zip fournit comprend un exemple de surcharge pour les mails de notifications.

Personnalisation des mails

La suite de ce document fait référence à la charte "myskin" fournit en exemple.
Terme qu'il faut remplacer par le nom que vous aurez donné à votre charte.

Personnalisation des couleurs / police

Les couleurs et police utilisées sont définies au travers de variables XSL.
Ajoutez dans votre charte un fichier skins/myskin/stylesheets/mail/component/variables.xsl dans lequel vous redéfinirez les variables nécessaires comme suit:

<xsl:stylesheet version="1.0" xmlns="http://www.w3.org/1999/xhtml" 
                              xmlns:ametys="org.ametys.web.transformation.xslt.AmetysXSLTHelper"
                              xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

    <xsl:import href="plugin:workspaces://stylesheets/mail/component/variables.xsl"/>
    
    <xsl:variable name="primary">#e8590c</xsl:variable>
    <xsl:variable name="text-default">#313131</xsl:variable>
    <xsl:variable name="text-light">#7F8182</xsl:variable>
    <xsl:variable name="text-contrast">#FFFFFF</xsl:variable>

<xsl:variable name="border-primary">#e8590c</xsl:variable>
    <xsl:variable name="border-highlight">#C1C1C1</xsl:variable>
    
</xsl:stylesheet>

La liste des variables disponibles (et donc surchargeables) est disponibles dans le fichier stylesheets/mail/component/variables.xsl du plugin "workspaces".

Personnalisation du logo

Le logo est présent dans l'entête et le pied page des mails.

Pour utiliser votre propre logo, vous devez surcharger les templates "header-logo-img" et "footer-logo-img".

Déposez votre logo au format PNG dans un répertoire de ressources de votre charte (ex: templates/common/img/logo-mail.png).
Les dimensions du logo initial est de 56x113 pixel.

Créez le fichier skins/myskin/stylesheets/mail/component/header.xsl dans votre skin. Il doit contenir votre surcharge comme dans l'exemple ci-dessous:

<xsl:stylesheet version="1.0" xmlns="http://www.w3.org/1999/xhtml"
                              xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                              xmlns:ametys="org.ametys.web.transformation.xslt.AmetysXSLTHelper">
                              
<xsl:import href="plugin:workspaces://stylesheets/mail/component/header.xsl"/>
    
  <xsl:template name="header-logo-img">
      <img width="164" height="37" src="{ametys:skinURL('templates/common/img/logo-mail.png'}" alt="My company" />
  </xsl:template>
</xsl:stylesheet>

Pensez à personnaliser l'alternative "alt".

Faites de même avec le fichier skins/myskin/stylesheets/mail/component/footer.xsl

<xsl:stylesheet version="1.0" xmlns="http://www.w3.org/1999/xhtml"
                              xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                              xmlns:ametys="org.ametys.web.transformation.xslt.AmetysXSLTHelper">
                              
  <xsl:import href="plugin:workspaces://stylesheets/mail/component/footer.xsl"/>
    
  <xsl:template name="footer-logo-img">
      <img width="164" height="37" alt="My company" src="{ametys:skinURL('templates/common/img/logo-mail.png')}"/>
  </xsl:template>
    
</xsl:stylesheet>
Retour en haut