PS PrestaShop Średnio zaawansowany

Prosty i Elegancki Checkout (dfsimplecheckout) — Kompletny przewodnik

Instalacja, konfiguracja i eksploatacja checkoutu one-page: kolory, logo, tryb bez rozpraszaczy, logowanie Google i Facebook, Google Places, formularz adresu per kraj, kod rabatowy AJAX i rozwiązywanie problemów dla PrestaShop 8 i 9.

Zaktualizowano Wersja modułu 1.3.2

Prezentacja

DataFirefly Simple Checkout zastępuje natywny, 5-etapowy checkout PrestaShop nowoczesnym tunelem zakupowym one-page, inspirowanym checkoutami Shopify i Stripe. Moduł montuje swój kontroler w czasie działania przez hook actionDispatcher — żaden plik override nie jest zapisywany na dysku, a istniejące zewnętrzne override’y na OrderController są czysto dziedziczone.

Główne funkcje: układ dwukolumnowy ze stałym podsumowaniem, logowanie społecznościowe Google i Facebook, autouzupełnianie adresu Google Places, adaptacyjny formularz adresu per kraj, kod rabatowy AJAX, pięć konfigurowalnych kolorów, tryb bez rozpraszaczy.

Proces zamówienia PrestaShop na jednej stronie: dane osobowe, adresy, dostawa i płatność
Proces zamówienia PrestaShop na jednej stronie: dane osobowe, adresy, dostawa i płatność
Zamówienie na jednej stronie na smartfonie ze zwijanym podsumowaniem
Zamówienie na jednej stronie na smartfonie ze zwijanym podsumowaniem
Rozwinięte podsumowanie zamówienia na smartfonie z produktami, kodem rabatowym i sumą
Rozwinięte podsumowanie zamówienia na smartfonie z produktami, kodem rabatowym i sumą

Instalacja

  1. W back-office PrestaShop przejdź do Moduły → Menedżer modułów → Zainstaluj moduł.
  2. Wybierz plik dfsimplecheckout-1.3.2.zip pobrany z Twojego konta DataFirefly.
  3. Kliknij Zainstaluj, a potem Konfiguruj.
  4. Wyczyść cache PrestaShop (Zaawansowane → Wydajność → Wyczyść cache).
  5. Odwiedź stronę /order sklepu z produktem w koszyku: nowy checkout wyświetla się natychmiast.

Moduł jest kompatybilny z PrestaShop 8.0 → 9.x. Żadna modyfikacja motywu nie jest wymagana. Odinstalowanie automatycznie przywraca natywny checkout.

Nowości w wersji 1.3.2 (05.11.2026): zintegrowany formularz karty Mollie (Mollie Components) obsługuje płatność bezpośrednio w checkoucie, bez przekierowania na stronę płatności Mollie; opcje „Zapisz kartę” i „Użyj zapisanej karty” są przekazywane. Aktualizacja: zainstaluj nowy plik zip na wersję 1.3.1, ustawienia zostaną zachowane.

Nowości w wersji 1.3.1 (30.10.2026): przy przewoźniku z punktami odbioru (punkty odbioru Colissimo i inne) etap dostawy pozostaje otwarty, a płatność zablokowana, dopóki nie wybrano punktu odbioru; blok Express checkout Mollie (Apple Pay, Google Pay, PayPal) pojawia się na górze etapu płatności; dwa nowe kolory (tło checkoutu, tło bloków); koszt pakowania na prezent widoczny obok pola wyboru; poprawione odstępy w motywach własnych (pola wyboru, tytuły etapów, przycisk wyboru punktu odbioru). Aktualizacja: zainstaluj nowy plik zip na wersji 1.3.0, ustawienia zostaną zachowane.

Nowości w wersji 1.3.0 (29.10.2026): zgodność z PrestaShop 9.1 (proces zamówienia przestał się wyświetlać), kody rabatowe znowu działają w PrestaShop 9, pole Stan/Prowincja dla USA, Hiszpanii, Włoch, Kanady…, wpisane dane zachowane przy zmianie kraju, ochrona przed podwójnym kliknięciem „Zamawiam i płacę”, kwota płatności aktualizowana po użyciu kodu rabatowego, czytelne komunikaty przy braku połączenia lub wygaśnięciu sesji, zachowane pakowanie na prezent, interfejs w 8 językach (FR, EN, ES, DE, IT, PT, PL, NL). Sprawdzono na PrestaShop 8.2.1 (motyw Classic) i 9.1.5 (motyw Hummingbird). Aktualizacja: zainstaluj nowy plik zip na poprzedniej wersji, ustawienia zostaną zachowane.

Konfiguracja ogólna

Kolory

