Banner Revolution: konfiguracja i pomoc
Szybki start
- Prześlij i zainstaluj ZIP Banner Revolution w Moduły > "Module Manager".
- Otwórz "Improve" > Banner Revolution i kliknij Dodaj nowy baner.
- Wybierz slider homepage i prześlij Obraz na komputer.
- Uzupełnij Tytuł, Podtytuł oraz ewentualne Tekst przycisku i URL przycisku dla swoich języków; pozostaw Aktywny włączone i zapisz.
- Otwórz "Settings" > Konfiguracja > Karuzela i sprawdź Odstęp między slajdami, Automatyczne odtwarzanie i Przejście.
- Sprawdź stronę główną przy szerokości poniżej i powyżej 768 pikseli, a następnie przetestuj przycisk i nawigację slajdów.
Wymaga PrestaShop 1.7.7 lub nowszego oraz PHP 7.1 lub nowszego.
Instrukcja konfiguracji
Instalacja i wybór pozycji na stronie głównej
Prześlij ZIP Banner Revolution w Moduły > "Module Manager" > "Upload a module". Zainstaluj go i kliknij "Configure". Możesz też otworzyć "Improve" > Banner Revolution.
Instalacja tworzy tabele banerów, katalog obrazów i slider homepage. Usuwa ps_imageslider z displayHome. W motywie używającym displayHomeIntro umieszcza tam Banner Revolution i usuwa jego przypisanie do displayHome. Inne motywy używają displayHome. Sugerowana pozycja to pierwsze miejsce w tym hooku.
W "Settings" > Konfiguracja użyj Położenie na stronie głównej > "Apply suggested placement", jeśli zmieniasz motyw lub chcesz przywrócić tę pozycję. Przed zastosowaniem wybierz jeden sklep. Zwykłe żądania witryny zachowują zapisane pozycje hooków.
Proces PHP wymaga prawa zapisu do katalogu obrazów modułu i katalogu pamięci podręcznej PrestaShop. Wybierz właściwy sklep przed edycją przetłumaczonej treści banerów.
Dodawanie wideo i dostosowanie układu na telefonie
Obrazy pozostają obrazem podglądu i materiałem zastępczym, gdy nie można odtworzyć wideo lub odwiedzający preferuje ograniczenie animacji.
Widoczny przycisk pauzy zatrzymuje lub wznawia zmianę slajdów, wideo i efekt Ken Burns. Na slajdzie z wideo pasek postępu pozwala też zmieniać pozycję odtwarzania kliknięciem, przeciągnięciem lub klawiszami strzałek po zaznaczeniu paska; podczas obsługi pojawia się czas odtwarzania.
| Pole | Domyślnie | Kiedy zmienić |
|---|---|---|
| Wideo na komputer (MP4) | Puste | Dodaj plik MP4 H.264 do 8 MB. Formularz zaleca 1920 x 600. |
| Wideo na komputer (WebM) | Puste | Dodaj to samo wideo w WebM dla obsługujących go przeglądarek. Limit: 8 MB. |
| Wideo na telefon (MP4) | Puste | Podaj osobne wideo dla szerokości poniżej 768 pikseli. Limit: 8 MB. |
| Usuń filmy | Wyłączone | Włącz, aby usunąć zapisane pliki wideo z tego slajdu. |
| Wideo ma dźwięk | Wyłączone | Wyświetla przycisk dźwięku. Wideo zawsze zaczyna się bez dźwięku; odwiedzający włączają go samodzielnie. |
| Czas slajdu | 0 sekund |
Nadpisuje globalny odstęp dla slajdu ze zdjęciem. 0 używa ustawienia slidera. Odtwarzane wideo przechodzi dalej po zakończeniu; ten czas jest wartością zastępczą. |
| Układ na telefonie | Tekst na obrazie | Wybierz Obraz lub wideo nad tekstem, aby ustawić elementy jeden pod drugim na telefonie. |
| Szerokość cienia pod tekstem | 0 procent |
Określ miejsce zanikania przyciemnienia pod tekstem na komputerze. 0 używa wbudowanej wartości domyślnej. |
Ustawianie działania karuzeli
Otwórz "Settings" > Konfiguracja > Karuzela. Opcje te obowiązują globalnie dla wszystkich sliderów.
| Ustawienie | Domyślnie | Działanie |
|---|---|---|
| Odstęp między slajdami | 5000 ms |
Czas między slajdami ze zdjęciami, chyba że slajd ma własny czas wyświetlania. |
| Automatyczne odtwarzanie | Włączone | Automatycznie zmienia slajdy. Wyłącz dla nawigacji ręcznej. |
| Pokaż strzałki | Włączone | Pokazuje strzałki poprzedniego i następnego slajdu, gdy istnieje kilka banerów. |
| Pokaż wskaźniki | Włączone | Pokazuje kropki nawigacji, gdy istnieje kilka banerów. |
| Przejście | slide |
Wybierz Slajd lub Zanikanie. |
| Wysokość banera | 500 px |
Wartość jest zapisywana, ale nie ustawia wyświetlanej wysokości karuzeli. |
W obecnej karuzeli dostosuj wysokość za pomocą CSS motywu i Układ na telefonie. Skrypt telefonu rezerwuje wysokość najwyższego slajdu, aby ograniczyć przesunięcia między slajdami. Starsze nadpisanie motywu może nadal korzystać z Wysokość banera; sprawdź ten szablon, zanim oprzesz się na tym ustawieniu.
Zapisana wartość domyślna KENBURNS jest włączona. Bieżący formularz konfiguracji nie udostępnia przełącznika Ken Burns. Preferencje ograniczonego ruchu wpływają na animacje.
Użyj wspólnych ustawień Style motywu, aby dopasować wygląd do sklepu. Style banerów odczytują bezpośrednio wspólne tokeny --mpr-*. Odśwież wykryte style po zmianie motywu. Nie opieraj się na starszych aliasach --mprbanner-*.
Wyświetlanie slidera w szablonie motywu
Umieszczenie na stronie głównej jest automatyczne. Programista może też wywołać widget z szablonu Smarty:
{widget name='mprbannerrevolution'}
{widget name='mprbannerrevolution' slider='homepage'}
{widget name='mprbannerrevolution' slider_id=1}
Domyślny proces administracyjny zarządza banerami. Dodatkowe rekordy sliderów mogą wymagać programisty lub kontrolowanego importu danych. Dla slidera utworzonego przez programistę z identyfikatorem sale użyj:
{widget name='mprbannerrevolution' slider='sale'}
Nie ma harmonogramu dat wyświetlania banerów. Pozostaw slajd kampanii nieaktywny do momentu, gdy chcesz go pokazać, a następnie zmień Aktywny ręcznie.
Dla nowoczesnych formatów obrazów umieść pasujące pliki AVIF lub WebP obok skonfigurowanego obrazu. Na przykład banner-1-desktop.jpg może mieć banner-1-desktop.avif i banner-1-desktop.webp. Mechanizm renderowania wykrywa istniejące warianty; nie tworzy ich. To samo dotyczy obrazów mobilnych.
W CSS motywu sprawdź obecne kontenery:
.mpr-banner-revolution { margin-bottom: 1.5rem; }
.mpr-bnr__title { text-transform: uppercase; }
.mpr-bnr__cta { border-radius: var(--mpr-radius, 8px); }
Sprawdzanie witryny sklepu
- Otwórz stronę główną w każdym skonfigurowanym języku i sklepie.
- Potwierdź, że właściwe aktywne banery pojawiają się w kolejności pozycji. Baner bez dostępnego obrazu na komputer lub telefon jest pomijany.
- Przy kilku slajdach przetestuj strzałki, kropki, strzałki klawiatury i gesty przesuwania.
- Zmniejsz szerokość poniżej 768 pikseli i sprawdź obraz mobilny, wideo oraz układ na telefonie.
- Przetestuj każdy adres przycisku i sterowanie dźwiękiem wideo.
- Odśwież po zmianie banera. Wygenerowana zawartość jest buforowana według sklepu, języka, umiejscowienia, parametrów widgetu, wersji i konfiguracji.
Obraz pierwszego slajdu ładuje się od razu. Kolejne obrazy są ładowane według potrzeb. Wideo korzysta z odroczonych źródeł. Te zachowania nie wymagają ustawienia.
Rozwiązywanie problemów z wyświetlaniem i przesyłaniem
Jeśli baner się nie pojawia, sprawdź Aktywny, wybrany slider i plik obrazu. Potwierdź, że motyw wywołuje wybrany hook strony głównej. Użyj "Apply suggested placement" we właściwym sklepie, jeśli rejestracja hooka jest błędna.
Jeśli przesyłanie nie działa, sprawdź limity modułu, limity przesyłania PHP i prawo zapisu do modules/mprbannerrevolution/img/. W przypadku wideo sprawdź także kontener, rozmiar i obsługę kodeka w przeglądarce.
Jeśli strona główna nadal pokazuje inny slider, sprawdź jego rejestracje hooków na ekranie pozycji PrestaShop. Instalacja usuwa natywny slider obrazów z displayHome, ale motyw może wyświetlać inny slider w innym miejscu.
Jeśli treść lub style wyglądają na stare, zapisz konfigurację ponownie i wyczyść odpowiednie pamięci podręczne PrestaShop, stron i CDN. Sprawdź nadpisanie banner-carousel.tpl w motywie przed zmianą plików modułu.
Odinstalowanie
Wykonaj kopię danych banerów i mediów przed odinstalowaniem przez "Module Manager". Odinstalowanie usuwa konfigurację modułu i wpisy menu oraz trzy tabele banerów/sliderów podczas czyszczenia schematu. Ponownie rejestruje też zainstalowany moduł ps_imageslider w displayHome. Następnie sprawdź pozycje strony głównej.
Zgodność
Wymaga PrestaShop 1.7.7 lub nowszego oraz PHP 7.1 lub nowszego.
Pytania
1
Jakie informacje są przechowywane w tabelach banerów?
Tabele banerów Banner Revolution przechowują definicje sliderów, nazwy plików multimedialnych, opcje wyświetlania oraz teksty i linki banerów dla każdego języka i sklepu. Te tabele nie zawierają profili klientów ani historii śledzenia odwiedzających.
Znane problemy
16
Automatyczne odtwarzanie karuzeli banerów nie zatrzymuje się, gdy karta nie jest widoczna
Pokaz slajdów z banerami przesuwa się dalej, gdy karta przeglądarki jest w tle, zużywając CPU. Po powrocie użytkownik widzi losowy slajd zamiast miejsca, w którym skończył.
Informacja o rozwiązaniu
Dodano sprawdzanie przez Page Visibility API, aby wstrzymywać automatyczne odtwarzanie.
Położenie na stronie głównej zmieniało się niespodziewanie
Tekst na szerokich slajdach był przycinany
Zmiany tekstu banerów nie były widoczne
Błędy zgodności wykrywania motywu
Karuzela poruszała się podczas wyboru zgody na cookies
Brakujące lub nieprawidłowe tłumaczenia
Karuzela motywu obsługiwała nawigację dwukrotnie
Brak działań w wierszach banerów
Strona ustawień modułu nie otwierała się
Wskaźniki slajdów nie aktualizowały się prawidłowo
Problemy z przesuwaniem i tekstem slajdów na urządzeniach mobilnych
Zgodność z buforowaniem połączonych zasobów
Szybkie kliknięcia zakłócały przejścia karuzeli
Uszkodzone obrazy banerów
Filtry listy banerów działały nieprawidłowo
Zgłoszenia funkcji
11
Zaimplementowane
Harmonogram banerów z datą początku i końca
Nowoczesne formaty obrazów banerów
Ustawienia stylu motywu
Kontrola i naprawa instalacji
Aktualizacje z panelu administracyjnego
Wyróżnione funkcje na slajdach
Nawigacja przeciąganiem i przesuwaniem
Konfigurowalne komunikaty budujące zaufanie
Slajdy banerów wideo
Przewijanie wideo
Tekst banerów wielokrotnego użytku
Dziennik zmian
v1.3.42026-05-27
- AddedAVIF support in picture element for banner images
- Addedautomatic theme detection for Classic and Hummingbird
- Addedcomplete FR/DE/ES/IT/PL translations
- ImprovedCache rendered banner widgets
- ImprovedStart autoplay on human interaction, not fixed timeout
- ImprovedDelay autoplay to 30s from navigation start
- FixedRestore banner list row actions
- FixedAvoid banner query cache pollution
- FixedCarousel fade transitions — inline styles, rapid-click interrupt
- FixedAdd migrateFromPsConfiguration for ps_configuration cleanup
Starsze wersje
v1.2.02026-04-20
- Addedself-healing integrity checks for automatic diagnostics and repair
- Addedadmin menu management via MenuInstaller for streamlined module setup
- AddedLicense management tab with key management and renewal options
- Addedcomplete FR/DE/ES/IT/PL translations
- FixedChange Previous/Next translation from d= domain to mod= to match PHP translation files
- Fixedadmin list filters — sorting, searching, and filtering now work correctly on all columns
v1.1.02026-01-22
- AddedPrestaShop 9 and Hummingbird theme compatibility
- Addedlazy loading for off-screen banner slides to improve Core Web Vitals LCP score
- ImprovedA/B testing engine with persistent variant assignment via localStorage cookie
- Fixedcountdown timer resetting on slide transition when multiple timers are active simultaneously
- Optimized video background preloading to respect the Save-Data browser header
- AddedARIA roles and keyboard navigation for WCAG 2.1 accessibility compliance
v1.0.02025-02-19
- Initialrelease of Banner Revolution
- InitialFull-width hero carousel with touch and swipe support on mobile
- InitialText overlays with configurable font size, color, weight, and position per slide
- InitialCall-to-action buttons with hover effect presets and configurable URLs
- InitialVideo background support for MP4 and WebM with poster image fallback
- InitialCountdown timers per slide for flash-sale and limited-time offer banners
- InitialA/B testing: split traffic between two banner variants and track click-through rates in back office
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.
Pobierając, akceptujesz warunki dema i politykę prywatności.
Otwierając to demo, akceptujesz regulamin wersji demo oraz politykę prywatności.
