PS PrestaShop Anfänger

Kategorie-Banner: vollständiger Leitfaden

Kategorie-Banner installieren, einrichten und betreiben: Position und Größe im Raster, Mobilbild, Link pro Sprache, Zeitsteuerung in der Uhrzeit des Shops, Unterkategorien, Motive pro Sprache, Creative Elements, Multishop und Fehlerbehebung für PrestaShop 1.7, 8 und 9.

Aktualisiert Modulversion 1.3.0

Überblick und Voraussetzungen

Kategorie-Banner fügt Motive an der Position Ihrer Wahl in das Produktraster Ihrer Kategorieseiten ein. Sie legen die Kategorie fest, die Produktnummer, nach der das Banner erscheinen soll, und das Bild je Sprache. Um den Rest kümmert sich das Modul, auch nach einem Facettenfilter oder einem Seitenwechsel.

  • Kompatibel mit PrestaShop 1.7.6 bis 9.x, geprüft mit 1.7.8, 8.2.1 und 9.1.5: Classic- und Hummingbird-Theme, abgeleitete Themes, Creative-Elements-Listen, CSS-Grid-Themes.
  • PHP 7.4 bis 8.5.
  • Multishop und mehrsprachig (fr, en, es, de, it, nl, pl, pt).
  • Kein Override, keine Template-Änderung, keine CRON-Aufgabe.
  • Das Banner-Markup wird serverseitig von einem Smarty-Template erzeugt; das JavaScript setzt es lediglich an die richtige Stelle, ohne jQuery und ohne Fremdbibliothek.

Hochgeladene Bilder liegen in /img/datafireflycategorybanner/, außerhalb des Modulordners. Sie überstehen daher Modul-Updates.

PrestaShop-Kategorieseite mit einem Werbebanner im Produktraster und einem Sale-Banner über die volle Breite
Ein Banner über eine Zelle nach dem ersten Produkt und ein Sale-Banner über die ganze Zeile auf einer Kategorieseite (Hummingbird-Theme, PrestaShop 9).

Installation

  1. Laden Sie das Archiv datafireflycategorybanner.zip aus Ihrem Kundenkonto herunter.
  2. Öffnen Sie im Backoffice Module > Modul-Manager.
  3. Klicken Sie auf Modul hochladen und legen Sie das Archiv ab.
  4. Klicken Sie auf Konfigurieren, um zur Bannerliste zu gelangen.

Bei der Installation legt das Modul seine drei Tabellen an (Banner, Übersetzungen, Shop-Zuordnung), erstellt den Ordner /img/datafireflycategorybanner/ und registriert seine Hooks.

Liste der Kategorie-Banner im Backoffice: Bild, Kategorie, Position, Sprachen, Größe und Zeitplanung
Die Bannerliste: Kategorie, Position, Sprachen mit Bild, Größe und Zeitsteuerung.

Ein Banner anlegen

Klicken Sie auf der Konfigurationsseite auf Neues Banner hinzufügen. Das Formular fasst die folgenden Einstellungen zusammen.

Zielsetzung

  • Kategorie: die Kategorie, in der das Banner erscheint. Die Liste bildet den Shop-Baum ab, deaktivierte Kategorien sind gekennzeichnet.
  • Auf Unterkategorien anwenden: erweitert das Banner auf alle Unterkategorien der gewählten Kategorie, unabhängig von der Tiefe.
  • Nach Produktnummer: das Banner wird nach diesem Produkt der Liste eingefügt. Der Wert 4 platziert das Banner nach dem vierten angezeigten Produkt.
  • Nur auf der ersten Seite: zeigt das Banner nur auf der ersten Seite der Liste an, ohne es auf Seite 2, 3 usw. zu wiederholen.
