DataFirefly Edytor e-maili transakcyjnych dla PrestaShop

Omówienie

Moduł dfmaileditor zastępuje treść e-maili transakcyjnych PrestaShop 8 i 9 projektami stworzonymi w wizualnym edytorze. Nie zmienia żadnego pliku w /mails ani w motywie i nie instaluje override: podczas wysyłki przejmuje e-mail przez hooki actionEmailSendBefore i actionEmailAddAfterContent i dostarcza własny HTML oraz własną wersję tekstową.

Dopóki e-mail nie ma aktywnego projektu, PrestaShop wysyła natywny e-mail. Jeśli renderowanie projektu się nie powiedzie, błąd trafia do logów, a wychodzi natywny e-mail: żadna wysyłka nie jest blokowana.

Instalacja

1. W Moduły > Menedżer modułów kliknij Załaduj moduł i wybierz plik dfmaileditor.zip.
2. Moduł tworzy swoje tabele, folder img/dfmaileditor na obrazy i stronę Wygląd > Edytor e-maili.
3. Po instalacji żaden e-mail się nie zmienia: projekty są tworzone jako nieaktywne i włączasz je pojedynczo.

Lista e-maili

Strona główna modułu pokazuje e-maile sklepu w grupach: zamówienia, płatność, status zamówienia, konto klienta, powiadomienia dla sprzedawcy i inne szablony. E-maile zainstalowanych modułów są wykrywane i trafiają do ostatniej grupy.

• Przełącznik Wł. / Wył.: włącza projekt e-maila. Po wyłączeniu wysyłany jest natywny e-mail.
• Zaprojektuj lub Edytuj otwiera edytor. Krzyżyk usuwa projekt i przywraca natywny e-mail.
• Pod każdym e-mailem: data ostatniej zmiany i liczba wysyłek z projektem z ostatnich 30 dni.
• Pole wyszukiwania filtruje listę po nazwie e-maila lub szablonu.

Zaprojektuj wszystkie e-maile na bazie stylu

Ten przycisk tworzy naraz projekty 16 głównych e-maili: potwierdzenie zamówienia, oczekiwanie na przelew, oczekiwanie na czek, płatność przyjęta, błąd płatności, w trakcie realizacji, wysłane, w transporcie, oczekuje na dostawę, zamówienie anulowane, zwrot środków, kupon, założenie konta, gość zamieniony w klienta, reset hasła oraz powiadomienie o nowym zamówieniu z modułu ps_emailalerts.

Wybierz jeden z trzech stylów, oglądając podgląd:

• Minimalistyczny: granat, czcionka systemowa, wyrównanie do lewej.
• Atelier: tytuły w Palatino, przyciski z obrysem, proste narożniki.
• Wyrazisty: kolorowy pas u góry, pełne przyciski, zaokrąglone narożniki.

Opcje: Użyj koloru mojej marki (ustawionego w Ustawieniach), Zastąp istniejące projekty i Aktywuj je od razu. Bez ostatniego pola projekty pozostają nieaktywne, abyś mógł je przejrzeć. Teksty są napisane w każdym zainstalowanym języku spośród francuskiego, angielskiego, hiszpańskiego, niemieckiego, włoskiego, niderlandzkiego, polskiego i portugalskiego; pozostałe języki dostają tekst angielski.

Edytor

Edytor ma trzy kolumny:

• Po lewej paleta bloków i struktura e-maila. Kliknij blok w palecie, aby dodać go pod zaznaczonym blokiem, albo przeciągnij go do struktury. Kolejność w strukturze zmieniasz przeciąganiem.
• Pośrodku podgląd. Kliknięcie bloku zaznacza go. Nad nim: języki, przełącznik komputer / telefon, pole ID zamówienia, temat e-maila i przycisk Kontrola.
• Po prawej zakładka Blok z ustawieniami zaznaczonego bloku i zakładka E-mail z ustawieniami całego e-maila.

Górny pasek zawiera Zacznij od stylu, Historia, Wyślij test, przełącznik Aktywny i Zapisz. Skróty: Ctrl+S zapisuje, Ctrl+Z cofa, Ctrl+Y ponawia, Del usuwa zaznaczony blok.

Bloki

• Treść: tytuł, tekst (pogrubienie, kursywa, podkreślenie, linki, listy), przycisk, obraz, obraz i tekst, wyróżniona ramka, trzy kolumny.
• Zamówienie: szczegóły zamówienia (numer, data, płatność, przewoźnik), zamówione produkty, podsumowanie zamówienia, adresy.
• Marketing: polecane produkty, osobisty kupon, baner promocyjny.
• Układ: nagłówek z logo, separator, odstęp, linki społecznościowe, własny HTML, stopka.

