Bitte beachte, dass sich diese Dokumentation auf die neuste Version dieser Erweiterung bezieht. Wenn eine ältere Version eingesetzt wird, kann diese abweichen. Die jeweils passende Dokumentation befindet sich im Dokumentation-Verzeichnis der Erweiterung.
Kundennachrichten
Hinweis:
Verfügbar ab Version 5.16.0
Das Kundennachrichten-Feature ermöglicht es, individuelle E-Mail-Nachrichten direkt aus dem TYPO3-Backend an Kunden zu versenden. Innerhalb einer Warenkorbbestellung können Sie eine E-Mail an den Kunden mit einem vordefinierten oder individuellen Betreff und Nachrichtentext verfassen und versenden.
Funktionsweise
Im Backend-Modul für Warenkorbbestellungen bietet jede Bestellung eine Nachricht senden-Aktion. Wenn Sie darauf klicken, öffnet sich ein Formular, in dem Sie:
- Ein Nachrichtentemplate auswählen können – die Felder für Betreff und Nachricht werden automatisch mit dem Template-Inhalt vorbefüllt.
- Betreff und Nachricht bearbeiten können, bevor Sie die E-Mail absenden.
- Die E-Mail versenden an die mit der Bestellung verknüpfte E-Mail-Adresse des Kunden.
Die Nachricht wird mit Fluid gerendert, sodass Sie das {basketOrder}-Objekt verwenden können, um bestellungsbezogene Informationen dynamisch in Ihre Templates einzufügen.
Nachrichtenvorlagen
Nachrichtenvorlagen sind einfache HTML-Dateien, die im Unterordner Email/Message/ der konfigurierten templateRootPaths liegen. Das System sammelt automatisch alle Dateien, die auf Message.html enden, und stellt sie als auswählbare Vorlagen im Backend bereit.
Aufbau der Template-Datei
- Zeile 1: Die Betreffzeile der E-Mail
- Zeile 2 bis Ende: Der Nachrichtentext der E-Mail
Beispiel-Template-Datei (DefaultMessage.html)
Subject: A message from you favorite TYPO3-Shop
Dear {basketOrder.name},
here are some information about your order in our shop.
Our internal order number: ###UID###
Your order/invoice number: ###INVOICE_NUMBER###
Your postal-code: ###POSTAL_CODE###
Your tracking-number: ###TRACKING_NUMBER###
Best regards
your Shopping teamVerfügbare Platzhalter
Die folgenden Platzhalter werden durch tatsächliche Bestelldaten ersetzt:
| Platzhalter | Beschreibung |
|---|---|
{basketOrder} |
Das vollständige Warenkorbbestell-Fluid-Objekt (z.B. {basketOrder.name}, {basketOrder.email}) |
###UID### |
Die interne Bestellnummer (UID) |
###INVOICE_NUMBER### |
Die Bestell-/Rechnungsnummer |
###POSTAL_CODE### |
Die Postleitzahl des Kunden |
###TRACKING_NUMBER### |
Die Sendungsverfolgungsnummer |
Überschreiben und Hinzufügen eigener Vorlagen
Sie können bestehende Vorlagen überschreiben oder eigene hinzufügen, indem Sie den Standard-TYPO3-templateRootPaths-Mechanismus verwenden. Die Pfade werden über TypoScript konfiguriert:
plugin.tx_shop {
view {
templateRootPaths {
200 = EXT:shop/Resources/Private/Templates/
400 = {$themes.resourcesPrivatePath}Extensions/Shop/Templates/
}
}
}Vorlagen in Pfaden mit einem höheren numerischen Index überschreiben Vorlagen mit demselben Dateinamen in Pfaden mit einem niedrigeren Index. Das bedeutet, Sie können Ihre eigenen Vorlagen in Ihrem Site-Package ablegen und diese haben Vorrang.
Eine eigene Vorlage hinzufügen
-
Erstellen Sie eine neue Datei, die auf
Message.htmlendet, im UnterordnerEmail/Message/eines Ihrer konfiguriertentemplateRootPaths, zum Beispiel:your_sitepackage/Resources/Private/Extensions/Shop/Templates/Email/Message/ShippingNoticeMessage.html -
Die erste Zeile ist der Betreff, der Rest ist der Nachrichtentext:
Your order has been shipped!
Dear {basketOrder.name},
your order ###INVOICE_NUMBER### has been shipped.
Your tracking number: ###TRACKING_NUMBER###
Best regards
your Shopping team- Die neue Vorlage
ShippingNoticeMessageerscheint automatisch im Template-Dropdown im Backend.
Datei-/Ordnerstruktur
📂 Email
└─ 📂 Message
├─ 📄 DefaultMessage.html
├─ 📄 CustomMessage.html
└─ 📄 ShippingNoticeMessage.htmlHinweis: Nur Dateien, die auf
Message.htmlenden, werden als Nachrichtenvorlagen erkannt. Andere Dateien im Ordner werden ignoriert.
TYPO3 Shop
Diese Erweiterung ist eine umfangreiche Shop-Erweiterung für TYPO3 zur Umsetzung von Webshops, Online-Shops oder Abo-Systemen (vergleicbar mit tt_products, Quick-Shop oder Aimeos).