HUSKY - WooCommerce Product Filter Professional

WooCommerce Produktfilter mobil nicht angezeigt: Ursachen und Lösungen

Der Filter funktioniert am Computer, aber auf dem Smartphone fehlt die Seitenleiste, die Schaltfläche Filter öffnen (Open filter) erscheint nie oder sie erscheint und reagiert nicht. Ein WooCommerce Produktfilter, der mobil nicht angezeigt wird, ist selten defekt. Der mobile Modus von HUSKY besteht aus drei Teilen: Der Server erkennt, dass der Besucher ein Smartphone nutzt, ein Skript verschiebt die Schaltfläche an ihren Platz, und ein Tipp öffnet das Formular als Vollbild-Panel. Jeder dieser Teile kann durch das Theme, einen Page Builder, einen Cache oder einen Optimizer gestoppt werden. Diese Anleitung zeigt, welcher Teil ausfällt und wie Sie ihn beheben.

So funktioniert der mobile Modus von HUSKY

Viele Themes zeigen die Seitenleiste auf Smartphones gar nicht an. Ist der Filter ein Sidebar-Widget und wurde sonst nichts eingerichtet, erklärt allein das, warum er fehlt. Der mobile Modus ist die Methode des Plugins, Smartphones eine Schaltfläche zu geben, die den Filter öffnet. In den Einstellungen gibt es keinen globalen Schalter „Mobil“; der mobile Modus wird pro Filterformular aktiviert:

  • Widget: Stellen Sie Mobiler Modus (Mobile mode) im HUSKY-Widget auf Ja.
  • Shortcode: [woof sid="mobile" mobile_mode=1]. Das Attribut sid ist erforderlich; ohne es wird mobile_mode ignoriert.
  • Front-Builder: Schalten Sie Mobiler Modus (Mobile mode) in den Optionen des Formulars [woof_front_builder] ein.

Wird die Seite für ein Smartphone erzeugt, gibt das Plugin dieses Formular ausgeblendet aus und fügt ihm zwei Schaltflächen hinzu, Filter öffnen (Open filter) und Filter schließen (Close filter). Auf Desktops wird dasselbe Formular wie gewohnt angezeigt. Beim Laden der Seite auf einem Smartphone verschiebt ein Skript die Schaltfläche Filter öffnen (Open filter) aus dem ausgeblendeten Formular an eine sichtbare Stelle:

  1. in den Container, den der Shortcode [woof_mobile] ausgibt, falls die Seite einen enthält;
  2. andernfalls in das Element, das zu .woocommerce-products-header passt, dem Block mit dem Shop- oder Kategorietitel im Standard-Archivtemplate von WooCommerce.

Ein Tipp auf die Schaltfläche fügt dem Formular die Klasse woof_show_filter_for_mobile hinzu, wodurch es zu einem fest positionierten Vollbild-Panel über der Seite wird. Im AJAX-Modus schließt sich das Panel nach jeder Filterung von selbst, sodass der Besucher die neuen Produkte sieht.

Zwei Tatsachen erklären die meisten Probleme. Erstens: Ob es sich um ein „Smartphone“ handelt, entscheidet der Server mit der WordPress-Funktion wp_is_mobile() anhand der Request-Header, nicht anhand der Bildschirmbreite. Zweitens: [woof_mobile] markiert nur einen Platz; es zeigt nichts an, wenn die Seite nicht zugleich ein Formular mit aktiviertem mobilem Modus enthält.

Die Schaltfläche „Filter öffnen“ erscheint nicht

Das Template hat keinen Platz dafür. In Theme-Builder-Templates von Elementor und Divi, in Avada-Layouts, in eigenen Seiten, die Produkte mit dem Shortcode [products] auflisten, und in vielen individuellen Themes fehlt oft der Block .woocommerce-products-header. Die Schaltfläche bleibt dann im ausgeblendeten Formular. Setzen Sie [woof_mobile] genau dorthin, wo die Schaltfläche stehen soll, meist oberhalb der Produkte, in ein Shortcode-Widget oder einen Shortcode-Block. Das ist die häufigste Lösung. Auf Desktops wird nichts ausgegeben, der Shortcode kann also auf der Seite bleiben.

