PrestaShop Kategorien auf der Homepage 1.0

PrestaShop Dokumentation Kategorien auf der Homepage

Umfassend Dokumentation für das Modul zur Anzeige von Kategorien auf der Startseite PrestaShop (cc_ps_heimat_kategorien) mit erweiterten Styling-Optionen, mehreren Anzeigemodi und vollständiger Kontrolle über das Erscheinungsbild der Kategorien.

Inhaltsübersicht

1. Einführung
2. Einrichtung
3. Aktivierung der Lizenz
4. Management-Panel
5. Allgemeine Einstellungen
6. Stile anzeigen
7. Konfiguration der Bilder
8. Auswahl der Kategorie
9. Anpassung des Erscheinungsbildes
10. Reaktionsfähigkeit
11. Lösung von Problemen
12. FAQ

1. Einleitung

CC PrestaShop Categories Home ist ein fortschrittliches Modul, mit dem Sie Kategorien auf der Startseite Ihres Shops elegant anzeigen können. Das Modul bietet eine breite Palette von Anzeigestilen, von klassischen Rastern bis hin zu modernen Schiebern, und gibt Ihnen die volle Kontrolle über das Aussehen und die Funktionalität.

Hauptfunktionen des Moduls:

• 7 verschiedene Gitterstile (klassisch, modern, minimalistisch, farbig, elegant, dunkler Modus, hell umrandet)
• Slider mit Navigation und Unterstützung von Touchgesten
• 3 Listenmodi (horizontal, vertikal, kompakt)
• Volle Kontrolle über die Kategorieauswahl
• Erweiterte Bildoptionen
• Reaktionsfähiges Design
• COCOS-Lizenzierungssystem
• Mehrsprachiger Dienst
• Animationen und Übergangseffekte
• Kann an verschiedenen Anschlüssen angebracht werden

2. Einbau

Systemanforderungen

• PrestaShop 1.7.0.0 oder höher
• PHP 7.2 oder höher
• MySQL 5.6 oder höher
• Erlaubnis zur Installation von Modulen
• Mindestens 256 MB RAM (512 MB empfohlen)
• GD-Erweiterung für die Bildverarbeitung

Einbauverfahren

1. Laden Sie die ZIP-Datei des Moduls aus dem offiziellen Shop herunter cocos.codes
2. Loggen Sie sich in das PrestaShop-Administrationspanel ein
3. Gehen Sie zu: Module > Modulmanager > Neues Modul hinzufügen
4. Klicken Sie auf "Modul hinzufügen" und wählen Sie die heruntergeladene ZIP-Datei aus.
5. Wenn die Installation abgeschlossen ist, klicken Sie auf "Konfigurieren".
6. Das Modul meldet sich automatisch im DisplayHome Hookup an

3. die Aktivierung der Lizenz

Bevor die volle Funktionalität des Moduls genutzt werden kann, ist es notwendig, die Lizenz zu aktivieren:

1. Nach der Installation fahren Sie mit der Modulkonfiguration fort
2. Wählen Sie die Registerkarte "Lizenz".
3. Geben Sie den nach dem Kauf erhaltenen Lizenzschlüssel ein
4. Klicken Sie auf "Lizenz aktivieren".
5. Das System prüft die Gültigkeit der Lizenzen auf den COCOS-Servern
6. Nach erfolgreicher Aktivierung erhalten Sie eine Bestätigungsmeldung

4 Management-Panel

Das Verwaltungspanel des Moduls besteht aus mehreren Registerkarten zur vollständigen Konfiguration:

Hauptregisterkarten:

• Einstellungen - Konfiguration des Hauptmoduls (nur mit einer gültigen Lizenz verfügbar)
• Dokumentation - Link zur vollständigen Online-Dokumentation
• Unterstützung - Link zur Seite des technischen Supports von COCOS
• Plug-ins - Liste der verfügbaren COCOS-Erweiterungen
• Lizenz - Modul Lizenzmanagement

Das System leitet automatisch zur Registerkarte "Lizenz" weiter, wenn der Schlüssel nicht aktiv ist, was einen intuitiven Konfigurationsprozess ermöglicht.

5. Allgemeine Einstellungen

Im Bereich der allgemeinen Einstellungen finden Sie die grundlegenden Optionen, die den Betrieb des Moduls steuern:

