Promocje ilościowe i plakietki promo: dokumentacja

Instalacja

Moduł instaluje się jak każdy moduł PrestaShop, przez back-office lub FTP.

1. Z Moduły, potem Menedżer modułów, kliknij Zainstaluj moduł i upuść plik dfquantitydeal.zip.
2. Przez FTP rozpakuj archiwum do folderu /modules/ sklepu, potem zainstaluj DataFirefly – Promocje ilościowe i plakietki promo z menedżera modułów.
3. Wyczyść cache w Zaawansowane, potem Wydajność.

Instalacja tworzy osiem tabel z prefiksem ps_df_quantity_deal, rejestruje siedem hooków i dodaje zakładkę Promocje ilościowe w menu Katalog.

Ustawienia ogólne

Przycisk Konfiguruj na karcie modułu otwiera ustawienia obowiązujące dla wszystkich ofert.

• Włącz moduł: wyłącza wyświetlanie plakietek i naliczanie rabatów bez odinstalowywania.
• Plakietki na listingach: pokazuje plakietkę na miniaturach stron kategorii, wyników wyszukiwania i bloków produktów.
• Plakietka na karcie produktu: osobny przełącznik, aby wyświetlać plakietkę tylko na listingach, jeśli chcesz.
• Tabela ofert na karcie produktu: listuje oferty obowiązujące dla produktu pod przyciskiem dodania do koszyka.
• Szczegóły ofert w koszyku: dodaje pod podsumowaniem koszyka kwotę wnoszoną przez każdą ofertę.
• Naliczaj rabaty brutto: włączone, reguła koszyka nosi kwotę brutto. Wyłączone, kwota jest netto i PrestaShop dolicza VAT według Twoich reguł.
• Etykieta rabatu koszyka: tekst wyświetlany w linii rabatu koszyka i zamówienia. Domyślnie „Promocje ilościowe”.
• Rozmiar czcionki plakietki: w pikselach, domyślnie 13.

Tworzenie oferty

Otwórz Katalog, potem Promocje ilościowe, i kliknij Nowa oferta. Formularz jest podzielony na trzy zakładki.

Zakładka Oferta

• Nazwa oferty: pole tłumaczone, używane na liście back-office i w tabeli ofert karty produktu.
• Typ oferty: pięć mechanik opisanych niżej. Formularz ukrywa zbędne pola zależnie od wybranego typu.
• Kupiona ilość (X) i Ilość gratis (Y): dla typu X kupione + Y gratis, i samo X dla ceny zestawu.
• Ranga rabatowanego artykułu (N): 2 dla „drugi za -25%”, 3 dla „trzeci za -50%”.
• Wartość rabatu: procent, kwota rabatu lub cena narzucona zależnie od typu. Etykieta pola zmienia się automatycznie.
• Oferta powtarzalna: włączona, oferta stosuje się tyle razy, na ile pozwala ilość. Wyłączona, stosuje się tylko raz na koszyk.
• Grupowanie ilości: per produkt, per wariant lub mix and match.
• Priorytet: najniższe wartości idą pierwsze.
• Aktywuj ofertę: odpowiednik przycisku aktywacji na liście.

Zakładka Warunki

• Zakres: cały katalog, wybrane produkty, wybrane kategorie lub wybrane marki. Odpowiednie pole wyboru pojawia się zależnie od wyboru.
• Objęte produkty: wpisz co najmniej dwa znaki, aby uruchomić wyszukiwanie. Obejmuje nazwę, referencję i ID. Kliknij wynik, aby dodać go do listy.
• Objęte kategorie: drzewo kategorii z checkboxami. Produkt przypisany do jednej z zaznaczonych kategorii wyzwala ofertę.
• Objęte marki: lista producentów sklepu.
• Grupy klientów: zostaw wszystko odznaczone, aby zastosować ofertę do wszystkich grup, łącznie z odwiedzającymi.
• Wyklucz produkty już w promocji: produkty korzystające z ceny specyficznej wypadają z naliczania.
• Data rozpoczęcia i Data zakończenia: zostaw puste dla oferty stałej. Sama data jest uzupełniana do 00:00:00 na początek i 23:59:59 na koniec.
• Sklepy: widoczne tylko przy aktywnym trybie multistore.

Zakładka Plakietka i wyświetlanie

