HUSKY - WooCommerce Product Filter Professional

WooCommerce AJAX-Filter zerstört Produktraster-Layout: Ursachen und Lösungen

Der Shop sieht bis zum ersten Filterklick richtig aus. Dann werden aus drei Spalten vier, in den Zeilen entstehen Lücken, Produktkarten verlieren die Badges oder Schaltflächen des Themes, oder die Seitenleiste rutscht unter die Produkte. Wenn ein WooCommerce-AJAX-Filter das Layout des Produktrasters zerstört, sind die Produkte selbst korrekt; geändert hat sich das HTML, das sie darstellt. Im Folgenden steht, was der AJAX-Modus von HUSKY ersetzt, warum themespezifisches Markup dabei verloren geht und wie Sie jedes Symptom beheben.

Was der AJAX-Modus ersetzt und was er nicht kopieren kann

Ist Versuchen Sie AJAX im Shop (Try to ajaxify the shop) auf Ja (Yes) gestellt (WooCommerce → Einstellungen → Products Filter → Optionen), markiert das Plugin den Produktbereich der Shop- und Kategorieseiten. Am Hook woocommerce_before_shop_loop (Priorität 2) öffnet es einen Container <div class="woocommerce woocommerce-page woof_shortcode_output"> mit <div id="woof_results_by_ajax"> darin, und an woocommerce_after_shop_loop (Priorität 10) schließt es beide.

Ändert ein Besucher den Filter, sendet das Skript eine Anfrage an /wp-admin/admin-ajax.php mit der Aktion woof_draw_products. Der Server rendert [woof_products is_ajax=1], und das Skript tauscht den Container gegen das Ergebnis aus. Dieses Ergebnis wird ausschließlich aus WooCommerce-Standardbausteinen aufgebaut:

  • dem Hook woocommerce_before_shop_loop (Hinweise, Ergebnisanzahl, Sortier-Dropdown);
  • woocommerce_product_loop_start(), das <ul class="products columns-N"> ausgibt;
  • dem Template-Teil content-product.php für jedes Produkt;
  • woocommerce_product_loop_end() und dem Hook woocommerce_after_shop_loop (Seitennummerierung).

Daraus folgen zwei Dinge. Erstens: Alles, was das Archiv-Template Ihres Themes selbst zwischen den beiden Hooks ausgibt (zusätzliche Wrapper, eine Raster-Klasse, ein Loop-Skin eines Builders), steckt nicht im neuen HTML. Zweitens: Das neue HTML entsteht in einer admin-ajax-Anfrage, nicht auf der Shopseite. Code, der beim Laden der Shopseite läuft, an der Aktion wp oder template_redirect, im Archiv-Template oder nur bei is_admin() gleich false, wird dafür nie ausgeführt. Auch Theme-Skripte, die das Raster einmalig beim Laden der Seite gestaltet haben, laufen nicht erneut.

Herausfinden, was sich geändert hat: Markup vorher und nachher vergleichen

Öffnen Sie den Shop in einem privaten Fenster, klicken Sie mit der rechten Maustaste auf das erste Produkt und wählen Sie Untersuchen (Inspect). Notieren Sie die Klassen von ul.products, seinen übergeordneten Elementen und des ersten li.product. Wenden Sie einen Filter an und untersuchen Sie dieselbe Stelle erneut. Der Unterschied weist auf die Lösung:

Symptom nach dem FilternUrsacheAbschnitt
Andere Spaltenanzahl, columns-4 statt columns-3Die Spalteneinstellung des Themes wird in der AJAX-Anfrage nicht angewendetSpalten und Lücken
Zeilen mit 3, dann 1, dann 3; Lücken im RasterDie Zeilenklassen first/last werden für eine andere Spaltenanzahl gezähltSpalten und Lücken
Seitenleiste oder Footer verschiebt sich, verschwindet oder wiederholt sich; Produkte erscheinen doppeltDas Theme ruft nicht beide Shop-Loop-Hooks um die Schleife aufShop-Loop-Hooks
Klasse an ul.products fehlt, Schaltflächen oder Badges sind wieder da, Raster-/Listenansicht verloren, leere BilderTheme-Markup, PHP-Bedingungen oder Theme-SkripteFunktionen der Theme-Karten

Produktspalten ändern sich nach dem Filtern, und Lücken entstehen

