J5.x

Gestion de la mise en page des templates d'e-mails

From Joomla! Documentation

This page is a translated version of the page J5.x:Managing Mail Template Layout and the translation is 100% complete.
Other languages:
English • ‎français
Joomla! 
≥ 5.2

Introduction

La fonctionnalité de mise en page des templates d'e-mails, introduite dans Joomla 5.2, offre de nouvelles capacités pour la gestion des modèles d'e-mails en permettant la personnalisation des mises en page de ces modèles. Cette fonctionnalité prend en charge la création d'une enveloppe parente autour des modèles d'e-mails existants et introduit des mises en page d'e-mails responsives, facilitant ainsi la gestion de la présentation des e-mails envoyés.

Nouvelles fonctionnalités

  • Un nouveau fichier de mise en page d'e-mail par défaut responsive, mailtemplate.php, qui affiche le contenu des e-mails avec le nom du site dans le pied de page et un logo optionnel.
  • Un nouveau champ de formulaire, MailtemplateLayoutField, qui liste les mises en page des modèles d'e-mails disponibles (surcharges) depuis les templates frontend.
  • Mises à jour de la classe MailTemplate pour gérer les données de mise en page et rendre le contenu des e-mails en utilisant la mise en page spécifiée.
  • Options de configuration globale pour activer ou désactiver la mise en page HTML et sélectionner une mise en page de modèle d'e-mail.
  • Options de configuration spécifiques aux templates pour désactiver la mise en page HTML et sélectionner une mise en page de modèle d'e-mail pour chaque template individuellement.
  • Ajustements du modèle de template pour retirer les champs de mise en page HTML lorsque le style d'e-mail est défini en texte brut.

Instructions

Pour configurer et tester la fonctionnalité de mise en page des templates d'e-mails, suivez ces étapes :

  1. Allez dans Configuration Globale -> Modèles d'e-mails.
  2. Réglez Format de l'e-mail sur HTML.
  3. Ajustez la configuration des modèles d'e-mails globaux selon vos besoins.
J5x-mail html enable-en.png

Gestion des surcharges des modèles d'e-mails

Cette fonctionnalité vous permet également de créer des surcharges des modèles d'e-mails au sein de vos templates. En créant des surcharges, vous pouvez personnaliser vos modèles d'e-mails sans risquer de perdre vos modifications lors des futures mises à jour de Joomla.

Pour créer une surcharge de modèle d'e-mail dans un template personnalisé :

  1. Allez dans Système -> Templates de site -> Ouvrez votre template (par exemple, Cassiopeia).
  2. Dans l'onglet Créer des surcharges, sélectionnez joomla -> mail.
  3. Joomla copiera le fichier `mailtemplate.php` dans le répertoire `/html/layouts/joomla/mail/` de votre template, où vous pourrez le modifier selon vos besoins.

Une fois la surcharge créée, vous pouvez ajuster la mise en page et les styles de vos e-mails sans affecter le template de base.

Tests et configuration

  1. Assurez-vous que les paramètres globaux des modèles d'e-mails sont configurés dans la Configuration Globale selon vos besoins.
  2. Si les paramètres spécifiques aux templates sont activés, allez dans Système -> Modèles d'e-mails et configurez les options supplémentaires disponibles.
  3. Envoyez un e-mail de test pour vérifier que les paramètres globaux ou spécifiques aux templates sont correctement appliqués.

Remarque sur l'origine de la fonctionnalité

Cette fonctionnalité a été ajoutée dans Joomla 5.2 via l'amélioration introduite dans le PR #43829.