1. Do czego służy moduł
Moduł pokazuje klientom, ile jeszcze brakuje im do darmowej dostawy: „Do darmowej dostawy brakuje Ci 23,50 zł.”, razem z paskiem postępu. Gdy koszyk osiągnie próg, komunikat zmienia się na „Masz darmową dostawę.”. Pasek pojawia się w koszyku i w podsumowaniu zamówienia i odświeża się od razu po każdej zmianie koszyka.
Działa z PrestaShop 1.7.8, 8.x i 9.x (PHP 7.2.5 lub nowszy), z szablonami Classic i Hummingbird oraz z trybem multistore.
2. Instalacja
- Pobierz moduł z Moje konto → Historia zamówień w sklepie addonspresta.com.
- W panelu sklepu otwórz Moduły → Menedżer modułów i kliknij Załaduj moduł.
- Upuść plik
ap_freeshippingbar_v1.0.1.zipi poczekaj na potwierdzenie. - Kliknij Konfiguruj na karcie modułu.
3. Jak to działa
Moduł porównuje koszyk z progiem dokładnie tak, jak PrestaShop decyduje o darmowej wysyłce: liczy wartość produktów z podatkiem i rabatami, bez kosztu dostawy. Reguła koszyka z darmową wysyłką też oznacza osiągnięty próg. Paska nie ma, gdy w koszyku są same produkty wirtualne, gdy sklep działa w trybie katalogu i gdy próg nie jest ustawiony.
Moduł tylko informuje — nie zmienia cen dostawy. Darmową dostawę daje konfiguracja wysyłki w sklepie. Moduł nie zmienia tabel PrestaShop i nie łączy się z addonspresta.com ani z żadnym innym serwerem.
4. Funkcje i ustawienia
Otwórz Moduły → Menedżer modułów → Pasek darmowej dostawy → Konfiguruj. Ramka Pomoc na górze prowadzi do tej instrukcji i do strony modułu w addonspresta.com, w języku Twojego panelu.
Próg
- Z ustawień Wysyłka > Preferencje — używa kwoty „Darmowa wysyłka od” z PrestaShop. Opis pokazuje obecną wartość. Jeśli nie jest ustawiona, pasek się nie wyświetla.
- Własna kwota — gdy darmowa dostawa wynika z przedziałów cenowych przewoźników albo reguł koszyka. Kwota musi odpowiadać temu, co naprawdę liczy sklep, inaczej pasek obieca coś, czego koszyk nie da.
Własna kwota
Próg w walucie domyślnej, z podatkiem. Klienci płacący w innej walucie widzą kwotę przeliczoną.
Pokazuj w koszyku / Pokazuj w podsumowaniu zamówienia
Miejsca wyświetlania: pod produktami na stronie koszyka i na górze podsumowania podczas składania zamówienia.
Pokazuj przy pustym koszyku
Zanim klient cokolwiek doda, pasek pokazuje tylko próg: „Darmowa dostawa przy zamówieniu od 200,00 zł.”.
Kolor paska
Kolor szesnastkowy, np. #24b9d7. Zostaw puste, żeby użyć głównego koloru szablonu.
Komunikaty
Trzy teksty dla każdego języka: poniżej progu, po osiągnięciu darmowej dostawy i przy pustym koszyku. W tekstach
{amount} zamienia się na brakującą kwotę, a {threshold} na próg; obie wartości są pogrubione. Tekst w języku
domyślnym jest wymagany; puste teksty w innych językach zastępuje tekst domyślny.
5. Multistore
Ustawienia zapisują się dla sklepu lub grupy sklepów wybranej w nagłówku panelu. Wybierz Wszystkie sklepy, żeby ustawić te same wartości wszędzie, albo jeden sklep, żeby nadać mu własny próg i komunikaty. W kontekście wszystkich sklepów albo grupy zapisać może tylko pracownik, który zarządza każdym jej sklepem. Jedna licencja obejmuje wszystkie sklepy instalacji.
6. Odinstalowanie
Menedżer modułów → Pasek darmowej dostawy → Odinstaluj usuwa ustawienia i komunikaty modułu. Żeby je zachować, użyj opcji Wyłącz.
7. Najczęstsze pytania i problemy
Pasek się nie wyświetla. Sprawdź, czy próg jest ustawiony (w Wysyłka → Preferencje albo jako własna kwota), czy w koszyku jest produkt fizyczny i czy tryb katalogu jest wyłączony. Potem wyczyść pamięć podręczną w Zaawansowane → Wydajność.
Pasek mówi o darmowej dostawie, a koszyk nadal liczy wysyłkę. Próg w module różni się od konfiguracji wysyłki. Wybierz Z ustawień Wysyłka > Preferencje albo wpisz własną kwotę równą tej, od której przewoźnicy naprawdę są darmowi.
Jakiś tekst w polskim sklepie jest nadal po angielsku. Uzupełnij komunikaty dla tego języka w konfiguracji modułu.
Czy mogę zmienić wygląd paska?
Tak. Skopiuj views/templates/hook/bar-content.tpl do themes/<twój-szablon>/modules/ap_freeshippingbar/views/templates/hook/
i zmień kopię albo dodaj w szablonie style dla klas .ap-freeshippingbar.
8. Aktualizacje i wsparcie
Aktualizacje są bezpłatne dożywotnio: nowe wersje pobierasz z Moje konto → Historia zamówień w addonspresta.com i wgrywasz tak samo jak nowy moduł. Ustawienia zostają zachowane.
Wsparcie obejmuje 12 miesięcy od zamówienia: napisz na mail@addonspresta.com albo przez formularz kontaktowy na addonspresta.com (od poniedziałku do piątku, 10:00–16:00; odpowiadamy zwykle w ciągu 2 dni roboczych). Podaj wersję PrestaShop, wersję modułu i kroki, które prowadzą do problemu.