[woof_products] übernimmt seine Spaltenanzahl aus dem WooCommerce-Filter loop_shop_columns, der auf Produkte pro Zeile (Products per row) unter Design → Customizer → WooCommerce → Produktkatalog zurückfällt. Themes mit eigener Spaltenoption wenden diese oft nur beim Laden einer Shopseite an. In der AJAX-Anfrage läuft dieser Code nicht, sodass die Ergebnisse mit dem WooCommerce-Wert zurückkommen: häufig 4, wo der Shop 3 zeigt.

Die Lücken haben dieselbe Wurzel. WooCommerce gibt dem ersten Produkt jeder Zeile die Klasse first und dem letzten last, gezählt anhand dieser Spaltenanzahl, und das klassische Float-Raster beginnt bei jedem first eine neue Zeile. Passen nach dem CSS des Themes 3 Produkte in eine Zeile und das AJAX-HTML zählt 4, erzwingt jedes vierte Produkt eine neue Zeile: 3 Produkte, dann 1 allein, dann wieder 3.

Legen Sie die Spaltenanzahl einmal für alle Anfragen fest, mit der Zahl, die Ihr Shop auf dem Desktop zeigt:

/**
 * Same number of columns on shop pages and in HUSKY AJAX results.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter( 'loop_shop_columns', function () {
    return 3; // products per row on desktop
}, 999 );

Verpacken Sie das nicht in is_shop() oder ähnliche Prüfungen, sonst wird es in der AJAX-Anfrage übersprungen. Die Priorität 999 sorgt dafür, dass es sich gegen den eigenen Filter des Themes durchsetzt. Die kurze FAQ Gefilterte Ergebnisse auf eine feste Spaltenanzahl zwingen verwendet denselben Filter. Auf einer eigenen Seite legt [woof_products columns=3] die Anzahl direkt fest. Smartphones und Tablets werden in beiden Fällen durch die CSS-Media-Queries des Themes gestaltet.

Steht nach dem Filtern columns-3 in der Klasse und die Breiten sind trotzdem falsch, dimensioniert das Theme die Produkte über eine Klasse an einem eigenen Wrapper außerhalb des ausgetauschten Bereichs. Fügen Sie CSS für den AJAX-Container unter Design → Customizer → Zusätzliches CSS oder im Feld Individueller CSS-Code (Custom CSS code) des Plugins (Erweitert → Code) hinzu:

/* HUSKY AJAX results: 3 products per row in a float-based grid */
#woof_results_by_ajax ul.products li.product {
    width: 30.75%;
    margin-right: 3.8%;
    clear: none;
}
#woof_results_by_ajax ul.products li.product:nth-child(3n) {
    margin-right: 0;
}
#woof_results_by_ajax ul.products li.product:nth-child(3n+1) {
    clear: both;
}

Legt Ihr Theme ul.products statt mit Floats mit CSS Grid aus, genügt eine Regel: #woof_results_by_ajax ul.products { grid-template-columns: repeat(3, 1fr); }. Verpacken Sie beide Varianten in eine Desktop-Media-Query, wenn das Theme auf Smartphones weniger Spalten verwendet.

Seitenleiste unter den Produkten, kaputter Footer, doppelte Ergebnisse: die Shop-Loop-Hooks

Der AJAX-Modus setzt voraus, dass das Theme woocommerce_before_shop_loop direkt vor der Produktliste und woocommerce_after_shop_loop direkt danach aufruft, wie es das WooCommerce-Standard-Template tut. Tut es das nicht:

  • Der schließende Hook fehlt. Die beiden Container werden nie geschlossen, und der Browser schließt sie erst am Ende ihres übergeordneten Elements. Die Seitenleiste, die zweite Spalte oder der Footer landen im Produktbereich: Oft liegt die Seitenleiste schon beim Laden der Seite unter den Produkten, und nach dem ersten Filterklick wird alles im Container, auch die Seitenleiste mit dem Filter, durch die Ergebnisse ersetzt.
  • Die Hooks werden an anderer Stelle aufgerufen. Löst das Theme sie in einer Toolbar aus und gibt die Produktschleife nach woocommerce_after_shop_loop aus, landen die AJAX-Ergebnisse im Container, während das ursprüngliche Raster darunter stehen bleibt, sodass Produkte doppelt erscheinen.
  • Theme-Wrapper überkreuzen die Container. Ein Element, das das Theme an woocommerce_before_shop_loop öffnet und an woocommerce_after_shop_loop schließt, muss entweder vollständig innerhalb der Container von HUSKY liegen (nach Priorität 2 geöffnet, vor Priorität 10 geschlossen) oder vollständig außerhalb. Alles dazwischen überlappt sie und zerstört die Verschachtelung.

