Cette page ne doit être appliquée que si le script de migration assistée vous demande de passer la migration manuelle code.20230726.templatemail

Ametys fournit maintenant un template de mail HTML pour tous les mails envoyés par l'application Ametys.

Le template de mail est notamment composé du logo Ametys en entête et pied de page du corps du mail, et la couleur primaire utilisée est le violet ametys.

Personnalisation du template de mail

Vous pouvez surcharger le template de mail pour modifier le logo / police / couleur.
Pour cela suivez le manuel Personnalisation du template de mail (v4.8.0+)

Migration des mails envoyés par l'application projet

Si votre application envoie ses propres mails, vous pouvez les migrer sur le nouveau template.

Recherchez "SendMailHelper.newMail()" dans les sources JAVA de votre projet pour détecter tous les envois de mails spécifiques à votre projet.

Pour la construction du "body" des mails envoyés, vous pouvez maintenant utiliser le helper org.ametys.core.ui.mail.StandardMailBodyHelper comme décrit sur la page Construction de mail html

Attention il s'agit alors de mails au format HTML et non texte. Vous devez transmettre le résultat du StandardMailBodyHelper à la méthode #withHTMLBody du SendMailHelper et non #withTextBody.

Mails envoyés par le workflow

Si votre application contient des workflow spécifiques ou surchargés utilisant la fonction org.ametys.cms.workflow.SendMailFunction ou org.ametys.web.workflow.SendMailFunction avec vos propres clés i18n, vous devez revoir les clés i18n utilisées pour les migrer au format HTML.

Par exemple la clé WORKFLOW_MAIL_BODY_ACTION_PROPOSE (utilisé par défaut lors de l'action "Proposer" sur un contenu) a été modifié de la manière suivante:

avant

<message key="WORKFLOW_MAIL_BODY_ACTION_PROPOSE">L'utilisateur {0} a proposé pour validation le contenu "{1}". Le contenu est en attente de validation.&#13;&#13;Pour vous rendre sur le contenu et le valider cliquez sur le lien ci-après {2}.</message>

après

<message key="WORKFLOW_MAIL_BODY_ACTION_PROPOSE">L'utilisateur &lt;strong&gt;{0}&lt;/strong&gt; a proposé pour validation le contenu &lt;strong&gt;"{1}"&lt;/strong&gt;. Le contenu est en attente de validation.&lt;br/&gt;&lt;br/&gt;Pour vous rendre sur le contenu et le valider cliquez sur le lien ci-après &lt;a href="{2}"&gt;{2}&lt;/a&gt;.</message>

Rechercher SendMailFunction dans vos fichiers de workflow et modifier vos clés sur le même principe.

Retour en haut