DataFirefly Designer für Transaktions-E-Mails für PrestaShop

Überblick

Das Modul dfmaileditor ersetzt den Inhalt der Transaktions-E-Mails von PrestaShop 8 und 9 durch Designs aus einem visuellen Editor. Es ändert keine Datei in /mails oder im Theme und installiert keinen Override: Beim Versand greift es über die Hooks actionEmailSendBefore und actionEmailAddAfterContent ein und liefert eigenes HTML und eine eigene Textversion.

Solange eine E-Mail kein aktives Design hat, sendet PrestaShop die Standard-E-Mail. Schlägt das Rendern eines Designs fehl, wird der Fehler protokolliert und die Standard-E-Mail geht raus: Kein Versand wird blockiert.

Installation

1. Klicken Sie unter Module > Modul-Manager auf Modul hochladen und wählen Sie die Datei dfmaileditor.zip.
2. Das Modul legt seine Tabellen, den Ordner img/dfmaileditor für Bilder und die Seite Design > E-Mail-Designer an.
3. Bei der Installation ändert sich keine E-Mail: Designs werden inaktiv angelegt und einzeln aktiviert.

Die E-Mail-Liste

Die Startseite des Moduls listet die E-Mails des Shops nach Gruppen: Bestellungen, Zahlung, Bestellstatus, Kundenkonto, Händlerbenachrichtigungen und weitere Vorlagen. E-Mails installierter Module werden erkannt und in der letzten Gruppe angezeigt.

• Schalter An / Aus: aktiviert das Design der E-Mail. Aus bedeutet, dass die Standard-E-Mail versendet wird.
• Gestalten oder Bearbeiten öffnet den Editor. Das Kreuz löscht das Design und gibt an die Standard-E-Mail zurück.
• Unter jeder E-Mail: Datum der letzten Änderung und Anzahl der mit dem Design versendeten E-Mails der letzten 30 Tage.
• Das Suchfeld filtert die Liste nach E-Mail- oder Vorlagennamen.

Alle E-Mails aus einem Stil gestalten

Diese Schaltfläche erstellt auf einmal die Designs der 16 wichtigsten E-Mails: Bestellbestätigung, Warten auf Überweisung, Warten auf Scheckzahlung, Zahlung akzeptiert, Zahlungsfehler, in Bearbeitung, versendet, unterwegs, nachbestellt, Bestellung storniert, Erstattung, Gutschein, Kontoerstellung, Gast in Kunde umgewandelt, Zurücksetzen des Passworts und die Benachrichtigung über neue Bestellungen des Moduls ps_emailalerts.

Wählen Sie einen der drei Stile anhand der Vorschau:

• Klar: Marineblau, Systemschrift, linksbündig.
• Atelier: Titel in Palatino, Schaltflächen mit Kontur, eckige Ecken.
• Lebhaft: farbiges Band oben, gefüllte Schaltflächen, abgerundete Ecken.

Optionen: Meine Markenfarbe verwenden (in den Einstellungen festgelegt), Vorhandene Designs ersetzen und Sofort aktivieren. Ohne das letzte Kästchen bleiben die Designs inaktiv, damit Sie sie prüfen können. Die Texte sind in jeder installierten Sprache unter Französisch, Englisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch und Portugiesisch verfasst; andere Sprachen erhalten den englischen Text.

Der Editor

Der Editor besteht aus drei Spalten:

• Links die Blockpalette und die Struktur der E-Mail. Ein Klick auf einen Block der Palette fügt ihn unter dem ausgewählten Block ein, oder Sie ziehen ihn in die Struktur. Die Struktur sortieren Sie per Drag and Drop.
• In der Mitte die Vorschau. Ein Klick auf einen Block wählt ihn aus. Darüber: Sprachen, Umschalter Desktop / Mobil, Feld für die Bestell-ID, Betreff der E-Mail und die Schaltfläche Prüfungen.
• Rechts der Reiter Block mit den Einstellungen des ausgewählten Blocks und der Reiter E-Mail mit den Einstellungen der ganzen E-Mail.

Die obere Leiste enthält Von einem Stil ausgehen, Verlauf, Test senden, den Schalter Aktiv und Speichern. Tastenkürzel: Strg+S speichert, Strg+Z macht rückgängig, Strg+Y wiederholt, Entf löscht den ausgewählten Block.

Die Blöcke

• Inhalt: Titel, Text (fett, kursiv, unterstrichen, Links, Listen), Schaltfläche, Bild, Bild und Text, Hinweisbox, drei Spalten.
• Bestellung: Bestelldetails (Bestellnummer, Datum, Zahlung, Versand), bestellte Produkte, Bestellsummen, Adressen.
• Marketing: empfohlene Produkte, persönlicher Gutschein, Aktionsbanner.
• Layout: Kopfzeile mit Logo, Trennlinie, Abstand, Social-Media-Links, eigenes HTML, Fußzeile.

