WOOT - WooCommerce Active Products Tables

HUSKY Filter mit einer WooCommerce Produkttabelle verbinden

Der in eine Produkttabelle integrierte Filter deckt die Grundlagen ab: Preis, Artikelnummer, Lagerbestand, Kategorien und Attribute. Wenn Kunden voneinander abhängige Filter brauchen, Optionen, die auf das tatsächlich Verfügbare beschränkt sind, oder einen Link auf das gefilterte Ergebnis, verbinden Sie Ihre WooCommerce Produkttabelle mit dem HUSKY Filter (WooCommerce Products Filter, auch als WOOF bekannt). Die Tabelle zeigt dann genau die Produkte, die HUSKY findet, mit ihren eigenen Spalten, ihrer Sortierung und ihrer Seitennummerierung. Im Folgenden erfahren Sie, wie die Verbindung funktioniert, welche zwei Shortcodes sie benötigt und wie Sie damit abhängige Filter und teilbare Filter-URLs erhalten.

Was der eingebaute Tabellenfilter nicht kann

Der Tab Filter einer Tabelle erstellt einen schnellen AJAX-Filter, der für viele Tabellen ausreicht. Er hat bewusste Grenzen:

  • Keine abhängigen Optionen. Jedes Element listet alle nicht leeren Begriffe seiner Taxonomie aus dem gesamten Shop auf. Die Wahl von Produkt A in einem Dropdown verringert die Größen im nächsten nicht.
  • Keine Anzahlen, kein Ausblenden von Sackgassen. Ein Kunde kann eine Kombination wählen, die nichts ergibt, und erfährt es erst aus der leeren Tabelle.
  • Kein Filterzustand in der URL. Der Filter arbeitet innerhalb der Seite, daher lässt sich eine gefilterte Ansicht weder als Lesezeichen speichern noch an jemanden senden.
  • Einfache Bedienelemente. Lange Begriffsnamen werden in einer schmalen Mehrfachauswahl abgeschnitten, und es gibt keine Farbmuster, Bilder oder schrittweisen Formulare.

HUSKY leistet all das. Es ist ein eigenständiges Plugin desselben Teams, erhältlich auf wordpress.org, und die Tabelle hat dafür eine fertige Verbindung.

Den HUSKY Filter mit einer WooCommerce Produkttabelle verbinden

Hat eine Tabelle filter_provider='woof', gibt jede Anfrage nach ihren Zeilen die aktuellen HUSKY-Parameter an HUSKY weiter, HUSKY berechnet die IDs der passenden Produkte, und die Tabelle zeigt nur diese Produkte, weiterhin mit ihren eigenen Spalten, ihrer Sortierung und ihrer Seitennummerierung. Die Verbindung steckt im Tabellen-Plugin, in die functions.php muss also nichts eingetragen werden; der Code auf der Seite woot_filter_provider_ ist derselbe Mechanismus, als Referenz.

  1. Installieren und aktivieren Sie HUSKY. Aktivieren Sie unter WooCommerce → Einstellungen → Produktfilter (Products Filter) im Tab Struktur (Structure) die Taxonomien und Elemente, die der Filter haben soll (Kategorien, Attribute, Preis und so weiter), und speichern Sie.
  2. Platzieren Sie den Filter und die Tabelle auf derselben Seite:
    [woof ajax_redraw=1 autosubmit=1 redirect="https://example.com/price-list/"]
    [woot id=1 filter_provider='woof']
    Ersetzen Sie 1 durch die ID Ihrer Tabelle und die Adresse durch die Adresse genau dieser Seite. Das Attribut redirect ist wichtig: Auf einer normalen Seite (also allem außer einem Archiv für Produktkategorie, Schlagwort oder Attribut) baut HUSKY seine Suchlinks auf der Shopseite auf, sodass ein Suchvorgang den Kunden ohne dieses Attribut in den Shop führen kann, wo die Tabelle nicht ist. Der Filter kann auch in ein Sidebar-Widget dieser Seite gesetzt werden; das HUSKY-Widget hat dieselben Einstellungen wie Weiterleiten zu (Redirect to) und Formular per AJAX neu zeichnen (Form AJAX redrawing).
  3. Prüfen Sie die Anführungszeichen. Geben Sie die Shortcodes in einem Code-Editor oder einem Shortcode-Block ein. Textverarbeitungen und manche Editoren machen aus 'woof' ein ’woof’ mit typografischen Anführungszeichen; der Attributwert ist dann nicht mehr gleich woof, und die Tabelle ignoriert den Filter ohne jede Fehlermeldung. Sie können die Anführungszeichen auch weglassen: filter_provider=woof funktioniert.
  4. Schalten Sie den eigenen Filter und die Suche der Tabelle ab. Mit filter_provider='woof' überlässt die Tabelle das Filtern HUSKY, und die meisten Elemente ihres eigenen Filter-Tabs sowie ihr Feld Suche nach Titel (search by title) grenzen die Ergebnisse nicht mehr ein. Lassen Sie den Filter-Tab leer oder aktivieren Sie in den Optionen (Options) der Tabelle Filterformular deaktivieren (Disable filter form), schalten Sie dort Suche nach Titel anzeigen (Show search by title) aus und verwenden Sie stattdessen die HUSKY-Textsuche, wie unter Produkttabelle nach Beschreibung durchsuchen beschrieben.

