Przewidywana data dostawy: konfiguracja i pomoc

1. Prześlij i zainstaluj ZIP modułu w Moduły > "Module Manager".
2. Otwórz Estimated Delivery Date > "Configure" i pozostaw "Enable" włączone.
3. Dostosuj "Processing days" do harmonogramu sklepu.
4. Ustaw "Order cutoff hour" w strefie czasowej sklepu i wybierz "Exclude weekends".
5. Wybierz "Date format" i kliknij Zapisz.
6. Otwórz stronę produktu. Sprawdź szacowaną datę, a przed godziną graniczną także zmniejszające się odliczanie.

Otwórz Moduły > "Module Manager" > Estimated Delivery Date > "Configure". Użyj Ustawienia szacowanej dostawy i po zmianach kliknij Zapisz.

Przykłady pokazują formatowanie, a nie przewidywaną datę dostawy. Tekstowe nazwy dni i miesięcy korzystają z formatowania dat PHP. Wybierz format liczbowy, aby wynik był niezależny od języka.

Szacowany termin używa strefy czasowej sklepu z PS_TIMEZONE. Jeśli ustawienie jest puste, stosowana jest domyślna strefa czasowa PHP.

Dla bieżącego dnia kalendarzowego sklepu moduł przygotowuje datę przed godziną graniczną, datę po niej, bezwzględny znacznik czasu godziny granicznej oraz następną północ w sklepie. Data przed godziną graniczną dodaje "Processing days". Data po godzinie granicznej dodaje kolejny dzień. Przy wykluczeniu weekendów liczą się tylko kwalifikujące się dni od poniedziałku do piątku.

Sklep pokazuje jeden szacowany termin naraz. JavaScript aktualizuje odliczanie HH:MM:SS co sekundę przed godziną graniczną. O godzinie granicznej ukrywa odliczanie i przełącza datę na termin po tej godzinie. O następnej północy w sklepie ukrywa stary termin do czasu wczytania świeżej zawartości strony. Zegar przeglądarki wpływa na to przełączanie.

Bez JavaScript szablon pokazuje datę po godzinie granicznej i pozostawia wiersz zachęcający do szybkiego zamówienia ukryty.

Ustawienia są globalne. Moduł nie dodaje czasu transportu przewoźnika, kalendarzy świąt, terminów realizacji poszczególnych produktów, kontroli stanów magazynowych ani zakresu dat dostawy. Traktuj datę jako wynik skonfigurowanego harmonogramu realizacji.

W PrestaShop 1.7 i nowszych motyw musi renderować displayProductAdditionalInfo. W PrestaShop 1.6 moduł rejestruje displayRightColumnProduct. CSS i JavaScript odliczania ładują się przez actionFrontControllerSetMedia, także na stronach, z których można otworzyć szybki podgląd.

Dla współczesnego szablonu produktu wywołanie hooka wygląda tak:

{hook h='displayProductAdditionalInfo' product=$product}

Aby dostosować znaczniki, skopiuj szablon modułu do:

themes/your-theme/modules/mprestimateddelivery/views/templates/hook/delivery.tpl

Zacznij od aktualnego szablonu. Zachowaj .mprestdel-box, .mprestdel-date, .mprestdel-urgency, .mprestdel-countdown oraz atrybuty data-cutoff-at, data-valid-until, data-before-date i data-after-date dla odliczania.

Przypisane wartości Smarty to mprestdel_cutoff_at, mprestdel_valid_until, mprestdel_before_date i mprestdel_after_date. Stosuj do nich escapowanie przy renderowaniu HTML. Wcześniejsze wartości mprestdel_date i mprestdel_hours_left nie są przypisywane w tej wersji.

Możesz stylować istniejące klasy w CSS motywu:

.mprestdel-box { background: #f7fbff; border-color: #cfe2f3; }
.mprestdel-date { font-weight: 700; }
.mprestdel-urgency { color: #b83227; }

Konfiguracja jest zapisywana przez wspólny system konfiguracji MPR pod nazwą modułu mprestimateddelivery. Zmieniaj ją przez formularz konfiguracji. Aby sprawdzić zapisane wartości globalne, użyj tego zapytania tylko do odczytu z prefiksem swojej bazy danych:

SELECT `key`, `value`
FROM ps_mpr_config
WHERE module = 'mprestimateddelivery'
  AND context_type = 'global'
  AND context_id = 0;

Zastąp ps_mpr_config, jeśli baza danych używa innego prefiksu.

1. Sprawdź strefę czasową sklepu i ustaw znany harmonogram realizacji.
2. Otwórz stronę produktu i porównaj datę z kalendarzem sklepu.
3. Przed godziną graniczną potwierdź, że odliczanie zmniejsza się co sekundę.
4. Przetestuj przekroczenie godziny granicznej. Potwierdź, że odliczanie znika, a szacowany termin się zmienia.
5. Sprawdź obliczenie dla piątku lub weekendu z włączonym "Exclude weekends".

Jeśli brakuje daty, sprawdź "Enable", właściwy hook produktu dla używanej wersji PrestaShop i baner integralności instalacji. Jeśli przed godziną graniczną brakuje odliczania, sprawdź żądanie JavaScript, konsolę i zegar przeglądarki oraz wszelkie nadpisania szablonu w motywie. Stare nadpisania korzystające z dawnych zmiennych Smarty wymagają aktualizacji.

Po zmianach szablonu wyczyść nieaktualną pamięć podręczną stron i zasobów. JavaScript celowo ukrywa szacowany termin wygenerowany dla poprzedniego dnia sklepu. Odśwież stronę, aby uzyskać nowy. Skrypt ponownie skanuje odświeżenia produktów i szybkie podglądy, ale motyw nadal musi dostarczać wynik hooka.

Ustaw "Enable" na Nie i zapisz, aby ukryć szacowany termin. Odinstaluj przez "Module Manager", aby usunąć wpisy menu i konfiguracji. Zachowaj harmonogram realizacji przed odinstalowaniem.

Wymaga PrestaShop 1.6 lub nowszego oraz PHP 7.1 lub nowszego.