Dokumentacja modułu Przedsprzedaży PrestaShop (dfpreorder)

<p>Moduł <strong>DataFirefly Pre-Orders</strong> (dfpreorder) pozwala sprzedawać produkty, zanim trafią do magazynu, w PrestaShop 8 i 9. Ta strona obejmuje instalację, ustawienia, reguły, przyjęcia towaru i rozwiązywanie problemów.</p>

<h2>Instalacja</h2>
<ol>
<li>Pobierz plik ZIP z konta klienta DataFirefly.</li>
<li>W panelu administracyjnym przejdź do <em>Moduły > Menedżer modułów > Wgraj moduł</em> i wyślij plik ZIP.</li>
<li>Podczas instalacji moduł tworzy swoje tabele, dwa statusy zamówienia i dwie pozycje menu: <em>Katalog > Przedsprzedaż</em> dla reguł oraz <em>Zamówienia > Przedsprzedaż</em> do monitorowania.</li>
<li>Otwórz konfigurację modułu, sprawdź ustawienia ogólne i skopiuj adres URL crona.</li>
</ol>
<p>Moduł działa od PrestaShop 8.0 do 9.x z tego samego pliku ZIP, w multisklepie i w wielu językach. Teksty są dostarczone po polsku, angielsku, francusku, hiszpańsku, niemiecku, włosku, niderlandzku i portugalsku.</p>

<h2>Ustawienia ogólne</h2>
<ul>
<li><strong>Domyślny tekst przycisku</strong> i <strong>tekst etykiety</strong>, w każdym języku. Każda reguła może je zastąpić.</li>
<li><strong>Koszyki łączące przedsprzedaż i produkty dostępne</strong>: zezwalaj bez komunikatu, zezwalaj z informacją, że zamówienie zostanie wysłane jednorazowo, albo zabroń łączenia.</li>
<li><strong>Pole zgody przy składaniu zamówienia</strong>: dodaje obowiązkowe pole, gdy koszyk zawiera przedsprzedaż. Treść obsługuje znacznik <code>%date%</code>, zastępowany najpóźniejszą przewidywaną datą wysyłki z koszyka. Data zgody jest zapisywana przy każdej pozycji przedsprzedaży.</li>
<li><strong>E-maile</strong> potwierdzenia i dostępności, włączane osobno.</li>
<li><strong>Automatyczny przydział</strong> przyjętego towaru oraz <strong>status zamówienia</strong> nadawany po przydzieleniu wszystkich pozycji.</li>
<li><strong>Formularz Powiadom mnie</strong> przy produktach, których nie można zamówić.</li>
<li><strong>Dane strukturalne PreOrder</strong>, domyślnie wyłączone: włącz je tylko wtedy, gdy motyw lub moduł SEO nie generuje już JSON-LD produktu.</li>
</ul>

<h2>Tworzenie reguły przedsprzedaży</h2>
<p>Przejdź do <em>Katalog > Przedsprzedaż</em>, a następnie <em>Dodaj regułę</em>. Reguła dotyczy produktu albo konkretnego wariantu.</p>

<h3>Trzy tryby</h3>
<ul>
<li><strong>Przy braku towaru</strong>: przedsprzedaż rusza, gdy stan osiąga zero, i kończy się po uzupełnieniu. To tryb dla braków u dostawcy.</li>
<li><strong>Wymuszony</strong>: produkt pozostaje w przedsprzedaży, dopóki reguła jest aktywna, nawet przy dostępnym towarze. To tryb premiery produktu.</li>
<li><strong>Okno dat</strong>: przedsprzedaż otwiera się i zamyka w podanych terminach. Zamknięcie realizuje zadanie cron, a awaryjnie każde wyświetlenie karty produktu.</li>
</ul>

<h3>Pozostałe pola</h3>
<ul>
<li><strong>Przewidywana data wysyłki</strong>: widoczna na karcie produktu, w koszyku, na koncie klienta, na fakturze i w e-mailach.</li>
<li><strong>Maksymalna ilość</strong> i <strong>maksimum na klienta</strong>: 0 oznacza brak limitu. Limity są sprawdzane po stronie serwera przy każdym zapisie koszyka.</li>
<li><strong>Rabat przedsprzedażowy</strong> procentowy lub kwotowy: dostępny w trybach wymuszonym i okna dat, gdzie okres jest znany z góry. Tworzy cenę specyficzną usuwaną po zakończeniu reguły.</li>
<li><strong>Tekst przycisku</strong> i <strong>komunikat</strong> w każdym języku, właściwe dla reguły.</li>
<li><strong>Odliczanie</strong> (do zamknięcia lub do premiery) oraz <strong>pasek zarezerwowanych sztuk</strong>, który wymaga maksymalnej ilości.</li>
</ul>

<h3>Tworzenie wielu reguł naraz</h3>
<p>Przycisk <em>Przypisanie zbiorcze i import CSV</em> otwiera dwa formularze. Pierwszy tworzy jedną regułę dla każdego produktu pasującego do kategorii, marki lub dostawcy, przy czym kryteria się sumują. Drugi importuje plik CSV z kolumnami <code>product</code> (ID lub indeks), <code>combination</code> (opcjonalnie), <code>mode</code>, <code>release_date</code>, <code>max_qty</code>, <code>max_per_customer</code>, <code>date_start</code>, <code>date_end</code>. Istniejące reguły są aktualizowane.</p>