Können Sie in diesem Template keinen Shortcode platzieren, richten Sie die Schaltfläche mit dem Hook woof_mobile_btn_place_container auf ein eigenes Element aus. Geben Sie diesem Element eine eindeutige ID (in Elementor: Erweitert → CSS-ID (Advanced → CSS ID)) und verwenden Sie sie:

/*
 * HUSKY: where to put the mobile "Open filter" button.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_mobile_btn_place_container', function ($selector) {
    return '#filter-button-place';
});

Verwenden Sie einen Selektor, der nur auf ein einziges Element passt. Eine allgemeine Klasse wie .elementor-widget-container kopiert die Schaltfläche in jedes passende Element der Seite. Der Hook wird nicht verwendet, wenn die Seite einen [woof_mobile]-Container enthält.

Weitere Gründe, warum die Schaltfläche fehlt:

  • Der Platz wird vom Theme auf Smartphones ausgeblendet (eine Kopfzeile oder Leiste, die nur auf Desktops erscheint). Wählen Sie einen Platz, der mobil sichtbar ist.
  • Die Schaltfläche erscheint zuerst und verschwindet nach dem Filtern: Der Container [woof_mobile] sitzt innerhalb der Produktliste, die per AJAX ersetzt wird. Verschieben Sie ihn oberhalb der Liste.
  • Die JavaScript-Optimierung verzögert Skripte bis zum ersten Tippen oder Scrollen („JavaScript-Ausführung verzögern“ in WP Rocket und ähnlichen Funktionen). Die Schaltfläche wird erst verschoben, wenn das Skript des Plugins läuft. Schließen Sie /wp-content/plugins/woocommerce-products-filter/ von Verzögerung, Defer und Zusammenfassung aus und leeren Sie danach die Caches. Die Einzelheiten stehen in Der Filter mit WP Rocket und Caching.
  • Die CSS-Optimierung (Zusammenfassen oder „Nicht verwendetes CSS entfernen“) hat die Stile des Plugins entfernt, sodass die Schaltfläche zwar auf der Seite existiert, aber ausgeblendet oder ohne Formatierung ist. Schließen Sie auch das CSS des Plugins aus.
  • Sie testen auf einem Tablet. Safari auf dem iPad und Chrome auf größeren Android-Tablets fordern standardmäßig die Desktop-Version von Websites an, diese Tablets erhalten also das Desktop-Layout. Blendet das Theme die Seitenleiste bei Tablet-Breite aus, ist der Filter dort verschwunden; zeigen Sie die Seitenleiste per CSS an oder platzieren Sie das Formular im Inhaltsbereich.

Die Schaltfläche ist da, aber nichts öffnet sich

Das Formular liegt in etwas Ausgeblendetem. Die Schaltfläche wurde verschoben, das Panel ist aber weiterhin das Formular selbst, an seinem ursprünglichen Platz. Blendet das Theme die Seitenleiste auf Smartphones mit display: none aus, öffnet sich das Panel in einem ausgeblendeten Kasten und bleibt unsichtbar. Es gibt drei Auswege:

  • Zeigen Sie die Seitenleiste auf Smartphones per CSS an. Das HUSKY-Formular darin bleibt ausgeblendet, bis die Schaltfläche getippt wird, aber auch andere Widgets dieser Seitenleiste werden sichtbar; das eignet sich daher für eine Seitenleiste, die nur den Filter enthält.
  • Verschieben Sie das Formular mit mobilem Modus aus der Seitenleiste in den Inhaltsbereich, zum Beispiel oberhalb der Produkte.
  • Lassen Sie das Widget für Desktops (Mobiler Modus (Mobile mode) auf Nein) und lassen Sie das Plugin nur auf Smartphones einen Filter oberhalb der Produkte platzieren: Optionen → Filter automatisch setzen → Ja, aber nur für mobile Geräte (Options → Set filter automatically → Yes, but only for mobile devices), dazu Design → Auto-Filter standardmäßig ausblenden → Ja (Design → Hide auto filter by default → Yes) für eine Schaltfläche zum Ein- und Ausblenden. Dafür ist ein Template nötig, das die Standard-Produktschleife von WooCommerce ausführt.

Eine typische Regel für den ersten Weg, mit an Ihr Theme angepasstem Selektor:

/* Theme hides #secondary (sidebar) on phones: keep it for the HUSKY panel */
@media (max-width: 768px) {
    body.woocommerce-page #secondary {
        display: block;
    }
}

