Showcase Revolution: konfiguracja i pomoc

Szybki start

  1. Prześlij i zainstaluj mprshowcaserevolution, a następnie kliknij "Configure".
  2. Otwórz Showcase Revolution > Ustawienia > Konfiguracja, aby sprawdzić ustawienia domyślne; pozostaw moduł włączony w "Module Manager".
  3. Otwórz Widgety i dodaj widget z polem Tytuł oraz wartością "New Products" w polu Typ widgetu.
  4. Ustaw Hook (umiejscowienie) na displayHome, Liczba produktów na 8 i Aktywny na Tak.
  5. Ustaw Układ na "Grid", liczbę produktów w wierszu na komputerze na 4, a na urządzeniu mobilnym na 2, po czym kliknij Zapisz.
  6. Otwórz stronę główną i sprawdź, czy pojawiają się kwalifikujące się produkty.
  7. W razie potrzeby przełącz na "Slider" i sprawdź nawigację, kropki, autoodtwarzanie, ceny oraz elementy sterujące koszykiem w swoim motywie.

Wymaga PrestaShop 1.6.1 lub nowszego oraz PHP 7.1 lub nowszego.

Instrukcja konfiguracji

Instalacja i utworzenie pierwszego widgetu

Prześlij i zainstaluj mprshowcaserevolution w Moduły > "Module Manager". Kliknij "Configure", aby otworzyć panel. W "Improve" > Showcase Revolution znajdziesz Widgety, Kolekcje oraz Ustawienia > Konfiguracja. Podmenu Ustawienia zawiera również Integralność, Licencja, Wsparcie i Aktualizuj.

Wymaga PrestaShop 1.6.1 lub nowszego oraz PHP 7.1 lub nowszego.

Na pierwszy test otwórz Widgety, dodaj widget, wpisz Tytuł i wybierz Typ widgetu: "New Products", Hook (umiejscowienie): "Homepage (displayHome)", Układ: "Grid", Liczba produktów: 8 oraz Aktywny: Tak. Wpisz 4 produkty w wierszu na komputerze i 2 na urządzeniu mobilnym. Zapisz i otwórz stronę główną.

Ekran konfiguracji

Funkcje

Ustawienie Domyślnie Działanie podczas wykonywania
"Enable module" Tak Zapisywana preferencja; nie steruje wyświetlaniem.
"Enable widgets" Tak Zapisywana preferencja; nie steruje wyświetlaniem.
"Enable collections" Tak Zapisywana preferencja; nie zmienia wyświetlanych produktów kolekcji.
"Enable trending products" Tak Zapisywana preferencja; nie steruje wyświetlaniem.
"Enable back-in-stock products" Tak Steruje rejestrowaniem zmian stanu magazynowego. Istniejące dane źródłowe to oddzielna kwestia.

Steruj rzeczywistym wyświetlaniem za pomocą stanu włączenia modułu w "Module Manager" lub ustawienia Aktywny widgetu. Oddzielne pole konfiguracyjne "Enable module" nie zastępuje tych opcji.

Domyślne ustawienia widgetów

Ustawienie Zapisana wartość domyślna
"Default widget layout" "Slider"
"Products count" 8
"Products per row" 4
"Products per row on mobile" 2
"Show navigation arrows" Tak
"Show pagination dots" Tak
"Autoplay slider" Nie
"Autoplay speed" 5000 ms

Są to zapisane preferencje globalne. Istniejące widgety mają własne pola. Ustaw każdy nowy widget jawnie; nie zakładaj, że zmiana preferencji globalnej aktualizuje zapisane wartości widgetów lub wstępnie wypełnia każde pole edytora.

Trendy

Ustawienie Domyślnie Zastosowanie
"Views weight" 0.3 Udział wyświetleń w wyniku tempa wzrostu. Wartość zero powoduje użycie 0.3.
"Sales weight" 0.7 Udział sprzedaży. Wartość zero powoduje użycie 0.7.
"Recalculate every" 6 godzin Zapisywana preferencja; w tym module nie podłączono do niej zaplanowanego przeliczania.
"Minimum views" 3 Minimalna liczba wyświetleń z siedmiu dni wymagana do uwzględnienia. Wartość zero powoduje użycie 3.
"Back-in-stock window" 30 dni Zakres historii uzupełnień stanu używany przez to źródło.
"Back-in-stock minimum quantity" 1 Zapisywana preferencja; powrót na stan jest rejestrowany przy zmianie stanu na dowolną dodatnią ilość.

