Phoca Cart 5 lässt sich in das native Email-Template-System von Joomla! integrieren. Alle von Phoca Cart versendeten Transaktions-Emails – Bestellbestätigungen, Stornierungsbenachrichtigungen, Geschenkgutscheine, Benachrichtigungen bei Lagerbestandsänderungen, Benachrichtigungen bei Fragen, Benachrichtigungen bei Artikel-Einreichungen und Benachrichtigungen zu Abonnements – werden über die Standardoberfläche für Email-Templates in der Joomla!Administration verwaltet.

In diesem Kapitel werden die Email-Template-Typen von Phoca Cart beschrieben, sowie deren Anzeige und Bearbeitung und die Möglichkeit, ihre Layout-Dateien mithilfe des Standardmechanismus von Joomla! zum Überschreiben von Templates zu überschreiben.

Übersicht über Joomla Email-Templates

Mit Joomla Email-Templates können Website-Administratoren den Betreff und den Text jeder System-Email anpassen, die vom Joomla!-Kern oder von Erweiterungen von Drittanbietern, einschließlich Phoca Cart, versendet wird. Die Templates unterstützen sowohl das Nur-Text- als auch das HTML-Format und können dynamische Platzhalter-Tags enthalten, die zum Zeitpunkt des E-Mail-Versands durch tatsächliche Daten ersetzt werden.

Email-Templates finden Sie unter:

Joomla! Administration → System → Templates → Email Templates

Die Liste enthält alle registrierten E-Mail-Vorlagen, gruppiert nach Erweiterung. Filtern Sie die Liste, indem Sie im Dropdown-Menü 'Nach Komponente filtern' die Option Phoca Cart auswählen, um nur die Phoca Cart Templates anzuzeigen.Die Liste enthält alle registrierten Email-Templates, gruppiert nach Erweiterungen.

Phoca Cart Mail-Template Typen

Phoca Cart registriert Email-Templates für alle gängigen Transaktions-Emails. Die Vorlagen werden durch einen Schlüssel im Format com_phocacart gekennzeichnet.

Templates für den Auftragsstatus

Bestellstatus Templates werden dynamisch für jeden Auftragsstatus erstellt. Jeder in Phoca Cart definierte Bestellstatus generiert beim Speichern seines Status einen eigenen Satz von E-Mail-Vorlagen. Die Template-Schlüssel enthalten die numerische ID des Auftragsstatus.

Diese Templates werden automatisch erstellt. Gehen Sie zu Administration → Phoca Cart → Auftragsstatus, öffnen Sie einen beliebigen Status und legen Sie fest, ob Emails an den Kunden, an andere Personen oder für Geschenkgutscheine versendet werden sollen. Die Joomla! Email-Templates enthalten dann entsprechende Einträge, die Sie unter System → Email Templates bearbeiten können.

Zu den in den Vorlagen für den Auftragsstatus verfügbaren Platzhalter-Tags gehören {html.document}, {text.document}, {document}, {ordernumber}, {status_title}, und {sitename}. Die {html.document} und {text.document} Tags werden durch die vollständig gerenderte Ausgabe der Phoca Cart Mail-Layoutdateien ersetztare — siehe den Phoca Cart Mail-Layoutdateien Bereich weiter unten.

Templates für Stornierungen (Widerruf)

Frage stellen Templates

Element senden Templates

Wieder auf Lager Template

Geschenkgutschein Templates

E-Mails mit Geschenkgutscheinen werden im Rahmen des Bestellstatus-Ablaufs versendet, wobei die oben beschriebenen Varianten  gift und gift_notificatio der Bestellstatus-Vorlagen verwendet werden. Das für die Darstellung des Geschenkgutschein-Inhalts verwendete Layout ist gift.php (siehe Phoca Cart Mail-Layoutdateien weiter unten).

Abonnement Templates

Abonnement-Emails werden zu verschiedenen Ereignissen in der Abonnement-Laufzeit versendet:

 Ein Email Template bearbeiten

Um ein Phoca Cart Email Template zu bearbeiten:

1. Gehen Sie zu Joomla! Administration → System → Email Templates
2. Filtern Sie nach Phoca Cart im Filter nach Komponente Dropdown
3. Klicken Sie auf den Email-Template-Titel, den Sie bearbeiten möchten

