WOOT - WooCommerce Active Products Tables

WooCommerce Produkttabelle nach Beschreibung, Kurzbeschreibung und SKU durchsuchen

Das Suchfeld über einer Produkttabelle durchsucht nur Produkttitel, sodass ein Kunde, der ein Wort aus der Beschreibung eingibt, nichts findet. Um eine WooCommerce Produkttabelle nach Beschreibung, Kurzbeschreibung oder SKU zu durchsuchen, erweitern Sie mit einem Shortcode-Attribut, was dieses Feld durchsucht, oder fügen dem Filter der Tabelle separate Suchfelder hinzu. Nachfolgend erfahren Sie, wie die eingebaute Suche funktioniert, wie Sie sie erweitern und warum ein Suchfeld manchmal scheinbar nichts tut.

So funktioniert die eingebaute Suche einer Produkttabelle

Jede Tabelle hat über sich ein Feld Suche nach Titel (search by title). Es wird über drei Zeilen im Tab Optionen der Tabelle gesteuert:

  • Suche nach Titel anzeigen (Show search by title): zeigt das Feld an oder blendet es aus.
  • Mindestzeichenanzahl (Min symbols count): die kürzeste Suche, die das Feld akzeptiert, standardmäßig 3.
  • Platzhalter der Suche nach Titel (Search by title placeholder): der Hinweistext im Feld.

Dasselbe lässt sich pro Shortcode mit hide_text_search=1, text_search_min_symbols=2 und text_search_placeholder='Find a product' festlegen. Wo das Feld im Verhältnis zum Filterformular sitzt, erklärt die Position des Filters nach Beitragstitel festlegen.

Drei Details seines Verhaltens erklären die meisten Meldungen der Art „Die Suche funktioniert nicht“:

  • Sie sucht bei Enter, nicht während der Eingabe. Die Tabelle lädt ihre Zeilen neu, wenn der Kunde die Eingabetaste drückt (auf der Smartphone-Tastatur die Suchtaste). Esc oder das kleine × im Feld löscht die Suche.
  • Eine zu kurze Suche wird ignoriert. Bei weniger Zeichen als Mindestzeichenanzahl (Min symbols count) erhält das Feld einen roten gestrichelten Rand, und es wird nichts gesendet. Senken Sie den Wert, wenn Ihre Produkte kurze Namen oder Codes haben.
  • Sie sucht den Text so, wie er eingegeben wurde. Die Suche findet Produkte, deren Titel den eingegebenen Text als zusammenhängenden Teil enthält, ohne Beachtung der Groß- und Kleinschreibung. rotes hemd findet „Rotes Hemd, langärmlig“, aber nicht „Hemd in Rot“.

WooCommerce Produkttabelle nach Beschreibung und Kurzbeschreibung durchsuchen

In WooCommerce wird die lange Produktbeschreibung als Beitragsinhalt (post_content) und die Kurzbeschreibung als Auszug (post_excerpt) gespeichert. Das Attribut woot_text_search_by von [woot] legt fest, in welchen dieser Felder das Suchfeld sucht:

[woot id=1 woot_text_search_by='post_title,post_content,post_excerpt']

Ein Produkt wird gefunden, wenn eines der aufgeführten Felder den Suchtext enthält. Jede Kombination funktioniert, zum Beispiel 'post_title,post_excerpt', um lange Beschreibungen auszulassen. Für den Wert gelten drei Regeln:

  • Durch Kommas getrennt, keine Leerzeichen. Jeder Name muss exakt stimmen. Bei 'post_title, post_content' beginnt der zweite Name mit einem Leerzeichen, wird nicht erkannt und stillschweigend verworfen, sodass die Suche bei den Titeln bleibt.
  • Gerade Anführungszeichen. Editoren, die ' in ’ umwandeln, kleben das Zeichen an den ersten und den letzten Namen, und beide werden verworfen. Bleibt kein gültiger Name übrig, filtert die Suche nichts, und jede Suche liefert alle Produkte. Geben Sie den Shortcode in einem Shortcode-Block oder im Code-Editor ein oder lassen Sie die Anführungszeichen weg: woot_text_search_by=post_title,post_content,post_excerpt funktioniert ebenfalls.
  • Nur diese drei Felder. post_title, post_content und post_excerpt sind die zulässigen Namen; alles andere wird ignoriert. Nach SKU und benutzerdefinierten Feldern wird über den Filter gesucht, wie unten gezeigt.

Die Einstellung gilt auch für das Element Titel (Title) im Filterformular der Tabelle, weil beide Felder dieselbe Suche senden. Der in der Beschreibung gefundene Text wird nicht hervorgehoben; damit Kunden ihn sehen, fügen Sie die Spalte Inhalt (Content) oder Auszug (Excerpt) hinzu.

Um die Felder für eine Tabelle überall festzulegen, wo sie erscheint, auch für die unten beschriebene Suche mit [woot_drop_down], die kein solches Attribut hat, fügen Sie sie per Code hinzu:

/*
 * Products table #1: the search field also looks in the description
 * and the short description. Child theme functions.php or a code snippets plugin.
 */
add_filter('woot_review_shortcode_args', function ($args) {
    if (isset($args['id']) && (int) $args['id'] === 1) {
        $args['woot_text_search_by'] = 'post_title,post_content,post_excerpt';
    }
    return $args;
});

Separate Suchfelder und SKU-Suche im Filter