Po zebraniu wyświetleń użyj w panelu opcji ręcznego przeliczania trendów. Wyniki łączą zarejestrowane wyświetlenia i sprzedaż z prawidłowych zamówień. Wyświetlenia produktów są rejestrowane przez actionObjectProductViewAfter; sprawdź, czy Twój sklep lub integracja wywołuje ten hook. Rejestrowanie powrotów do magazynu używa actionUpdateQuantity i porównuje ilość widoczną w zapisanych danych z nową ilością przekazaną przez hook. Sprawdź to przejście w swoim procesie aktualizacji stanów magazynowych.

Wydajność

Ustawienie Domyślnie Działanie podczas wykonywania
"Track product clicks" Tak Zapisywana preferencja; kliknięcia są rejestrowane niezależnie od tego przełącznika.
"Track product views" Tak Włącza hook rejestrujący wyświetlenia produktów.
"Cache widget HTML" Tak Zapisywana preferencja; nie włącza ani nie wyłącza buforowania HTML.
"Cache TTL" 3600 sekund Zapisywana preferencja; buforowana treść wygasa po stałym okresie 1800 sekund.

HTML zawierający cenę lub element dodawania do koszyka jest wyłączony ze wspólnej pamięci podręcznej HTML widgetów. Źródła osobiste również są z niej wyłączone. Karuzele zgodne z Warehouse mają dodatkową pamięć podręczną wyboru i uproszczonych kart; spersonalizowane dane produktów pierwszego wiersza są renderowane w kontekście odwiedzającego.

Style motywu

Wartości domyślne pochodzą ze wspólnego systemu stylów motywu. Moduł rejestruje --mpr-sc-primary, --mpr-sc-accent, --mpr-sc-filter-bg, --mpr-sc-radius, --mpr-sc-shadow-hover i --mpr-sc-transition. "Card gap" ma domyślną wartość 16px i dostarcza --mpr-sc-gap. Zmień wspólne opcje stylów, gdy chcesz dostosować wykrytą paletę lub odstępy. Mapowania primary-hover i zwykłego cienia nie są dostępne.

Ekran widgetów

Edytor ma karty Ogólne, Wyświetlanie i Zaawansowane. Poniższe wartości domyślne opisują wartości ze schematu; wpisz je jawnie, gdy nowy formularz jest pusty.

Ogólne

Ustawienie Domyślnie Działanie
Tytuł Puste Wymagany nagłówek wielojęzyczny.
Podtytuł Puste Opcjonalny wielojęzyczny tekst dodatkowy.
Typ widgetu "Best Sellers" Wybiera źródło produktów.
Zakres kategorii Wszystkie kategorie, 0 Ogranicza obsługiwane źródła do wybranej kategorii; podkategorie nie są uwzględniane automatycznie.
Kolekcja 0 Wybierz zapisaną kolekcję dla "Curated Collection".
Hook (umiejscowienie) displayHome Wybiera hook w części sklepowej.
Liczba produktów 8 Maksymalna liczba żądanych produktów. Po sprawdzeniu kwalifikacji i obrazów może pojawić się ich mniej.
Okres (dni) Puste Ogranicza historię sprzedaży bestsellerów lub zastępuje zakres czasu dla nowych produktów.
Aktywny Tak Steruje widocznością tego widgetu.

Dostępne źródła to "Best Sellers", "New Products", "On Sale", "Featured Products", "Trending Now", "Curated Collection", "Back in Stock", "Recently Viewed" i "Cart Recommendations". "Recently Viewed" jest na liście, ale nie zwraca produktów; nie wybieraj go do działającego bloku.

"Cart Recommendations" wymaga włączonego modułu MPR Sales Revolution, załadowanego koszyka oraz produktów w nim. Pozostałe źródła działają niezależnie od tej integracji. "Featured Products" używa ustawienia Zakres kategorii lub skonfigurowanej kategorii produktów polecanych. Ustawienie Zakres kategorii nie jest stosowane przez wszystkie źródła, w tym ścieżki kolekcji i rekomendacji koszykowych.

Wyświetlanie

