# 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… - Strona: - Język: pl - Zaktualizowano: 2026-10-09 - Inne języki: [fr](https://www.datafirefly.com/documentation/dfmaileditor/index.md), [en](https://www.datafirefly.com/en/documentation/dfmaileditor/index.md), [es](https://www.datafirefly.com/es/documentation/dfmaileditor/index.md), [de](https://www.datafirefly.com/de/documentation/dfmaileditor/index.md), [it](https://www.datafirefly.com/it/documentation/dfmaileditor/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfmaileditor/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfmaileditor/index.md) - Indeks: ## 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. Moduł działa na PrestaShop od 8.0 do 9.x, w trybie multistore (projekty dla każdego sklepu) i w wielu językach, także pisanych od prawej do lewej. Nie wymaga zależności Composer. ## 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, portugalskiego i słowackiego; 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. Blok można też upuścić bezpośrednio na podgląd: zielona linia pokazuje, gdzie zostanie wstawiony. Bloki ze struktury przenosi się tak samo, a kolumna i podgląd przewijają się same, gdy kursor zbliża się do ich krawędzi. - **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.