Blok Zamówione produkty pokazuje dla każdej pozycji zdjęcie zamówionej kombinacji, nazwę, atrybuty, personalizacje klienta, opcjonalnie kod produktu, ilość i cenę jednostkową netto lub brutto zgodnie z Ustawieniami. Polecane produkty dobierane są automatycznie, spośród akcesoriów zamówionych produktów, bestsellerów, nowości lub listy ID, od 2 do 4 produktów; produkty już zamówione są pomijane.

Blok Własny HTML przyjmuje Twój kod dla każdego języka, np. widżet opinii. Skrypty, formularze, iframe i atrybuty zdarzeń są usuwane przy zapisie.

Odstępy i widoczność

Każdy blok ma tło, odstęp nad i pod, marginesy boczne (-1 przejmuje marginesy e-maila) i dwie opcje:

• Ukryj na telefonie.
• Pokaż tylko, gdy ta zmienna ma wartość: np. przycisk Śledź przesyłkę ze zmienną followup, ukryty, dopóki paczka nie ma linku do śledzenia. W edytorze blok ukryty przez warunek jest wyszarzony.

Ustawienia e-maila

Zakładka E-mail ustawia temat i tekst podglądu w skrzynce odbiorczej (dla każdego języka), tło strony i e-maila, szerokość od 480 do 720 px, marginesy, zaokrąglenie narożników, czcionki tytułów i tekstu oraz kolory: tekst, tekst pomocniczy, kolor główny (przyciski), tekst na kolorze głównym, linki, linie, tło ramek. Pusty temat zachowuje temat PrestaShop.

Zmienne

Przycisk { } obok pól otwiera listę zmiennych e-maila z przykładowymi wartościami: {firstname}, {order_name}, {shop_url}, {followup}… PrestaShop podstawia je przy wysyłce. Linki mogą zawierać zmienną, np. {shop_url} lub {followup}.

Języki

Przyciski nad podglądem zmieniają wyświetlany i edytowany język. Pomarańczowa kropka oznacza brak tekstu w danym języku; blok, którego to dotyczy, ma w strukturze kod języka. Pod pustym polem odnośnik Skopiuj tekst z przejmuje tekst z innego języka. Przy wysyłce brakujący tekst zastępuje tekst w domyślnym języku sklepu, a potem angielski.

Podgląd, test i kontrola

• Komputer / Telefon pokazuje e-mail w szerokości ekranu 390 px.
• Podgląd z: wpisz ID zamówienia, aby zobaczyć e-mail z produktami, sumami i adresami tego zamówienia. Bez ID używane są dane przykładowe.
• Wyślij test wysyła treść edytora, także niezapisaną, na wybrany adres i w wybranym języku. Żaden kupon nie jest tworzony.
• Kontrola wskazuje: e-mail powyżej 102 KB (Gmail go obcina i ukrywa koniec), brakujące teksty w językach, obraz bez tekstu alternatywnego, przycisk bez tekstu lub linku, brak tekstu podglądu lub nagłówka, osobisty kupon w e-mailu do sprzedawcy. Kliknięcie pozycji zaznacza odpowiedni blok.

Historia

Każdy zapis zachowuje wersję, do 20 na e-mail. Przywróć wczytuje wersję do edytora; zapisz, aby ją zachować. To samo okno oferuje Eksportuj ten projekt i Usuń projekt.

Udostępnianie i kopiowanie

• Użyj tego bloku we wszystkich moich e-mailach, na dole ustawień bloku: zastępuje blok tego samego typu we wszystkich pozostałych zaprojektowanych e-mailach. Brakujący nagłówek lub stopka zostaje dodana. Wygodne, aby zmienić stopkę tylko raz.
• Zastosuj te kolory i czcionki do wszystkich moich e-maili, na górze zakładki E-mail: przenosi kolory, czcionki, szerokość i marginesy bez zmiany tematów i tekstów podglądu.
• Zacznij od stylu > Skopiuj projekt innego e-maila: przejmuje bloki i kolory już zaprojektowanego e-maila, zachowując temat i tekst podglądu bieżącego e-maila.

Osobisty kupon

Ten blok pokazuje kod rabatowy przypisany do klienta. Ustawienia: tytuł, tekst, tekst nad kodem, przycisk i jego link, rodzaj rabatu (procent, stała kwota lub darmowa wysyłka), wartość, ważność od 1 do 365 dni, minimalna kwota zamówienia i prefiks kodu (np. DZIEKI daje DZIEKI-K7P2M9QX). W tekstach {voucher_value} pokazuje wartość rabatu, a {voucher_expiry} datę końca ważności.