Ustawienie Domyślnie Działanie
Układ "Slider" "Grid", "Slider", "Carousel", "List" lub "Compact".
Produkty w wierszu (desktop) 4 Kolumny na komputerze lub widoczne slajdy.
Produkty w wierszu (mobile) 2 Kolumny lub slajdy na urządzeniu mobilnym.
Pokaż strzałki nawigacji Tak Elementy nawigacji karuzeli.
Pokaż kropki Tak Elementy paginacji karuzeli.
Autoodtwarzanie Nie Włącza automatyczne przesuwanie slidera/karuzeli.
Szybkość autoodtwarzania (ms) 5000 Opóźnienie autoodtwarzania.
Pokaż ceny Tak Steruje widocznością przygotowanych cen oraz widokiem listy/kompaktowym modułu. Miniatury nowoczesnych motywów również otrzymują dostosowane dane prezentacji; sprawdź, jak Twój motyw ich używa.
Pokaż dodawanie do koszyka Tak Steruje przygotowaną dostępnością dodawania do koszyka i widokiem listy modułu. Sprawdź, jak wykorzystuje to Twój motyw.
Pokaż opis Nie Zapisywane pole; nie pokazuje ani nie ukrywa opisów.
Ukryj produkty bez zdjęć Tak Wyklucza produkty bez użytecznego obrazu okładki w sklepie.
Tekst linku Puste Opcjonalna wielojęzyczna etykieta linku w nagłówku.
URL linku Puste Opcjonalny adres docelowy linku w nagłówku.

"Grid", "Slider" i "Carousel" zwykle używają natywnej miniatury produktu z motywu w nowoczesnych wersjach PrestaShop. PrestaShop 1.6 korzysta ze starszego szablonu modułu. "List" i "Compact" używają mniejszych szablonów modułu. Kropki i autoodtwarzanie są przekazywane do bieżącego renderera karuzeli.

Zaawansowane

Ustawienie Sortuj według jest zapisywane, ale automatyczne źródła zachowują własną kolejność zapytań. Pole Klasa CSS jest domyślnie puste i dodaje klasę kontenera. Pole Własny CSS jest domyślnie puste i wyświetla blok stylów. Pozycja ma domyślną wartość 0 i porządkuje widgety w obrębie hooka.

Własny CSS nie jest automatycznie ograniczany do widgetu. Uwzględnij wartość pola Klasa CSS w swoich selektorach:

.homepage-staff-picks .mpr-showcase-widget__title {
  text-transform: uppercase;
}

Baza danych zapisuje również sort_dir z domyślną wartością DESC i show_manufacturer z domyślną wartością 0; nie są to opcje dostępne w bieżącym formularzu widgetu.

Ekran kolekcji

Utwórz kolekcję z polami Nazwa, opcjonalnym polem Opis z edytorem tekstu sformatowanego, Typ, Data rozpoczęcia, Data zakończenia, Aktywny i Pozycja. Nazwa i opis są domyślnie puste, Typ ma wartość curated, daty są puste, Aktywny ma wartość Tak, a Pozycja 0. Dostępne typy to curated, staff_picks, seasonal i spotlight.

Dodaj wybrane produkty, zmień ich kolejność, a następnie zapisz widget z Typ widgetu: "Curated Collection" i odpowiednią wartością pola Kolekcja. Produkty korzystają ze swojej zapisanej pozycji w kolekcji.

Daty i ustawienie Aktywny wpływają na zapytania o kolekcje, które żądają wyłącznie aktywnych pozycji. Bezpośrednie wyszukiwanie produktów kolekcji przez widget nie sprawdza tych pól harmonogramu. Steruj widgetem kolekcji za pomocą jego własnego przełącznika Aktywny; nie polegaj na datach kolekcji, aby ukryć już przypisany widget.

Na przykład utwórz kolekcję o nazwie Summer Picks, a następnie skonfiguruj:

Title: Summer Picks
Widget Type: Curated Collection
Collection: your saved collection
Hook (Placement): displayHome
Layout: Grid
Products Count: 8
Active: Yes

Umiejscowienie i dostosowanie motywu

Obsługiwane hooki to:

displayHome
displayFooterCategory
displayLeftColumn
displayRightColumn
displayFooterBefore
displayFooterProduct
displayProductAdditionalInfo
displayOrderConfirmation2
displayCrossSellingShoppingCart
displayNotFound

Motyw musi wywoływać wybrany hook. Dla niestandardowej stopki produktu:

{hook h='displayFooterProduct'}

Nie ma renderera shortcode’ów CMS. Użyj obsługiwanego hooka.

Ścieżki nadpisywania w motywie obejmują:

themes/your_theme/modules/mprshowcaserevolution/views/templates/front/widget.tpl
themes/your_theme/modules/mprshowcaserevolution/views/templates/front/_product-miniature-widget.tpl
themes/your_theme/modules/mprshowcaserevolution/views/templates/front/layouts/list-item.tpl
themes/your_theme/modules/mprshowcaserevolution/views/templates/front/layouts/compact-item.tpl

Przydatne selektory to .mpr-showcase-widget, jego modyfikatory --grid, --slider, --carousel, --list i --compact, .mpr-showcase-widget__title, .mpr-showcase-widget__subtitle, .mpr-showcase-widget__link, .mpr-showcase-slider__nav, .mpr-list-item oraz .mpr-compact-item.

Weryfikacja i rozwiązywanie problemów

  1. Sprawdź, czy pierwszy widget "Grid" wyświetla produkty w wybranym hooku.
  2. Zmień go na "Slider" i przetestuj strzałki, kropki oraz autoodtwarzanie na komputerze i urządzeniu mobilnym.
  3. Sprawdź opcje cen i dodawania do koszyka w faktycznie używanym motywie.
  4. Kliknij produkt widgetu i sprawdź żądanie trackClick, jeśli zależy Ci na rejestrowaniu kliknięć.
  5. Przetestuj oddzielnie źródło kolekcji i rekomendacji koszykowych, zanim użyjesz ich ponownie w innych miejscach.

Kontener nie jest wyświetlany, jeśli źródło nie zwraca produktów nadających się do prezentacji. Sprawdź stan aktywności, powiązanie z bieżącym sklepem, dokładny hook, kwalifikację źródła, kategorię, obrazy okładek oraz liczbę produktów. "Best Sellers" wymaga sprzedaży, a "Trending Now" zarejestrowanych wyświetleń i przeliczenia. "Back in Stock" wymaga zarejestrowanych zmian stanu magazynowego. "Recently Viewed" nie zwraca produktów w tej wersji.

Jeśli zmiany pojawiają się z opóźnieniem, uwzględnij stałe 30-minutowe pamięci podręczne i pamięć podręczną sklepu/motywu. Jeśli harmonogram kolekcji wydaje się ignorowany, użyj własnej opcji Aktywny widgetu. Jeśli motyw ignoruje flagi cen lub przycisków, sprawdź jego szablon miniatury.

Odinstalowanie

Przed odinstalowaniem wyeksportuj lub zapisz widgety i kolekcje. Odinstalowanie usuwa menu administracyjne, rejestrację zarządzania kolumnami, rejestrację motywu i tabele schematu należące do modułu, w tym widgety, kolekcje, trendy oraz dane śledzenia. Standardowe odinstalowanie usuwa rejestracje hooków. Jeśli czyszczenie motywu się nie powiedzie, metoda zatrzymuje się przed usunięciem pozostałej konfiguracji. Usuń wszystkie ręcznie dodane wywołania hooków w motywie i nadpisania.

Zrzuty ekranu

Showcase Revolution, zrzut ekranu 3

Showcase Revolution, zrzut ekranu 5

Showcase Revolution, zrzut ekranu 8

Showcase Revolution, zrzut ekranu 10

Pytania

2

Jak Showcase Revolution wybiera treści w trybie multistore?

Wybór widżetów korzysta z ich przypisań do bieżącego sklepu, a listy kolekcji z przypisań kolekcji do sklepów. Wyszukiwanie produktów uwzględnia bieżący sklep, w tym jego aktywne produkty w kolekcji. Obliczenia wyświetleń i sprzedaży dla trendów również dotyczą danego sklepu. Sprawdź przypisania widżetów i kolekcji dla każdej witryny sklepowej.

Jakie działania klientów rejestruje Showcase Revolution?

Endpoint kliknięć zapisuje identyfikator produktu, widżetu i sklepu, źródło oraz czas. Hook wyświetlenia produktu może zapisywać identyfikator produktu i sklepu oraz czas na potrzeby trendów, jeśli Track product views jest włączone i hook zostanie wywołany. Obecny endpoint kliknięć nie sprawdza Track product clicks, więc wyłączenie tej zapisanej preferencji nie zatrzymuje rejestrowania kliknięć.