Dasselbe passiert, wenn der Filter in einer Off-Canvas-Schublade des Themes oder in einem Elementor-Popup liegt: Schublade und Popup haben ihre eigene Sichtbarkeit und eigene Skripte, und das Panel kann sich von dort aus nicht öffnen. Verwenden Sie entweder die Schublade oder den mobilen Modus von HUSKY, nicht beides.

Die sid enthält ein Leerzeichen. Skin-Syntax wie sid="flat_grey woof_auto_3_columns" funktioniert für das Aussehen des Formulars, aber in 3.4.6 findet die mobile Schaltfläche kein Formular, dessen sid aus zwei Wörtern besteht. Verwenden Sie für ein Formular im mobilen Modus eine sid aus einem Wort.

Es gibt zwei Kopien des Filters. Page Builder enthalten oft einen Abschnitt für Desktops und ein Duplikat für Smartphones, ausgeblendet über die responsive Sichtbarkeit. Beide stehen im HTML und werden nur per CSS ausgeblendet, sodass zwei Formulare mit denselben Kennungen miteinander in Konflikt geraten: Abschnitte öffnen sich nicht mehr, zwei Filtersymbole erscheinen, oder die Schaltfläche öffnet die Kopie, die Sie nicht sehen. Behalten Sie einen Filter pro Seite und überlassen Sie Smartphones dem mobilen Modus.

Ein Skriptfehler. Öffnen Sie die Seite auf dem Smartphone oder in der Geräteemulation des Desktop-Browsers nach einem Neuladen und prüfen Sie die Browserkonsole. Auch ein Fehler in einem Skript, das vor dem von HUSKY geladen wird, stoppt dieses.

Mobiles Layout am Desktop, Desktop-Layout am Smartphone

Da die Entscheidung beim Erzeugen der Seite fällt, liefert ein Seitencache, der eine Kopie für alle speichert, das aus, was der erste Besucher mit seinem Gerät erzeugt hat. Desktop-Besucher erhalten dann die Schaltfläche Filter öffnen (Open filter) und ein ausgeblendetes Formular, oder Smartphone-Besucher erhalten die volle Seitenleiste ohne Schaltfläche, und das ändert sich nach jedem Leeren des Caches. Die Lösung liegt im Cache, nicht im Filter:

  • WP Rocket: Aktivieren Sie das mobile Caching und Separate Cache-Dateien für mobile Geräte (Separate cache files for mobile devices).
  • LiteSpeed Cache: Schalten Sie Mobile zwischenspeichern (Cache Mobile) ein.
  • Cloudflare-Seitencache, Varnish oder ein Hosting-Cache: Cachen Sie nach Gerätetyp oder schließen Sie die Shop- und Kategorieseiten aus.

Leeren Sie nach der Änderung alle Caches. Dasselbe gilt für die mobile Sichtbarkeit der Slideout-Erweiterung und für Filter automatisch setzen (Set filter automatically) mit den Werten Ja, aber nur für mobile Geräte (Yes, but only for mobile devices) und Ja, aber nur für den Desktop (Yes, but only for desktop), die ebenfalls wp_is_mobile() verwenden.

Aus demselben Grund schaltet das Verändern der Größe eines Desktop-Browserfensters den Filter nie in den mobilen Modus. Testen Sie auf einem echten Smartphone, abgemeldet, oder in der Geräteemulation des Browsers mit anschließendem Neuladen der Seite.

Probleme im geöffneten Panel

Dropdowns sind zusammengeklappt, leer oder öffnen die Tastatur. Die Dropdowns von Chosen und SelectWoo berechnen ihre Breite beim Laden der Seite, solange das Formular noch ausgeblendet ist, und bringen ein Suchfeld mit, das die Smartphone-Tastatur einblendet. Am saubersten lösen Sie das mit Design → Dropdown-Skin → Nativ (Design → Drop-down skin → Native): Smartphones zeigen dann ihre eigene Auswahlliste, ohne Suchfeld und ohne Breitenprobleme. Wenn Sie Chosen oder SelectWoo behalten möchten, geben Sie ihnen eine Mindestbreite:

/* HUSKY: drop-downs collapsed in a hidden or narrow container */
.woof .chosen-container,
.woof .select2-container {
    min-width: 200px;
}

Das Panel ist durchsichtig, liegt unter einer fixierten Kopfzeile oder sein Text ist unsichtbar. Das Panel ist standardmäßig leicht transparent und verwendet z-index: 9999, was manche fixierte Kopfzeilen übertreffen. Passen Sie es in Ihrem eigenen CSS an:

/* HUSKY mobile panel: opaque, above the sticky header, readable text */
.woof_show_filter_for_mobile.woof {
    opacity: 1;
    z-index: 100000;
}
.woof_show_filter_for_mobile.woof h4,
.woof_show_filter_for_mobile.woof label {
    color: #333;
}

Öffnet sich das Panel dennoch unter der Kopfzeile (die Kopfzeile liegt in einem Stacking-Kontext, über den das Panel nicht hinauskommt), fügen Sie der ersten Regel padding-top: 90px; hinzu, damit die Schaltfläche Filter schließen (Close filter) unterhalb der Kopfzeile beginnt.

Das Panel schließt sich nach jedem Tippen. Mit Autosubmit und AJAX löst jede Auswahl die Filterung aus, und das Panel schließt sich, um die Ergebnisse zu zeigen. Kombinieren Besucher meist mehrere Optionen, schalten Sie Autosubmit für dieses Formular aus, [woof sid="mobile" mobile_mode=1 autosubmit=0], damit sie erst auswählen und dann die Filter-Schaltfläche tippen.

Kleine Darstellungsfehler auf dem iPhone. Ein verschobener Platzhalter im Textsuchfeld lässt sich mit .woof_container .woof_container_inner input[type="search"] { line-height: normal !important; } beheben. Produktzähler von Filtern des Typs Label, die von ihren Labels wegrutschen, lassen sich mit .woof_container_label .woof_list_label li { position: relative; } beheben.

Die Schaltfläche anpassen

Das Aussehen der Schaltfläche legen Sie im Tab Design fest: Bild für mobile Filter-Schaltfläche (Image for mobile filter button), Text für mobile Filter-Schaltfläche (Text for mobile filter button), Bild zum Schließen des mobilen Filters (Image to close mobile filter) und Text zum Schließen des mobilen Filters (Text to close mobile filter). Geben Sie -1 in ein Bildfeld ein, um nur Text anzuzeigen, oder in ein Textfeld, um nur das Symbol anzuzeigen. Abstände und Farbe sind einfaches CSS für .woof_show_mobile_filter, zum Beispiel .woof_show_mobile_filter { margin: 10px 0 20px; color: #796699; }.

Die grundlegenden Einrichtungsschritte finden Sie unter So zeigen Sie den Filter auf mobilen Geräten an; alle Attribute des Haupt-Shortcodes stehen in der Referenz zu [woof].

Checkliste

  • Ein Filterformular auf der Seite, mit aktiviertem mobilem Modus (Widget-Option, oder mobile_mode=1 mit einer sid aus einem Wort, oder die Option des Front-Builders).
  • [woof_mobile] steht dort, wo die Schaltfläche hingehört, außerhalb der Produktliste, an einem auf Smartphones sichtbaren Platz.
  • Das Formular selbst liegt nicht in einer Seitenleiste, Schublade oder einem Popup, die auf Smartphones ausgeblendet sind.
  • JavaScript und CSS des Plugins sind von Verzögerung, Defer, Zusammenfassung und dem Entfernen nicht verwendeten CSS ausgeschlossen.
  • Der Seitencache hält getrennte Kopien für mobile Geräte vor, und alle Caches wurden geleert.
  • Getestet auf einem echten Smartphone oder mit Geräteemulation und Neuladen, abgemeldet.

Wenn der Filter auf dem Smartphone weiterhin nicht angezeigt wird, eröffnen Sie ein Thema im HUSKY-Support-Forum mit dem Link zur Seite, den Einstellungen von Shortcode oder Widget und den Fehlern aus der Browserkonsole.