Zur Kontrolle öffnen Sie den Seitenquelltext (Strg+U), suchen nach woof_results_by_ajax und folgen dem HTML nach unten: Nach dem schließenden </ul> der Produkte und der Seitennummerierung müssen zwei </div> stehen, bevor die Seitenleiste oder der Footer beginnt. Suchen Sie im Theme-Ordner in den Archiv-Templates nach woocommerce_after_shop_loop. Der Produktteil eines Templates, das mit dem AJAX-Modus funktioniert, sieht aus wie das archive-product.php von WooCommerce selbst:

<?php
if ( woocommerce_product_loop() ) {
    do_action( 'woocommerce_before_shop_loop' );

    woocommerce_product_loop_start();
    if ( wc_get_loop_prop( 'total' ) ) {
        while ( have_posts() ) {
            the_post();
            do_action( 'woocommerce_shop_loop' );
            wc_get_template_part( 'content', 'product' );
        }
    }
    woocommerce_product_loop_end();

    do_action( 'woocommerce_after_shop_loop' );
} else {
    do_action( 'woocommerce_no_products_found' );
}

Nehmen Sie die Änderung in einer Child-Theme-Kopie des Templates vor oder bitten Sie den Theme-Autor, den fehlenden Hook zu ergänzen. Page-Builder-Layouts rufen selten beide Hooks auf; für sie ist der unten beschriebene Weiterleitungsmodus die realistische Wahl. Produkte, die sich überhaupt nicht ändern, behandelt Filter-URL ändert sich, Produkte aber nicht, und Elementor-Templates Elementor Loop Grid und Archiv-Templates filtern nicht.

Funktionen der Theme-Karten gehen verloren: Badges, Schaltflächen, Raster-Klassen, Skripte

Änderungen, die Ihr PHP nur auf Shopseiten vornimmt

Code, der Warenkorb-Schaltflächen ausblendet, eine Kategoriezeile oder ein Badge hinzufügt und das an wp oder template_redirect mit is_shop() entscheidet, läuft in der AJAX-Anfrage nicht, sodass nach dem Filtern die Standardkarte zurückkommt. Führen Sie ihn auch für die Anfrage von HUSKY aus. admin_init wird bei jeder admin-ajax-Anfrage ausgelöst:

/**
 * Card changes for shop pages AND for HUSKY AJAX results.
 * Child theme functions.php or a code snippets plugin.
 */
function my_shop_card_changes() {
    // Example: no add-to-cart buttons in the product grid
    remove_action( 'woocommerce_after_shop_loop_item', 'woocommerce_template_loop_add_to_cart', 10 );
}

// Normal page loads of the shop and product archives
add_action( 'wp', function () {
    if ( is_shop() || is_product_taxonomy() ) {
        my_shop_card_changes();
    }
} );

// HUSKY AJAX filtering, sent through admin-ajax.php
add_action( 'admin_init', function () {
    if ( wp_doing_ajax() && isset( $_REQUEST['action'] ) && 'woof_draw_products' === $_REQUEST['action'] ) {
        my_shop_card_changes();
    }
} );

Theme-Optionen, die die Karte verändern (eine Kategoriezeile, ein Hover-Bild, eine Schnellansicht-Schaltfläche), werden oft auf dieselbe Weise im Theme selbst angewendet. Verschwinden sie nach dem Filtern und hat das Theme keinen Hook, der auch AJAX-Anfragen abdeckt, verwenden Sie den Weiterleitungsmodus.

Klassen, die das Theme zur Produktliste hinzufügt

Zeigt der Vergleich eine Klasse an ul.products, die beim Laden der Seite vorhanden ist und nach dem Filtern fehlt, fügen Sie sie der AJAX-Antwort mit dem Filter woof_draw_products_html hinzu. Er erhält das HTML, das gleich an den Browser gesendet wird:

/**
 * Add the theme's grid class to the product list in HUSKY AJAX results.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter( 'woof_draw_products_html', function ( $html, $shortcode_str ) {
    return str_replace(
        '<ul class="products columns-',
        '<ul class="products my-theme-grid columns-', // use the class from your page
        $html
    );
}, 10, 2 );

Die Suchzeichenfolge entspricht dem loop/loop-start.php von WooCommerce; überschreibt Ihr Theme diese Datei, kopieren Sie das öffnende Tag aus dem Seitenquelltext. Rendert das Theme Karten mit einem anderen Template-Teil als content-product.php, geben Sie dessen Namen mit dem Filter woof_template_part zurück: Der Wert product-grid lädt content-product-grid.php aus dem Ordner woocommerce Ihres Themes.

Theme-Skripte: Lazy-Bilder, gleiche Höhen, Masonry, Schnellansicht

Skripte, die einmal beim Laden der Seite laufen (verzögert geladene Bilder, Karten gleicher Höhe, Masonry, Umschalter zwischen Raster und Liste, Schnellansicht-Schaltflächen), sehen die neuen Produkte nicht. HUSKY löst nach jedem Austausch das jQuery-Ereignis woof_ajax_done aus; legen Sie den Initialisierungsaufruf des Themes dorthin, in eine JS-Datei des Themes oder in JavaScript-Code nach Abschluss von AJAX (JavaScript code after AJAX is done) (Erweitert → Code). Der Theme-Autor kann die Funktion nennen; mehr zum Ereignis unter woof_ajax_done.

jQuery(document).on('woof_ajax_done', function () {
    // Many layout scripts recalculate on resize
    jQuery(window).trigger('resize');
    // Call your theme's own init function here if it has one
});

Ergebnisanzahl oder Sortierung doppelt angezeigt

Ein Theme, das seine eigene Anzahl- und Sortierleiste außerhalb des Produktbereichs ausgibt, kann in den AJAX-Ergebnissen trotzdem die WooCommerce-Standardkopien erhalten. Blenden Sie die inneren Kopien aus, aber nur, wenn es wirklich Duplikate sind:

#woof_results_by_ajax .woocommerce-result-count,
#woof_results_by_ajax .woocommerce-ordering {
    display: none;
}

Aktualisiert sich die Anzahl des Themes außerhalb des Bereichs nach dem Filtern nicht, tragen Sie ihren CSS-Selektor in Ergebnisanzahl-CSS-Selektor (Result count css selector) (Erweitert → Optionen) ein: Das Plugin sendet dann mit jeder AJAX-Antwort eine aktuelle Anzahl und ersetzt das gefundene Element.

Wann Sie auf AJAX verzichten: Weiterleitungsmodus und Turbo Mode

Manche Layouts lassen sich nicht aus WooCommerce-Standardbausteinen neu aufbauen: Loop-Skins von Buildern, Karussells, Theme-Templates ohne die Hooks. Stellen Sie Versuchen Sie AJAX im Shop auf Nein (No). Jede Filteränderung lädt dann die gefilterte URL, und Ihr Theme rendert die ganze Seite wie gewohnt, sodass das Raster mit dem des ungefilterten Shops identisch ist. Verloren geht die Aktualisierung an Ort und Stelle. Um nur einmal pro Suche statt nach jedem Klick neu zu laden, stellen Sie Automatische Übermittlung (Autosubmit) auf Nein, damit der Filter auf seine Schaltfläche wartet, und lesen Sie Automatisches Scrollen zu den Produkten im Weiterleitungsmodus, um den Besucher bei den Ergebnissen landen zu lassen.

Springt Versuchen Sie AJAX im Shop immer wieder auf Ja zurück, ist der Turbo Mode eingeschaltet: Er aktiviert den AJAX-Modus bei jedem Seitenaufruf. Stellen Sie zuerst Turbomodus aktivieren (Enable turbo mode) in seinem Tab auf Nein, schalten Sie dann AJAX aus und leeren Sie den Seiten-Cache, damit Besucher die neue Einstellung erhalten.

Checkliste

  • Markup vor und nach dem Filtern im Browser-Inspektor verglichen.
  • loop_shop_columns gibt die Spaltenanzahl des Shops ohne Seitenbedingungen zurück.
  • Der Seitenquelltext zeigt, dass die beiden HUSKY-Container direkt nach den Produkten und der Seitennummerierung schließen.
  • PHP-Änderungen an den Karten laufen auch für die Anfrage woof_draw_products; Theme-Skripte laufen bei woof_ajax_done erneut.
  • Weicht das Layout weiterhin ab: Versuchen Sie AJAX im Shop = Nein, bei ausgeschaltetem Turbo Mode und geleerten Caches.

Bricht das Layout auch mit einem Standard-Theme wie Storefront und nur HUSKY als aktivem Plugin weiterhin, eröffnen Sie ein Thema im HUSKY-Support-Forum mit einem Link zur Shopseite und einer Beschreibung dessen, was sich nach dem Filtern ändert.