Etykiety zestawów produktów: konfiguracja i pomoc

W panelu administracyjnym otwórz Moduły > "Module Manager", wybierz "Upload a module" i prześlij ZIP modułu. Zainstaluj go, a następnie kliknij "Configure". W starszych wersjach PrestaShop użyj odpowiedniej strony modułów.

Otwórz Ustawienia produktów pakietowych i pozostaw Włącz odznaki pakietów włączone. Domyślna wartość to Tak. Jest to jedyne ustawienie zachowania pakietów. Steruje oznaczaniem na listach, znacznikiem przed ceną, zawartymi produktami i mechanizmem obsługi adresów URL opartych wyłącznie na przepisanej nazwie.

Wymaga PrestaShop 1.7 lub nowszego oraz PHP 7.1 lub nowszego.

Zmień indeks każdego odpowiedniego produktu tak, aby zaczynał się od mpr-pack-, na przykład mpr-pack-starter, mpr-pack-seo-tools lub mpr-pack-bathroom-kit. Zapisz produkt i otwórz listę, która go zawiera. Sam natywny status pakietu PrestaShop nie jest regułą wykrywania stosowaną przez ten moduł.

Etykieta Pakiet jest udostępniana przez actionProductFlagsModifier, gdy jest dostępny, aby motyw mógł wyświetlić ją wraz z natywnymi oznaczeniami. Istniejące natywne oznaczenie pakietu zostaje zachowane. W razie potrzeby JavaScript dodaje .product-flag.pack w natywnym stylu do listy oznaczeń motywu. Tylko karty bez takiej listy korzystają z zapasowej nakładki modułu .mpr-pack-badge.

Hook displayProductListReviews wyświetla wskaźnik pakietu z tekstem "Bundle: Save Big". Ten tekst jest etykietą wyświetlania; moduł nie oblicza oszczędności ani nie tworzy rabatów. Nie dodaje specjalnej klasy obramowania/cienia karty pakietu. Za wygląd karty nadal odpowiadają style motywu.

W konfiguracji modułu nie ma edytora zawartości. Poproś administratora bazy danych o dodanie powiązania pakietu z produktem do tabeli mpr_pack_content z prefiksem. Zastąp ps_ rzeczywistym prefiksem tabel i użyj rzeczywistych identyfikatorów produktów:

INSERT INTO ps_mpr_pack_content (id_pack, id_product, position) VALUES
(100, 12, 0),
(100, 34, 1),
(100, 56, 2);

Zainstalowana tabela zawiera kolumny bez znaku id_pack, id_product i position. Domyślna pozycja to 0. Klucz główny to (id_pack, id_product), z indeksem na id_pack.

W produkcie z wymaganym prefiksem indeksu displayProductExtraContent dodaje "What's Included (N modules)", gdy można załadować pasujące aktywne produkty. Produkty są uporządkowane według position. Karty zawierają link, nazwę, obraz lub tekst zastępczy Brak obrazu oraz cenę albo "FREE", jeśli zapisana cena wynosi zero lub mniej. Mechanizm wyświetlania odczytuje cenę bazową z tabeli produktów i formatuje ją w bieżącej walucie. Nie traktuj jej jako potwierdzenia końcowej ceny sprzedaży właściwej dla klienta, uwzględniającej podatek lub przeliczenie waluty.

Jest to powiązanie służące wyświetlaniu. Nie tworzy natywnego pakietu PrestaShop, nie zarządza zapasami składników ani nie zmienia tego, co zostanie dostarczone po złożeniu zamówienia. Zapytanie korzysta z wierszy językowych produktów dla bieżącego języka i sklepu; nie egzekwuje w pełni aktywacji zawartych produktów w sklepie przez product_shop.

Lista produktów powinna udostępniać indeks produktu hookom. Zgodna karta może zawierać:

<article class="product-miniature js-product-miniature">
  <div class="thumbnail-container">
    {* product image here *}
  </div>
  {hook h='displayProductPriceBlock' product=$product type='before_price'}
  {hook h='displayProductListReviews' product=$product}
</article>

Ukryty znacznik przed ceną sam w sobie nie jest widoczną odznaką. Zapasowe nakładki szukają .product-miniature__top, .thumbnail-container lub .product-image-container. JavaScript obserwuje treści wstawiane pod #js-product-list i oznacza nowe wskaźniki pakietów po aktualizacjach listy przez AJAX. Przetestuj motyw, jeśli zastępuje cały obserwowany kontener.

W razie potrzeby dostosuj zapasową nakładkę w arkuszu stylów motywu:

.mpr-pack-badge {
  top: .5rem;
  right: .5rem;
  background-color: #3BAF5C;
}

W arkuszu stylów motywu możesz nadpisać zmienne używane przez zapasową odznakę, wskaźnik oszczędności i karty zawartych produktów:

:root {
  --mprpackproducts-success: #3BAF5C;
  --mprpackproducts-bg: #fff;
  --mprpackproducts-bg-secondary: #D8F0E0;
  --mprpackproducts-border: rgba(59, 175, 92, 0.2);
  --mprpackproducts-radius: 0.375rem;
  --mprpackproducts-shadow-hover: 0 8px 24px rgba(0, 0, 0, 0.1);
}

Moduł integruje zmienne ThemeDetector pod --mprpackproducts-*. Edytuj tylko zmienne używane przez zainstalowane arkusze stylów. Natywny styl .product-flag.pack pochodzi z motywu. Panel administracyjny nie ma opcji zmiany treści etykiet, kształtu, koloru ani projektów poszczególnych pakietów.

Włączony moduł zawiera też mechanizm rozstrzygania niejednoznacznych tras produktów/kategorii/CMS/producentów opartych wyłącznie na przepisanej nazwie. Nie jest to ogólny ekran konfiguracji przyjaznych adresów URL. Po zmianie głównego przełącznika przetestuj istniejące uproszczone adresy URL.

1. Potwierdź, że indeks zaczyna się dokładnie od prefiksu mpr-pack-.
2. Otwórz listę kategorii i wyników wyszukiwania zawierającą ten aktywny produkt. Sprawdź oznaczenie Pakiet/natywnego pakietu i wskaźnik na liście.
3. Zmień filtr fasetowy lub wywołaj odświeżenie AJAX i potwierdź, że nowa karta nadal ma oznaczenie.
4. Jeśli brakuje oznaczenia, sprawdź Włącz odznaki pakietów, dane indeksu produktu, umiejscowienie hooków i kod HTML karty. Istniejące natywne oznaczenie pakietu może zastąpić etykietę Pakiet modułu.
5. Jeśli brakuje karty, sprawdź wiersze powiązań, dane aktywacji/języka zawartych produktów i obsługę dodatkowej zawartości produktu przez motyw.
6. Użyj "Integrity", jeśli brakuje wymaganych tabel lub hooków. W starszych wersjach PrestaShop sprawdź dostępność API ustawień regionalnych, jeśli karta zawartości powoduje błąd.

Wyłącz Włącz odznaki pakietów, aby tymczasowo zatrzymać działanie. Odinstaluj moduł przez "Module Manager", aby usunąć konfigurację i tabelę mpr_pack_content. Wcześniej wykonaj kopię powiązań. Odinstalowanie usuwa również rejestrację ThemeDetector; niepowodzenie tego czyszczenia zatrzymuje odinstalowanie, aby można było naprawić problem i ponowić próbę. Indeksy produktów nie są przywracane.

Wymaga PrestaShop 1.7 lub nowszego oraz PHP 7.1 lub nowszego.