WooCommerce Filter-URL ändert sich, Produkte nicht: So beheben Sie es
Sie wählen eine Farbe oder eine Kategorie, der Ladeindikator erscheint, die Adressleiste ändert sich in etwas wie /shop/?swoof=1&pa_color=red, und das Produktraster zeigt weiterhin dieselben Produkte. Wenn sich die URL des WooCommerce-Filters ändert, die Produkte aber nicht, hat der Filter seinen Teil erledigt: Er hat die Suchanfrage erstellt. Das Template, das die Produkte ausgibt, hat sie nur nie gelesen. Diese Anleitung zeigt, wie Sie das in zwei Minuten bestätigen und wie Sie ein Theme, einen Page Builder oder ein eigenes Template dazu bringen, auf den Filter zu reagieren.
Warum sich die Filter-URL ändert, die Produkte aber nicht
HUSKY zeichnet das Produktraster Ihres Shops nicht selbst. Es fügt seine Bedingungen (Taxonomien, Preis, Meta-Felder, Text) zu den Produktabfragen hinzu, die WooCommerce ohnehin ausführt, und nur zu diesen:
- die Hauptabfrage der Shop-Seite sowie der Archive für Produktkategorien, Schlagwörter und Attribute (der Schritt
woocommerce_product_queryvon WooCommerce); - der eigene Shortcode
[woof_products]des Plugins; - die Produkt-Shortcodes von WooCommerce wie
[products], überwoocommerce_shortcode_products_query.
Eine Produktliste, die ihre eigene WP_Query aufbaut, liegt außerhalb dieses Pfads. Produktraster von Page Buildern, Post-Karten und Repeater, „Query Loop“-Elemente, Archiv-Layouts von Themes mit eigener Abfrage und handgeschriebene Schleifen in einem PHP-Template fragen die Datenbank jeweils auf ihre Weise nach Produkten ab und zeigen daher unabhängig vom Filter weiter den ganzen Katalog. Am Filter ist nichts kaputt; die Liste hört schlicht nicht zu.
Zwei verwandte Symptome haben dieselbe Wurzel. Auf einer normalen Seite, auf der das Skript des Filters keine WooCommerce-Produktliste findet, schickt es den Besucher zur Anzeige der Ergebnisse auf die Shop-Seite. Und auf einer „Kategorieseite“, die in Wirklichkeit eine mit einem Builder gestaltete WordPress-Seite ist, kennt der Filter die aktuelle Kategorie nicht, bietet daher jeden Begriff an und durchsucht den ganzen Katalog.
Die Ursache in zwei Minuten bestätigen
- Lesen Sie die URL nach dem Filtern. Enthält sie
swoof=1und Ihre Auswahl (/swoof/gefolgt von der Auswahl bei aktivierten SEO-URLs, oder nurmin_priceundmax_price, wenn der Preis die einzige Auswahl ist), hat der Filter funktioniert. Ändert sich die URL gar nicht, wurde der Filter nie abgeschickt: Suchen Sie zuerst in der Browser-Konsole nach einem JavaScript-Fehler. - Probieren Sie dieselbe Anfrage auf der Standard-Shop-Seite. Kopieren Sie alles ab
?swoof=1und hängen Sie es an die URL Ihrer WooCommerce-Shop-Seite an. Gefilterte Produkte dort und ungefilterte auf Ihrer Seite weisen direkt auf die Produktliste Ihrer Seite. - Testen Sie mit einem einfachen Shortcode. Setzen Sie auf einer Entwurfsseite
[woof]und darunter[woof_products per_page=12]oder den WooCommerce-Shortcode[products limit="12"]. Filtern diese korrekt, verwenden Sie für Ihre echte Seite eine der folgenden Lösungen. - Prüfen Sie, um welche Art von Seite es sich handelt. Sehen Sie sich den Bearbeitungsbildschirm an: Eine WordPress-Seite (Page) mit einem Produktraster ist kein Produktarchiv, selbst wenn ihre URL wie
/category/shoes/aussieht.
Lösung 1: Produkte mit [woof_products] anzeigen
Die zuverlässigste Lösung ist, das Plugin die Produkte ausgeben zu lassen. Ersetzen Sie das Produktelement des Builders durch ein Shortcode-Widget oder einen Shortcode-Block mit [woof_products]:
[woof_products per_page=12 columns=4 is_ajax=1]
Der Shortcode reagiert auf jeder Seite auf den Filter, unterstützt mit is_ajax=1 den AJAX-Modus und stellt jedes Produkt mit der normalen WooCommerce-Produktkarte Ihres Themes dar (dem Template-Teil content-product.php), sodass es wie der Shop aussieht. Um einen anderen Template-Teil zu verwenden, ändern Sie ihn mit dem Filter woof_template_part.
Soll eine Seite nur eine Kategorie auflisten, geben Sie beiden Shortcodes dieselbe Bedingung, sonst bietet der Filter Begriffe aus dem ganzen Katalog an:
[woof taxonomies=product_cat:25]
[woof_products taxonomies=product_cat:25 per_page=12 is_ajax=1]
Ersetzen Sie 25 durch die Kategorie-ID (sie steht in der URL, wenn Sie die Kategorie bearbeiten). Auch der WooCommerce-Shortcode [products] wird gefiltert, aber nur mit einem Neuladen der Seite. Brauchen Sie ihn im AJAX-Modus, schreiben Sie ihn als [products_woof limit="12" columns="4"]: Das Plugin umhüllt ihn so, dass die Ergebnisse ohne Neuladen ausgetauscht werden können.
Lösung 2: Ein Builder-Raster oder eine eigene WP_Query auf den Filter hören lassen
Wenn Sie das Kartendesign des Builders behalten möchten, lassen Sie dessen Abfrage das Ergebnis des Filters verwenden. Das folgende Snippet hängt sich in pre_get_posts ein, fragt HUSKY, welche Produkte zum aktuellen Filter passen, und beschränkt die Abfrage des Rasters darauf. Es ist eine gehärtete Version des Codes in Page Builder und eigene Templates filterbar machen: Es lässt Produktlisten in wp-admin in Ruhe, hält die Seitennummerierung des Rasters funktionsfähig, berücksichtigt eine feste Produktauswahl des Elements und zeigt „keine Produkte“ statt des ganzen Katalogs, wenn nichts passt.
/**
* HUSKY: apply the active filter to product lists that run their own query
* (page builder grids, post cards, query loops, custom templates).
* Child theme functions.php or a code snippets plugin.
*/
add_action( 'pre_get_posts', function ( $query ) {
static $busy = false;
if ( $busy || ! function_exists( 'woof' ) || $query->is_main_query() ) {
return;
}
// Keep the product lists in wp-admin untouched.
if ( is_admin() && ! wp_doing_ajax() ) {
return;
}
// Product queries only.
if ( ! in_array( 'product', (array) $query->get( 'post_type' ), true ) ) {
return;
}
// WooCommerce archives and [woof_products] are filtered already.
if ( 'product_query' === $query->get( 'wc_query' ) ) {
return;
}
// Only while a filter is active: ?swoof=1, an SEO URL,
// or ?min_price=...&max_price=... when only the price is set.
$request = woof()->get_request_data();
if ( ! isset( $request[ woof()->get_swoof_search_slug() ] ) && ! isset( $request['min_price'] ) ) {
return;
}
// Optional: limit to one page.
// if ( ! is_page( 123 ) ) { return; }
$was_doing = isset( $_REQUEST['woof_products_doing'] );
$args = woof()->woof_products( array( 'get_args_only' => 1 ) );
// All matching IDs, whatever page of the grid is open.
$args['fields'] = 'ids';
$args['posts_per_page'] = -1;
$args['paged'] = 1;
$args['no_found_rows'] = true;
$args['orderby'] = 'ID';
unset( $args['meta_key'] );
$busy = true;
$ids = ( new WP_Query( $args ) )->posts;
$busy = false;
if ( ! $was_doing ) {
unset( $_REQUEST['woof_products_doing'] );
}
// Respect a fixed product selection of the element itself.
$own = array_filter( array_map( 'intval', (array) $query->get( 'post__in' ) ) );
if ( $own ) {
$ids = array_values( array_intersect( $ids, $own ) );
}
// No match: show "no products" instead of the whole catalog.
$query->set( 'post__in', $ids ? $ids : array( 0 ) );
} );
So funktioniert es: woof()->woof_products( array( 'get_args_only' => 1 ) ) liefert die Abfrageargumente, die [woof_products] für die aktuelle Anfrage verwenden würde, ohne sie auszuführen. Das Snippet macht daraus eine Liste passender Produkt-IDs und übergibt diese Liste als post__in an das Raster. Das Raster behält sein eigenes Layout, seine Sortierung und seine Seitengröße. Derselbe Hook deckt auch eine WP_Query ab, die Sie selbst in einem Template schreiben, solange sie den Beitragstyp product abfragt.
Jede Produktabfrage auf einer gefilterten Seite folgt jetzt dem Filter, auch Slider wie „Bestseller“ oder „Ähnliche Produkte“ in einem Footer. Ist das nicht gewünscht, entfernen Sie das Kommentarzeichen in der Zeile mit is_page() und tragen Sie die ID der Seite mit dem Raster ein; das erspart zudem eine zusätzliche Datenbankabfrage für jede andere Produktliste auf der Seite.
Der AJAX-Modus braucht die beiden Shop-Loop-Hooks
Ist Versuchen Sie AJAX im Shop (Try to ajaxify the shop) auf Ja (Yes) gesetzt (WooCommerce → Settings → Products Filter → Options), umhüllt das Plugin die Produktliste mit einem eigenen Container. Es öffnet den Container am Hook woocommerce_before_shop_loop und schließt ihn am Hook woocommerce_after_shop_loop. Nach jeder Filteränderung fordert es vom Server neues HTML an und ersetzt den Inhalt dieses Containers. Das Standard-Archiv-Template von WooCommerce ruft beide Hooks auf; viele Builder-Layouts und eigene Templates tun es nicht. Das Ergebnis ist eines von drei Symptomen:
- Keiner der Hooks wird aufgerufen: Es gibt keinen Container, der ersetzt werden könnte, daher lädt jede Filteränderung die ganze Seite neu.
- Nur der erste Hook wird aufgerufen: Der geöffnete Container wird nie geschlossen und verschluckt den Rest des Layouts, zum Beispiel die zweite Spalte oder die Seitenleiste, die plötzlich innerhalb der Produktspalte erscheint.
- Die Karten ändern nach dem Filtern ihr Aussehen: AJAX-Ergebnisse werden auf dem Server von
[woof_products]mit der Standard-WooCommerce-Produktkarte gerendert, nicht mit dem Kartendesign des Builders. Standard-Mengenfelder oder In-den-Warenkorb-Buttons erscheinen dort, wo der Builder sie ausgeblendet hatte.
Wenn Sie den Template-Code kontrollieren, rufen Sie beide Hooks um die Schleife auf:
<?php
// Product list part of your theme template.
do_action( 'woocommerce_before_shop_loop' );
woocommerce_product_loop_start();
while ( have_posts() ) {
the_post();
wc_get_template_part( 'content', 'product' );
}
woocommerce_product_loop_end();
do_action( 'woocommerce_after_shop_loop' );
Alles zwischen den beiden Hooks wird bei jeder AJAX-Anfrage ersetzt; Wrapper-Markup, das Sie um jedes Produkt haben möchten, gehört daher in content-product.php, nicht in das Archiv-Template. Eigene Bedingungen Ihrer Schleife (zum Beispiel „Produkte der letzten 60 Tage“) sind nicht Teil des AJAX-Ergebnisses, weil der Server es mit [woof_products] rendert; fügen Sie solche Bedingungen mit dem Hook woof_products_query hinzu oder verwenden Sie den Weiterleitungsmodus.
Können Sie das Template nicht ändern, was bei Buildern der Normalfall ist, setzen Sie Versuchen Sie AJAX im Shop (Try to ajaxify the shop) auf Nein (No). Im Weiterleitungsmodus lädt jede Filteränderung die gefilterte URL, und das Snippet aus Lösung 2 sorgt dafür, dass das Builder-Raster die richtigen Produkte zeigt. Ist die automatische Übermittlung (Autosubmit) aktiv, wird jede Auswahl sofort angewendet, nur eben mit einem Seitenaufruf statt eines AJAX-Austauschs.
Der Filter springt zur Shop-Seite oder ignoriert die Kategorie
Die Ergebnisse öffnen sich auf der Shop-Seite. Auf einer Seite, die kein Produktarchiv ist, sucht das Skript des Filters nach einer WooCommerce-Produktliste: einem Element mit der Klasse products in einem .woocommerce-Container, oder der eigenen Ausgabe des Plugins. Findet es keine, schickt es die Suche auf die Shop-Seite, und der Filter auf Ihrer Seite scheint zu verschwinden. Lösung 1 behebt das; die Shortcode-Setups für Landingpages und die Startseite stehen in Produktfilter auf einer eigenen Seite. Reagiert Ihr Builder-Raster dank Lösung 2 bereits auf den Filter, verwendet aber anderes Markup, weisen Sie das Skript an, auf der Seite zu bleiben:
/**
* HUSKY: keep filter results on this page instead of the shop page.
* Child theme functions.php or a code snippets plugin.
*/
add_action( 'wp_footer', function () {
if ( is_page( 123 ) ) { // ID of the page with the product grid
echo '<script>var woof_not_redirect = 1;</script>';
}
} );
Der Filter bietet Begriffe aus anderen Kategorien an. Das Plugin übernimmt die aktuelle Kategorie von WordPress (dem abgefragten Objekt eines Produkt-Taxonomie-Archivs). Eine WordPress-Seite, die wie eine Kategorie gestaltet ist, hat keines, sodass der Filter mit dem ganzen Katalog arbeitet. Verwenden Sie das echte Kategoriearchiv und gestalten Sie es mit dem Archiv- oder Theme-Builder-Template Ihres Builders, oder übergeben Sie taxonomies=product_cat:ID an beide Shortcodes, wie in Lösung 1 gezeigt. Ein eigenes Theme ohne WooCommerce-Unterstützung kann denselben Effekt auch auf echten Archiven haben; die Deklaration add_theme_support( 'woocommerce' ) in einem after_setup_theme-Callback behebt die Erkennung, allerdings müssen dann eventuell die Produkt-Templates des Themes angepasst werden. Ist die Seite ein echtes Archiv und wird die Kategorie trotzdem nicht erkannt, setzen Sie Zusätzliche Prüfung der Kategorieseite (Additional check of the category page) unter Advanced → Options auf Ja (Yes). Block-Themes erhalten diese Prüfung automatisch. Wie Sie Begriffe ausblenden, die in der aktuellen Kategorie keine Produkte haben, lesen Sie unter nur die Filteroptionen der aktuellen Kategorie anzeigen.
Routing-Konflikte: SEO-URLs und Permalinks
Ist die Erweiterung SEO URL request aktiv, wird der Filter Teil des Pfads, zum Beispiel /shop/swoof/color-red/, statt eines Query-Strings. Manche Builder lösen URLs und Templates selbst auf (Bricks ist ein bekannter Fall) und erkennen diesen Pfad nicht, sodass die Filteroberfläche funktioniert, die Produkte sich aber nie ändern, oder die Seite auf ein ungefiltertes Template zurückfällt. Zum Testen öffnen Sie Advanced → SEO URL request, setzen Aktivieren/Deaktivieren (Enable/Disable) auf Nein (No), leeren alle Caches und filtern erneut. Funktionieren die einfachen Links ?swoof=1&..., liegt die Ursache im Routing; lassen Sie SEO-URLs auf dieser Website ausgeschaltet.
SEO-URLs setzen außerdem sprechende Permalinks voraus. Steht unter Settings → Permalinks die Einstellung Einfach (Plain), wählen Sie eine beliebige andere Struktur, speichern Sie und testen Sie erneut.
Typische Builder-Situationen
| Was die Produkte anzeigt | Was zu tun ist |
|---|---|
| Produktraster eines Builders, Post-Karten, Repeater oder Query-Loop-Element (Avada Post Cards, Oxygen Repeater, Bricks Query Loop, ein Query-Loop-Block mit eigener Abfrage) | Lösung 2, Weiterleitungsmodus. Oder das Element durch [woof_products] ersetzen. |
| Theme-Builder-Layout, das das Shop- oder Kategorie-Template ersetzt (Avada-Layouts, YOOtheme, Flatsome, Beaver Themer, Breakdance) | Funktioniert im Weiterleitungsmodus, wenn das Layout die WooCommerce-Schleife verwendet. AJAX-Modus nur, wenn das Layout beide Shop-Loop-Hooks aufruft; andernfalls Versuchen Sie AJAX im Shop (Try to ajaxify the shop) auf Nein (No) setzen. |
| Elementor-Produkt-Widgets und Loop-Raster | Siehe Elementor-Produktraster filterbar machen. |
Handgeschriebene WP_Query in einem PHP-Template | Lösung 2 deckt sie ab; für den AJAX-Modus die beiden Hooks hinzufügen. |
| Ein anderes Plugin, das die Produktabfrage oder das Template ersetzt | Zum Test deaktivieren. Funktioniert der Filter danach, muss dieses Plugin die Standard-WooCommerce-Abfrage verwenden. |
Wenn es weiterhin nicht funktioniert
- Testen Sie abgemeldet in einem privaten Fenster. Ein Seiten-Cache, der den Query-String ignoriert, liefert für jede Filter-URL dasselbe ungefilterte HTML aus; schließen Sie URLs, die
swoofenthalten, vom Seiten-Cache aus. - Öffnen Sie nach dem Hinzufügen des Snippets direkt eine Filter-URL. Ist das Raster weiterhin ungefiltert, fragt das Element vermutlich nicht den Beitragstyp
productab, oder es lädt seine Produkte später mit einer eigenen AJAX-Anfrage ohne die Filterparameter nach (manche „Mehr laden“-Buttons tun das). - Filtert die erste Seite korrekt, Seite 2 zeigt aber einen 404-Fehler oder ungefilterte Produkte, verlieren die Paginierungslinks des Rasters die Filterparameter. Prüfen Sie, ob der Link zu Seite 2 weiterhin
swoof=1und Ihre Auswahl enthält; weitere Ursachen stehen unter Filter-Paginierung funktioniert nicht.
Funktioniert der Shortcode-Test aus dem ersten Abschnitt und Ihr Template weiterhin nicht, eröffnen Sie im HUSKY-Support-Forum ein Thema mit einem Link zur Seite, dem Theme oder Builder und dem Element, das die Produkte anzeigt.