Category Wall — Visuelle Kategorieseite

Category Wall ersetzt die native Unterkategorie-Liste von PrestaShop durch eine Wand aus Bildkacheln, mit Produktzählern und drei wählbaren Layouts. Diese Anleitung behandelt Installation, Konfiguration und fortgeschrittene Nutzung des Moduls.

Installation

Das Modul wird wie jedes PrestaShop-Modul installiert, ohne externe Abhängigkeit und ohne Composer.

1. Öffnen Sie im Back-Office Module > Modulmanager und klicken Sie auf Modul hochladen (Schaltfläche oben rechts).
2. Wählen Sie die Datei dfcategorywall.zip und starten Sie die Installation.
3. Klicken Sie nach der Installation auf Konfigurieren, um zu den Einstellungen zu gelangen.

Wie die Anzeige funktioniert

Auf jeder Kategorieseite zeigt das Modul die Unterkategorie-Wand automatisch oberhalb der Produktliste an. Es stützt sich auf den Hook displayContentWrapperTop, der im Classic-Theme und den meisten davon abgeleiteten Themes vorhanden ist.

Existiert für die aufgerufene Kategorie keine aktive Unterkategorie, wird die Wand nicht angezeigt: Das Modul bleibt auf „Blatt“-Kategorien völlig unsichtbar.

Konfigurationsoptionen

Alle Optionen werden über den Konfigurationsbildschirm des Moduls eingestellt.

Layout

Drei Darstellungen stehen zur Verfügung:

• Raster — ein regelmäßiges Raster gleich großer Kacheln, ideal für ein sauberes, strukturiertes Ergebnis.
• Mosaik — eine dynamische Anordnung, bei der die erste Unterkategorie eine vergrößerte Kachel einnimmt, um den Blick auf ein Flaggschiff-Sortiment zu lenken.
• Karussell — ein flüssiges horizontales Scrollen, touch-freundlich auf dem Smartphone und mit Navigationspfeilen auf dem Desktop.

Spalten

Legen Sie die Anzahl der auf dem Desktop angezeigten Spalten fest, von 2 bis 6. Dieser Wert gilt für die Layouts Raster und Karussell. Die Anzeige wechselt auf Tablet und Smartphone automatisch auf 3 und dann 2 Spalten.

Produktzähler

Aktivieren Sie Produktzähler anzeigen, damit auf jeder Kachel die Produktanzahl der Unterkategorie als Badge erscheint.

• Produkte rekursiv zählen — summiert die Produkte des gesamten Unterbaums (verschachtelte Unterkategorien inbegriffen), nicht nur die direkt zugeordneten Produkte.
• Leere Unterkategorien ausblenden — entfernt Unterkategorien ohne sichtbares Produkt aus der Wand, um nur wirklich gefüllte Sortimente zu zeigen.

Beschreibung und Titel

• Beschreibung der Unterkategorien anzeigen — zeigt einen kurzen Auszug unter dem Namen jeder Kachel (auf 120 Zeichen gekürzt).
• Abschnittstitel anzeigen und Abschnittstitel — eine anpassbare, mehrsprachige Überschrift über der Wand (zum Beispiel „Unterkategorien entdecken“). Lassen Sie das Feld leer, um den Titel auszublenden.

Native Liste ausblenden

Die Option Native Unterkategorie-Liste ausblenden fügt eine dezente CSS-Regel hinzu, die den Standard-Unterkategorie-Block des Themes ausblendet, um Duplikate mit der Wand zu vermeiden. Diese Option hat keine Wirkung, wenn Ihr Theme diesen Block nicht anzeigt.

Kacheln ohne Bild

Hat eine Unterkategorie kein Titelbild, erzeugt das Modul automatisch eine Ersatzkachel: ein stabiler Farbverlauf, abgeleitet aus der Kategorie-ID, mit dem Anfangsbuchstaben des Namens. So bleibt das Raster stets homogen, ohne leere Zelle.

Nutzung als Widget

Über die Kategorieseite hinaus kann die Wand mithilfe der Widget-Schnittstelle von PrestaShop an beliebiger Stelle in einem Template eingefügt werden.

{widget name='dfcategorywall'}

Um eine bestimmte Kategorie anzusteuern, übergeben Sie deren ID:

{widget name='dfcategorywall' id_category=12}

Fehlerbehebung

Die Wand wird nicht angezeigt

• Prüfen Sie, ob die aufgerufene Kategorie tatsächlich aktive Unterkategorien hat.
• Stellen Sie sicher, dass Ihr Theme den Hook displayContentWrapperTop auslöst. Andernfalls verwenden Sie die oben beschriebene Widget-Einfügung.

Unterkategorien erscheinen doppelt

Aktivieren Sie die Option Native Unterkategorie-Liste ausblenden, um den ursprünglichen Block des Themes zu entfernen.

Die Karussell-Pfeile erscheinen nicht

Die Pfeile erscheinen nur, wenn genügend Kacheln vorhanden sind, um die sichtbare Breite zu überschreiten. Auf dem Smartphone erfolgt die Navigation ausschließlich per Finger (Touch-Scrolling).