Der Block Bestellte Produkte zeigt für jede Position das Foto der bestellten Variante, Name, Attribute, Personalisierungen des Kunden, optional die Artikelnummer, Menge und Stückpreis brutto oder netto gemäß den Einstellungen. Empfohlene Produkte werden automatisch gewählt, aus dem Zubehör der bestellten Produkte, den Bestsellern, den Neuheiten oder einer Liste von IDs, 2 bis 4 Produkte; bereits bestellte Produkte sind ausgeschlossen.

Der Block Eigenes HTML nimmt Ihren eigenen Code pro Sprache auf, etwa ein Bewertungs-Widget. Skripte, Formulare, iframes und Event-Attribute werden beim Speichern entfernt.

Abstände und Sichtbarkeit

Jeder Block hat einen Hintergrund, Abstand oben und unten, Seitenränder (-1 übernimmt die Ränder der E-Mail) und zwei Optionen:

• Auf Mobilgeräten ausblenden.
• Nur anzeigen, wenn diese Variable einen Wert hat: zum Beispiel die Schaltfläche Sendung verfolgen mit der Variable followup, die ausgeblendet bleibt, bis das Paket einen Tracking-Link hat. Im Editor erscheint ein durch seine Bedingung ausgeblendeter Block blass.

E-Mail-Einstellungen

Der Reiter E-Mail legt Betreff und Vorschautext im Posteingang (pro Sprache), Seiten- und E-Mail-Hintergrund, Breite von 480 bis 720 px, Ränder, Eckenradius, Schriften für Titel und Text sowie die Farben fest: Text, Nebentext, Hauptfarbe (Schaltflächen), Text auf der Hauptfarbe, Links, Linien, Hintergrund der Boxen. Ein leerer Betreff behält den PrestaShop-Betreff.

Variablen

Die Schaltfläche { } neben den Feldern öffnet die Liste der Variablen der E-Mail mit Beispielwert: {firstname}, {order_name}, {shop_url}, {followup}… PrestaShop ersetzt sie beim Versand. Links können eine Variable enthalten, etwa {shop_url} oder {followup}.

Sprachen

Die Schaltflächen über der Vorschau wechseln die angezeigte und bearbeitete Sprache. Ein oranger Punkt markiert einen fehlenden Text in dieser Sprache; der betroffene Block trägt in der Struktur den Sprachcode. Unter einem leeren Feld übernimmt Text übernehmen aus den Text einer anderen Sprache. Beim Versand wird ein fehlender Text durch die Standardsprache des Shops ersetzt, danach durch Englisch.

Vorschau, Test und Prüfungen

• Desktop / Mobil zeigt die E-Mail in der Breite eines 390-px-Bildschirms.
• Vorschau mit: Geben Sie eine Bestell-ID ein, um die E-Mail mit Produkten, Summen und Adressen dieser Bestellung zu sehen. Ohne ID werden Beispieldaten verwendet.
• Test senden verschickt den Inhalt des Editors, auch ungespeichert, an die gewählte Adresse und in der gewählten Sprache. Es wird kein Gutschein erstellt.
• Prüfungen meldet: eine E-Mail über 102 KB (Gmail kürzt sie und blendet das Ende aus), fehlende Texte pro Sprache, ein Bild ohne Alternativtext, eine Schaltfläche ohne Text oder Link, fehlenden Vorschautext oder fehlende Kopfzeile, einen persönlichen Gutschein in einer Händler-E-Mail. Ein Klick auf einen Eintrag wählt den betroffenen Block aus.

Verlauf

Jedes Speichern bewahrt eine Version auf, bis zu 20 pro E-Mail. Wiederherstellen lädt eine Version in den Editor; speichern Sie, um sie zu behalten. Dasselbe Fenster bietet Dieses Design exportieren und Design löschen.

Teilen und kopieren

• Diesen Block in allen meinen E-Mails verwenden, unten in den Blockeinstellungen: ersetzt den Block gleichen Typs in allen anderen gestalteten E-Mails. Fehlende Kopf- oder Fußzeilen werden ergänzt. Praktisch, um die Fußzeile nur einmal zu ändern.
• Diese Farben und Schriften für alle meine E-Mails übernehmen, oben im Reiter E-Mail: überträgt Farben, Schriften, Breite und Ränder, ohne Betreffzeilen oder Vorschautexte zu ändern.
• Von einem Stil ausgehen > Design einer anderen E-Mail kopieren: übernimmt Blöcke und Farben einer bereits gestalteten E-Mail und behält Betreff und Vorschautext der aktuellen E-Mail.

Persönlicher Gutschein

Dieser Block zeigt einen Rabattcode, der nur für den Kunden gilt. Einstellungen: Titel, Text, Text über dem Code, Schaltfläche und ihr Link, Rabattart (Prozent, fester Betrag oder kostenloser Versand), Wert, Gültigkeit von 1 bis 365 Tagen, Mindestbestellwert und Code-Präfix (zum Beispiel DANKE ergibt DANKE-K7P2M9QX). In den Texten zeigt {voucher_value} den Rabattwert und {voucher_expiry} das Enddatum.