Mit oder ohne Neuladen der Seite

Das Attribut ajax_redraw=1 bestimmt, wie die Seite auf eine Filteränderung reagiert.

  • [woof ajax_redraw=1 autosubmit=1]: ohne Neuladen. Bei jeder Änderung zeichnet HUSKY nur sein Formular mit aktualisierten Anzahlen neu und meldet das über ein JavaScript-Ereignis; die Tabelle hört auf dieses Ereignis und lädt ihre Zeilen mit dem neuen Filter nach. Nach der ersten Änderung blendet die Tabelle die HUSKY-Schaltfläche Filtern (Filter) aus, da sich die Tabelle von selbst aktualisiert. Um die Schaltfläche von Anfang an auszublenden, fügen Sie .woof[data-ajax-redraw="1"] .woof_submit_search_form { display: none; } zum benutzerdefinierten CSS Ihres Themes hinzu.
  • [woof redirect="..."] ohne ajax_redraw: mit Neuladen. Jede Änderung (oder die Schaltfläche Filtern (Filter), wenn Autosubmit aus ist) lädt die Seite mit dem Filter in der URL neu, und die Tabelle liest ihn beim Laden. Die Bedienung ist langsamer, dafür enthält die Adressleiste immer den aktuellen Filter.

Ältere Anleitungen verwenden [woof is_ajax=1]. is_ajax ist ein Attribut von [woof_products], nicht von [woof], das es ignoriert, sodass diese Kombination im Neulade-Modus läuft. Fügen Sie [woof_products] nicht auf der Tabellenseite ein: Es gibt unter der Tabelle eine zweite, normale Produktliste aus.

Abhängige Filter, die nur verfügbare Optionen zeigen

Abhängige Filter sind eine HUSKY-Funktion namens Dynamische Neuzählung (Dynamic recount). Wählt ein Kunde in einem Bereich einen Wert, berechnet HUSKY jeden anderen Bereich für die verbleibenden Produkte neu, sodass Optionen ohne Ergebnisse verschwinden. Unter WooCommerce → Einstellungen → Produktfilter (Products Filter) → Optionen (Options):

  • Anzahl anzeigen (Show count): Ja. Die Neuzählung baut auf den Anzahlen auf.
  • Dynamische Neuzählung (Dynamic recount): Ja. Die Anzahlen folgen der aktuellen Auswahl.
  • Leere Begriffe ausblenden (Hide empty terms): Ja. Optionen mit der Anzahl 0 werden ausgeblendet, statt grau angezeigt zu werden.

Wählen Sie Produkt A, und der Größenbereich zeigt nur Small und Medium, wenn Produkt A nur in diesen erhältlich ist. Mit ajax_redraw=1 geschieht das an Ort und Stelle, im Neulade-Modus nach dem Neuladen.

Zwei verwandte Einstellungen sind gut zu kennen. Verschiedene Bereiche grenzen sich immer gegenseitig ein: Farbe und Größe müssen beide passen. Innerhalb eines Bereichs bedeuten zwei angehakte Kontrollkästchen standardmäßig „eines von beiden“; damit beide Begriffe auf dasselbe Produkt zutreffen, öffnen Sie im Tab Struktur (Structure) die zusätzlichen Optionen dieser Taxonomie und setzen Filterlogik (Logic of filtering) auf AND. Für eine geführte Auswahl, bei der der Kunde eine Frage nach der anderen beantwortet (Grundfarbe, dann Farbname, dann Stil), bietet HUSKY eine Schritt-für-Schritt-Filter-Erweiterung mit dem Shortcode [woof_step]; aktivieren Sie sie im Tab Erweiterungen (Extensions) und lesen Sie ihre Dokumentation auf der HUSKY-Website.

