Wspólne zakładki produktu – instrukcja obsługi modułu PrestaShop

1. Do czego służy moduł

Moduł dodaje do kart produktów Twoje własne zakładki — „Dostawa”, „Zwroty”, „Tabela rozmiarów” i każdą inną treść, która powtarza się w wielu produktach. Każdą zakładkę piszesz raz, w każdym języku, w tym samym edytorze co opisy produktów. Zakładka może pojawiać się na wszystkich produktach albo tylko w wybranych kategoriach lub u wybranych producentów (marek). Sam ustalasz kolejność zakładek i włączasz lub wyłączasz każdą z nich bez utraty treści.

Zakładki wyglądają tak, jak zakładki Twojego szablonu: w szablonie Classic obok zakładek Opis i Szczegóły produktu, w Hummingbird jako kolejne sekcje rozwijane pod opisem.

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

1. Pobierz moduł z Moje konto → Historia zamówień w sklepie addonspresta.com.
2. W panelu sklepu otwórz Moduły → Menedżer modułów i kliknij Załaduj moduł.
3. Upuść plik ap_producttabs_v1.0.1.zip i poczekaj na potwierdzenie.
4. Kliknij Konfiguruj na karcie modułu.

Po instalacji moduł nie ma jeszcze żadnej zakładki. Pierwszą dodasz przyciskiem + nad listą.

3. Jak to działa

Na każdej karcie produktu moduł bierze włączone zakładki bieżącego sklepu w kolejności z listy i zostawia te, które dotyczą danego produktu:

• Wszystkie produkty — zakładka pojawia się wszędzie.
• Produkty z kategorii poniżej — produkt musi być przypisany do co najmniej jednej zaznaczonej kategorii. Liczy się każda kategoria produktu, nie tylko główna. Podkategorie nie są dodawane same: zaznacz je także, jeśli ich produkty mają pokazywać zakładkę.
• Produkty marek poniżej — marka produktu musi być jedną z zaznaczonych. Produkty bez marki nigdy nie pokazują takiej zakładki.

Moduł przekazuje zakładki do PrestaShop jako „dodatkową treść” karty produktu (hak displayProductExtraContent), a rysuje je Twój szablon. Pojawiają się po zakładkach samego szablonu. Jeśli zakładki dodaje kilka modułów, ich kolejność wynika z ustawień Wygląd → Pozycje dla tego haka.

Teksty wyświetlają się w języku klienta. Język pozostawiony pusty korzysta z tekstu języka domyślnego. Przy zapisie treść czyści mechanizm PrestaShop (HTMLPurifier, jeśli jest włączony w Preferencje → Ogólny), a moduł odrzuca skrypty, atrybuty zdarzeń, linki uruchamiające kod (np. javascript:) oraz znaczniki <style>, <link>, <meta> i <base> oraz animacje SVG, także przy wyłączonym HTMLPurifier. Ramki iframe, np. osadzony film, są przyjmowane tylko wtedy, gdy na tej samej stronie włączona jest opcja Pozwól na iframes w polach HTML.

Moduł nie wymaga żadnego szczególnego ustawienia sklepu. Tworzy własne tabele w bazie, nie zmienia tabel PrestaShop i nie łączy się z addonspresta.com ani z żadnym innym serwerem. Zakładki pojawiają się tylko na karcie produktu, nie w szybkim podglądzie na listach produktów.

4. Funkcje i ustawienia

Otwórz Moduły → Menedżer modułów → Wspólne zakładki produktu → Konfiguruj. Ramka Pomoc na górze prowadzi do tej instrukcji i do strony modułu w addonspresta.com, w języku Twojego panelu.

Lista zakładek

Lista pokazuje zakładki sklepów wybranych w nagłówku panelu: ID, tytuł, gdzie zakładka się pojawia, status i kolejność.

• Status — kliknij ikonę, żeby włączyć albo wyłączyć zakładkę. Wyłączona zakładka zachowuje swoją treść.
• Kolejność — strzałki przesuwają zakładkę o jedno miejsce wyżej lub niżej. W tej kolejności zakładki pojawiają się na karcie produktu.
• Edytuj — otwiera formularz zakładki.
• Usuń — po potwierdzeniu usuwa zakładkę. W trybie multistore znika ona tylko ze sklepów wybranych w nagłówku (zobacz Multistore).

Formularz zakładki