Statt eines Feldes für alles kann der Tab Filter der Tabelle separate Textfelder zeigen: Titel (Title), Inhalt (Content), Auszug (Excerpt) und SKU. Jedes durchsucht nur sein eigenes Feld, sie lassen sich miteinander und mit den anderen Filterelementen kombinieren, und wie das Hauptfeld werden sie bei Enter ausgeführt. In ihren Optionen hat jedes einen Platzhalter (Placeholder) und eine Breite (Width), und die Felder für Titel, Inhalt und Auszug außerdem eine Mindestlänge (Minlength).

Das Element SKU ist der Weg, um nach SKU zu suchen. Seine Option Suchlogik (Search logic) wählt zwischen LIKE (die SKU enthält den eingegebenen Text, sodass A12 auch A123 findet) und EXACT (die gesamte SKU muss übereinstimmen). Es gibt zwei Einschränkungen:

  • Es durchsucht die SKU des Produkts in der Zeile. In einer regulären Tabelle sind die Zeilen Produkte, daher werden die SKUs von Variationen, die zu den Variationsdatensätzen gehören, nicht gefunden. Eine Tabelle, die Variationen als Zeilen auflistet, wie in Variationen als separate Zeilen anzeigen beschrieben, findet sie.
  • Leerzeichen und Bindestriche zählen. ZDUP112 stimmt nicht mit ZDUP 112 überein; wenn Kunden Codes unterschiedlich eingeben, halten Sie die SKUs in einem einheitlichen Format.

Ein Suchfeld auf anderen Seiten: [woot_drop_down]

Um eine Produktsuche in Header, Sidebar oder auf der Shopseite einzubauen, verwenden Sie [woot_drop_down]. Er zeigt ein Sucheingabefeld, und wenn der Kunde Enter drückt, klappt darunter eine Tabelle mit den Ergebnissen auf:

[woot_drop_down id=1 placeholder='Search products' width='100%' height=400]

id ist die Tabelle, deren Spalten die Ergebnisse verwenden, height die maximale Höhe des Dropdowns in Pixeln, und skin legt das Aussehen der Ergebnisse fest; ohne es verwenden sie das Standardaussehen, nicht den Skin der Tabelle. Es durchsucht Titel, sofern die Tabelle nicht über den obigen Code woot_text_search_by erhält. Beispiele für die Platzierung finden Sie unter Sucheingabe mit Dropdown-Tabelle hinzufügen.

Textsuche mit dem HUSKY-Filter

Ist die Tabelle mit filter_provider='woof' an den Produktfilter HUSKY angebunden, wie in HUSKY-Filter mit einer WooCommerce Produkttabelle verbinden beschrieben, kann seine Textsuche als Suchfeld dienen. Aktivieren Sie im HUSKY-Tab Struktur (Structure) die Option Suche nach Text (Search by text) (oder setzen Sie [woof_text_filter]) und stellen Sie in den zusätzlichen Optionen unter Verhalten (Behavior) die zu durchsuchenden Felder ein, zum Beispiel Titel oder Inhalt oder Auszug; +SKU fügt der Suche die SKU im selben Feld hinzu. Sie unterscheidet sich auf nützliche Weise von der eigenen Suche der Tabelle: Sie zerlegt den Text in Wörter und findet Produkte, die alle davon in beliebiger Reihenfolge enthalten, sodass hemd rot auch „Rotes Baumwollhemd“ findet. Außerdem bietet sie Autovervollständigung und kann benutzerdefinierte Felder durchsuchen. Verwenden Sie sie anstelle des Feldes der Tabelle: Sobald HUSKY der Filteranbieter ist, übergibt die Tabelle das Filtern an HUSKY, und ihr Feld Suche nach Titel (search by title) schränkt die Ergebnisse nicht mehr ein. Schalten Sie daher Suche nach Titel anzeigen (Show search by title) für diese Tabelle aus.

Geschwindigkeit bei großen Katalogen

Beide Suchen verwenden LIKE mit dem Text mitten in einem Wert, was die Datenbank nicht über einen Index beantworten kann: Jede Suche liest die durchsuchten Felder aller Produkte. Titel sind kurz, daher ist das selbst mit Tausenden von Produkten schnell. Beschreibungen sind oft lang, und die Suche in post_content kostet bei einem großen Katalog spürbar mehr. Durchsuchen Sie Beschreibungen nur in Tabellen, die es brauchen, und lassen Sie Mindestzeichenanzahl (Min symbols count) bei 3 oder höher, damit ein oder zwei Buchstaben keine Suche durch alle Beschreibungen auslösen.

Wenn die Suche trotzdem nicht funktioniert

  • Drücken Sie nach der Eingabe Enter und prüfen Sie, ob der Text mindestens Mindestzeichenanzahl (Min symbols count) Zeichen lang ist.
  • Beschreibungen werden nicht durchsucht: Suchen Sie in woot_text_search_by nach Leerzeichen oder typografischen Anführungszeichen.
  • Jede Suche liefert alle Produkte: Das Attribut enthält keinen gültigen Feldnamen.
  • Der Shortcode hat mode='json' oder mode='to_json': Solche Tabellen laden alle Zeilen auf einmal und durchsuchen sie im Browser nur nach Titel, ohne Filterformular, sodass woot_text_search_by keine Wirkung hat. Entfernen Sie das Attribut, um auf dem Server zu suchen.
  • Das Feld fehlt: Suche nach Titel anzeigen (Show search by title) ist ausgeschaltet, oder der Shortcode hat hide_text_search=1.

Wenn nichts davon hilft, eröffnen Sie im WOOT-Support-Forum ein Thema mit einem Link zur Seite und dem von Ihnen verwendeten Shortcode.