Teilbare URLs mit den aktuellen Filtern

HUSKY hält den Filter in URL-Parametern: dem Suchkennzeichen swoof=1 plus einem Parameter pro Bereich, zum Beispiel:

https://example.com/price-list/?swoof=1&product_cat=shirts&pa_color=red,blue

Eine Tabelle mit filter_provider='woof' liest diese Parameter beim Laden der Seite, sodass der Link die Tabelle bereits gefiltert öffnet, mit denselben angehakten Optionen im HUSKY-Formular. So teilen Sie eine gefilterte Tabelle mit einem Kunden, nehmen sie in einen Newsletter auf oder verknüpfen einen Menüeintrag mit einer fertigen Auswahl.

Im Neulade-Modus enthält die Adressleiste immer den aktuellen Link, bereit zum Kopieren. Im Modus ohne Neuladen wird die Adressleiste nicht bei jeder Änderung zuverlässig aktualisiert. Wenn Ihnen teilbare Links wichtiger sind als das Vermeiden von Neuladen, verwenden Sie daher [woof] ohne ajax_redraw. Ein Link lässt sich auch von Hand aus den Begriffs-Slugs zusammensetzen, die Sie unter Produkte → Kategorien und Produkte → Attribute sehen.

Andere Filter-Plugins: der Container-Selektor und der Hook

Viele Filter-Plugins verlangen einen „Produkt-Container“ oder „Selektor der Produktliste“, standardmäßig ul.products, und ersetzen dessen Inhalt nach dem Filtern. In einer Produkttabelle liegen die Zeilen in .woot-table tbody, eine Zeile pro Produkt. Diesen Selektor einzutragen, reicht meist nicht aus: Ein solches Plugin schreibt sein eigenes Produkt-Markup, die Karten der Shop-Schleife, statt Tabellenzeilen in den Tabellenkörper, und die Spalten, die Sortierung und die Seitennummerierung der Tabelle passen nicht mehr zu dem, was angezeigt wird.

Eine funktionierende Verbindung übergibt die Ergebnisse des Filters an die eigene Abfrage der Tabelle. Die Tabelle ruft den Filter woot_filter_provider_{name} für jede Tabelle mit filter_provider='{name}' auf, mit den Abfrageargumenten, den Filterdaten und den Shortcode-Argumenten, und das Plugin begrenzt die Abfrage, meist indem es post__in auf die IDs setzt, die sein Filter gefunden hat. Die Seite woot_filter_provider_ zeigt die vollständige HUSKY-Anpassung als Vorlage, und der Hook woot_wp_query_args deckt einfachere Fälle ab, in denen eine Tabelle nur eine feste Auswahl braucht. Das Filter-Plugin muss der Tabelle außerdem mitteilen, wann sie neu zeichnen soll, wie HUSKY es mit seinem Ereignis tut; das ist Sache seines Entwicklers.

Checkliste zur Fehlersuche

  • Die Tabelle ignoriert den Filter: Suchen Sie im Shortcode nach typografischen Anführungszeichen um woof und stellen Sie sicher, dass HUSKY aktiv ist.
  • Eine Filteränderung öffnet die Shopseite: Fügen Sie [woof] das Attribut redirect mit der Adresse der Tabellenseite hinzu.
  • Der Filter hat keine Elemente: Im HUSKY-Tab Struktur (Structure) sind keine Taxonomien oder Elemente aktiviert.
  • Im Modus ohne Neuladen passiert nach einer Änderung nichts: Das Attribut muss exakt ajax_redraw=1 lauten, und die Browser-Konsole muss frei von JavaScript-Fehlern sein. Nehmen Sie die Skripte beider Plugins von den Optionen „JavaScript verzögern“ und „Kombinieren“ von Optimierungs-Plugins aus.
  • Der Filter fehlt auf der Seite: Wird im HUSKY-Tab Erweitert (Advanced) die Option Init plugin on the next site pages only verwendet, tragen Sie die Tabellenseite in deren Liste ein.
  • Die Tabelle zeigt die richtigen Produkte, aber Optionen verschwinden nicht: Anzahl anzeigen (Show count), Dynamische Neuzählung (Dynamic recount) und Leere Begriffe ausblenden (Hide empty terms) müssen alle auf Ja stehen.
  • Unter der Tabelle erscheint eine zweite Produktliste: Entfernen Sie [woof_products] von der Seite.

Wenn Tabelle und Filter weiterhin nicht zusammenarbeiten, eröffnen Sie im WOOT-Support-Forum ein Thema mit einem Link auf die Seite.