Banner Revolution: Einrichtung und Hilfe

Laden Sie die ZIP-Datei von Banner Revolution unter Module > "Module Manager" > "Upload a module" hoch. Installieren Sie sie und klicken Sie auf "Configure". Sie können auch "Improve" > Banner Revolution öffnen.

Die Installation erstellt die Bannertabellen, das Bildverzeichnis und einen Slider homepage. Sie entfernt ps_imageslider aus displayHome. Bei einem Theme mit displayHomeIntro platziert sie Banner Revolution dort und entfernt dessen Platzierung in displayHome. Andere Themes verwenden displayHome. Die vorgeschlagene Position ist die erste in diesem Hook.

Verwenden Sie unter "Settings" > Konfiguration die Funktion Platzierung auf der Startseite > "Apply suggested placement", wenn Sie das Theme wechseln oder diese Position wiederherstellen müssen. Wählen Sie vor dem Anwenden einen einzelnen Shop aus. Normale Shopanfragen behalten Ihre gespeicherten Hook-Positionen bei.

Der PHP-Prozess benötigt Schreibzugriff auf das Bildverzeichnis des Moduls und das Cache-Verzeichnis von PrestaShop. Wählen Sie den gewünschten Shop, bevor Sie übersetzte Bannerinhalte bearbeiten.

Öffnen Sie die Bannerliste und klicken Sie auf Neues Banner hinzufügen. Wählen Sie den Slider homepage. Laden Sie Desktop-Bild hoch. Fügen Sie den Text in jeder Shopsprache hinzu, lassen Sie Aktiv eingeschaltet und speichern Sie. Öffnen Sie die Startseite, um das Ergebnis zu prüfen.

Das Modul speichert übersetzte Titel, Untertitel, Vorteil-Chips, Buttontexte und URLs pro Sprache und Shop. Bereiten Sie Bilder vor dem Hochladen in den benötigten Abmessungen vor; die Uploadfunktion dient nicht als allgemeiner Dienst zur Bildskalierung.

Bilder bleiben das Vorschaubild und die Ausweichdarstellung, wenn ein Video nicht abgespielt werden kann oder Besucher reduzierte Bewegung wünschen.

Mit der sichtbaren Pausenschaltfläche halten Besucher Folienwechsel, Video und Ken-Burns-Bewegung an oder setzen sie fort. Bei einer Videofolie lässt sich über die Fortschrittsleiste per Klick, Ziehen oder bei fokussierter Leiste mit den Pfeiltasten zu einer anderen Stelle springen; während der Bedienung wird die Wiedergabezeit angezeigt.

Öffnen Sie "Settings" > Konfiguration > Karussell. Diese Optionen gelten global für alle Slider.

Passen Sie beim aktuellen Karussell die Höhe über Theme-CSS und Layout auf dem Smartphone an. Das Smartphone-Skript reserviert die Höhe der höchsten Folie, um Bewegungen beim Folienwechsel zu verringern. Ein älteres Theme-Override kann Bannerhöhe weiterhin verwenden; prüfen Sie diese Vorlage, bevor Sie sich darauf verlassen.

Der gespeicherte Standardwert KENBURNS ist aktiviert. Das aktuelle Konfigurationsformular bietet keinen Ken-Burns-Schalter. Einstellungen für reduzierte Bewegung beeinflussen das Animationsverhalten.

Verwenden Sie die gemeinsamen Steuerelemente Theme-Stile, um die Gestaltung an Ihren Shop anzupassen. Bannerstile lesen die gemeinsamen Tokens --mpr-* direkt. Aktualisieren Sie die erkannten Stile nach einem Theme-Wechsel. Verlassen Sie sich nicht auf die älteren Aliase --mprbanner-*.

Die Startseitenplatzierung erfolgt automatisch. Entwickler können das Widget auch aus einer Smarty-Vorlage aufrufen:

{widget name='mprbannerrevolution'}
{widget name='mprbannerrevolution' slider='homepage'}
{widget name='mprbannerrevolution' slider_id=1}