Der Email-Template-Editor enthält folgende Felder:

Für Auftragsstatus-Templates, enthält das HTML-Inhalt Feld normalerweise {html.document} and the Inhalt Feld normalerweise {text.document}. Diese Tags werden beim Absenden durch die gerenderte Ausgabe der entsprechenden Phoca Cart Layoutdatei ersetzt (siehe unten). Sie können direkt im Editor zusätzlichen Text oder HTML-Code oberhalb oder unterhalb dieser Tags einfügen.

Optionen Tab

Jede Email-Template verfügt über eine Registerkarte Optionen, über die die siteweiten Email-Einstellungen für diese bestimmte Vorlage überschrieben werden können. Bedingung dafür ist aber, das Sie diese Funktion auch in den Optionen der Email-Templates aktiviert haben. Joomla! Administration → System → Email Templates → Optionen → E-Mail-Einstellungen je nach Template=Ja

Phoca Cart Mail-Layoutdateien

Phoca Cart stellt spezielle PHP-Layoutdateien bereit, die den HTML- (und Klartext-)Inhalt jeder E-Mail erstellen. Diese Dateien liefern den Inhalt, der schließlich in den Platzhalter-Tags {html.document} und {text.document} erscheint. Die Layoutdateien sind innerhalb der Komponente in zwei parallelen Ordnerstrukturen organisiert:

components/com_phocacart/layouts/phocacart/mail/html/    ← HTML Format-Layouts
components/com_phocacart/layouts/phocacart/mail/text/    ← Text Format-Layouts

Jeder Mail-Typ verfügt über eine Einstiegsdatei im Stammverzeichnis von html/ oder text/, die eine Reihe von Sublayout-Dateien koordiniert, die in einem gleichnamigen Unterordner gespeichert sind. Die Einstiegsdatei ruft $this->sublayout(...) auf, um jeden Abschnitt zu rendern, fasst die Ergebnisse in einem $blocks-Array zusammen und gibt die vollständige HTML-Struktur aus.

Einstiegsdatei-Layoutdateien

Dies sind die Stammdateien, eine pro E-Mail-Typ. Jede davon liegt sowohl in einer html/ und text/ Variante vor:

Bestellung Sublayoutdateien

Die Bestellart ist am komplexesten. Sie ist in die folgenden Sublayouts unterteilt, die sowohl in html/order/ und text/order/ vorhanden sind:The order type is the most complex. It is split into the following sublayouts, present in both html/order/ and text/order/:

Andere Sublayoutdateien

Hinweis: Der Ordner text/ spiegelt die Struktur des Ordners html/ wider, jedoch enthalten alle Dateien reinen Text anstelle von HTML. In den Layouts unter text/ gibt es keine Datei styles.php, da E-Mails im Klartext-Format kein CSS enthalten.

Phoca Cart Mail-Layoutdateien überschreiben

Die Layoutdateien von Phoca Cart folgen dem standardmäßigen Mechanismus zur Überschreibung von Layouts in Joomla!. Kopieren Sie eine beliebige Datei aus der Komponente in den entsprechenden Pfad innerhalb Ihrer aktiven Website-Vorlage und bearbeiten Sie sie dort. Ihre Änderungen gehen bei einer Aktualisierung von Phoca Cart nicht verloren, da die Dateien der Komponente niemals verändert werden.

Pfadstruktur überschreiben

Quellort (Originaldateien innerhalb der Komponente; bearbeiten Sie diese nicht direkt):

components/com_phocacart/layouts/phocacart/mail/html/
components/com_phocacart/layouts/phocacart/mail/text/

Überschreibungsort (Dateien, die Sie innerhalb Ihrer aktiven Website-Templates erstellen):

templates//html/layouts/com_phocacart/phocacart/mail/html/
templates//html/layouts/com_phocacart/phocacart/mail/text/

Ersetzen Sie dies durch den Ordnernamen Ihres aktiven Website-Templates, zum Beispiel cassiopeia oder phoca_premiere.

Beispiel – Den Block 'Bestell-Email-Produkte' überschreiben

Um die Darstellung der Produktliste in Bestell-Emails zu ändern, kopieren Sie bitte nur das Produkt-Sublayout:

VON:

components/com_phocacart/layouts/phocacart/mail/html/order/products.php

ZU:

templates/phoca_premiere/html/layouts/com_phocacart/phocacart/mail/html/order/products.php

Bearbeiten Sie den Text und nehmen Sie Ihre Änderungen vor. Phoca Cart übernimmt die Überschreibung automatisch.

Beispiel – Den Block 'Bestellsummen' überschreiben

VON:

components/com_phocacart/layouts/phocacart/mail/html/order/totals.php

ZU:

templates/phoca_premiere/html/layouts/com_phocacart/phocacart/mail/html/order/totals.php

Beispiel – Überschreiben der gesamten Email-Struktur für Bestellungen

So ändern Sie das allgemeine Layout und die Anordnung der Blöcke in der HTML-Bestellbestätigung (z. B. um die Produktliste über die Adressfelder zu verschieben oder einen völlig neuen Abschnitt hinzuzufügen):

VON:

components/com_phocacart/layouts/phocacart/mail/html/order.php

ZU:

templates/phoca_premiere/html/layouts/com_phocacart/phocacart/mail/html/order.php

In dieser Einstiegsdatei kannst du die $displayData['blocks'], die zusammengestellt und ausgegeben werden, neu anordnen, hinzufügen oder entfernen. Jeder Block wird weiterhin durch seine eigene Sublayout-Datei gerendert (die wiederum unabhängig überschrieben werden kann).

Beispiel – Überschreiben der Stornierungs-Email (Kunde)

VON:

components/com_phocacart/layouts/phocacart/mail/html/cancellation/customer.php

ZU:

templates/phoca_premiere/html/layouts/com_phocacart/phocacart/mail/html/cancellation/customer.php

Tipp: Sie können nur die einzelnen Sublayout-Dateien überschreiben, die Sie benötigen, ohne die Einstiegsdatei zu verändern. Joomla! verarbeitet jede Sublayout-Datei über das Überschreibungssystem unabhängig voneinander. So ist es beispielsweise völlig zulässig, nur die Datei order/billing.php zu überschreiben, ohne dass dies Auswirkungen auf die anderen Bestellblöcke hat.

Tipp: Überschreiben Sie immer sowohl die HTML- als auch die Text-Variante, wenn Sie Inhalte ändern (z. B. ein Feld hinzufügen). Das Text-Layout wird verwendet, wenn die Website E-Mails im Klartext- oder Multipart-Format versendet, und sollte dieselben Informationen enthalten wie die HTML-Version.

Layout des Joomla-Mail-Wrappers überschreiben

Zusätzlich zu den oben genannten Phoca Cart Layoutdateien unterstützt Joomla! ein globales HTML-Wrapper-Layout, das alle HTML-E-Mails mit einem markenspezifischen Außenrahmen (Logo, Kopf- und Fußzeile) umgibt. Hierbei handelt es sich um eine Standardfunktion von Joomla!, die völlig unabhängig vom Phoca Cart Sublayout-System ist.

So erstellen Sie ein benutzerdefiniertes Layout für den Joomla-Mail-Wrapper:

1. Go to Joomla! Administration → System → Site Templates → Öffnen Sie Ihr aktives Template
2. Klicken Sie auf den  Overrides erstellen Tab
3. Wählen Sie joomla → mail aus dem Dropdown Layouts
4. Joomla kopiert die Basis-Wrapper-Datei nach:

templates//html/layouts/joomla/mail/mailtemplate.php

5. Bearbeiten Sie diese Datei, um den äußeren HTML-Rahmen anzupassen – Markenfarben, Logo, Kopf- und Fußzeile.

Sie können in diesem Ordner mehrere Dateien anlegen, zum Beispiel mailtemplate_order.php und mailtemplate_minimal.php. Alle in diesem Ordner befindlichen PHP-Dateien werden in der Dropdown-Liste Layout im Tab Optionen der jeweiligen E-Mail-Vorlage angezeigt.

So wenden Sie Ihren benutzerdefinierten Wrapper für ein bestimmtes Phoca Cart Email-Template an: Gehen Sie zu System → Email Templates, öffnen Sie das Template, klicken Sie auf den Tab Optionen, setzen Sie Email Template-Layout auf Aktiviert und wählen Sie Ihre Layout-Datei aus der Dropdown-Liste aus.

