Bloki treści – instrukcja obsługi modułu PrestaShop

1. Co robi moduł

Moduł wstawia Twoją treść w dowolne miejsce motywu — baner nad stopką, komunikat w nagłówku, film na stronie głównej, dodatkowy tekst pod przyciskiem „Dodaj do koszyka” — bez edycji plików motywu, które aktualizacja by nadpisała. Każdy blok treści ma własną treść w każdym języku, pisaną w tym samym edytorze co opisy produktów, oraz hook: miejsce motywu, w którym się pojawia. Blok możesz pokazywać tylko między dwiema datami, tylko na wybranych rodzajach stron i tylko wybranym grupom klientów. Bloki włączasz, wyłączasz, ustawiasz w kolejności, duplikujesz i usuwasz z jednej listy.

Edytor zachowuje dowolny kod HTML, także skrypty, style i osadzone filmy. Bloki przejmują czcionki i kolory motywu; moduł nie dodaje własnych stylów.

Działa z PrestaShop 1.7.8, 8.x i 9.x (PHP 7.2.5 lub nowszy), z motywami Classic i Hummingbird oraz w trybie multistore.

2. Instalacja

1. Na stronie modułu w sklepie addonspresta.com kliknij Pobierz za darmo (konto nie jest potrzebne).
2. W panelu sklepu otwórz Moduły → Menedżer modułów i kliknij Załaduj moduł.
3. Upuść plik ap_contentbox_v1.0.0.zip i poczekaj na potwierdzenie.
4. Kliknij Konfiguruj na karcie modułu.

Po instalacji moduł nie ma żadnego bloku. Pierwszy dodasz przyciskiem + nad listą.

3. Jak to działa

Motyw składa się z hooków, czyli nazwanych miejsc, np. displayHome (treść strony głównej), displayFooterBefore (nad stopką) albo displayProductAdditionalInfo (obok przycisku „Dodaj do koszyka”). Gdy zapisujesz blok, moduł podpina się pod jego hook; gdy żaden blok nie korzysta już z danego hooka, moduł się od niego odpina. W Wygląd → Pozycje widać hooki motywu i podpięte pod nie moduły.

Za każdym razem, gdy strona wyświetla hook, moduł bierze włączone bloki bieżącego sklepu z tego hooka w kolejności z listy i zostawia te, które w tej chwili pasują:

• Daty — bieżący czas sklepu (strefa czasowa z Międzynarodowe → Lokalizacja) mieści się między Pokazuj od a Pokazuj do; pusta data oznacza brak ograniczenia.
• Strony — wszystkie strony albo tylko zaznaczone rodzaje stron (strona główna, kategorie, produkty, strony CMS, marki i dostawcy, wyszukiwarka i listy produktów, koszyk, zamówienie, konto klienta, pozostałe strony).
• Grupy klientów — odwiedzający należy do jednej z zaznaczonych grup. Niezalogowani są w grupie Odwiedzający, osoby kupujące bez konta w grupie Gość. Gdy funkcja grup jest wyłączona w Klienci → Grupy, PrestaShop traktuje każdego zalogowanego klienta jak członka domyślnej grupy klientów.

Treść pokazuje się w języku odwiedzającego; język pozostawiony pusty dostaje treść z języka domyślnego. Trafia do sklepu dokładnie tak, jak ją wpiszesz, razem ze skryptami: wklejaj tylko kod, któremu ufasz, a skrypty śledzące uruchamiaj dopiero po zgodzie na pliki cookie, jak wymaga RODO. Sam moduł nie zapisuje ciasteczek.

Moduł tworzy własne tabele w bazie, nie zmienia tabel PrestaShop i nie łączy się z addonspresta.com ani z żadnym innym serwerem. Daty, strony i grupy są sprawdzane przy każdym wyświetleniu strony; jeśli sklep korzysta z pamięci podręcznej całych stron, blok zmieni się po odświeżeniu tej pamięci.

4. Funkcje i ustawienia

Otwórz Moduły → Menedżer modułów → Bloki treści → Konfiguruj. Ramka Pomoc na górze prowadzi do tej instrukcji i do strony modułu w addonspresta.com, w języku Twojego panelu.

Lista bloków

Lista pokazuje bloki sklepów wybranych w nagłówku panelu, posortowane według hooka: ID, nazwę, hook, daty, strony, status i kolejność; pod każdym hookiem krótki opis mówi, gdzie się pojawia. Nad listą Pokaż bloki z zawęża ją do jednego hooka.

• Daty — Zawsze, Od …, Do … albo obie daty; Zaplanowany oznacza, że blok zacznie się później, Zakończony — że minęła data końca.
• Status — kliknij ikonę, żeby włączyć albo wyłączyć blok. Wyłączony blok zachowuje treść.
• Kolejność — strzałki przesuwają blok o jedno miejsce w górę lub w dół w obrębie jego hooka. Bloki jednego hooka pojawiają się w tej kolejności.
• Edytuj — otwiera formularz bloku.
• Duplikuj — tworzy kopię o nazwie „… (kopia)” z tą samą treścią i ustawieniami, wyłączoną, na końcu jej hooka. Zmień ją i włącz, gdy będzie gotowa.
• Usuń — pyta o potwierdzenie i usuwa blok. W trybie multistore znika tylko ze sklepów wybranych w nagłówku (zobacz Multistore).