Znane problemy

7

Konflikty obsługi motywu między modułami

RozwiązaneZaktualizowano:
Naprawiono w: 2.7.0
Prezentacja mogła nie działać, gdy inny zainstalowany moduł dostarczał starszą wersję współdzielonej obsługi motywu.

Prezentacje renderowane później bez stylów

RozwiązaneZaktualizowano:
Naprawiono w: 2.6.2
Prezentacje renderowane później na stronie, w tym rekomendacje na nieistniejących stronach, mogły pojawiać się bez wymaganych stylów.

Łączenie zasobów sklepu

RozwiązaneZaktualizowano:
Naprawiono w: 2.5.2
Pliki modułu mogły się nie łączyć prawidłowo przy włączonej optymalizacji plików PrestaShop.

Brakujące lub uszkodzone tłumaczenia interfejsu

RozwiązaneZaktualizowano:
Naprawiono w: 2.5.2
Niektóre etykiety modułu pozostawały po angielsku lub wyświetlały uszkodzony tekst po wybraniu innego języka sklepu.

Konflikty treści nieistniejących stron

RozwiązaneZaktualizowano:
Naprawiono w: 2.5.2
Prezentacja mogła konkurować z dedykowanym modułem stron 404 na nieistniejących stronach.

Filtry listy prezentacji

RozwiązaneZaktualizowano:
Naprawiono w: 2.4.5
Niektóre filtry list w panelu administracyjnym nie filtrowały poprawnie rekordów prezentacji.

Zgodność wyświetlania cen

RozwiązaneZaktualizowano:
Naprawiono w: 2.4.5
Formatowanie cen mogło nie działać w wersjach PrestaShop, w których starsza metoda wyświetlania cen była niedostępna.

Zgłoszenia funkcji

5

Zaimplementowane

Widżet Showcase z rekomendacjami na podstawie koszyka

Zaimplementowane
Wyświetla rekomendacje produktów na podstawie aktualnej zawartości koszyka i pomija produkty, które już się w nim znajdują. Widżet wymaga aktywnego modułu mprsalesrevolution.

Prezentacje produktów

Zaimplementowane
Wyświetlaj prezentacje produktów ze stylem dopasowanym do motywu.

Rekomendacje w koszyku

Zaimplementowane
Wyświetlaj widżet rekomendacji produktów w koszyku.

Ukrywanie produktów bez zdjęć

Zaimplementowane
Wykluczaj z prezentacji produkty bez zdjęcia.

Odroczone ładowanie kart produktów w karuzeli

Zaimplementowane
Prezentacje ładują pełne karty produktów poza pierwszym widokiem, gdy zbliżają się one do obszaru ekranu, ograniczając początkowe obciążenie strony i zachowując przyciski dodawania do koszyka.

Dziennik zmian

v2.4.62026-05-27

  • AddedFinalize showcase widget endpoint SEO cleanup
  • AddedUse shared theme style tokens
  • Addedcomplete FR/DE/ES/IT/PL translations
  • FixedSimplify showcase dashboard actions
  • FixedReplace Tools::displayPrice with PriceFormatter compat wrapper
Starsze wersje

v1.1.02026-04-20

  • Addedautomatic theme detection for Classic and Hummingbird style compatibility
  • Addedadmin menu management via MenuInstaller for streamlined module setup
  • AddedLicense management tab with key management and renewal options
  • Addedself-healing integrity checks for automatic diagnostics and repair
  • Addedcomplete FR/DE/ES/IT/PL translations
  • Improvedadmin list columns with visual badge indicators and multiselect filters
  • Fixedadmin list filters — sorting, searching, and filtering now work correctly on all columns

Demo

Przetestuj pełny moduł przed zakupem

Licencję kupisz później, a ustawienia zostaną.

  • Twoje 30-dniowe demo Przetestuj go we własnym sklepie przez 30 dni od pierwszej instalacji.
  • Gotowy sklep demo Poznaj gotowy sklep demo w przeglądarce.
  • Bez rejestracji Bez konta, adresu e-mail ani domeny sklepu.
Uruchom sklep demo

Pobierając, akceptujesz warunki dema i politykę prywatności.

Otwierając to demo, akceptujesz regulamin wersji demo oraz politykę prywatności.

Ładowanie...
Do góry