Aller au contenu

Module v1.0.0

Configurer E-mails

Tout ce que votre site envoie, au même endroit : les e-mails automatiques et leurs interrupteurs, ce qui a posé problème, l'état de l'envoi et l'apparence commune de vos e-mails.

emails Ce que ce module apporte →

Ce qu'il fait

L'espace unique de tout ce que le site envoie : un tableau de bord (ce qui est parti, ce qui a posé problème, l'état de l'envoi), tous les e-mails automatiques du site avec leur interrupteur, qu'ils partent d'une commande, d'un compte ou d'un formulaire, et les réglages d'envoi : serveur SMTP, boîte de secours, expéditeur, apparence commune des e-mails. La newsletter y ajoute ses campagnes et ses abonnés.

  • Tous les e-mails automatiques du site, en deux familles : liés à une commande ou au compte, et commerciaux
  • Un interrupteur et des destinataires en copie pour chacun
  • Les e-mails refusés affichés, et une boîte de secours qui les reprend
  • Le serveur d'envoi, l'expéditeur et un test en un clic
  • Le logo, la couleur, le mot d'en-tête et la signature communs à vos e-mails

Où le trouver

Les écrans que ce module ajoute à l'administration, une fois activé.

  • E-mails /admin/emails

Ses droits

Ce que chaque rôle peut faire par défaut. Modifiable rôle par rôle depuis l'administration.

Droit Clé Administrateur Éditeur
Voir l'espace E-mails emails.read ✓ ✓
Régler les e-mails (envoi, interrupteurs, apparence) emails.write ✓ —

Ses satellites

Des modules qui se greffent sur celui-ci et s'activent séparément. Chacun a sa page.

  • Newsletter Abonnés en double opt-in (e-mail de confirmation) et désinscription RGPD toujours possible, avec un lien dans chaque e-mail.

Ce qu'il suppose

Le désactiver arrêterait aussi :

Piloter par une IA

Ce module ne se pilote pas par une IA.

Des réglages d'envoi (serveur, secours, interrupteurs) qui se font à l'écran ; la newsletter, elle, a ses propres actions pilotables.

Ses points de branchement

Pour greffer du code sans toucher au module : ce qu'il annonce, et ce qu'il écoute.

Ce qu'il annonce 9
emails.onglets
Filter — les onglets de l'espace E-mails. Args: [array $onglets] ; clé => ['label' => string, 'url' => string, 'ordre' => int, 'compte' => ?int]. La newsletter y ajoute Campagnes (30) et Abonnés (40) ; le socle tient Tableau de bord (10), Automatiques (20) et Réglages d'envoi (90).
emails.reglages.sections
Event — rendu HTML direct dans E-mails › Réglages d'envoi, sous le SMTP de secours (écho). Args: [array $user]. Un module qui envoie EN NOMBRE (la newsletter) y règle son propre relais et son plafond par jour. Remplace `settings.emails.relais`.
emails.hotes_envoi
Filter — les serveurs qui envoient au nom du domaine de l'expéditeur, pour la vérification du SPF (tableau de bord). Args: [array $hotes] ; liste de noms d'hôte, celui du SMTP du site en premier. La newsletter y ajoute le relais des campagnes.
emails.a_regarder
Filter — les lignes « À regarder » du tableau de bord de l'espace E-mails. Args: [array $lignes] ; liste de ['niveau' => 'warn'|'ko', 'texte' => string traduit, 'url' => ?string, 'bouton' => ?string]. La newsletter y signale les adresses en erreur.
emails.automatiques.gestes
Filter — les liens d'une ligne d'E-mails › Automatiques. Args: [array $gestes, string $cle, array $def] ; liste de ['label' => string traduit, 'url' => string]. La newsletter y pose « Mise en page », vers l'éditeur de la mise en page propre à cet e-mail.
emails.tableau
Filter — les cartes du tableau de bord de l'espace E-mails. Args: [array $cartes] ; liste de ['zone' => 'principale'|'cote', 'ordre' => int, 'html' => string]. La newsletter y pose ses dernières campagnes.
emails.catalogue
Filter — LE catalogue des e-mails automatiques du site (E-mails › Automatiques). Args: [array $catalogue] ; clé => [label, desc, audience (customer|merchant|superadmin), default (bool), locked (bool)?, famille ('commercial')?, note (HTML traduit)?]. Chaque module y ajoute LES SIENS et les envoie par `Notifications::envoyer($cle, …)` (ou la clé passée à `Thread::notify`, `Mailer::notifyNewLead`). Une clé ABSENTE du catalogue envoie toujours.
emails.opposition
Filter bool — cette adresse s'est-elle opposée aux e-mails commerciaux ? Args: [bool $oppose, string $email]. Lu avant tout e-mail de la famille « commercial » : vrai = il ne part pas. La newsletter répond pour une adresse désinscrite. Zéro écouteur = personne ne s'est opposé.
emails.mise_en_page
Filter ?string — LA MISE EN PAGE PROPRE à un e-mail automatique, à la place de l'automatique. Args: [?string $html, string $cle, string $corps] ; `$corps` est l'e-mail habillé par `Mailer::wrap`, dont `Mailer::corpsDe()` rend ce qu'a écrit le module. Rendre le HTML complet, ou laisser null : la mise en page automatique part. La newsletter répond avec celle composée dans son éditeur.