• Kod powstaje przy faktycznej wysyłce e-maila jako reguła koszyka przypisana do klienta i jednorazowa.
• Jeśli ten sam e-mail zostanie wysłany ponownie dla tego samego zamówienia, np. z karty zamówienia, używany jest już utworzony kod.
• Podglądy i e-maile testowe pokazują kod przykładowy i niczego nie tworzą.
• Kupon pojawia się tylko wtedy, gdy odbiorcą jest klient: nigdy w powiadomieniu o nowym zamówieniu wysyłanym do sprzedawcy.

Utworzone reguły mają opis dfmaileditor: nazwa_szablonu w Katalog > Rabaty > Reguły koszyka.

Banery promocyjne

Zakładka Banery promocyjne zarządza banerami wielokrotnego użytku. Każdy baner ma nazwę wewnętrzną, status, opcjonalne daty początku i końca, kolor tła obszaru tekstu i listę wybranych e-maili (wszystkie lub wybrane). Dla każdego języka: obraz (JPG, PNG lub GIF, zalecana szerokość 1200 px, maks. 3 MB), link, tekst alternatywny, nagłówek, tekst i kod rabatowy do wyświetlenia.

W e-mailu blok Baner promocyjny pokazuje pierwszy aktywny baner przypisany do tego e-maila (tryb automatyczny, według kolejności na liście) albo wybrany baner. Zaplanowany baner pojawia się i znika samodzielnie według dat.

Ustawienia

• Używaj zaprojektowanych e-maili: przełącznik główny. Po wyłączeniu wszystkie e-maile wracają do formatu natywnego, projekty są zachowane.
• Ceny brutto w blokach produktów: ceny jednostkowe i sumy pozycji brutto lub netto.
• Kolor marki: używany przez gotowe style, gdy opcja jest zaznaczona.
• Rozmiar obrazu w pozycjach zamówienia i w polecanych produktach, spośród formatów zdjęć produktów sklepu.
• Linki społecznościowe: linki wyświetlane przez blok Linki społecznościowe jako przyciski tekstowe. Puste pole ukrywa sieć.
• Śledzenie linków: dodaje utm_source, utm_medium i utm_campaign (nazwa szablonu) tylko do linków prowadzących do sklepu.

Eksport i import

Eksportuj na liście pobiera plik ZIP ze wszystkimi projektami sklepu i obrazami przesłanymi przez moduł; historia e-maila oferuje eksport tylko tego projektu. Bez rozszerzenia PHP ZipArchive eksport ma postać pliku JSON bez obrazów.

Importuj przyjmuje taki ZIP lub JSON. Obrazy są sprawdzane (tylko prawdziwe JPG, PNG lub GIF) i kopiowane do img/dfmaileditor. Opcje: zastąp istniejące projekty, zachowaj aktywne projekty, które były aktywne w eksporcie. Bez tych pól już zaprojektowane e-maile są pomijane, a nowe projekty trafiają jako nieaktywne. Banery nie są częścią eksportu.

Rozwiązywanie problemów

E-mail nadal wychodzi w formacie natywnym

Sprawdź, czy projekt jest aktywny na liście i czy główny przełącznik w Ustawieniach jest włączony. Jeśli e-mail jest wywoływany z panelu (zmiana statusu zamówienia), PrestaShop pomija hooki modułu, gdy profil zalogowanego pracownika nie ma uprawnienia Widok do tego modułu: nadaj je w Zaawansowane > Zespół > Uprawnienia > Moduły. Na koniec zajrzyj do Zaawansowane > Logi: błąd renderowania jest tam zapisany z prefiksem [dfmaileditor].

Klient nie widzi obrazów

Obrazy są ładowane z publicznego adresu sklepu: nie wyświetlą się ze sklepu lokalnego ani chronionego hasłem. Część programów pocztowych blokuje obrazy, dopóki odbiorca ich nie zezwoli; wtedy widać tekst alternatywny.

Gmail pokazuje „Wiadomość została obcięta”

E-mail przekracza 102 KB. Usuń bloki, zwłaszcza obszerny własny HTML, albo pokaż mniej polecanych produktów. Przycisk Kontrola podaje dokładną wagę.

Kupon się nie pojawia

W edytorze i w testach wyświetla się kod przykładowy. Przy faktycznej wysyłce kupon pojawia się tylko dla jednego odbiorcy, który jest klientem zamówienia, lub dla istniejącego klienta w e-mailach dotyczących konta.

Dwie listy produktów w e-mailu

Inny moduł dodaje do e-maili własne pozycje produktów. Wyłącz go dla zaprojektowanych e-maili: blok Zamówione produkty już pokazuje zdjęcia.