WooCommerce Filter: Paginierung funktioniert nicht – Ursachen und Lösungen
Wenn die Paginierung des WooCommerce Filters nicht funktioniert, zeigt sich das meist auf eine von wenigen Arten: Seitenlinks, die auf /wp-admin/admin-ajax.php?paged=2 zeigen, eine leere Seite mit einer einzelnen 0, leere Seiten oder ein 404 am Ende der gefilterten Ergebnisse, der Filter geht auf Seite 2 verloren oder ein Infinite Scroll bleibt nach der ersten Filterung stehen. Jedes Symptom hat seine eigene Ursache, und die meisten entstehen daraus, wie das Theme seine Paginierung aufbaut, nicht durch den Filter. Beginnen Sie mit der Tabelle und gehen Sie dann zum passenden Abschnitt.
| Was Sie sehen | Wahrscheinliche Ursache |
|---|---|
Links zu admin-ajax.php?paged=2, leere Seite mit 0 | AJAX-Modus mit nicht standardmäßigem Paginierungs-Markup |
| Zwei Paginierungen oder zwei Zeilen „Zeige 1–12 von 40“ nach dem Filtern | Das Theme gibt eigene Elemente außerhalb des Bereichs aus, den HUSKY aktualisiert |
| Mehr Seiten als Produkte, letzte Seiten 404 oder leer | Unterschiedliche Werte für „Produkte pro Seite“ in HUSKY, im Theme und im Builder |
| Leeres Raster nach Änderung eines Filters auf Seite 3 | Die alte Seitennummer wird in den neuen Filterlink übernommen |
| Filter tot oder ohne Formatierung nach dem Wechsel auf Seite 2 | Die eigene AJAX-Paginierung, „Mehr laden“ oder der Infinite Scroll des Themes |
| Filter fehlt auf Seite 2, oder Seite 2 zeigt ungefilterte Produkte | Filter im Seiteninhalt platziert, oder Paginierungslinks, die den Filter verlieren |
| Nach dem Filtern überhaupt keine Paginierung | Eigenes Template oder Theme, das die Paginierung außerhalb der Schleifen-Hooks ausgibt |
Links zu admin-ajax.php: AJAX-Modus und Theme-Markup
Ist Versuchen Sie AJAX im Shop (Try to ajaxify the shop) auf Ja (Yes) gestellt (oder [woof_products is_ajax=1] auf einer Seite), lädt HUSKY die Seite nicht neu. Es fordert neue Produkte über admin-ajax.php beim Server an und ersetzt den Produktblock samt Paginierung. Weil diese neue Paginierung innerhalb der AJAX-Anfrage erzeugt wird, zeigen ihre Links auf admin-ajax.php?paged=2. Sie sind nie dafür gedacht, aufgerufen zu werden: HUSKY fängt Klicks auf .woocommerce-pagination a.page-numbers ab, liest die Seitennummer aus und lädt diese Seite per AJAX.
Ändert das Theme das Paginierungs-Markup (eine andere Klasse am Wrapper, Links ohne die Klasse page-numbers, eine eigene Paginierungsfunktion), wird der Klick nicht abgefangen, und der Browser öffnet den rohen Link. WordPress beantwortet eine Anfrage an admin-ajax.php ohne Action mit 0, und das ist die leere Seite. Das von HUSKY erwartete Markup ist das von WooCommerce selbst:
<nav class="woocommerce-pagination">
<ul class="page-numbers">
<li><span aria-current="page" class="page-numbers current">1</span></li>
<li><a class="page-numbers" href="https://example.com/shop/page/2/">2</a></li>
<li><a class="next page-numbers" href="https://example.com/shop/page/2/">→</a></li>
</ul>
</nav>
Untersuchen Sie Ihre Paginierung im Browser und vergleichen Sie. Ein Theme, das woocommerce/loop/pagination.php überschreibt oder eine eigene Paginierung verwendet, lässt sich in einem Child-Theme korrigieren (schon ein Tippfehler wie woocmmerce-pagination in der Wrapper-Klasse genügt, um es zu brechen), aber die zuverlässige Lösung braucht keinen Code: Wechseln Sie in den Weiterleitungsmodus. Öffnen Sie die Plugin-Einstellungen, den Tab Optionen (Options), stellen Sie Versuchen Sie AJAX im Shop (Try to ajaxify the shop) auf Nein (No) und speichern Sie; auf Seiten mit dem Shortcode verwenden Sie is_ajax=0. Jede Filterung lädt dann die Seite neu, und die Paginierung ist die normale Paginierung des Themes. AJAX lässt sich nicht nur für die Paginierung ausschalten. Siehe auch Paginierungsprobleme im AJAX-Modus.
Springt die Option nach dem Speichern wieder auf Ja (Yes) zurück, ist der Turbo-Modus aktiviert. Der Turbo-Modus funktioniert nur mit AJAX und schaltet die Option bei jedem Laden der Seite wieder ein; deaktivieren Sie zuerst den Turbo-Modus.
Doppelte Paginierung oder ein Ergebniszähler, der sich nicht aktualisiert
Manche Themes geben den Ergebniszähler, die Sortierung oder die Paginierung außerhalb des Blocks aus, den HUSKY ersetzt. Nach dem AJAX-Filtern sehen Sie dann das veraltete Element des Themes neben dem frischen oder einen Zähler, der noch den ungefilterten Shop beschreibt. Tragen Sie für den Zähler seinen Selektor, meist .woocommerce-result-count, unter Erweitert → Optionen → CSS-Selektor für Ergebniszähler (Advanced → Options → Result count css selector) ein; HUSKY zeichnet ihn dann nach jeder Filterung neu (Reihenfolge Dropdown-CSS-Selektor (Order dropdown css selector) tut dasselbe für die Sortierung). Bleiben Duplikate bestehen, beseitigt sie der Weiterleitungsmodus.
Zusätzliche Seiten und ein 404 am Ende der Ergebnisse
WordPress entscheidet anhand der Hauptabfrage der Seite, ob /page/7/ existiert: Hat die Hauptabfrage sechs Seiten, ist Seite 7 ein 404, was auch immer ein Produktraster auf dieser Seite anzeigt. Probleme beginnen, wenn das sichtbare Raster und die Hauptabfrage die Produkte pro Seite unterschiedlich zählen, zum Beispiel wenn ein Builder-Widget 30 pro Seite zeigt, die Hauptabfrage aber die 12 des Themes verwendet: Paginierung und vorhandene Seitennummern stimmen dann nicht mehr überein, und Seiten bleiben leer oder enden mittendrin in einem 404. Die eigene Einstellung von HUSKY, Erweitert → Optionen → Produkte pro Seite (Advanced → Options → Products per page), gilt nur, solange ein Filter aktiv ist (ihr Standardwert -1 bedeutet „nicht verwalten“), sodass eine Abweichung davon erst nach dem Filtern auftritt.
- Suchen Sie jede Stelle, an der die Zahl festgelegt wird: die Katalogeinstellungen des Themes oder von WooCommerce, das Produkte-Widget des Builders und Produkte pro Seite (Products per page) von HUSKY.
- Stellen Sie überall dieselbe Zahl ein, oder setzen Sie die von HUSKY auf
-1, damit sie nicht eingreift. - Testen Sie ohne den Filter: Deaktivieren Sie HUSKY kurz und öffnen Sie direkt eine hohe Seite, etwa
/shop/page/17/. Ist das jetzt ein 404, liegt die Abweichung zwischen Theme und Builder, nicht im Filter.
Ist die Seitenzahl nur beim Filtern noch immer zu hoch, berechnet das Theme die Paginierung vermutlich aus einer anderen Abfrage; So beheben Sie eine Paginierung mit zu vielen Seiten enthält ein Snippet, das die Gesamtzahl aus der gefilterten Abfrage erzwingt. Avada hat einen eigenen Fall, beschrieben unter Avada: Filter geht bei der Paginierung verloren.
Leere Seite nach Änderung eines Filters auf Seite 2 oder später
Ein Besucher auf Seite 3 ändert einen Filter. Das neue Ergebnis hat eine Seite; fordert der neue Link dennoch Seite 3 an, ist das Raster leer oder die Seite ein 404. HUSKY verhindert das bei der Standard-Paginierung: Es entfernt /page/N/ und den WooCommerce-Parameter product-page aus dem Link, den es erstellt, und setzt im AJAX-Modus bei jeder Änderung auf Seite 1 zurück. Andere Seitenparameter im Query-String werden mit dem Rest der Adresse in den neuen Link übernommen, zum Beispiel ?paged=3 auf Websites mit einfachen Permalinks oder der eigene Paginierungsparameter eines Page Builders. Verwenden Sie schöne Permalinks (Einstellungen → Permalinks (Settings → Permalinks), jede Struktur außer Einfach (Plain)) und die Standard-Paginierung von WooCommerce, und prüfen Sie die Adresse nach einer Filteränderung: Sie sollte keine Seitennummer enthalten.
AJAX-Paginierung, „Mehr laden“ und Infinite Scroll des Themes
Viele Themes haben einen eigenen AJAX-Shop: Paginierung, „Mehr laden“-Schaltflächen, Infinite Scroll, AJAX-Sortierung oder einen Raster-/Listen-Umschalter, die Produkte und Seitenleiste ersetzen, ohne neu zu laden. HUSKY initialisiert sein Formular beim Laden der Seite (und nach seiner eigenen AJAX-Aktualisierung). Setzt das Theme neues Sidebar-HTML ein, werden die neuen Filterelemente nie initialisiert, sodass der Filter nicht mehr reagiert, seine Formatierung verliert oder falsche Werte sendet. Die „Mehr laden“-Anfrage eines Themes baut außerdem eine eigene Abfrage für „die nächste Seite“ auf und weiß nichts vom Filter, weshalb sie einer gefilterten Liste ungefilterte Produkte hinzufügen kann.
- Schalten Sie die AJAX-Paginierung, den AJAX-Shop, den Infinite Scroll und die „Mehr laden“-Optionen des Themes aus und testen Sie mit der Standard-Paginierung. Das behebt die meisten Fälle.
- Für Infinite Scroll hat HUSKY eine eingebaute Unterstützung für das kostenlose Plugin YITH Infinite Scrolling: Nach jeder AJAX-Filterung initialisiert es das Scrollen neu und korrigiert den Link zur nächsten Seite. Verwenden Sie die Selektoren aus Infinite Scroll für gefilterte Produkte.
- Jedes andere Skript, das nach der AJAX-Filterung neu starten muss, kann auf das Ereignis
woof_ajax_donehören, beschrieben unter Das Ereignis woof_ajax_done. Welcher Aufruf es neu startet, hängt von diesem Skript ab; fragen Sie dessen Autor.
/*
* Runs after every HUSKY AJAX filtering.
* Put it in a JavaScript file of your child theme.
*/
jQuery(document).on('woof_ajax_done', function () {
// call the init function of your infinite scroll or load-more script here
});
Statt in eine Theme-Datei kann der Rumpf dieser Funktion auch in Erweitert → Code → JavaScript-Code nach Abschluss von AJAX (Advanced → Code → JavaScript code after AJAX is done) eingetragen werden.
Filter fehlt oder geht auf Seite 2 verloren
- Der Filter verschwindet auf Seite 2. Er wurde im Inhalt der Shop-Seite oder in einer Kategoriebeschreibung platziert. WooCommerce gibt beides nur auf der ersten Seite eines Archivs aus. Setzen Sie den Filter in ein Sidebar-Widget, einen Theme-Bereich, der auf jeder Seite erscheint, oder einen Builder-Block außerhalb der Beschreibung.
- Seite 2 zeigt ungefilterte Produkte. Im Weiterleitungsmodus behält die Standard-Paginierung von WooCommerce den Filter in ihren Links (
/shop/page/2/?swoof=1&pa_color=red). Fahren Sie mit der Maus über einen Seitenlink: Fehlenswoof=1und Ihre Filterwerte, baut das Theme eigene Links ohne Query-String; wechseln Sie zur Standard-Paginierung oder korrigieren Sie die Linkfunktion des Themes. - Seite 2 leitet zum Shop um oder verliert die Kategorie. Plugins und eigener Code, die Produkt-URLs oder Archiv-Slugs umschreiben, können mit Filterlinks in Konflikt geraten. Testen Sie mit ihnen deaktiviert; für einen bekannten Fall siehe HUSKY und Permalinks Manager Pro.
Keine Paginierung nach dem Filtern
Im AJAX-Modus enthält der aktualisierte Block alles, was WooCommerce am Hook woocommerce_after_shop_loop ausgibt, und dort liegt die Paginierung von WooCommerce. Ein Theme, das die Paginierung von diesem Hook entfernt und eine eigene an anderer Stelle ausgibt, verliert sie nach der ersten AJAX-Filterung; der Weiterleitungsmodus vermeidet das Problem. Haben Sie ein eigenes Archiv-Template gebaut, geben Sie die Paginierung nach der Produktschleife selbst aus:
<?php
// In your WooCommerce archive template (child theme), after the product loop:
woocommerce_pagination();
?>
Ein eigenes Template benötigt außerdem die Standard-Shop-Schleifen-Hooks, damit der AJAX-Modus überhaupt funktioniert; Die Filter-URL ändert sich, aber die Produkte nicht erklärt, welche das sind.
Um Besucher nach einem Seitenwechsel zum Anfang der Produkte zurückzubringen, siehe Automatisches Scrollen nach der AJAX-Filterung oder, im Weiterleitungsmodus, Automatisches Scrollen zu den Produkten im Weiterleitungsmodus.
Checkliste, wenn die Paginierung des WooCommerce Filters nicht funktioniert
- Im Weiterleitungsmodus getestet (Versuchen Sie AJAX im Shop (Try to ajaxify the shop) = Nein (No), Turbo-Modus aus,
is_ajax=0in Shortcodes), nachdem alle Caches geleert wurden. - Das Paginierungs-Markup ist
nav.woocommerce-paginationmit Linksa.page-numbers. - Die Zahl der Produkte pro Seite ist im Theme, im Builder und in HUSKY dieselbe, oder die von HUSKY ist
-1. - AJAX-Paginierung, „Mehr laden“ und Infinite Scroll des Themes sind aus oder werden bei
woof_ajax_doneneu initialisiert. - Paginierungslinks auf einer gefilterten Seite enthalten
swoof=1und die Filterwerte, und nach einer Filteränderung bleibt keine alte Seitennummer erhalten. - Der Filter sitzt in einer Seitenleiste oder einem Template-Bereich, nicht in der Beschreibung von Shop oder Kategorie.
Schlägt die Paginierung im Weiterleitungsmodus mit der Standard-Paginierung des Themes weiterhin fehl, eröffnen Sie ein Thema im HUSKY-Support-Forum mit dem Link zur Seite und der Adresse einer Seite, die fehlschlägt.