Mail-Format Einstellungen

Das Email-Format für alle ausgehenden E-Mails wird global geregelt in:

Joomla! Administration → System → Mail Templates → Optionen Button

Hinweis: Das Feld HTML-Inhalt im Editor sowie die html/ Layout-Dateien werden nur verwendet, wenn das Email-Format auf HTML oder Beides eingestellt ist. Bei der Einstellung Klartext werden nur die text/Layout-Dateien sowie 'Inhalt' verwendet.

Wie alles zusammenpasst

Das folgende Diagramm zeigt den gesamten Ablauf, wenn Phoca Cart eine Email zum Auftragsstatus versendet:

Phoca Cart löst eine Email aus (z. B. ändert sich der Bestellstatus zu "Versendet")
        │
        ▼
MailHelper::renderBody('order', 'html', $data, $mailData)
  Lädt: components/com_phocacart/layouts/phocacart/mail/html/order.php
  Überschreibt: templates//html/layouts/com_phocacart/phocacart/mail/html/order.php
        │
        ├─ sublayout('styles')      → html/order/styles.php
        ├─ sublayout('header')      → html/order/header.php
        ├─ sublayout('info')        → html/order/info.php
        ├─ sublayout('billing')     → html/order/billing.php
        ├─ sublayout('shipping')    → html/order/shipping.php
        ├─ sublayout('products')    → html/order/products.php
        ├─ sublayout('totals')      → html/order/totals.php
        ├─ sublayout('link')        → html/order/link.php
        ├─ sublayout('downloads')   → html/order/downloads.php
        ├─ sublayout('taxes')       → html/order/taxes.php
        └─ sublayout('rewardpoints')→ html/order/rewardpoints.php
        │
        │   (Jedes Sublayout kann im Template-Ordner individuell überschrieben werden)
        │
        ▼
Gerendertes HTML, gespeichert als $mailData['html.document']
Der gleiche Ablauf gilt für das Format 'Text' format → $mailData['text.document']
        │
        ▼
Joomla Mail Template (System → Mail Templates)
  com_phocacart.order_status.
  Body (HTML) field e.g.: "Dear customer, {html.document}"
  {html.document} is replaced with the rendered layout output
        │
        ▼
Optional: Joomla Mail-Wrapper-Layout
  templates//html/layouts/joomla/mail/mailtemplate.php
  HTML-Frame mit Markenlogo: Logo, Kopfzeile, Fußzeile
        │
        ▼
E-Mail an Kunden / Lieferanten / Administrator gesendet

Das Gleiche gilt für Klartext unter Verwendung von renderBody('order', 'text', ...) und dem {text.document} Tag.

Schritt für Schritt: Eine Bestellbestätigungs-Email anpassen

Schritt 1 — Finden Sie das richtige Email-Template

Gehen Sie zu System → Mail Templates und filtern Sie nach Phoca Cart. Auftragsstatus-Templates sind so gelistet com_phocacart.order_status.. Suchen Sie den Eintrag für den Auftragsstatus, den Sie anpassen möchten (die ID entspricht der Status-ID, in Phoca Cart → Auftragsstatus).

Schritt 2 — Bearbeiten Sie den Betreff und den Inhalt

Klicken Sie auf das Template. Im Feld HTML-Inhalt finden Sie in der Regel {html.document}, das beim Versenden durch das gerenderte Layout ersetzt wird. Sie können direkt in diesem Feld einen einleitenden Text darüber oder eine abschließende Bemerkung darunter einfügen, ohne Layout-Dateien zu bearbeiten.

Schritt 3 — Überschreiben Sie ein Sublayout, um den HTML-Inhalt zu ändern

Um den Inhalt der E-Mail zu ändern – beispielsweise um zusätzliche Produktfelder in der Produktliste anzuzeigen – kopieren Sie das Folgende:

components/com_phocacart/layouts/phocacart/mail/html/order/products.php

zu:

templates/phoca_premiere/html/layouts/com_phocacart/phocacart/mail/html/order/products.php

