# Numer śledzenia w e-mailu Wysłane: kompletny przewodnik > Przegląd Moduł Numer śledzenia w e-mailu Wysłane dodaje blok Śledź swoją paczkę do e-maila „Wysłane” w PrestaShop: przewoźnika, numer śledzenia i przycisk otwierający stronę śledzenia przewoźnika. Blok jest napisany w… - Strona: - Język: pl - Zaktualizowano: 2026-11-03 - Inne języki: [en](https://www.datafirefly.com/en/documentation/dftrackingmail/index.md), [fr](https://www.datafirefly.com/documentation/dftrackingmail/index.md), [es](https://www.datafirefly.com/es/documentation/dftrackingmail/index.md), [de](https://www.datafirefly.com/de/documentation/dftrackingmail/index.md), [it](https://www.datafirefly.com/it/documentation/dftrackingmail/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftrackingmail/index.md), [pt](https://www.datafirefly.com/pt/documentation/dftrackingmail/index.md) - Indeks: ## Przegląd Moduł Numer śledzenia w e-mailu Wysłane dodaje blok **Śledź swoją paczkę** do e-maila „Wysłane” w PrestaShop: przewoźnika, numer śledzenia i przycisk otwierający stronę śledzenia przewoźnika. Blok jest napisany w języku zamówienia i wstawiany podczas wysyłania e-maila: Twoje szablony e-mail nigdy nie są modyfikowane. Moduł może też **wstrzymać e-mail „Wysłane”**, gdy zamówienie zostanie oznaczone jako wysłane przed wprowadzeniem numeru śledzenia, i wysłać go, gdy tylko numer zostanie zapisany. Wyświetla kartę śledzenia na koncie klienta oraz oferuje podgląd na żywo, testowy e-mail, kolejkę i dziennik aktywności. Działa w PrestaShop od 1.7.8 do 9.x z PHP od 7.1 do 8.5, z motywami Classic, Hummingbird i ich motywami potomnymi. Panel administracyjny i domyślne teksty są dostępne w językach: angielskim, francuskim, hiszpańskim, niemieckim, włoskim, polskim, niderlandzkim i portugalskim. ![Przegląd modułu Numer przesyłki w e-mailu Wysłane: statystyki, pierwsze kroki i ostatnia aktywność](https://www.datafirefly.com/wp-content/uploads/2026/11/przeglad-numer-przesylki-email-wyslane-dftrackingmail-pl.webp) Zakładka Przegląd: status, wskaźniki z ostatnich 30 dni, lista pierwszych kroków i ostatnia aktywność. ## Instalacja i aktualizacja 1. W **Moduły > Menedżer modułów** kliknij **Załaduj moduł** i upuść plik `dftrackingmail-2.0.0.zip`. 2. Kliknij **Konfiguruj**. Moduł jest już aktywny dla e-maila „Wysłane”, z domyślnymi tekstami we wszystkich zainstalowanych językach. Wiadomość powitalna wymienia trzy punkty do sprawdzenia: linki śledzenia Twoich przewoźników, kolory bloku i testowy e-mail. **Aktualizacja z wersji 1.0:** załaduj nowy plik zip na stary. Twoje ustawienia, teksty, kolory, linki przewoźników i wstrzymane e-maile zostają zachowane. Karta na koncie klienta jest początkowo wyłączona, więc w Twoim sklepie nic się nie zmienia, dopóki jej nie włączysz. ## Ustawienia ### Aktywacja - **Dodawaj dane śledzenia do e-maili**: po wyłączeniu każdy e-mail jest wysyłany dokładnie tak, jak tworzy go PrestaShop. - **Pokazuj kartę śledzenia na koncie klienta**: na stronie szczegółów zamówienia i na stronie śledzenia dla gości. ### E-maile pokazujące numer śledzenia Domyślny status „Wysłane” wysyła e-mail `shipped`, który jest wybrany domyślnie. Każdy status zamówienia wysyłający e-mail jest wymieniony wraz ze swoim szablonem, więc możesz dodać własne statusy lub e-mail `in_transit`. ### Dane i prywatność Wybierz, jak długo przechowywać dziennik aktywności i wysłane e-maile (domyślnie 90 dni). Kopia wstrzymanego e-maila jest usuwana zaraz po jego wysłaniu lub anulowaniu. Dzięki oficjalnemu modułowi RODO dane klientów są eksportowane i usuwane wraz z resztą konta. ![Ustawienia: e-maile z numerem przesyłki, karta na koncie klienta i wstrzymanie do wpisania numeru](https://www.datafirefly.com/wp-content/uploads/2026/11/ustawienia-wstrzymanie-emaila-wyslane-dftrackingmail-pl.webp) Zakładka Ustawienia: aktywacja, objęte e-maile, wstrzymywanie e-maila i przechowywanie danych. ## Wstrzymywanie e-maila do czasu wprowadzenia numeru śledzenia Jeśli zmienisz status na „Wysłane” przed wydrukowaniem etykiety, domyślny e-mail zostanie wysłany bez żadnego numeru. Włącz **Wstrzymaj e-mail**: e-mail „Wysłane” czeka wtedy w kolejce i zostaje wysłany, gdy tylko numer śledzenia zostanie zapisany na stronie zamówienia lub przez moduł przewoźnika. - **Mimo to wyślij po**: po tym czasie e-mail zostanie wysłany bez numeru (lub z komunikatem oczekiwania); domyślnie jest to 48 godzin. - **E-mail W drodze**: PrestaShop wysyła go po wprowadzeniu numeru śledzenia. Domyślnie jest pomijany, gdy wstrzymany e-mail „Wysłane” został właśnie wysłany, więc klient otrzymuje jeden kompletny e-mail zamiast dwóch. - Wstrzymywane są tylko e-maile przewoźników z zaznaczoną opcją **Oczekiwany numer śledzenia** w zakładce Przewoźnicy. Odbiór w sklepie i inni przewoźnicy bez śledzenia nigdy nie są wstrzymywani. Na stronie zamówienia karta pokazuje numery, które zobaczy klient, stan wstrzymanego e-maila i dwie akcje: **Wyślij teraz bez numeru śledzenia** i **Nie wysyłaj**. ![Strona zamówienia w panelu: e-mail Wysłane wstrzymany do wpisania numeru przesyłki](https://www.datafirefly.com/wp-content/uploads/2026/11/strona-zamowienia-email-wstrzymany-dftrackingmail-pl.webp) Strona zamówienia: e-mail „Wysłane” jest wstrzymany do czasu wprowadzenia numeru śledzenia. ### Zadanie cron Zadanie cron jest potrzebne tylko przy włączonym wstrzymywaniu. Uruchamiaj je co 15 minut: wysyła wstrzymane e-maile, których numer zapisał moduł przewoźnika lub dla których upłynął limit czasu, i usuwa stare wpisy. Skopiuj URL z zakładki Ustawienia (działa w trybie konserwacji) lub użyj wiersza poleceń: ``` php /path/to/prestashop/modules/dftrackingmail/cli/process-queue.php ``` **Wygeneruj nowy URL** unieważnia poprzedni. ## E-mail i teksty ### Pozycja w e-mailu - **Po numerze referencyjnym zamówienia** (zalecane): zaraz po zdaniu podającym numer referencyjny zamówienia. - **Zaraz po powitaniu**: widoczny jako pierwszy. - **Ręcznie**: blok pojawia się tylko tam, gdzie Twój szablon zawiera `{df_tracking_block}`. ### Styl i kolory Wybierz styl (karta, pasek akcentu lub minimalny), a następnie kolory tła, obramowania, przycisku i tekstu przycisku. Kontrast przycisku jest sprawdzany na żywo: poniżej 4,5:1 tekst jest słabo czytelny i wyświetlane jest ostrzeżenie. ### Zawartość i teksty Pokaż lub ukryj nazwę przewoźnika i przycisk śledzenia oraz wybierz, co się dzieje, gdy zamówienie nie ma jeszcze numeru śledzenia: ukrycie bloku lub wyświetlenie komunikatu oczekiwania. Teksty edytuje się osobno dla każdego języka: tytuł, wstęp, etykiety przewoźnika i numeru, tekst przycisku, komunikat oczekiwania i etykieta paczki. Wstęp akceptuje `{firstname}`, `{lastname}`, `{order_name}`, `{carrier_name}` i `{tracking_number}`; etykieta paczki akceptuje `{n}` i `{total}`. Podgląd na żywo po prawej stronie odzwierciedla zmiany jeszcze przed zapisaniem, w języku wybranym dla tekstów, na komputerze lub telefonie. ![Edytor bloku śledzenia: położenie, styl, kolory, teksty w każdym języku i podgląd e-maila na żywo](https://www.datafirefly.com/wp-content/uploads/2026/11/edytor-bloku-sledzenia-podglad-dftrackingmail-pl.webp) Zakładka E-mail i teksty z podglądem na żywo. ## Przewoźnicy i linki śledzenia Przycisk śledzenia używa URL śledzenia ustawionego w **Wysyłka > Przewoźnicy**. Wypełnij pole przewoźnika, aby zastąpić go tylko w e-mailach. Wstaw `{tracking_number}` (lub `@`, składnia PrestaShop) w miejscu numeru; `{postcode}` i `{country_iso}` są uzupełniane na podstawie adresu dostawy dla przewoźników, którzy ich wymagają. - Podpowiedź pojawia się, gdy nazwa przewoźnika zostanie rozpoznana; **Inni przewoźnicy** zawiera 21 linków śledzenia (Colissimo, Chronopost, Mondial Relay, DPD, GLS, UPS, FedEx, DHL, PostNL, bpost, Correos, SEUR, CTT, Poste Italiane, BRT, InPost, Poczta Polska, Royal Mail, USPS, 17TRACK). - **Test** otwiera link z przykładowym numerem. - **Oczekiwany numer śledzenia**: odznacz przewoźników, którzy nigdy nie mają numeru. Ich e-mail nigdy nie jest wstrzymywany i nie są liczeni jako przewoźnicy bez linku. Przetestuj każdy link raz z prawdziwym numerem: przewoźnicy czasem zmieniają adres swojej strony śledzenia. ![Linki śledzenia przewoźników z podpowiedziami, przyciskiem testu i ustawieniem oczekiwanego numeru przesyłki](https://www.datafirefly.com/wp-content/uploads/2026/11/linki-sledzenia-przewoznikow-dftrackingmail-pl.webp) Przewoźnicy, linki śledzenia, podpowiedzi i przycisk Test. ## Podgląd i test Zakładka Podgląd i test pokazuje cały e-mail, utworzony z szablonów Twojego sklepu: z fikcyjnymi danymi przykładowymi (jedna paczka, dwie paczki lub brak numeru śledzenia) albo z ostatnim zamówieniem. Wybierz język i e-mail, a następnie przełączaj się między wersją HTML, wersją tekstową i widokiem na telefonie. **Wyślij testowy e-mail** wysyła wybrany e-mail na podany adres, z **[Test]** w temacie. Klient nic nie otrzymuje. Test używa zapisanych ustawień. ![Pełny podgląd e-maila Wysłane dla prawdziwego zamówienia i wysłany e-mail testowy](https://www.datafirefly.com/wp-content/uploads/2026/11/podglad-emaila-wyslane-test-dftrackingmail-pl.webp) Podgląd e-maila „Wysłane” dla prawdziwego zamówienia i wysłany testowy e-mail. ## Co otrzymują Twoi klienci Blok pokazuje przewoźnika, numer śledzenia zapisany czytelną czcionką i przycisk śledzenia. Gdy zamówienie ma kilka paczek, każda jest numerowana i ma własny przycisk. Wersja tekstowa e-maila zawiera te same informacje. ![E-mail Wysłane z przewoźnikiem, numerem przesyłki i przyciskiem śledzenia](https://www.datafirefly.com/wp-content/uploads/2026/11/email-wyslane-numer-przesylki-dftrackingmail-pl.webp) E-mail „Wysłane” z blokiem śledzenia. ![E-mail Wysłane na telefonie z dwiema paczkami i dwoma przyciskami śledzenia](https://www.datafirefly.com/wp-content/uploads/2026/11/email-wyslane-telefon-kilka-paczek-dftrackingmail-pl.webp) Na telefonie, z dwiema paczkami. ## Konto klienta Gdy opcja jest włączona, strona szczegółów zamówienia i strona śledzenia dla gości pokazują kartę śledzenia z przewoźnikiem, numerem, przyciskiem **Kopiuj** i przyciskiem śledzenia. Karta używa tekstów bloku i dopasowuje się do motywów Classic, Hummingbird i ich motywów potomnych. ![Karta śledzenia paczki na koncie klienta z przyciskiem kopiowania i przyciskiem śledzenia](https://www.datafirefly.com/wp-content/uploads/2026/11/konto-klienta-sledzenie-paczki-dftrackingmail-pl.webp) Karta śledzenia na stronie szczegółów zamówienia. ![Karta śledzenia paczki na koncie klienta na telefonie](https://www.datafirefly.com/wp-content/uploads/2026/11/konto-klienta-sledzenie-paczki-telefon-dftrackingmail-pl.webp) Ta sama karta na telefonie. ## Kolejka i aktywność Zakładka **Kolejka i aktywność** zawiera listę wstrzymanych e-maili z filtrami według statusu (wstrzymane, wysłane, nieudane, anulowane). **Wyślij teraz** i **Nie wysyłaj** działają na pojedynczy e-mail; **Przetwórz kolejkę teraz** od razu uruchamia zadanie cron. Nieudany e-mail jest automatycznie ponawiany trzy razy, a przyczyna błędu jest wyświetlana. Dziennik aktywności rejestruje każdy e-mail: dodano numer śledzenia, wysłany bez numeru, wstrzymany, wysłano wstrzymany e-mail, pominięto e-mail W drodze, testowy e-mail. ![Kolejka e-maili wstrzymanych do wpisania numeru przesyłki i dziennik aktywności](https://www.datafirefly.com/wp-content/uploads/2026/11/kolejka-wstrzymanych-emaili-aktywnosc-dftrackingmail-pl-scaled.webp) Wstrzymane e-maile i dziennik aktywności. ## Pozycja ręczna i zmienne Przy pozycji ręcznej dodaj te zmienne do szablonu e-mail (Wygląd > Motyw e-mail, folder mails Twojego motywu lub moduł edytora e-maili): - `{df_tracking_block}`: cały blok, wersja HTML. - `{df_tracking_block_txt}`: cały blok, wersja tekstowa. - `{df_tracking_number}`: numery śledzenia, oddzielone przecinkami. - `{df_tracking_url}`: link śledzenia pierwszej paczki. - `{df_carrier_name}`: nazwy przewoźników. ![Pomoc: działanie, zmienne do ręcznego położenia i najczęstsze pytania](https://www.datafirefly.com/wp-content/uploads/2026/11/pomoc-zmienne-faq-dftrackingmail-pl.webp) Zakładka Pomoc: jak to działa, zmienne i najczęściej zadawane pytania. ## Rozwiązywanie problemów ### Klient otrzymał e-mail bez numeru śledzenia Zamówienie otrzymało status „Wysłane” przed wprowadzeniem numeru. Włącz wstrzymywanie w zakładce Ustawienia. Tabela Aktywność pokazuje każdy e-mail z numerem lub bez. ### Przycisk śledzenia się nie pojawia Przewoźnik nie ma użytecznego linku śledzenia. Otwórz zakładkę Przewoźnicy, użyj podpowiedzi lub wklej link przewoźnika, a następnie kliknij **Test**. ### Wstrzymane e-maile nie są wysyłane Numer został zapisany przez moduł przewoźnika lub upłynął limit czasu, ale zadanie cron nie działa. Zakładka Przegląd wyświetla ostrzeżenie, gdy nie było ono uruchamiane od ponad 2 godzin. Skonfiguruj je za pomocą URL lub wiersza poleceń albo kliknij **Przetwórz kolejkę teraz**. ### E-mail jest w niewłaściwym języku E-mail używa języka zamówienia. Jeśli PrestaShop nie ma szablonu w tym języku, wysyła wersję w języku domyślnym: podgląd informuje, która wersja jest używana.