Einstellung	Beschreibung	Standardwert
Einschalten des Moduls	Globale Anzeige ein/aus	Auf
Titel des Abschnitts anzeigen	Anzeige der Kopfzeile über den Kategorien	Auf
Titel der Sektion	Mehrsprachiger Kopfzeilentext	"Unsere Kategorien"
Kategorie Grenze	Maximale Anzahl von Kategorien (1-50)	6

Funktionsweise des Hauptschalters

• Auf - Die Kategorien sind auf der Startseite je nach Konfiguration sichtbar
• Aus - das Modul zeigt keine Kategorien an

6. Anzeigestile

Das Modul bietet 11 verschiedene Darstellungsarten für Kategorien, die in 3 Hauptgruppen unterteilt sind:

Gitterstile

Stil	Beschreibung	Empfohlene Verwendung
netz_klassisch	Klassische Karten mit Rahmen und Schatten	Universal-Läden
grid_modern	Hintergrundgradient mit Überlagerung auf Bildern	Moderne Marken
gitter_minimal	Saubere, minimalistische Karten	Hochwertige Geschäfte
grid_colorful	Bunte Rahmen mit Animationen	Geschäfte für Kinder/Jugendliche
grid_elegant	Elegante Karten mit goldenen Akzenten	Luxusmarken
gitter_dunkel	Dunkles Thema mit Lichteffekten	Spiele/Elektronik
grid_light_bordered	Helle Karten mit klaren Rändern	Firmengeschäfte

Stile auflisten

Stil	Beschreibung	Empfohlene Verwendung
Liste_horizontal	Horizontale Bildkarten auf der linken Seite	Hauptkategorieseiten
Liste_vertikal	Vertikale Karten in Spalten	Schmale Abschnitte
Liste_Kompakt	Kompakte Liste mit kleinen Bildern	Seitenleiste, Fußzeile

Schieberegler-Stile

• Schieberegler_klassisch - Eleganter Slider mit Navigation und Hover-Overlay

7. die Konfiguration der Bilder

Das Modul bietet volle Kontrolle über die Anzeige der Kategoriebilder:

Containergrößen

Größe	Höhe	Empfohlen für
klein	150px	Kompakte Systeme
mittel	250px	Standardanzeige
groß	350px	Eindrucksvolle Präsentationen

Arten von Bildern
Das System erkennt automatisch die verfügbaren Bildtypen, die in PrestaShop für die Kategorien definiert sind:

• Kategorie_Standard - Standardtyp für die Kategorie

Fallback-Bilder
Wenn einer Kategorie kein Bild zugeordnet ist, zeigt das System automatisch ein Standard-Ersatzbild an kein-bild-kategorie.jpg.

8 Auswahl der Kategorie

Das Modul bietet zwei Modi zur Auswahl der anzuzeigenden Kategorien:

Automatischer Modus
Das System wählt automatisch die Hauptkategorien entsprechend ihrer Position aus:

• Überspringt Wurzelkategorie (ID: 1)
• Überspringt die Hauptkategorie des Shops
• Sortiert nach Position im Kategorienbaum
• Wählt nur aktive Kategorien aus
• Beachtet den festgelegten Grenzwert

Manueller Modus
Der Administrator kann bestimmte Kategorien manuell auswählen:

• Liste der durch Kommas getrennten Kategorie-IDs
• Beispiel: 2,5,8,12
• Das System prüft, ob Kategorien existieren und aktiv sind
• Reihenfolge der Anzeige in der Liste
• Automatisches Überspringen von nicht existierenden Kategorien

Kategorie-Validierung
Unabhängig vom Modus prüft das System:

• Ist die Kategorie in der Datenbank vorhanden?
• Ist die Kategorie aktiv
• Hat die Kategorie einen Namen in der aktuellen Sprache?
• ob der Benutzer die Erlaubnis hat, sie anzusehen

9. Anpassung des Erscheinungsbildes

Kontrolle des Inhalts

Option	Funktion	Standardmäßig
Kategorienamen anzeigen	Anzeige der Kategorietitel	Aktiviert
Kategoriebeschreibungen anzeigen	Anzeige von Beschreibungen (abgekürzt)	Aktiviert
Anzahl der Spalten	Rastereinteilung (1-6 Spalten)	3

Ansprechbares Verhalten
Das System passt die Anzahl der Spalten automatisch an:

• Schreibtisch - volle Anzahl von Spalten
• Tablette - maximal 2-3 Spalten
• Mobil - immer 1 Spalte

Effekte und Animationen

