Filter Revolution: Einrichtung und Hilfe

Laden Sie die ZIP-Datei von Filter Revolution unter Modul > "Module Manager" hoch und installieren Sie sie. Klicken Sie auf "Configure" oder öffnen Sie Filter Revolution im Backoffice.

Wählen Sie den vorgesehenen Shop. Öffnen Sie Übersicht und verwenden Sie Index neu erstellen für einen bestehenden oder importierten Katalog. Warten Sie auf einen erfolgreichen Abschluss ohne gemeldete Probleme. Wenn der Index vorhanden ist, aber Facettenaggregate fehlen, verwenden Sie "Rebuild Facet Aggregates".

Öffnen Sie Filtervorlagen und prüfen Sie die installierten Vorlagen sowie die Zuweisungen unter Standard-Filtervorlagen. Der Filterablauf erfordert eine passende Vorlage und einen verwendbaren Index. Testen Sie eine Kategorie, bevor Sie den gesamten Katalog ändern.

Öffnen Sie Filter Revolution > Einstellungen > Konfiguration > Anzeige.

Hooks zum Speichern/Löschen von Produkten pflegen die betroffenen Indexzeilen. Andere Katalogänderungen machen Filter-Caches und Revisionen der Produktlisten ungültig. Erstellen Sie den Index nach Importen, die normale Hooks umgehen, oder bei einem im Dashboard gemeldeten fehlerhaften Index-/Aggregatzustand neu.

Das Modul registriert die gemeinsame geplante Aufgabe "Listing cache catalogue check" (listing_digest). Ihr Standardintervall beträgt 300 Sekunden, die Nachweisfrist 1800 Sekunden. Sie verwendet einen gemeinsamen MPR-Cron-Runner, wenn dieses Paket verfügbar ist. Stellen Sie sicher, dass der Runner Aufgaben im Cron-Kontext ausführt; dieses Modul liefert keinen separaten cron.php-Befehl mit. Die Digest-Zeitschlüssel gehören zur internen Konfiguration und sind keine Felder im Standardformular.

Öffnen Sie Konfiguration > SEO.

Gewöhnliche erzeugte Kombinationen sind nicht automatisch indexierbare Zielseiten. Das Modul wendet noindex auf erzeugte Filterseiten und Varianten der Listensteuerung an. Kanonische URLs hängen von der Listenansicht und der zentralen SEO-Integration ab. Bei zentraler SEO-Zuständigkeit verwendet Seite eins gewöhnlicher Kategoriefilter die kanonische URL der Basiskategorie; eigenständige gefilterte Seiten können eine gefilterte selbstreferenzielle kanonische URL behalten. Gehen Sie nicht davon aus, dass jede gefilterte URL stets auf die ungefilterte Kategorie kanonisiert wird.

Gezielt erstellte indexierbare Seiten benötigen einen geeigneten aktiven SEO-Datensatz und lokalisierte Inhalte für genau diesen Shop und diese Sprache. Prüfen Sie die tatsächlich zurückgegebenen Canonical- und Robots-Werte in Ihrem Shop.

Der aktuelle Crawling-Schutz integriert erzeugte Filterregeln und gezielte Ausnahmen in die Robots-Verwaltung von MPR SEO. Der alte optionale Schalter "Disallow filter paths in robots.txt" ist in diesem Formular nicht vorhanden. Wenn Konfiguration meldet, dass die Robots-Datei benutzerdefiniert ist, fehlt oder die Durchsetzung ausgeschaltet ist, aktivieren Sie die Robots-Verwaltung in MPR SEO und führen Sie die Integritätsreparatur von Filter Revolution aus. Prüfen Sie anschließend die veröffentlichte Robots-Datei. Überschreiben Sie gezielte Ausnahmen nicht mit den alten pauschalen Beispielregeln.

Wenn das Modul fehlende Slugs meldet, verwenden Sie "Allocate missing slugs" unter Konfiguration. Sie benötigen Bearbeitungsrechte und einen ausgewählten Shop-Kontext. Die Aktion weist fehlende Identitäten zu und erhält bestehende URLs.

Beispielformate mit dem von Ihrem Shop erzeugten Vokabular:

Stored facets: color:red/size:m
Public path: color/red/size/m
Ranges: price/10-50 or weight/1-5
Compact unique value: 120-x-120-cm

Kopieren Sie beim Erstellen einer SEO-Seite eine tatsächlich funktionierende Kombination aus Ihrem Frontoffice; Namen und lokalisierte Slugs unterscheiden sich je nach Katalog.

Öffnen Sie Filtervorlagen. Legen Sie Vorlagenname, Seitentyp, gegebenenfalls Standard-Ausschlüsse, die Filter und Kategorien zuweisen fest.

Unterstützte Listenkontexte umfassen Kategorie, Suche, Hersteller, Lieferant, Bestseller, neue Produkte und Preisreduzierungen. Wählen Sie unter Standard-Filtervorlagen eine Standardvorlage für jeden Listentyp. Kategoriespezifische Zuweisungen haben Vorrang vor der Ersatzvorlage. Eine leere Kategoriezuweisung bedeutet eine breit anwendbare Kategorievorlage; bestätigen Sie den gewählten Standard, statt davon auszugehen, dass jede nicht zugewiesene Vorlage den Vorrang erhält.

Ziehen Sie Einträge von Verfügbare Filter nach Aktive Filter (ziehen zum Sortieren). Sie können Filter für Attributgruppen, Eigenschaften, Preis, Gewicht, Hersteller, Lieferant, Zustand, Bestand, Kategorie und Angebote verwenden. Attribute und Eigenschaften stammen aus Ihrem nativen Katalog.

Wählen Sie für jeden aktiven Filter das Widget, Spalten und Sichtbarkeitsabhängigkeit. Neue Filter beginnen mit Checkbox, einer Spalte und dem Abhängigkeitsmodus „immer sichtbar“; Preis und Gewicht verwenden standardmäßig Schieberegler, der Zustand Radiobuttons. Zulässige Widgets hängen vom Typ ab. Attribut- und Eigenschaftsgruppen können Checkbox-, Radio-, Dropdown-, numerische Schieberegler-, Farb- oder Bild-Widgets unterstützen. Preis und Gewicht verwenden Schieberegler, Bestand und Angebote Checkboxen.

Abhängigkeitsmodi können einen Filter immer sichtbar halten oder die Erfüllung beliebiger/aller Regeln verlangen. Zum Beispiel:

[{"filter_type":"feature","id_value":166,"values":[565]}]

Ersetzen Sie die IDs durch die relevante Eigenschaft und die passenden Werte. Standard-Ausschlüsse speichert Regeln, die markierte Produkte verbergen, bis ihr Markierungsfilter gewählt wird. Beginnen Sie ohne Ausschlüsse oder Abhängigkeiten und prüfen Sie anschließend jede Regel im Frontoffice.

Weitere Filterstandardwerte sind Position 0, Produktanzahl ein, Anzeigelimit 0 und eingeklappt aus. Diese Werte sind nicht alle als separate Steuerelemente im Vorlageneditor verfügbar.

Verwenden Sie den Bildmanager im Vorlagenbereich für Attribut- und Eigenschaftswerte. Laden Sie WebP, PNG, JPG/JPEG oder GIF hoch. Nicht-WebP-Dateien werden in WebP umgewandelt; dafür ist serverseitig GD mit WebP-Unterstützung erforderlich.

Die aktuelle Speicherung erfolgt shopspezifisch im PrestaShop-Bildverzeichnis:

img/mprfilterrevolution/shops/{id_shop}/attributes/{id_attribute}.webp
img/mprfilterrevolution/shops/{id_shop}/feature_values/{id_feature_value}.webp

Der Renderer kann eine vorlagenspezifische Variante {id_template}_{id_value}.webp gegenüber der allgemeinen Wertedatei bevorzugen. Verwenden Sie den Upload-Ablauf im Backoffice, statt neue Bilder im alten modulinternen Verzeichnis img/attributes abzulegen. Das Bildverzeichnis und seine Datei mit Zugriffsregeln müssen während der Einrichtung beschreibbar sein.