• Tekst plakietki: pole tłumaczone. Zostaw puste dla automatycznej generacji z wartości oferty.
• Kolor tła i Kolor tekstu: selektory kolorów, domyślnie czerwony i biały.
• Kształt: kwadrat, zaokrąglone rogi, pigułka, pochylona wstęga, okrągła pastylka.
• Pozycja na miniaturze: lewy górny, prawy górny, lewy dolny, prawy dolny, lub wyświetlanie w linii pod ceną.
• Pokazuj na listingach, na karcie produktu, w tabeli ofert: trzy przełączniki per oferta, w uzupełnieniu ustawień globalnych.
• Opis oferty: tłumaczony tekst wzbogacony, wyświetlany pod zdaniem objaśniającym w tabeli ofert.

Pięć typów ofert

X kupione + Y gratis

Klasyczny format 2+1, 3+1 lub 4+2. Silnik dzieli kwalifikujące się sztuki z koszyka na zestawy X plus Y. Dla każdego kompletnego zestawu Y najtańszych sztuk jest gratis.

Przykład: oferta 4+2, sześć artykułów po 4,49 € w koszyku. Jeden kompletny zestaw, dwie sztuki gratis, rabat 8,98 €. Przy tylko pięciu artykułach żaden zestaw nie jest kompletny i rabat wynosi zero.

N-ty za -X %

Silnik dzieli sztuki na zestawy po N. W każdym zestawie sztuka o randze N otrzymuje procentowy rabat. Ponieważ sztuki są sortowane malejąco po cenie, rabatowany artykuł jest najtańszy w zestawie.

Przykład: oferta „drugi za -25%”, cztery artykuły po 20 €. Dwa zestawy po dwa, dwa artykuły z rabatem 5 €, rabat łączny 10 €.

N-ty za -X €

Ten sam podział, ale rabat jest kwotą stałą. Jest ograniczony do ceny artykułu: rabat 30 € na artykuł za 8 € daje 8 € rabatu, nie 30 €.

N-ty w cenie narzuconej

Artykuł o randze N jest sprowadzany do ceny, którą ustalasz. Rabat odpowiada różnicy. Dla „drugi za 1 €” na dwóch artykułach po 12 € rabat wynosi 11 €.

Cena zestawu

Dla każdego zestawu X sztuk suma jest sprowadzana do ogłoszonej ceny. Przy ofercie 3 za 10 € z sześcioma artykułami po 5 € silnik tworzy dwa zestawy i stosuje 10 € rabatu łącznie.

Który artykuł jest gratis

Silnik sortuje kwalifikujące się sztuki malejąco po cenie, potem stosuje korzyść do najtańszych z każdego zestawu. To reguła stosowana przez wielką dystrybucję i ta, której oczekuje klient.

W zestawie 3+1 złożonym z artykułów po 20 €, 15 €, 10 € i 5 € artykułem gratis jest ten za 5 €. Klient płaci 45 € zamiast 50 €.

Grupowanie ilości

• Per produkt: wszystkie warianty tej samej referencji liczą się razem. Sześć flakonów tego samego żelu pod prysznic wyzwala ofertę 4+2, nawet jeśli to trzy różne zapachy.
• Per wariant: każdy wariant liczy się osobno. Potrzeba sześciu sztuk tego samego zapachu, aby wyzwolić tę samą ofertę.
• Mix and match: wszystkie sztuki produktów przypisanych do oferty zasilają ten sam licznik. Przydatne do 4+2 na całej gamie.

Priorytet i kumulacja ofert

Oferty są ewaluowane w kolejności priorytetu, od najniższego do najwyższego. Każda oferta zużywa sztuki, których używa, a następna pracuje na reszcie. Ta sama sztuka nigdy nie jest rabatowana dwa razy.

Przykład: siedem artykułów w koszyku, oferta 4+2 z priorytetem 10. Sześć sztuk jest zużytych przez zestaw, siódma pozostaje dostępna dla oferty z priorytetem 20 celującej w ten sam produkt.

Plakietka

Zmienne tekstu

Pole Tekst plakietki akceptuje pięć zmiennych, zastępowanych przy wyświetlaniu wartościami oferty.

• {x}: kupiona ilość
• {y}: ilość gratis
• {n}: ranga rabatowanego artykułu
• {value}: wartość rabatu, bez zbędnych zer
• {price}: wartość rabatu sformatowana jako cena, w walucie klienta