• Einblendung beim Laden der Seite
• Hover-Effekte auf Karten
• Reibungslose Übergänge
• Animationen zur Bildlaufanzeige
• Ladezustände für Bilder

Reaktionsfähigkeit des Schiebereglers
Schieberegler automatisch:

• Passt die Anzahl der sichtbaren Elemente an
• Unterstützt Gestyswipe auf Touch-Geräten
• Navigation nach Bedarf ein-/ausblenden
• Behält das Seitenverhältnis auf verschiedenen Bildschirmen bei

10 Reaktionsfähigkeit

Das Modul ist vollständig responsive und passt sich automatisch an verschiedene Bildschirmgrößen an:

Haltepunkte

Gerät	Breite	Rubriken	Verhalten
Schreibtisch	> 768px	Vollständige Konfiguration	Standardanzeige
Tablette	481-768px	Maximal 2-3	Vereinfachtes Layout
Mobil	< 480px	1	Vertikales Layout

Mobile Optimierungen

• Automatische Reduzierung von Füllung und Rand
• Ansprechende Typografie
• Berührungsfreundliche Navigation
• Optimierte Bildgrößen
• Vereinfachte Animationen

Mobile Styles für einzelne Modi

• Horizontale Liste - verwandelt sich in eine vertikale
• Kompakte Liste - die Elemente stapeln sich untereinander
• Schieberegler - reduziert die Breite der Elemente und die Abstände

11 Fehlersuche

Die Kategorien erscheinen nicht auf der Startseite

1. Prüfen Sie, ob das Modul in den allgemeinen Einstellungen aktiviert ist
2. Sicherstellen, dass die Lizenz aktiv ist
3. Prüfen Sie, ob die ausgewählten Kategorien in PrestaShop aktiv sind.
4. PrestaShop und Browser-Cache löschen
5. Prüfen Sie, ob der displayHome-Haken von der Vorlage unterstützt wird

CSS-Stile werden nicht geladen

1. Prüfen Sie, ob die Datei views/css/front.css Es gibt
2. Stellen Sie sicher, dass Sie sich auf der Startseite befinden (Controller: IndexController)
3. Prüfung auf Konflikte mit anderen Modulen
4. CSS-Cache in den PrestaShop-Einstellungen deaktivieren
5. Überprüfen Sie die Leseberechtigungen der Moduldateien

Schieberegler funktioniert nicht richtig

1. Prüfen Sie die Browser-Konsole auf JavaScript-Fehler
2. Stellen Sie sicher, dass die Datei views/js/front.js geladen ist
3. Prüfung auf Konflikte mit jQuery
4. Deaktivieren Sie andere Slider-Module für die Dauer der Tests
5. Prüfen Sie, ob die Elemente die richtige HTML-Struktur haben

Bilder werden nicht angezeigt

1. Prüfen Sie, ob den Kategorien Bilder zugeordnet sind
2. Stellen Sie sicher, dass der ausgewählte Bildtyp im System vorhanden ist.
3. Verzeichnisberechtigungen prüfen img/c/
4. Prüfen Sie, ob die Datei kein-bild-kategorie.jpg Es gibt
5. Bild-Cache löschen

Fehler bei der Lizenzierung

1. Prüfen Sie, ob der Lizenzschlüssel korrekt ist
2. Sicherstellen, dass die Domain mit der Lizenz übereinstimmt
3. Überprüfen Sie die Verbindung zu den COCOS-Servern
4. Löschen Sie den Modul-Cache
5. Kontakt zum Support bei Aktivierungsproblemen

12. FAQ

Kann ich mehrere Stile gleichzeitig verwenden?
Nein, das Modul erlaubt es Ihnen nur, jeweils einen Anzeigestil zu wählen. Sie können den Stil jedoch leicht in den Einstellungen ändern.

Wie kann ich meinen eigenen Anzeigestil hinzufügen?
Die neuen Stile erfordern eine Änderung der CSS- und PHP-Dateien. Wir empfehlen, den bestehenden Stil zu kopieren und an Ihre Bedürfnisse anzupassen.

Kann ich Unterkategorien anzeigen?
Derzeit unterstützt das Modul nur Hauptkategorien. Die Anzeige von Unterkategorien erfordert eine Änderung des Quellcodes.

Wie kann ich die Position eines Moduls auf der Seite ändern?
Das Modul wird automatisch an der ersten Position im DisplayHome-Hookup platziert. Sie können die Reihenfolge im Menü "Position" im Modulbedienfeld ändern.