Öffnen Sie SEO-Seiten und fügen Sie einen Datensatz für eine bewusst gewählte Kombination hinzu.

Speichern und öffnen Sie die genaue Seite in jeder Sprache. Füllen Sie für jede zur Indexierung vorgesehene Sprache eigenständige, nützliche Metadaten oder H1-Inhalte aus. Eine leere Übersetzungszeile erbt keine Indexierbarkeit, nur weil eine andere Sprache vollständig ist. Geeignete Varianten können ihre eigene kanonische URL verwenden und über die Integration gSitemapAppendUrls erscheinen; die Sitemap-Ausgabe hängt auch von Routen- und Crawling-Eignung ab.

Verwenden Sie Konfiguration > Theme-Stile für erkannte Farben, Rahmen, Radius, Schrift und Übergangs-Tokens. Das Modul stellt außerdem den Wert "Loading overlay" bereit, standardmäßig rgba(255, 255, 255, 0.7). Theme-CSS kann .mpr-filter-container, .mpr-filter-group, .mpr-filter-group--active, .mpr-filter-active-tag, .mpr-filter-swatch, .mpr-filter-image-swatch und .mpr-seo-content-top verwenden.

1. Öffnen Sie eine Kategorie mit passender Vorlage und bestätigen Sie, dass sinnvolle Facetten erscheinen.
2. Wählen und entfernen Sie Filter. Bestätigen Sie, dass Produkte, Anzahlen, aktive Tags, Paginierung und URL gemeinsam aktualisiert werden.
3. Laden Sie die resultierende URL erneut oder teilen Sie sie und bestätigen Sie dieselbe Auswahl.
4. Testen Sie Preisbereiche, Bestandsmodi und die Steuerung der Produkte pro Seite.
5. Testen Sie den mobilen Drawer/Offcanvas unterhalb des konfigurierten Breakpoints.
6. Prüfen Sie für SEO-Seiten die zurückgegebenen Metadaten, Canonical und Robots sowie die Sitemap und die veröffentlichten Crawling-Regeln.

Das Modul verwendet die Integration der PrestaShop-Produktsuchanbieter und AJAX-Aktualisierungen der Produktlisten. Über actionMprSearchRevolutionRenderSections kann es auch Filterabschnitte für Search Revolution bereitstellen. Eine benutzerdefinierte Produktliste oder ein Theme muss die entsprechende Integration weiterhin unterstützen.

Wenn Filter fehlen, prüfen Sie den aktiven Shop, Standard- und Kategorievorlagenzuweisungen, den Katalogindex und ob das Theme den Filterbereich rendert. Eine Facette mit weniger als zwei sinnvollen Werten kann durch die Standardsichtbarkeitseinstellungen ausgeblendet werden.

Wenn Ergebnisse oder Anzahlen nach einem Import veraltet sind, erstellen Sie Index und Aggregate neu. Wenn eine URL abgewiesen wird oder eine SEO-Seite nicht geeignet ist, prüfen Sie vorhandene Slugs, die genaue Kombinationsidentität, lokalisierte Metadaten und den Robots-Status. Verwenden Sie Einstellungen > Integrität für Installations- und Infrastrukturprüfungen.

Wenn Bedienelemente die URL ohne die Ergebnisse aktualisieren, prüfen Sie JavaScript-Fehler und die AJAX-Antwort der Produktliste. Überprüfen Sie benutzerdefinierte Container-IDs und erzwungene mobile Panels erneut. Wenn eine Einstellung wirkungslos erscheint, unterscheiden Sie die älteren SEO-/URL-Felder von den oben beschriebenen Regeln für Produktlisten.

Sichern Sie Vorlagen, SEO-Seiten und Musterbilder, bevor Sie über "Module Manager" deinstallieren. Die Deinstallation entfernt Modulkonfiguration und Menüeinträge sowie die Musterbilder des Shops, gleicht die Robots-Regeln des Moduls ab und führt die Tabellenbereinigung aus. Prüfen Sie anschließend erneut den Filteranbieter des Themes.

Erfordert PrestaShop 1.7.6 oder höher und PHP 7.1 oder höher.