Bannerformular: Kategorie, Unterkategorien, Position nach einem Produkt, nur erste Seite, Breite, Höhe und Bilddarstellung
Zielsetzung, Position, Größe im Raster und Bilddarstellung.
  • Banner-Link: Ziel-URL, absolut (https://…) oder mit einem Schrägstrich beginnend (/neuheiten). Leer lassen für ein nicht klickbares Banner.
  • Breite im Raster: Anzahl der Produktspalten, die das Banner belegt, von 1 bis 4, oder Ganze Zeile. Auf Bildschirmen mit weniger Spalten wird die Breite automatisch reduziert.
  • Höhe im Raster: Anzahl der Produktzeilen, die das Banner belegt, von 1 bis 3. Verfügbar bei Listen mit CSS-Grid (Creative Elements, die meisten neueren Themes).
  • Bilddarstellung: Bannerfläche ausfüllen beschneidet das Bild auf die Größe der Zelle, Bildproportionen beibehalten zeigt es vollständig.
  • CSS-Klasse: zusätzliche Klassen für die Bannerzelle. Leer lassen, um die Klassen der Produktzellen Ihres Themes zu übernehmen. Bei Breite und Höhe 1 gilt eine Größenklasse Ihres Themes (zum Beispiel eine, die grid-area setzt) weiterhin.
  • Eigenes CSS: Deklarationen, die nur für dieses Banner gelten, zum Beispiel border-radius: 12px; padding: 10px;.

Zeitsteuerung und Status

  • Startdatum und Enddatum: Anzeigefenster im Format JJJJ-MM-TT HH:MM:SS. Ein leeres Feld bedeutet keine Begrenzung auf dieser Seite.
  • Aktiv: zeigt das Banner an oder setzt es aus, ohne es zu löschen.
  • Shop-Zuordnung: im Multishop die betroffenen Shops ankreuzen.

Bilder pro Sprache

Die Felder Bannerbild, Mobilbild, Alternativtext und Link für diese Sprache gibt es für jede aktive Sprache. Die Sprachauswahl direkt über diesen Feldern blendet die Felder der gewählten Sprache ein. Liegt bereits ein Bild vor, erscheint eine Vorschau samt Schalter Bild löschen, der nur diese Sprache betrifft.

Zulässige Formate: JPG, PNG, GIF, WebP und SVG, bis 4 MB. Eine Breite von 1200 px passt zu den meisten Rastern.

Bannerbild, Mobilbild, Alternativtext und Link für jede Sprache des Shops
Für jede Sprache: Bild, Mobilbild, Alternativtext und optionaler Link.

Wie die Position berechnet wird

Die Position wird als Produktanzahl angegeben und gilt für jede Seite der Liste. Ein auf 4 gesetztes Banner erscheint nach dem vierten Produkt der aktuellen Seite, egal ob der Besucher auf Seite 1 oder Seite 3 ist.

Mehrere Banner können dieselbe Kategorie betreffen, jedes an seiner Position. Teilen sich zwei Banner dieselbe Position, werden sie in der Speicherreihenfolge nacheinander eingefügt. Übersteigt die Position die Anzahl der auf der Seite angezeigten Produkte, wird das Banner für diese Seite schlicht übersprungen, ohne die anderen zu verschieben.

Standardmäßig nimmt das Banner den Platz einer Produktzelle ein. Die Felder Breite im Raster und Höhe im Raster vergrößern es, wie unten beschrieben.

Mobilansicht einer PrestaShop-Kategorie: Das Banner nimmt den Platz eines Produkts im zweispaltigen Raster ein
Auf dem Smartphone nimmt das Banner nach dem ersten Produkt den Platz eines Produkts im zweispaltigen Raster ein.

Bannergröße im Raster

Jedes Banner belegt einen Block von Produktzellen: standardmäßig 1 × 1, bis zu 4 Spalten über 3 Zeilen oder die ganze Zeile. Die Produkte nach dem Banner füllen die frei gebliebenen Zellen, sodass im Raster keine Lücke bleibt.

  • Listen mit CSS-Grid (Creative Elements, die meisten neueren Themes): Breite und Höhe gelten beide. Ein Banner in 2 × 2 nach dem 4. Produkt eines vierspaltigen Rasters belegt die ersten beiden Spalten der Zeilen 2 und 3, die Produkte 5 bis 8 stehen daneben.
  • Bootstrap-Zeilen (Classic Theme): Die Breite gilt als Anteil der Zeile. Die Höhe richtet sich nach dem Bild.
  • Kleine Bildschirme: Die Breite ist auf die Zahl der angezeigten Spalten begrenzt. Ein vierspaltiges Banner in einem zweispaltigen mobilen Raster wird zum Banner über die ganze Zeile.

Im Füllmodus deckt das Bild die ganze Fläche ab, übernimmt die Höhe der benachbarten Produkte und wird von der Mitte aus beschnitten. Ein Banner über die ganze Zeile behält immer seine Proportionen, da kein Produkt daneben ihm eine Höhe gibt: Verwenden Sie dafür ein Querformat.

Für ein Banner in 2 × 2 im Füllmodus bereiten Sie ein Bild vor, das etwas höher als breit ist, und halten Sie die Kernbotschaft in der Mitte, da die Ränder beschnitten werden können.

Zweispaltiges Banner für kostenlosen Versand und Banner mit Geschenkideen zwischen den Produkten einer PrestaShop-Kategorie
Ein Banner in 2 × 1 nach dem 4. Produkt und ein Banner in 1 × 1 nach dem 6., im Füllmodus.
Zweispaltiges Banner für kostenlosen Versand über die ganze Breite des mobilen Produktrasters
In einem zweispaltigen mobilen Raster belegt das Banner in 2 × 1 die ganze Breite.

Eine Aktion planen

Tragen Sie ein Start- und ein Enddatum ein, damit ein Banner von selbst erscheint und wieder verschwindet. Das ist das richtige Werkzeug, um Schlussverkauf, Black Friday oder eine Jahresendaktion Wochen im Voraus vorzubereiten.

  • Nur Startdatum: Das Banner erscheint an diesem Datum und bleibt danach sichtbar.
  • Nur Enddatum: Das Banner wird sofort angezeigt und endet an diesem Datum.
  • Beide Daten: Das Banner ist nur in diesem Fenster sichtbar.
  • Kein Datum: Das Banner ist dauerhaft.

Die Daten werden in der Uhrzeit des Shops eingegeben und verglichen, also in der Zeitzone, die unter International > Lokalisierung eingestellt ist, und nicht in der Uhrzeit des Besuchers. Ein Enddatum ohne Uhrzeit endet um 23:59:59.

Zeitplanung des Banners: Kalender für Start- und Enddatum in der Zeitzone des Shops
Start- und Enddatum mit dem Kalender von PrestaShop, in der Uhrzeit des Shops.

Einen ganzen Baum abdecken

Die Option Auf Unterkategorien anwenden erspart Ihnen, dasselbe Banner in jeder Abteilung neu anzulegen. Auf einer übergeordneten Kategorie gesetzt, erscheint das Banner in dieser Kategorie und in allen ihren Nachfahren.

Die Auflösung nutzt den nativen verschachtelten Baum von PrestaShop (Spalten nleft und nright) und erzeugt daher keine zusätzliche Abfrage pro Seite. Verschieben Sie Kategorien im Baum, berechnet PrestaShop diese Werte neu und der Geltungsbereich folgt automatisch.

Bilder und Sprachen

Jedes Banner nimmt ein Motiv und einen Alternativtext pro Sprache an, womit Sie eine Botschaft oder einen Preis je Markt anpassen können. Hat eine Sprache kein eigenes Motiv erhalten, zeigt das Modul das der Standardsprache des Shops an, statt das Banner auszublenden. Ein eigener Alternativtext der Sprache bleibt dabei erhalten, sofern er ausgefüllt ist.

Jedes Motiv lässt sich um ein optionales Mobilbild ergänzen: Es wird auf Bildschirmen bis 767 px Breite ausgeliefert, mit eigenen Abmessungen. Für ein Banner über die ganze Zeile bereiten Sie es im Hochformat vor.

Die Bildabmessungen werden beim Hochladen ausgelesen und in die HTML-Attribute width und height geschrieben, was Layoutverschiebungen beim Laden verhindert. Das beim Öffnen der Seite sichtbare Banner wird bevorzugt geladen (fetchpriority="high"), die übrigen verzögert (loading="lazy"). Die Dateien werden mit einem zufälligen Suffix umbenannt und in /img/datafireflycategorybanner/ abgelegt.

Den Alternativtext lesen Suchmaschinen und Screenreader. Beschreiben Sie den Inhalt des Motivs, statt den Kategorienamen zu wiederholen.

Sale-Banner über die volle Breite mit eigenem Mobilbild auf dem Smartphone
Das Banner über die ganze Zeile zeigt auf dem Smartphone sein Mobilbild im Hochformat.

Multishop

Ist die Multishop-Funktion aktiv, zeigt das Formular einen Block Shop-Zuordnung. Ein Banner erscheint nur in den angekreuzten Shops, und die Backoffice-Liste zeigt nur die im aktuellen Shop-Kontext sichtbaren Banner.

Ist kein Shop angekreuzt, ordnet das Modul das Banner dem aktuellen Kontext zu, damit nie ein verwaistes Banner entsteht.

Facettenfilter, Sortierung und Seitennavigation

In PrestaShop 8 und 9 laden Facettenfilter, Sortierung und Seitennavigation die Produktliste per AJAX neu, ohne die Seite neu zu laden. Das Modul beobachtet die Liste: Sobald neue Produktzellen erscheinen, nach einem Filter, einem Seitenwechsel, einem „Mehr laden“-Button oder Infinite Scroll, setzt es die Banner wieder an die richtigen Positionen. Zusätzlich lauscht es auf das Ereignis updateProductList von PrestaShop.

Das Produktraster wird anhand der Produkte selbst erkannt (Merkmale data-id-product und product-miniature), nicht anhand der Klassen eines bestimmten Themes. Das deckt das Classic Theme, Creative-Elements-Listen und die meisten individuellen Themes ab.

CSS und JavaScript werden nur auf Kategorieseiten geladen, und nur wenn die aktuelle Kategorie mindestens ein aktives und anzeigbares Banner hat.

Einstellungen: Selektor des Produktrasters

Unter der Bannerliste enthält der Bereich Einstellungen ein einziges Feld, Selektor des Produktrasters. Lassen Sie es leer: Das Raster wird automatisch erkannt.

Nur wenn die Banner bei einem Theme mit ungewöhnlicher Struktur nie erscheinen, geben Sie den CSS-Selektor des Elements ein, das die Produktzellen direkt enthält, zum Beispiel #js-product-list .products oder .ce-products. Findet das Modul das Raster nicht, schreibt es eine Warnung [DataFirefly Category Banner] in die Browserkonsole.

Neu in Version 1.3.0

Version 1.3.0 behebt mehrere Fehler, die bei einer vollständigen Prüfung unter PrestaShop 1.7.8, 8.2.1 und 9.1.5 aufgefallen sind, und bringt einige neue Einstellungen.

  • Mobilbild: Jede Sprache nimmt ein zweites Bild an, das auf Bildschirmen bis 767 px Breite angezeigt wird. Das hilft bei einem Banner über die ganze Zeile, das im Querformat auf dem Smartphone schwer lesbar ist.
  • Link pro Sprache: Ein optionaler Link je Sprache ersetzt den gemeinsamen Link, etwa für eine Seite mit übersetzter Adresse wie /en/content/1-delivery.
  • Nur auf der ersten Seite: Das Banner wird nicht mehr auf Seite 2, 3 usw. der Liste wiederholt. Es erscheint wieder, sobald der Besucher zu Seite 1 zurückkehrt oder einen Filter anwendet.
  • Datumskalender: Der Kalender im Formular trägt das Datum jetzt im richtigen Format ein. Ein Enddatum ohne Uhrzeit endet um 23:59:59.
  • Uhrzeit des Shops: Die Daten werden mit der Uhrzeit des Shops verglichen. Bisher verschob die Uhr des MySQL-Servers, die oft auf UTC eingestellt ist, Beginn und Ende um ein bis zwei Stunden.
  • Core Web Vitals: Die Banner werden direkt nach dem Produktraster eingefügt (Hook displayFooterCategory), noch vor der ersten Darstellung, was die Layoutverschiebung (CLS) beseitigt. Das beim Öffnen der Seite sichtbare Banner wird bevorzugt geladen, die folgenden verzögert.
  • Bildsicherheit: SVG-Dateien mit Skript, Event-Handler oder externem Inhalt werden abgelehnt, und der Ordner /img/datafireflycategorybanner/ erhält eine eigene .htaccess (nur Bilder, SVG isoliert). Ein abgelehntes Bild erzeugt kein leeres Banner mehr.
  • WebP unter PrestaShop 1.7: WebP-Bilder werden angenommen und korrekt ausgeliefert.
  • Backoffice-Liste: Spalte Bilder mit den Sprachen, die ein Motiv haben, und Kennzeichnung beendeter oder geplanter Banner.

Zum Aktualisieren installieren Sie das Archiv 1.3.0 im Modul-Manager über die vorhandene Version. Ihre Banner und Bilder bleiben erhalten. Leeren Sie anschließend den PrestaShop-Cache und den Cache aller Performance-Module.

Update auf Version 1.2.0

Installieren Sie das Archiv 1.2.0 im Modul-Manager über die vorherige Version. Das Update-Skript ergänzt die Spalten für Größe und Bilddarstellung sowie die Einstellung für den Raster-Selektor. Bestehende Banner behalten ihr bisheriges Aussehen: 1 × 1, Bildproportionen beibehalten. Bearbeiten Sie ein Banner, um ihm eine andere Größe zu geben oder es in den Füllmodus zu schalten.

Das Frontend-Skript ändert sich in dieser Version. Leeren Sie nach dem Update den PrestaShop-Cache und den Cache aller Performance-Module (CCC, Seitencache, Minifizierung), sonst wird weiterhin das alte Skript ausgeliefert.

Update von Version 1.0.0

Installieren Sie das neue Archiv im Modul-Manager einfach über das alte. Das Update-Skript erledigt Folgendes:

  • Spalten für Geltungsbereich, Zeitsteuerung und Bildabmessungen hinzufügen;
  • die Zuordnungstabelle für Shops anlegen und den ursprünglichen Shop jedes Banners übernehmen;
  • vorhandene Bilder von views/img/banners/ nach /img/datafireflycategorybanner/ verschieben und ihre Abmessungen auslesen;
  • einen nicht mehr benötigten Hook entfernen.

Ihre Banner, deren Positionen und Motive bleiben erhalten.

FAQ und Fehlerbehebung

Das Banner erscheint nicht auf der Kategorieseite

Prüfen Sie der Reihe nach: Das Banner ist aktiv; das heutige Datum liegt im Zeitfenster; die anvisierte Kategorie ist die aufgerufene, oder die Geltung für Unterkategorien ist eingeschaltet; die angezeigte Sprache hat ein Bild, oder die Standardsprache hat eines; im Multishop ist der aktuelle Shop angekreuzt. Leeren Sie zuletzt den PrestaShop-Cache.

Bei einer Liste, die mit Creative Elements oder einem anderen Page Builder gebaut ist, prüfen Sie, dass das Modul in Version 1.2.0 oder neuer läuft: Frühere Versionen erkannten nur das Raster des Classic Themes. Öffnen Sie dann die Browserkonsole: Eine Warnung [DataFirefly Category Banner] bedeutet, dass das Raster nicht gefunden wurde, siehe Abschnitt Einstellungen.

Das Banner erscheint an der falschen Stelle

Die Position zählt die Produkte der aktuellen Seite. Zeigt Ihre Liste 12 Produkte pro Seite, erscheint ein Banner auf Position 20 auf keiner Seite. Senken Sie den Wert oder erhöhen Sie die Produktanzahl pro Seite.

Das Banner zerstört das Rasterlayout

Stellen Sie die Größe über die Felder Breite im Raster und Höhe im Raster ein statt über Rasterklassen, und leeren Sie das Feld CSS-Klasse, sofern Ihr Theme keine Größenklasse bereitstellt. Mischen Sie keine Klassen verschiedener Rastersysteme.

Das Banner verschwindet nach dem Filtern

Seit Version 1.2.0 setzt das Modul die Banner wieder ein, sobald neue Produktzellen in der Liste erscheinen, unabhängig vom Filtermodul. Verschwindet das Banner trotzdem, öffnen Sie die Browserkonsole: Eine Warnung [DataFirefly Category Banner] bedeutet, dass das Raster nach der Aktualisierung nicht gefunden wurde. Tragen Sie dann den Selektor des Rasters im Bereich Einstellungen ein und wenden Sie sich an den Support, falls das Problem bleibt.

Das Bild lässt sich nicht hochladen

Das Modul akzeptiert JPG, PNG, GIF, WebP und SVG bis 4 MB. Prüfen Sie außerdem, ob /img/datafireflycategorybanner/ beschreibbar ist und ob die PHP-Direktiven upload_max_filesize und post_max_size größer als die Datei sind.

Akzeptiert werden nur URLs, die mit http://, https:// oder einem Schrägstrich beginnen. Das schützt vor der Einschleusung von javascript:– oder data:-Adressen.

Was passiert bei der Deinstallation?

Das Modul löscht seine Tabellen und entfernt den Ordner /img/datafireflycategorybanner/ samt der darin liegenden Motive. Sichern Sie Ihre Bilder, wenn Sie später erneut installieren wollen.

War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren