
Voraussetzungen: TYPO3 13.4 oder 14.3, typo3/cms-form, Site-Set mpc/mp-core-form, Symfony Mailer in config/system/settings.php.
Übersicht
| Thema | Verhalten |
|---|---|
| Mitarbeiter-E-Mail | Vorlage ContactReceiver, Layout MpcoreFormEmail |
| Besucherbestätigung | Vorlage ContactSender (Finisher zu Kontaktformularen hinzufügen) |
| Reihenfolge der Finisher | EmailToReceiver → EmailToSender → Redirect (empfohlen) |
| Absenderadresse | Site-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-Einbindung | BrandedEmailFinisher (erweitert den Kern EmailFinisher) führt die Zusammenführung variables.emailBrand vor dem Versand |
| Logo | Spezielle 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
- Der Formular-Prototyp
BaseSetup.yamllegt Folgendes festimplementationClassName: Mpc\MpCore\Domain\Finishers\BrandedEmailFinisheraufEmailToReceiverundEmailToSender. BrandedEmailFinisherermittelt die aktuelle Website aus der Formularanfrage.- Der
FormEmailBrandingBuildererstellt dasemailBrandArray (Logo-URL, Startseite, Farben, Fußzeile als HTML/Text). - Der Kern-
EmailFinisherversendet FluidEmail unter Verwendung dertemplateNameund die mitgelieferten Layouts/Vorlagen.
PHP-Klassen
| Klasse | Rolle |
|---|---|
Mpc\MpCore\Domain\Finishers\BrandedEmailFinisher | Fügt emailBrand in die Finisher-Optionen |
Mpc\MpCore\Service\FormEmailBrandingBuilder | Erstellt das Branding anhand der Website-Einstellungen |
Mpc\MpCore\Service\SiteLogoResolver | Lö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: ContactReceiversenderAddress/senderName: Website-Adressen (müssen mitform.email.*oder Literale)replyToRecipients: Besucherzuordnung (Feldbezeichner anpassen)recipients: Mitarbeiter-PosteingangaddHtmlPart: true(empfohlen)message: HTML-Einleitung;{formValues}bei Bedarf
EmailToSender
templateName: ContactSenderrecipients: BesucherzuordnungsenderAddress/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)
| Pfad | Zweck |
|---|---|
Resources/Extensions/form/Yaml/BaseSetup.yaml | Prototyp + 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
| Variable | Quelle |
|---|---|
emailBrand.logoUrl | form.email.logo |
emailBrand.logoAlt | form.email.logoAlt |
emailBrand.homeUrl | Sprache der Startseite |
emailBrand.headerBackgroundColor | form.email.headerColor oder color-primary |
emailBrand.footerBackgroundColor | form.email.footerColor oder color-secondary |
emailBrand.linkColor | color-tertiary (Ausweichlösung #1f5aad) |
emailBrand.footerText | Benutzerdefinierte oder automatische HTML-Fußzeile |
emailBrand.footerTextPlain | Einfache Fußzeile für .fluid.txt |
Verifizierung
- Absenden von Kontaktformularen auf der öffentlichen Website (E-Mails an Mitarbeiter und Besucher).
- E-Mails an Mitarbeiter: Branding, Wertetabelle, Reply-To = Besucher.
- E-Mail an Besucher: Bestätigung, Absender = „noreply“ der Website.
- HTML- und Textteile im E-Mail-Client überprüfen.
- Optional:
composer test:unit—FormEmailBrandingBuilderTest.
Fehlerbehebung
| Symptom | Mögliche Ursache |
|---|---|
| Fehler 500 bei „Zusammenfassung“/„Absenden“ | Aktualisieren Sie mp-core auf ≥ 1.3.5, typo3 cache:flush |
| Kein Logo | Leer oder ungültig form.email.logo |
Core orange / Default Vorlage | Falsch templateName oder veralteter Cache |
| Antwort geht an falsche Adresse | Fehlender replyToRecipients zuständiger Mitarbeiter |
Unbearbeitet in einfacher E-Mail | Aktuelle ContactFormValues.fluid.txt aus der Erweiterung |
Verwandte Themen (Frontend, nicht E-Mail-Transport)
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).