• Der Code wird beim echten Versand der E-Mail erstellt, als Warenkorbregel, die dem Kunden vorbehalten und einmal nutzbar ist.
• Wird dieselbe E-Mail für dieselbe Bestellung erneut gesendet, etwa aus der Bestellansicht, wird der bereits erstellte Code wiederverwendet.
• Vorschau und Test-E-Mails zeigen einen Beispielcode und erstellen nichts.
• Der Gutschein erscheint nur, wenn der Empfänger der Kunde ist: nie in der Benachrichtigung über neue Bestellungen an den Händler.

Die erstellten Regeln tragen die Beschreibung dfmaileditor: vorlagenname unter Katalog > Rabatte > Warenkorbregeln.

Aktionsbanner

Der Reiter Aktionsbanner verwaltet wiederverwendbare Banner. Jedes Banner hat einen internen Namen, einen Status, optionale Start- und Enddaten, eine Hintergrundfarbe für den Textbereich und eine Liste der Ziel-E-Mails (alle oder eine Auswahl). Pro Sprache: Bild (JPG, PNG oder GIF, 1200 px Breite empfohlen, max. 3 MB), Link, Alternativtext, Überschrift, Text und anzuzeigender Rabattcode.

In einer E-Mail zeigt der Block Aktionsbanner entweder das erste aktive Banner, das für diese E-Mail gilt (automatischer Modus, in der Reihenfolge der Liste), oder ein bestimmtes Banner. Ein geplantes Banner erscheint und verschwindet selbstständig nach seinen Daten.

Einstellungen

• Gestaltete E-Mails verwenden: Hauptschalter. Aus bedeutet, dass alle E-Mails wieder im Standardformat versendet werden; die Designs bleiben erhalten.
• Bruttopreise in Produktblöcken: Stückpreise und Positionssummen brutto oder netto.
• Markenfarbe: wird von den fertigen Stilen verwendet, wenn die Option angekreuzt ist.
• Bildgröße in den Bestellpositionen und bei empfohlenen Produkten, aus den Produktbildformaten des Shops.
• Social-Media-Links: Links, die der gleichnamige Block als Text-Schaltflächen anzeigt. Ein leeres Feld blendet das Netzwerk aus.
• Link-Tracking: ergänzt utm_source, utm_medium und utm_campaign (Vorlagenname) nur bei Links zu Ihrem Shop.

Export und Import

Exportieren in der Liste lädt ein ZIP mit allen Designs des Shops und den über das Modul hochgeladenen Bildern herunter; der Verlauf einer E-Mail bietet den Export nur dieses Designs. Ohne die PHP-Erweiterung ZipArchive erfolgt der Export als JSON ohne Bilder.

Importieren akzeptiert dieses ZIP oder JSON. Die Bilder werden geprüft (nur echte JPG-, PNG- oder GIF-Dateien) und nach img/dfmaileditor kopiert. Optionen: vorhandene Designs ersetzen, Designs aktiv lassen, wenn sie im Export aktiv waren. Ohne diese Kästchen werden bereits gestaltete E-Mails übersprungen und neue Designs kommen inaktiv an. Banner sind nicht Teil des Exports.

Fehlerbehebung

Eine E-Mail wird weiter im Standardformat versendet

Prüfen Sie, ob das Design in der Liste aktiv ist und der Hauptschalter in den Einstellungen eingeschaltet ist. Wird die E-Mail aus dem Backoffice ausgelöst (Änderung des Bestellstatus), überspringt PrestaShop die Hooks eines Moduls, wenn das Profil des angemeldeten Mitarbeiters kein Recht Anzeigen für dieses Modul hat: Erteilen Sie es unter Erweiterte Einstellungen > Team > Berechtigungen > Module. Sehen Sie zuletzt unter Erweiterte Einstellungen > Protokolle nach: Ein Renderfehler steht dort mit dem Präfix [dfmaileditor].

Bilder erscheinen beim Kunden nicht

Bilder werden über die öffentliche URL des Shops geladen: Aus einem lokalen oder passwortgeschützten Shop werden sie nicht angezeigt. Manche E-Mail-Programme blockieren Bilder, bis der Empfänger sie freigibt; dann erscheint der Alternativtext.

Gmail zeigt „Nachricht gekürzt“

Die E-Mail ist größer als 102 KB. Entfernen Sie Blöcke, vor allem umfangreiches eigenes HTML, oder zeigen Sie weniger empfohlene Produkte. Die Schaltfläche Prüfungen nennt das genaue Gewicht.

Der Gutschein erscheint nicht

Im Editor und in Tests wird ein Beispielcode angezeigt. Beim echten Versand erscheint der Gutschein nur bei einem einzelnen Empfänger, der Kunde der Bestellung ist, oder bei einem bestehenden Kunden in Konto-E-Mails.

Zwei Produktlisten in der E-Mail

Ein anderes Modul fügt den E-Mails eigene Produktzeilen hinzu. Deaktivieren Sie es für gestaltete E-Mails: Der Block Bestellte Produkte zeigt die Fotos bereits.