W zakładce ustawień modułu konfigurowanych jest pięć kolorów:

  • Kolor główny — przyciski, linki, stany aktywne, zaznaczone radio (domyślnie #1a73e8).
  • Kolor hover przycisków — stan najechania na przyciski główne „Kontynuuj”, „Zamów” (domyślnie #1559b8).
  • Kolor akcentu / sukcesu — wskaźniki ukończonego kroku, plakietka zastosowanego kodu rabatowego, etykieta „Gratis” przewoźnika, komunikaty sukcesu (domyślnie #008060).
  • Kolor tła procesu zamówienia — tło strony za etapami i podsumowaniem (domyślnie #fafbfb, bardzo jasnoszary). Obejmuje całą szerokość strony, łącznie z kontenerem motywu.
  • Kolor tła bloków — tło bloków etapów, podsumowania zamówienia i paska nagłówka (domyślnie #ffffff, biały).

Pięć wartości jest wstrzykiwanych jako zmienne CSS (--dfsc-primary, --dfsc-primary-hover, --dfsc-success, --dfsc-page-bg, --dfsc-bg) i walidowanych ścisłym regexem szesnastkowym: nieprawidłowa wartość jest zastępowana kolorem domyślnym.

Podaj URL własnego logo do nagłówka checkoutu; w przeciwnym razie używane jest logo sklepu. Renderowane wymiary: maksymalnie 190×42 px.

Tryb bez rozpraszaczy

Opcja Ukryj nagłówek i stopkę motywu (domyślnie włączona) usuwa kompletny nagłówek motywu (menu, wyszukiwarka, koszyk) i jego stopkę wyłącznie na stronie /order. Implementacja nadpisuje bloki Smarty header i footer w naszym szablonie: na motywie, który nie używa tych standardowych bloków, opcja po prostu nie działa — nigdy nie powoduje pustej strony.

Pozostałe opcje

  • Pole notatki dla sprzedawcy (wł/wył)
  • Pole kodu rabatowego (wł/wył)
  • Pakowanie na prezent: gdy opcja jest włączona w PrestaShop, koszt pojawia się obok pola wyboru (brutto lub netto zależnie od sklepu), a pozycja „Pakowanie na prezent” jest widoczna w podsumowaniu
  • Znaczki zaufania — dowolny HTML wyświetlany pod podsumowaniem
  • Linki prawne w stopce checkoutu (regulamin, prywatność, zwroty — wykrywane przez natywne role CMS)
Ustawienia modułu w panelu PrestaShop: kolory, logo, płatność ekspresowa, notatki, kod rabatowy i adres do faktury
Ustawienia modułu w panelu PrestaShop: kolory, logo, płatność ekspresowa, notatki, kod rabatowy i adres do faktury

Logowanie społecznościowe Google

Tworzenie danych uwierzytelniających

  1. Wejdź na Google Cloud Console i utwórz (lub wybierz) projekt.
  2. W APIs & Services → Credentials utwórz OAuth client ID typu Web application.
  3. W Authorized JavaScript origins dodaj URL swojego sklepu (np. https://www.twojsklep.pl) — bez ścieżki, z protokołem https.
  4. Skopiuj wygenerowany Client ID (kończy się na .apps.googleusercontent.com).

Konfiguracja modułu

  1. W ustawieniach modułu włącz Google Sign-In i wklej Client ID.
  2. Zapisz, a potem wyczyść cache.
  3. Na /order przycisk Google pojawia się nad zakładkami „Jestem nowym klientem / Mam już konto”.

Przebieg: klient klika, wybiera swoje konto Google, moduł otrzymuje token JWT i waliduje go po stronie serwera przez oficjalny endpoint tokeninfo (weryfikacja audience, wystawcy, daty ważności i zweryfikowanego e-maila). Jeśli konto klienta z tym e-mailem istnieje, następuje zalogowanie; w przeciwnym razie konto tworzone jest automatycznie z imieniem i nazwiskiem z profilu Google.

Logowanie społecznościowe Facebook

Tworzenie aplikacji

  1. Na Meta for Developers utwórz aplikację typu Consumer.
  2. Dodaj produkt Facebook Login i zadeklaruj swoją domenę w ustawieniach.
  3. Pobierz App ID i App Secret z Settings → Basic.

Konfiguracja modułu

Włącz Facebook Login w ustawieniach, wklej App ID i App Secret, zapisz. Walidacja serwerowa jest dwuetapowa: debug_token (sprawdza, czy token faktycznie należy do Twojej aplikacji), a następnie pobranie profilu z podpisem appsecret_proof (HMAC-SHA256). App Secret nigdy nie opuszcza Twojego serwera.

Autouzupełnianie adresu Google Places

  1. W Google Cloud Console aktywuj API Places API i Maps JavaScript API.
  2. Utwórz klucz API i ogranicz go do swojej domeny (zalecane).
  3. W module włącz Autouzupełnianie adresu i wklej klucz.

Pole „Adres” formularza podpowiada wtedy sugestie podczas pisania. Wybór sugestii wypełnia ulicę, dodatek do adresu, miasto, kod pocztowy, kraj i region, jeśli dotyczy. Sugestie są ograniczone do aktywnych krajów sklepu (do 5 krajów — limit API Google).

API Places jest płatne przez Google powyżej miesięcznego darmowego limitu. Dla sklepu o umiarkowanym wolumenie darmowy limit zwykle wystarcza.

Adaptacyjny formularz adresu per kraj

Formularz adresu dostosowuje się automatycznie do wybranego kraju:

  • Domyślny kraj dropdownu to ten skonfigurowany w Międzynarodowy → Lokalizacja back-office (a nie pierwszy kraj alfabetycznie).
  • Pole Stan/Region pojawia się tylko dla krajów, które je mają (USA, Hiszpania, Włochy…), a jego dropdown zawiera wyłącznie aktywne regiony wybranego kraju.
  • Pole DNI pojawia się dla krajów, które go wymagają (Hiszpania).
  • Walidacja kodu pocztowego używa formatu kraju.
  • Po zmianie kraju strona przeładowuje się z formularzem przebudowanym pod nowy kraj.

Edycja adresu

Każdy zapisany adres ma ikonę ołówka. Kliknięcie otwiera formularz inline wstępnie wypełniony wszystkimi wartościami adresu (ładowanymi po stronie serwera z kontrolą własności — klient nigdy nie może podejrzeć adresu innego klienta). Zapis aktualizuje istniejący adres, bez tworzenia duplikatu.

Wybór zapisanego adresu dostawy w formie kart, z edycją i osobnym adresem do faktury
Wybór zapisanego adresu dostawy w formie kart, z edycją i osobnym adresem do faktury
Formularz adresu w zamówieniu z polem Stan i błędem kodu pocztowego wyświetlanym pod polem
Formularz adresu w zamówieniu z polem Stan i błędem kodu pocztowego wyświetlanym pod polem

Kod rabatowy

Pole kodu rabatowego (opcjonalne) działa w AJAX: dodawanie i usuwanie bez przeładowania, natychmiastowa aktualizacja podsumowania. Kod jest sprawdzany według dokładnie tych samych reguł co w natywnym koszyku PrestaShop (CartRule::checkValidity): daty, kwota minimalna, ograniczenia przewoźnika, kraju lub grupy, łączenie rabatów. Natywne komunikaty błędów („Ten kod wygasł”, „Nie osiągnięto kwoty minimalnej”…) są zwracane bez zmian.

Kod rabatowy zastosowany bez przeładowania, zaktualizowane podsumowanie i kwota płatności
Kod rabatowy zastosowany bez przeładowania, zaktualizowane podsumowanie i kwota płatności

Kompatybilność z przewoźnikami i Colissimo

Dodatkowa zawartość przewoźników (mapa punktów odbioru Colissimo, widget Mondial Relay…) jest renderowana przez {$carrier.extraContent} jak w natywnym szablonie. Etap dostawy jest zatwierdzany dopiero wtedy, gdy akceptuje go moduł przewoźnika, dokładnie jak w natywnym checkoucie (hook actionValidateStepComplete).

  • Nie wybrano punktu odbioru (Colissimo Points Relais, Mondial Relay…): etap dostawy pozostaje otwarty z przyciskiem wyboru punktu, a etap płatności jest zablokowany. Komunikat przewoźnika pojawia się tylko wtedy, gdy klient kliknie „Przejdź do płatności” bez wybranego punktu.
  • Punkt wybrany: płatność się otwiera i pozostaje otwarta po przeładowaniu strony. W przypadku Colissimo zapisany punkt jest odczytywany automatycznie (identyfikator i telefon komórkowy): klient nie musi wybierać go ponownie.
  • Zmiana przewoźnika: jeśli klient przejdzie od zwykłego przewoźnika do punktu odbioru, etap dostawy otwiera się ponownie, dopóki punkt nie zostanie wybrany.
Wybór przewoźnika w zamówieniu na jednej stronie z czasem i kosztem dostawy
Wybór przewoźnika w zamówieniu na jednej stronie z czasem i kosztem dostawy
Zamówienie na jednej stronie z prezentem gratis (DF Free Gift) i ofertą 3+1 (DF Quantity Deal) w podsumowaniu
Zamówienie na jednej stronie z prezentem gratis (DF Free Gift) i ofertą 3+1 (DF Quantity Deal) w podsumowaniu
Strona potwierdzenia zamówienia PrestaShop po płatności czekiem
Strona potwierdzenia zamówienia PrestaShop po płatności czekiem

Płatność ekspresowa Mollie (Apple Pay, Google Pay, PayPal)

Od wersji 1.3.1 moduł renderuje natywne hooki etapu płatności. Blok Express checkout modułu Mollie (Express Component: Apple Pay, Google Pay, PayPal) pojawia się więc na górze etapu płatności, nad metodami płatności. Jego przyciski pozostają zablokowane do czasu zaznaczenia regulaminu, a następnie Mollie sprawdza koszyk przed płatnością.

  • Włącz blok w module Mollie (ustawienia Express checkout). Mollie wyświetla go tylko w trybie live, a Apple Pay pojawia się tylko w Safari (iPhone, iPad, Mac) z domeną zweryfikowaną w Mollie.
  • Przyciski Apple Pay Direct Mollie na karcie produktu i w koszyku nie przechodzą przez checkout: działają bez zmian.

Zintegrowany formularz karty Mollie

Gdy w Mollie włączona jest opcja zintegrowanego formularza karty w zamówieniu (Mollie Components), pola karty wyświetlają się na etapie płatności, a płatność kartą odbywa się bezpośrednio w checkoucie: po kliknięciu „Zamawiam i płacę” Mollie tworzy bezpieczny token karty i wysyła go razem z zamówieniem, bez przekierowania na hostowaną stronę płatności Mollie.

  • Działa też płatność jednym kliknięciem Mollie: opcje „Zapisz kartę” i „Użyj zapisanej karty” są przekazywane do Mollie.
  • Wymagana jest wersja 1.3.2 modułu: przed tą poprawką klient był przekierowywany na stronę płatności Mollie i musiał ponownie wpisać dane karty.

Hooki deweloperskie

  • displayDfsimplecheckoutExpress — slot u góry checkoutu na płatności ekspresowe (Apple Pay, Google Pay, PayPal Express).
  • displayDfsimplecheckoutSidebarTop / displayDfsimplecheckoutSidebarBottom — strefy wstrzykiwania w kolumnie podsumowania.
  • actionDfscSocialLogin — wyzwalany po udanym logowaniu społecznościowym, z parametrami customer i dfsc_social_provider (google lub facebook). Przydatny do tagowania CRM.
  • Natywne hooki procesu zamówienia, renderowane w tym samym miejscu co w natywnych szablonach (1.3.1): displayPaymentTop (góra etapu płatności), displayCheckoutBeforeConfirmation (między regulaminem a „Zamawiam i płacę”), displayBeforeCarrier i displayAfterCarrier (przed listą przewoźników i po niej).

Rozwiązywanie problemów

Przycisk Google się nie wyświetla

  • Sprawdź, czy Client ID jest wpisany i opcja włączona.
  • Sprawdź w konsoli przeglądarki, czy nie ma błędu „origin not allowed” — w takim przypadku dodaj dokładny URL sklepu (z https, bez końcowego slasha) do Authorized JavaScript origins w Google Cloud Console.

Logowanie społecznościowe się nie utrzymuje

Wyczyść cache PrestaShop i cache przeglądarki. Jeśli problem nie ustępuje, sprawdź, czy żaden zewnętrzny moduł bezpieczeństwa nie unieważnia ciasteczek sesji po zalogowaniu.

Pole Stan pokazuje niewłaściwe regiony

Upewnij się, że używasz wersji 1.3.0 lub nowszej modułu, która rozwiązuje strukturę formularza po stronie serwera dla każdego kraju.

Płatność otwiera się, choć nie wybrano punktu odbioru

Zaktualizuj moduł do wersji 1.3.1 lub nowszej: etap dostawy pozostaje wtedy otwarty, dopóki moduł przewoźnika nie zatwierdzi punktu odbioru.

Płatność kartą Mollie przekierowuje na stronę płatności Mollie

Zaktualizuj moduł do wersji 1.3.2 lub nowszej: zintegrowany formularz karty przekazuje wtedy kartę do Mollie bezpośrednio z checkoutu. Jeśli problem nie ustępuje, wyczyść pamięć podręczną PrestaShop i sprawdź w konsoli przeglądarki, czy żaden błąd JavaScript nie blokuje wczytania skryptu Mollie.

Pusta strona na /order

Włącz tryb debug PrestaShop (_PS_MODE_DEV_), aby wyświetlić błąd, lub sprawdź var/logs. Upewnij się, że żaden inny moduł checkoutu one-page nie jest aktywny jednocześnie.

Odinstalowanie

Odinstaluj moduł z Menedżera modułów. Środowisko runtime jest natychmiast zwalniane i przywracany jest natywny 5-etapowy checkout. Żadnych plików resztkowych, żadnych osieroconych danych.

Czy ta strona była pomocna?

Nadal utknąłeś? Napisz do wsparcia