Zum Inhalt springen

Branding von Formular-E-Mails

Markenspezifische HTML- und Nur-Text-E-Mails für EXT:form-Finisher EmailToReceiver sowie EmailToSender: Website-Farben, optionales Logo, rechtliche Fußzeile und übermittelbare Absenderadressen.

MP-Core Logo

Voraussetzungen: TYPO3 13.4 oder 14.3, typo3/cms-form, Site-Set mpc/mp-core-form, Symfony Mailer in config/system/settings.php.

Übersicht

ThemaVerhalten
Mitarbeiter-E-MailVorlage ContactReceiver, Layout MpcoreFormEmail
BesucherbestätigungVorlage ContactSender (Finisher zu Kontaktformularen hinzufügen)
Reihenfolge der FinisherEmailToReceiver → EmailToSender → Redirect (empfohlen)
AbsenderadresseSite-form.email.senderEmail / form.email.senderName – nicht der Besucher (SPF/DMARC)
Antwort-an (Mitarbeiter-E-Mail)Besucherfeld im Formular-YAML, z. B. replyToRecipients: '{email-1}': '{text-1} {name}'
Branding-EinbindungBrandedEmailFinisher (erweitert den Kern EmailFinisher) führt die Zusammenführung variables.emailBrand vor dem Versand
LogoSpezielle Einstellungsform.email.logo (t3://file?uid=…); kein Fallback auf Header-Logos

Einstellungsschlüssel und Standardwerte der Website: Konfiguration (Abschnitt Formular (mpc/mp-core-form)).

Laufzeitablauf

  1. Der Formular-Prototyp BaseSetup.yaml legt Folgendes fest implementationClassName: Mpc\MpCore\Domain\Finishers\BrandedEmailFinisher auf EmailToReceiver und EmailToSender.
  2. BrandedEmailFinisher ermittelt die aktuelle Website aus der Formularanfrage.
  3. Der FormEmailBrandingBuilder erstellt das emailBrand Array (Logo-URL, Startseite, Farben, Fußzeile als HTML/Text).
  4. Der Kern-EmailFinisher versendet FluidEmail unter Verwendung der templateName und die mitgelieferten Layouts/Vorlagen.

PHP-Klassen

KlasseRolle
Mpc\MpCore\Domain\Finishers\BrandedEmailFinisherFügt emailBrand in die Finisher-Optionen
Mpc\MpCore\Service\FormEmailBrandingBuilderErstellt das Branding anhand der Website-Einstellungen
Mpc\MpCore\Service\SiteLogoResolverLöst t3://file?uid=… zu einer öffentlichen URL

Die Finisher-DI wird registriert, Configuration/Services.php beim Laden von EXT:form.

Website-Einstellungen (form.email.*)

Konfigurieren Sie dies unter Site-Verwaltung → MPCoreForm oder config/sites/<site>/settings.yaml:

 
form.email.senderEmail: noreply@example.com
form.email.senderName: 'Website Contact example.com'
form.email.replyToEmail: mail@example.com
form.email.logo: 't3://file?uid=1234'
form.email.logoAlt: 'Company logo'
form.email.headerColor: ''   # empty = site color-primary
form.email.footerColor: ''   # empty = site color-secondary
form.email.footerText: ''    # empty = copyright + Imprint/Privacy from site / mpcConsent.*
 

Laden Sie das E-Mail-Logo in fileadmin hoch und verweisen Sie auf dessen FAL-UID. Ist form.email.logo leer, wird kein Logo in der E-Mail-Kopfzeile angezeigt.

Als Fallback für den rechtlichen Fußbereich werden copyrightTextsowie mpcConsent.imprintPage und mpcConsent.privacyPolicyPage, wenn form.email.footerText leer ist. Benutzerdefinierter HTML-Fußtext wird im Layout bereinigt; bei reinem Text werden footerTextPlain.

Formulardefinitionen (pro Formular)

Im Formular-Modul oder in der exportierten YAML-Datei (z. B. fileadmin/form_definitions/):

EmailToReceiver

  • templateName: ContactReceiver
  • senderAddress / senderName: Website-Adressen (müssen mit form.email.* oder Literale)
  • replyToRecipients: Besucherzuordnung (Feldbezeichner anpassen)
  • recipients: Mitarbeiter-Posteingang
  • addHtmlPart: true (empfohlen)
  • message: HTML-Einleitung; {formValues} bei Bedarf

EmailToSender

  • templateName: ContactSender
  • recipients: Besucherzuordnung
  • senderAddress / senderName: Website (nicht Besucher)
  • addHtmlPart: true
  • Lokalisiertes Thema und Titel

Beispiele für Persistenz-IDs auf mpcore: kontakt_1 (DE), contact_1 (EN).

Erweiterungs-Assets (nicht in den Dateiverwalter kopieren)

PfadZweck
Resources/Extensions/form/Yaml/BaseSetup.yamlPrototyp + BrandedEmailFinisher
Resources/Extensions/form/Frontend/Layouts/MpcoreFormEmail.fluid.*HTML/einfache Shell
Resources/Extensions/form/Frontend/Templates/Finishers/Email/ContactReceiver.fluid.*Mitarbeitertext
Resources/Extensions/form/Frontend/Templates/Finishers/Email/ContactSender.fluid.*Besucherbestätigung
Resources/Extensions/form/Frontend/Partials/Finishers/Email/ContactFormValues.fluid.*Wertetabelle (umgeht Honeypot/Spam-Rauschen)
Configuration/Sets/mp-core-form/Standardwerte der Website und Editorfelder

Benutzerdefinierte Vorlagen: templateName im Finisher, fügen Sie „Fluid“ unter dem Prototyp hinzu templateRootPaths, Layout MpcoreFormEmail verwenden.

emailBrand Fluid-Variablen

VariableQuelle
emailBrand.logoUrlform.email.logo
emailBrand.logoAltform.email.logoAlt
emailBrand.homeUrlSprache der Startseite
emailBrand.headerBackgroundColorform.email.headerColor oder color-primary
emailBrand.footerBackgroundColorform.email.footerColor oder color-secondary
emailBrand.linkColorcolor-tertiary (Ausweichlösung #1f5aad)
emailBrand.footerTextBenutzerdefinierte oder automatische HTML-Fußzeile
emailBrand.footerTextPlainEinfache Fußzeile für .fluid.txt

Verifizierung

  1. Absenden von Kontaktformularen auf der öffentlichen Website (E-Mails an Mitarbeiter und Besucher).
  2. E-Mails an Mitarbeiter: Branding, Wertetabelle, Reply-To = Besucher.
  3. E-Mail an Besucher: Bestätigung, Absender = „noreply“ der Website.
  4. HTML- und Textteile im E-Mail-Client überprüfen.
  5. Optional: composer test:unit — FormEmailBrandingBuilderTest.

Fehlerbehebung

SymptomMögliche Ursache
Fehler 500 bei „Zusammenfassung“/„Absenden“Aktualisieren Sie mp-core auf ≥ 1.3.5, typo3 cache:flush
Kein LogoLeer oder ungültig form.email.logo
Core orange / Default VorlageFalsch templateName oder veralteter Cache
Antwort geht an falsche AdresseFehlender replyToRecipients zuständiger Mitarbeiter
Unbearbeitet in einfacher E-MailAktuelle ContactFormValues.fluid.txt aus der Erweiterung

Die Benutzeroberfläche für die Zusammenfassung mehrstufiger Formulare und die Überschriften der Feldgruppen (Seite + E-Mail) wurden ab Version 1.3.4 geändert. Siehe CHANGELOG [1.3.4] / [1.3.5] sowie im Backend (Formular-YAML / Feldgruppe-Inspektor).

Seite teilen