Możesz też wpisać tekst na sztywno: „4+2 gratis”, „3+1 gratis”, „drugi za -25%”. Pole jest tłumaczone, więc każdy język ma swoje sformułowanie.

Jeśli pole pozostaje puste, moduł generuje krótką etykietę z typu i wartości: 4+2 dla oferty X kupione Y gratis, -25% x2 dla N-tego z procentem.

Pozycja i integracja z miniaturą

Plakietka jest renderowana w bloku ceny, przez hook displayProductPriceBlock. Skrypt front przenosi ją potem do kontenera miniatury, aby wyświetlić ją na obrazie. Umieszczanie jest powtarzane po odświeżeniach Ajax wyszukiwania fasetowego, paginacji i quick view.

Tryb W linii (pod ceną) wyłącza to przenoszenie i zostawia plakietkę w przepływie, pod ceną. Wybierz ten tryb, jeśli Twój motyw używa niestandardowej struktury miniatury.

Naliczanie rabatu w koszyku

Przy każdej modyfikacji koszyka silnik przelicza sumę rabatów i synchronizuje prywatną regułę koszyka. Jej kod wewnętrzny zaczyna się od DFQD plus identyfikator koszyka. Klient widzi tylko jedną linię rabatu i nie musi wpisywać żadnego kodu.

Reguła jest aktualizowana tylko gdy kwota się zmieniła, co unika jej odtwarzania przy każdym ładowaniu strony. Jeśli suma spada do zera, reguła jest odpinana od koszyka i usuwana.

Przy zatwierdzeniu zamówienia reguła jest dezaktywowana, a jej data końcowa cofana w przeszłość, aby nie mogła być użyta ponownie. Pozostaje przypisana do zamówienia, więc widoczna w eksportach księgowych i użyteczna do noty kredytowej.

Dostosowanie wyświetlania do motywu

Trzy szablony można nadpisać. Skopiuj je z /modules/dfquantitydeal/views/templates/hook/ do /themes/twoj-motyw/modules/dfquantitydeal/views/templates/hook/.

• badge.tpl: sama plakietka
• offers.tpl: tabela ofert na karcie produktu
• cart.tpl: podsumowanie pod koszykiem

CSS jest wyizolowany pod prefiksem dfqd. Dla punktowej korekty celuj w klasy z arkusza stylów motywu zamiast modyfikować views/css/front.css, który zostałby nadpisany przy aktualizacji.

Multistore i wielojęzyczność

Każda oferta jest przypisana do sklepów zaznaczonych w zakładce Warunki. Oferta utworzona w jednym sklepie nie pojawia się w innych, dopóki nie zostanie do nich przypisana.

Pola Nazwa, Tekst plakietki i Opis są tłumaczone na zainstalowane języki. Wyświetlana plakietka używa języka klienta.

Rozwiązywanie problemów

Plakietka się nie wyświetla

1. Sprawdź, czy moduł i oferta są aktywne oraz czy bieżąca data mieści się w okresie ważności.
2. Sprawdź zakres: produkt musi być jawnie przypisany do oferty albo należeć do zaznaczonej kategorii lub marki.
3. Skontroluj przełączniki wyświetlania, w ustawieniach globalnych i w zakładce Plakietka oferty.
4. Jeśli grupa klientów jest ograniczona, przetestuj kontem z właściwej grupy.
5. Wyczyść cache Smarty i cache serwera.

Rabat nie stosuje się w koszyku

Ilość musi osiągnąć próg oferty według wybranego trybu grupowania. W trybie Per wariant sześć sztuk rozłożonych na trzy warianty nie wyzwala oferty 4+2. Sprawdź też, czy produkt nie jest wykluczony przez opcję dotyczącą produktów już w promocji.

Dwie oferty nachodzą na siebie

To zachowanie oczekiwane: sztuka zużyta przez pierwszą ofertę wypada z naliczania drugiej. Jeśli chcesz, aby jedna oferta szła przed drugą, obniż jej priorytet.

Plakietka pojawia się w złym miejscu

Niektóre motywy niestandardowe nie używają standardowej struktury miniatury. Przełącz pozycję na W linii (pod ceną) albo nadpisz badge.tpl, aby umieścić plakietkę tam, gdzie chcesz.

Odinstalowanie

Odinstalowanie usuwa osiem tabel modułu, jego klucze konfiguracji i zakładkę menu Katalog. Reguły koszyka już przypisane do przeszłych zamówień są zachowane, aby nie naruszyć historii księgowej.