Bedienung für Shop-Betreiber

Diese Anleitung richtet sich an Shop-Betreiber und OXID-Admin-Benutzer ohne Server- oder Programmierzugriff. Installation und technische Updates sind unter Installation für Agenturen beschrieben.

Wo sich das Modul befindet

MailContact fügt jeder Bestellung einen eigenen Tab hinzu. Öffnen Sie eine Bestellung unter Bestellungen verwalten ‣ Bestellungen und wechseln Sie in den Tab Email. Dort finden Sie den E-Mail-Editor mit Vorlagenauswahl, Absender, Empfänger, Betreff und Textfeld.

Die Moduleinstellungen erreichen Sie unter Erweiterungen ‣ Module über den Eintrag „eComStyle.de: MailContact“ im Tab Einstell. in der Gruppe „Grundeinstellungen“.

Moduleinstellungen

Einstellung

Wirkung

BCC (Blindkopie) senden an …

E-Mail-Adresse(n) für eine Blindkopie jeder versendeten Mail, kommagetrennt. Leer lassen zum Deaktivieren – praktisch für ein internes Postfach als Versandnachweis.

CK-Editor deaktivieren

Schaltet den grafischen Editor aus; der Text wird dann als reines Eingabefeld ohne Formatierwerkzeugleiste bearbeitet. Standard: deaktiviert (Editor an).

Letzte Änderungen bei Deaktivierung löschen

Notfall-Option: Aktivieren und das Modul einmal de- und aktivieren, falls ein fehlerhaftes Vorlagen-Tag den Email-Tab blockiert. Die zuletzt geänderte Vorlage wird dabei entfernt und die Option schaltet sich danach automatisch wieder aus. Standard: deaktiviert.

Der Email-Tab im Überblick

Der Editor besteht aus:

  • Emailvorlage: Auswahl gespeicherter Vorlagen oder „Standardvorlage“ für den neutralen Standardtext. Beim Öffnen lädt automatisch die zuletzt bearbeitete Vorlage.

  • Absender: Vorausgefüllt mit der Info-E-Mail des Shops; eine andere gültige Absenderadresse ist möglich.

  • Emailempfänger: Eine oder mehrere Adressen, kommagetrennt.

  • Betreff und Emailtext: Freitext mit Platzhaltern (siehe unten).

  • Vorschau: Zeigt die Mail mit den echten Bestelldaten.

  • Vorlagenname + Speichern: Aktuelle Eingaben als eigene Vorlage ablegen.

  • Absenden: Sendet die Mail nach einer Sicherheitsabfrage.

Platzhalter in Betreff und Text

Betreff und Text akzeptieren Template-Variablen, die beim Versand durch die echten Daten ersetzt werden. Beispiele:

{{ order.oxorder__oxordernr.value }}     → Bestellnummer
{{ order.oxorder__oxbillnr.value }}      → Rechnungsnummer
{{ order.oxorder__oxbilllname.value }}   → Nachname des Kunden
{{ order.oxorder__oxbillsal.value }}     → Anrede
{{ user.oxuser__oxcustnr.value }}        → Kundennummer
{{ shop.oxshops__oxname.value }}         → Shopname

Auch Schleifen und Bedingungen sind möglich, etwa {% for oOrderArticle in order.getOrderArticles(true) %} für die Positionsliste oder {% if order.getShipmentTrackingUrl() %} für einen Sendungsverfolgungs-Link. Über {% ifcontent ident "oxemailfooter" %} lässt sich der CMS-E-Mail-Fuß des Shops einbinden.

Bemerkung

Die Platzhalter-Schreibweise gehört zur Twig-Ausgabe für OXID 7. Im OXID-6-Paket werden Smarty-Platzhalter verwendet; die mitgelieferten Standardvorlagen sind bereits in der passenden Schreibweise formuliert.

Schnellstart

  1. Öffnen Sie eine Bestellung und wählen Sie den Tab Email.

  2. Wählen Sie eine Vorlage, etwa „Statusupdate“ – Betreff und Text werden mit den Bestelldaten vorbereitet.

  3. Prüfen Sie das Ergebnis über Vorschau: Alle Platzhalter sind bereits durch echte Werte ersetzt.

  4. Passen Sie Empfänger und Text an und klicken Sie Absenden – nach der Sicherheitsabfrage geht die Mail raus.

Versendete E-Mails werden mit Empfänger, Betreff und Inhalt als Vermerk in der Benutzerhistorie des Kunden festgehalten (Benutzer verwalten ‣ Benutzer ‣ Historie).

Vorlagen verwalten

  • Speichern: Geben Sie einen Vorlagennamen ein (max. 32 Zeichen) und klicken Sie Speichern. Ein vorhandener Name wird überschrieben.

  • Laden: Vorlage in der Auswahl wählen – sie füllt Betreff und Text.

  • Löschen: Die geladene Vorlage lässt sich über Vorlage löschen nach Rückfrage entfernen.

  • Ein abweichender Absender wird nur in der Vorlage gespeichert, wenn er nicht der Shop-Info-Adresse entspricht.

Empfohlene Arbeitsweise

  • Hinterlegen Sie eine interne BCC-Adresse, wenn Sie einen Versandnachweis im eigenen Postfach wünschen.

  • Legen Sie eigene Vorlagen für wiederkehrende Fälle an (Mahnung, Teillieferung, Rückfrage) statt jedes Mal neu zu schreiben.

  • Testen Sie neue Vorlagen zuerst an eine eigene Adresse und mit der Vorschau – Fehler in Platzhaltern fallen sofort auf.

Grenzen und Hinweise

  • Die Mail geht nur an die eingetragenen Empfänger; es gibt keinen automatischen Versand an Bestellstatus oder Ereignisse.

  • Vorlagen sind zentral und für alle Admin-Benutzer gleich sichtbar – Änderungen wirken sofort für alle.

  • Anhänge sind nicht vorgesehen; die Mail besteht aus dem formatierten Text.

  • Der Vermerk in der Benutzerhistorie dokumentiert den Versand, ist aber kein Zustellnachweis.

Häufige Anwenderfragen

Der Email-Tab lässt sich nicht mehr öffnen

Meist steckt ein fehlerhaftes Template-Tag (z. B. fehlende Klammer) in der zuletzt gespeicherten Vorlage. Aktivieren Sie in den Moduleinstellungen „Letzte Änderungen bei Deaktivierung löschen“, de-/aktivieren Sie das Modul einmal – die problematische Vorlage wird entfernt und die Option stellt sich zurück.

Platzhalter werden nicht ersetzt

Prüfen Sie die Schreibweise: OXID 7 nutzt {{ … }}, OXID 6 [{ … }]. Ein Tippfehler im Variablennamen führt zu leerem Text – die Vorschau zeigt das Ergebnis vorab.

Die Mail kommt nicht an

Prüfen Sie Empfänger-Adresse(n) auf Tippfehler und ob die generelle E-Mail-Funktion des Shops funktioniert (z. B. Bestellbestätigung). Der Vermerk in der Benutzerhistorie zeigt, ob der Versand ausgelöst wurde.

Eine Vorlage wurde versehentlich überschrieben

Vorlagen werden ohne Versionierung überschrieben; eine Wiederherstellung ist nicht möglich. Bewahren Sie wichtige Vorlagen zusätzlich als Kopie auf.