Funktioniert das Modul mit Caching?
Ja, das Modul ist kompatibel mit PrestaShop Cache-Systemen und erfordert keine besondere Konfiguration.

Wie kann der Titel des Abschnitts übersetzt werden?
Das Feld "Sektionstitel" unterstützt alle im Shop aktiven Sprachen. Wechseln Sie die Sprache im Administrationsbereich und geben Sie die Übersetzung ein.

Kann ich Kategoriebeschreibungen für bestimmte Stile ausblenden?
Die Option "Kategoriebeschreibungen anzeigen" funktioniert global für alle Stile. Einige Stile (wie grid_modern) zeigen die Beschreibungen im Overlay an.

Warum zeigt der Schieberegler Navigationspfeile an, obwohl sie nicht benötigt werden?
JavaScript blendet die Pfeile automatisch aus, wenn alle Elemente in die Ansicht passen. Prüfen Sie, ob die Elemente die richtigen Abmessungen haben.

Wie funktioniert das faule Laden von Bildern?
Bilder werden automatisch geladen, wenn sie im Ansichtsfenster sichtbar werden. Dies spart Bandbreite und beschleunigt das Laden der Seite.

Kann ich die Hover-Animation ändern?
Animationen werden in der CSS für jeden Stil definiert. Sie können sie ändern, indem Sie die front.css.

Warum werden einige Kategorien nicht angezeigt?
Das System überspringt inaktive Kategorien, unbenannte Kategorien und Kategorien, für die der Benutzer keine Rechte hat.

Wie kann ich das Standard-Kategoriebild ändern?
Ersetzen Sie die Datei ansichten/img/kein-bild-kategorie.jpg ein eigenes Bild mit den gleichen Abmessungen.

Unterstützt das Modul RTL (rechts-nach-links)?
Das Modul verwendet standardmäßige Bootstrap-Klassen, die RTL unterstützen. Möglicherweise müssen Sie einige der Stile anpassen.

Wie kann ich die Animationen ausschalten?
Sie können CSS-Animationen in der Datei entfernen oder auskommentieren front.css oder hinzufügen Animation: keine; zu den entsprechenden Selektoren.

Kann ich die Anzahl der Kategoriebeschreibungen ändern?
Die Beschreibungen werden je nach Stil automatisch auf 80-120 Zeichen gekürzt. Sie können dies in der Vorlagendatei ändern home_kategorien.tpl.

Warum funktioniert das Modul nach einem PrestaShop-Update nicht mehr?
Prüfen Sie die Versionskompatibilität in der Moduldatei. Es ist möglich, dass Sie das Modul auf die neueste Version aktualisieren müssen.

Wie kann die Leistung für eine große Anzahl von Kategorien optimiert werden?
Verwenden Sie den manuellen Auswahlmodus für Kategorien und beschränken Sie die Anzahl auf maximal 12 Einträge. Aktivieren Sie "Lazy Loading" und "Image Caching".

Kann ich das Modul auf Kategorieseiten verwenden?
Das Modul ist für die Homepage vorgesehen. Die Platzierung auf anderen Seiten erfordert eine Änderung des Hooks im Quellcode.

Wie kann ich überprüfen, welche Anschlüsse in meiner Vorlage verfügbar sind?
Verwenden Sie das Modul "Hook displayer" oder prüfen Sie die Vorlagendateien im Vorlagenverzeichnis. Nicht alle Vorlagen unterstützen alle Hooks.

Warum werden die Stile im dunklen Modus nicht richtig angezeigt?
Dunkle Stile erfordern einen speziellen Wrapper. Vergewissern Sie sich, dass die Vorlage keine Hintergrundfarben überschreibt und dass es keine Konflikte mit anderen Stilen gibt.

Wie kann ich die Modulkonfiguration exportieren?
Die Konfiguration wird in einer Tabelle gespeichert ps_Konfiguration mit einer Vorsilbe CC_PS_HC_. Sie können diese Datensätze über phpMyAdmin exportieren.

Wenn Sie einen Shop mit PrestaShop betreiben und die Darstellung der Kategorien auf der Startseite verbessern wollen, empfehlen wir die Verwendung des CC PrestaShop Modul Kategorien auf der Homepagedie ein professionelles Aussehen und volle Kontrolle über die Anzeige der Produktkategorien bietet.