• Tytuł zakładki — nazwa na zakładce, np. „Dostawa”. Wymagany w języku domyślnym, najwyżej 255 znaków, sam tekst bez formatowania.
• Treść — zawartość zakładki z edytorem: nagłówki, listy, tabele, linki, obrazki. Wymagana w języku domyślnym.
• Gdzie pokazywać — wszystkie produkty, produkty z kategorii poniżej albo produkty marek poniżej.
• Kategorie — drzewo kategorii; zaznacz kategorie dla drugiej opcji.
• Marki — lista Twoich marek; zaznacz marki dla trzeciej opcji.
• Włączona — pokazuje albo ukrywa zakładkę w sklepie.
• Sklepy — tylko w trybie multistore: sklepy, w których zakładka się pojawia.

Przełącznikiem języka obok pól tytułu i treści wpisujesz kolejne języki. Języki pozostawione puste dostają przy zapisie tekst z języka domyślnego.

5. Multistore

Każda zakładka należy do jednego lub kilku sklepów. Lista pokazuje zakładki sklepu albo grupy sklepów wybranej w nagłówku panelu; wybierz Wszystkie sklepy, żeby zobaczyć wszystkie. Widzisz tylko zakładki sklepów, do których masz dostęp.

• Nowa zakładka jest proponowana dla sklepów z bieżącego wyboru; zmienisz je w polu Sklepy. Pracownik z dostępem do jednego sklepu nie widzi tego pola: jego zakładki należą do tego sklepu.
• Tytuł, treść, status, kolejność i miejsce wyświetlania są wspólne dla wszystkich sklepów zakładki.
• Usuń zabiera zakładkę ze sklepów wybranych w nagłówku. Zakładka znika całkowicie, gdy nie zostaje w żadnym sklepie; przy wybranych Wszystkich sklepach jest usuwana od razu.
• Pracownik, który ma dostęp tylko do części sklepów, edytuje, włącza, wyłącza i przesuwa tylko zakładki pokazywane wyłącznie w jego sklepach. Zakładka wspólna z innymi sklepami zostaje bez zmian, a panel wyświetla komunikat; Usuń zabiera ją tylko z jego sklepów, w pozostałych zostaje.

Jedna licencja obejmuje wszystkie sklepy instalacji.

6. Odinstalowanie

Menedżer modułów → Wspólne zakładki produktu → Odinstaluj usuwa tabele modułu razem ze wszystkimi zakładkami i ich treścią. Tego nie da się cofnąć. Żeby ukryć zakładki i je zachować, użyj opcji Wyłącz. Opcja Wyczyść także usuwa zakładki.

7. Najczęstsze pytania i problemy

Zakładka nie pojawia się na produkcie. Sprawdź, czy zakładka jest włączona, czy należy do sklepu, który oglądasz, i czy produkt pasuje: musi być przypisany do zaznaczonej kategorii (Katalog → Produkty → produkt → Kategorie) albo mieć zaznaczoną markę. Jeśli nie widać żadnej zakładki, sprawdź w Wygląd → Pozycje, czy moduł jest podpięty pod displayProductExtraContent, a potem wyczyść pamięć podręczną w Zaawansowane → Wydajność.

Mój szablon w ogóle nie pokazuje zakładek. Niektóre szablony nie wyświetlają dodatkowej treści karty produktu. Szablony Classic i Hummingbird ją wyświetlają. Poproś autora szablonu o wyświetlanie product.extraContent na karcie produktu.

W polskim sklepie zakładka ma angielski tekst. Ten język został pusty, więc używany jest język domyślny. Edytuj zakładkę i uzupełnij ten język.

Czy mogę dodać film? Tak, jeśli w Preferencje → Ogólny włączona jest opcja Pozwól na iframes w polach HTML. W przeciwnym razie moduł odrzuci ramkę iframe przy zapisie.

Czy mogę zmienić wygląd zakładki? Tak. Treść korzysta z klas, którymi szablon formatuje opis produktu. Możesz też skopiować views/templates/hook/tab-content.tpl do themes/<twój-szablon>/modules/ap_producttabs/views/templates/hook/ i zmienić kopię (potem wyczyść pamięć podręczną w Zaawansowane → Wydajność) albo dodać w szablonie style dla klasy .ap-producttabs-tab.

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ł. Twoje zakładki 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.

Wróć do: Instrukcje modułów