Bearbeiten Sie die Kopie. Es müssen keine weiteren Dateien geändert werden.

Schritt 4 — Überschreiben Sie Stile, um das visuelle Design anzupassen

Um Schriftarten, Farben oder Abstände zu ändern, kopieren Sie:

components/com_phocacart/layouts/phocacart/mail/html/order/styles.php

zu:

templates/phoca_premiere/html/layouts/com_phocacart/phocacart/mail/html/order/styles.php

Das Sublayout styles.php definiert Inline-CSS-Stil-Strings (bezeichnet als $styles['fs-normal'], $styles['w100'] usw.), die von allen anderen Sublayout-Blöcken der Bestellung verwendet werden.

Schritt 5 — Fügen Sie einen Rahmen mit Markenlogo hinzu (optional)

Erstellen Sie eine Überschreibung des Joomla-Mail-Wrappers, wie unter Layout des Joomla-Mail-Wrappers überschreiben beschrieben, und weisen Sie diese dann dem Email-Template des Tabs Optionen zu.

Schritt 6 — Test

Geben Sie über Ihren Shop eine Testbestellung auf und lösen Sie die entsprechende Statusänderung aus, oder nutzen Sie Globale Konfiguration → Server → Test-Email senden, um zu überprüfen, ob die Email in Ihrem Email-Client korrekt angezeigt wird.

Mehrsprachige Mail-Templates

Wenn Ihre Website in mehreren Sprachen verfügbar ist, unterstützen Joomla! Mail-Templates sprachenspezifische Betreffzeilen und Textinhalte. So übersetzen Sie eine Phoca Cart Email-Template:

1. Gehen Sie zu System → Email Templates, und öffnen Sie das gewünschte Phoca Cart Template
2. Verwenden Sie die Sprachauswahl im Editor, um zu einer anderen Sprache zu wechseln
3. Geben Sie den übersetzten Betreff und Text für diese Sprache ein
4. Speichern

Phoca Cart übergibt beim Versenden von Emails die Sprache des Benutzers ($order->user_lang) oder die Standardsprache der Website ($order->user_lang) an das Email-Template, sodass automatisch die richtige Sprachversion ausgewählt wird.

Tipps und Fehlerbehebung

HTML-Emails werden nicht versendet

Überprüfen Sie System → Mail Templates → Optionen , dass das Email-Format  HTML oder Beide gesetzt ist. Bei der Einstellung Klartext werden das HTML-Hauptfeld sowie alle HTML- und Layout-Dateien ignoriert.

Die Layout-Überschreibung wird nicht übernommen

Achten Sie darauf, dass der Überschreibungspfad genau stimmt.

templates//html/layouts/com_phocacart/phocacart/mail/html/.php
templates//html/layouts/com_phocacart/phocacart/mail/html//.php

Beachten Sie den zweistufigen Unterpfad phocacart/mail/ innerhalb von layouts/com_phocacart/. Bei Ordnernamen wird auf Linux-Servern zwischen Groß- und Kleinschreibung unterschieden.

Das Überschreiben eines Sublayouts hat keine Auswirkungen auf andere Blöcke

Jedes Sublayout wird unabhängig ausgewertet. Sie können getrost nur die Datei order/products.php überschreiben und alle anderen Blöcke (billing.php, totals.php usw.) unverändert lassen – diese verwenden weiterhin die Originaldateien aus der Komponente.

Das {html.document} Tag erscheint wörtlich in der empfangenen E-Mail

Das bedutet, dass das Das bedeutet, dass das html/Layout von Phoca Cart nicht gerendert werden konnte, höchstwahrscheinlich aufgrund eines PHP-Fehlers in einer überschriebenen Datei. Überprüfen Sie Ihr Server-Fehlerprotokoll. Wenn das Rendern fehlschlägt, wird das Tag nicht ersetzt.

Das Layout der Umhüllung wird nicht angewendet

Überprüfen Sie im Tab Optionen des Email-Templates, ob Layout Email-Template auf Aktiviert gesetzt ist und eine Layoutdatei ausgewählt wurde. Vergewissern Sie sich außerdem, dass beim Button Optionen für E-Mail-Vorlagen der Parameter Email-Einstellungen je Template auf Ja gesetzt ist.