Formularz bloku

• Nazwa — tylko dla Ciebie, widoczna na liście, np. „Baner świąteczny na stronie głównej”. Do 128 znaków.
• Hook — miejsce w motywie z krótkim opisem, gdzie się pojawia, np. displayHome — Strona główna, główna treść. Najpierw Popularne miejsca, potem Pozostałe miejsca w Twoim sklepie, w tym hooki motywu i innych modułów. Hooki panelu, plików PDF i hooki techniczne nie są dostępne.
• Treść — edytor z wyborem języka obok. Przyciskiem Kod źródłowy w edytorze wkleisz HTML, skrypt albo kod osadzenia. Wymagana w języku domyślnym.
• Włączony — pokazuje albo ukrywa blok.
• Pokazuj od / Pokazuj do — opcjonalnie, w czasie sklepu, np. 2026-12-01 08:00. Data bez godziny w polu Pokazuj do oznacza koniec tego dnia.
• Strony — Wszystkie strony albo Tylko na stronach poniżej z rodzajami stron do zaznaczenia.
• Grupy klientów — grupy, które widzą blok; w nowym bloku zaznaczone są wszystkie.
• Sklepy — tylko w trybie multistore: sklepy, w których blok się pojawia.

W szablonach motywu

Programista może wstawić bloki w szablon motywu bez hooka: {widget name='ap_contentbox' hook='displayHome'} wyświetla bloki danego hooka, {widget name='ap_contentbox' id_box=5} — blok o ID 5. Daty, strony i grupy nadal obowiązują.

5. Multistore

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

• Nowy blok jest proponowany dla sklepów z bieżącego wyboru; zmienisz je w polu Sklepy. Pracownik, który pracuje tylko na jednym sklepie, nie widzi tego pola: jego bloki należą do tego sklepu.
• Nazwa, hook, treść, daty, strony, grupy, status i kolejność są wspólne dla wszystkich sklepów bloku.
• Usuń usuwa blok ze sklepów wybranych w nagłówku. Blok znika całkowicie, gdy nie należy już do żadnego sklepu; przy wybranych Wszystkich sklepach znika od razu.
• Pracownik, który ma dostęp tylko do części sklepów, edytuje, włącza, duplikuje i przesuwa tylko bloki widoczne wyłącznie w jego sklepach. Blok wspólny z innymi sklepami zostaje bez zmian i pokazuje komunikat; Usuń zdejmuje go tylko ze sklepów tego pracownika.

6. Odinstalowanie

Menedżer modułów → Bloki treści → Odinstaluj usuwa tabele modułu ze wszystkimi blokami i ich treścią. Tego nie da się cofnąć. Żeby ukryć bloki i je zachować, użyj Wyłącz. Resetuj również usuwa bloki.

7. Najczęstsze pytania i problemy

Blok się nie pokazuje. Sprawdź, czy jest włączony, czy jego daty obejmują bieżący czas (lista pokazuje Zaplanowany albo Zakończony), czy należy do sklepu, który oglądasz, czy rodzaj strony i Twoja grupa klientów są zaznaczone i czy oglądasz stronę, która wyświetla ten hook. Potem sprawdź w Wygląd → Pozycje, czy moduł jest podpięty pod hook (zapis bloku podpina go ponownie), i wyczyść pamięć podręczną w Zaawansowane → Wydajność.

Wybrałem hook, ale w moim motywie nic się nie pojawia. Nie każdy motyw wyświetla każdy hook. Wybierz jedno z popularnych miejsc albo zapytaj autora motywu, które hooki motyw wyświetla.

Mój skrypt się nie uruchamia. Wklej go przyciskiem Kod źródłowy w edytorze i sprawdź błędy w konsoli przeglądarki. Skrypty, które potrzebują biblioteki, np. jQuery, działają tylko wtedy, gdy motyw ładuje ją przed nimi.

Czy mogę dodać film albo mapę? Tak. Wklej kod osadzenia (<iframe>) przyciskiem Kod źródłowy.

W polskim albo francuskim sklepie blok pokazuje angielski tekst. Ten język został pusty, więc używany jest język domyślny. Edytuj blok i uzupełnij ten język.

Czy mogę zmienić wygląd bloków? Tak. Ostyluj w motywie klasę .ap-contentbox (każdy blok) albo .ap-contentbox-5 (blok o ID 5) lub skopiuj views/templates/hook/boxes.tpl do themes/<twój-motyw>/modules/ap_contentbox/views/templates/hook/, zmień kopię i wyczyść pamięć podręczną w Zaawansowane → Wydajność.

8. Aktualizacje i wsparcie

Aktualizacje są bezpłatne: nowe wersje pobierzesz ze strony modułu w addonspresta.com i wgrasz jak nowy moduł. Bloki zostają. Każda wersja przed publikacją przechodzi nasz audyt bezpieczeństwa.

Ten bezpłatny moduł ma tę samą licencję co nasze moduły płatne (jeden sklep z dowolną liczbą sklepów multistore, kod możesz zmieniać, ale nie udostępniać) i jest bez wsparcia technicznego. Jeśli potrzebujesz pomocy przy instalacji lub konfiguracji, możemy ją zaproponować jako płatną usługę. Błędy bezpieczeństwa zgłaszaj na mail@addonspresta.com — naprawiamy je w pierwszej kolejności.

Wróć do: Instrukcje modułów