<h2>Co widzi klient</h2>
<p>Przy produkcie w przedsprzedaży przycisk dodania do koszyka przyjmuje wybrany tekst, na zdjęciach na listach i na karcie pojawia się etykieta, a ramka pokazuje przewidywaną datę, Twój komunikat, odliczanie i pasek zarezerwowanych sztuk. Blok odświeża się po zmianie wariantu.</p>
<p>W koszyku każda pozycja objęta przedsprzedażą jest oznaczona przewidywaną datą. Przy składaniu zamówienia pole zgody przypomina termin. Po zamówieniu klient śledzi przedsprzedaż w sekcji <em>Moje konto > Moje zamówienia przedsprzedażowe</em> i może poprosić o anulowanie pozycji, które nadal czekają.</p>

<h2>Monitorowanie i przydział towaru</h2>
<p><em>Zamówienia > Przedsprzedaż</em> zbiera cały monitoring.</p>
<h3>Panel</h3>
<p>Wskaźniki pokazują sztuki oczekujące, liczbę zamówień, zarezerwowany przychód brutto, sztuki już przydzielone i prośby o anulowanie. Tabela produktów podaje dla każdego produktu lub wariantu sztuki oczekujące, stan w PrestaShop, sztuki możliwe do przydzielenia od razu oraz ilość do zamówienia u dostawcy. Eksport CSV korzysta z tych samych kolumn.</p>
<h3>Przydział dostawy</h3>
<p>Zamówienie w przedsprzedaży zmniejsza stan magazynowy już w chwili złożenia, co spycha go poniżej zera. Sztuki fizycznie dostępne dla przedsprzedaży to zatem: sztuki oczekujące + bieżący stan. Po uzupełnieniu towaru przycisk <em>Przydziel (najstarsze najpierw)</em> obsługuje zamówienia według daty, a <em>Wybierz zamówienia</em> otwiera ekran przydziału z zaznaczonymi i edytowalnymi pozycjami.</p>
<p>Gdy wszystkie pozycje przedsprzedaży w zamówieniu zostaną przydzielone, zamówienie przechodzi do ustawionego statusu (domyślnie <em>Przedsprzedaż: gotowe do wysyłki</em>), a klient dostaje e-mail. Dalej kompletujesz zamówienie jak zwykle.</p>
<div class=”df-callout note”><p>Automatyczny przydział obsługuje przedsprzedaż bez ręcznego zatwierdzania, ale nigdy przed ogłoszoną datą w regule wymuszonej lub z oknem dat.</p></div>

<h2>Obsługa opóźnienia</h2>
<p>Otwórz regułę, zmień przewidywaną datę wysyłki i pozostaw włączoną opcję <em>Powiadom klientów o zmianie daty</em>. Oczekujące zamówienia zostaną zaktualizowane, a każdy zainteresowany klient otrzyma e-mail z nową datą i linkiem do prośby o anulowanie. Liczba powiadomionych klientów pojawia się po zapisaniu, a historia ogłaszanych dat znajduje się pod formularzem.</p>
<p>Prośby o anulowanie trafiają do panelu. <em>Potwierdź anulowanie</em> zwalnia zarezerwowane sztuki; zwrot środków wykonujesz na stronie zamówienia swoją metodą płatności. <em>Zachowaj zamówienie</em> przywraca pozycje do stanu oczekującego.</p>

<h2>Zadanie cron</h2>
<p>Konfiguracja modułu pokazuje adres URL z tokenem. Zaplanuj go co 15 minut u swojego hostingodawcy. Otwiera i zamyka okna dat o właściwej porze, a przy włączonym automatycznym przydziale obsługuje przedsprzedaż, do której dotarł towar.</p>

<h2>Najczęstsze pytania</h2>
<h3>Czy klient płaci całość?</h3>
<p>Tak, w wersji 1.0. Zaliczka z dopłatą przy dostępności jest planowana w wersji 1.1.</p>
<h3>Dlaczego zamówienie przechodzi do statusu Przedsprzedaż: oczekuje na towar?</h3>
<p>Moduł nadaje ten status, gdy zamówienie jest opłacone i zawiera co najmniej jedną pozycję w przedsprzedaży. Status jest opłacony i nie pozwala na wysyłkę, dzięki czemu niekompletne zamówienie nie trafia do kompletacji.</p>
<h3>Czy reguła dla jednego wariantu wpływa na pozostałe?</h3>
<p>PrestaShop obsługuje ustawienie zezwalające na zamówienia bez towaru wyłącznie na poziomie produktu. Moduł ustawia je więc na produkcie, a następnie blokuje w sklepie i w koszyku warianty bez towaru, które nie mają reguły, aby zachować pierwotne zachowanie sklepu.</p>
<h3>Odliczanie się nie pojawia</h3>
<p>Pojawia się tylko wtedy, gdy data zakończenia (tryb okna dat) lub przewidywana data wysyłki jest w przyszłości i gdy opcja jest włączona w regule.</p>
<h3>Przycisk zachowuje pierwotny tekst</h3>
<p>Moduł podmienia tekst przycisku dodania do koszyka w standardowych motywach. Przy mocno zmodyfikowanym motywie skontaktuj się ze wsparciem, podając adres karty produktu: selektor przycisku można dostosować.</p>