Der normale Verwaltungsablauf verwaltet Banner. Zusätzliche Slider-Datensätze können einen Entwickler oder einen kontrollierten Datenimport erfordern. Verwenden Sie für einen vom Entwickler erstellten Slider mit der Kennung sale:

{widget name='mprbannerrevolution' slider='sale'}

Es gibt keine Datumsplanung für Banner. Lassen Sie eine Kampagnenfolie inaktiv, bis Sie sie zeigen möchten, und ändern Sie dann Aktiv manuell.

Legen Sie für moderne Bildformate passende AVIF- oder WebP-Dateien neben dem konfigurierten Bild ab. Beispielsweise kann banner-1-desktop.jpg die Varianten banner-1-desktop.avif und banner-1-desktop.webp haben. Der Renderer erkennt vorhandene Varianten; er erstellt sie nicht. Dasselbe gilt für Mobilbilder.

Prüfen Sie für Theme-CSS die aktuellen Wrapper:

.mpr-banner-revolution { margin-bottom: 1.5rem; }
.mpr-bnr__title { text-transform: uppercase; }
.mpr-bnr__cta { border-radius: var(--mpr-radius, 8px); }

1. Öffnen Sie die Startseite in jeder konfigurierten Sprache und jedem konfigurierten Shop.
2. Bestätigen Sie, dass die gewünschten aktiven Banner in Positionsreihenfolge erscheinen. Banner ohne verfügbares Desktop- oder Mobilbild werden übersprungen.
3. Testen Sie bei mehreren Folien Pfeile, Punkte, Tastaturpfeile und Wischgesten.
4. Verkleinern Sie die Breite auf unter 768 Pixel und prüfen Sie Mobilbild, Video und Smartphone-Layout.
5. Testen Sie jedes Buttonziel und jede Videotonsteuerung.
6. Laden Sie nach einer Banneränderung neu. Die gerenderte Ausgabe wird nach Shop, Sprache, Platzierung, Widgetparametern, Version und Konfiguration zwischengespeichert.

Das Bild der ersten Folie wird sofort geladen. Spätere Bilder werden bei Bedarf geladen. Videos verwenden verzögert geladene Quellen. Diese Verhaltensweisen erfordern keine Einstellung.

Wenn kein Banner erscheint, prüfen Sie Aktiv, den gewählten Slider und die Bilddatei. Stellen Sie sicher, dass Ihr Theme den gewählten Startseiten-Hook aufruft. Verwenden Sie "Apply suggested placement" im gewünschten Shop, wenn die Hook-Registrierung falsch ist.

Wenn ein Upload fehlschlägt, prüfen Sie Modulgrenzen, PHP-Uploadgrenzen und Schreibzugriff auf modules/mprbannerrevolution/img/. Prüfen Sie bei Videos außerdem Container und Größe sowie die Codec-Unterstützung des Browsers.

Zeigt die Startseite weiterhin einen anderen Slider, prüfen Sie dessen Hook-Registrierungen in der Positionsverwaltung von PrestaShop. Die Installation entfernt den nativen Bildslider aus displayHome, ein Theme kann jedoch andernorts einen anderen Slider ausgeben.

Wirken Inhalte oder Stile veraltet, speichern Sie die Konfiguration erneut und leeren Sie die betreffenden PrestaShop-, Seiten- und CDN-Caches. Prüfen Sie Theme-Overrides von banner-carousel.tpl, bevor Sie Moduldateien ändern.

Sichern Sie Bannerdaten und Medien, bevor Sie das Modul über "Module Manager" deinstallieren. Die Deinstallation entfernt Modulkonfiguration und Menüeinträge sowie die drei Banner-/Slidertabellen über die Schemabereinigung. Sie registriert außerdem ein installiertes Modul ps_imageslider wieder in displayHome. Prüfen Sie danach Ihre Startseitenpositionen.

Erfordert PrestaShop 1.7.7 oder neuer und PHP 7.1 oder neuer.