HUSKY - WooCommerce Product Filter Professional

Filtre de produits WooCommerce absent sur mobile : causes et solutions

Le filtre fonctionne sur ordinateur, mais sur téléphone la barre latérale a disparu, le bouton Ouvrir le filtre (Open filter) n’apparaît jamais, ou il apparaît sans rien faire. Un filtre de produits WooCommerce absent sur mobile est rarement en panne. Le mode mobile de HUSKY repose sur trois rouages : le serveur décide que le visiteur utilise un téléphone, un script place le bouton à son emplacement, et un appui ouvre le formulaire dans un panneau plein écran. Chacun de ces rouages peut être bloqué par le thème, un constructeur de pages, un cache ou un outil d’optimisation. Ce guide montre lequel a échoué et comment le corriger.

Comment fonctionne le mode mobile de HUSKY

De nombreux thèmes n’affichent pas du tout la barre latérale sur téléphone. Si le filtre est un widget de barre latérale et que rien d’autre n’est configuré, cela suffit à expliquer son absence. Le mode mobile est le moyen qu’offre le plugin de donner aux téléphones un bouton qui ouvre le filtre. Il n’existe pas de réglage « mobile » global ; le mode mobile s’active formulaire de filtre par formulaire de filtre :

  • Widget : réglez Mode mobile (Mobile mode) sur Oui dans le widget HUSKY.
  • Shortcode : [woof sid="mobile" mobile_mode=1]. L’attribut sid est obligatoire ; sans lui, mobile_mode est ignoré.
  • Constructeur frontal (Front builder) : activez Mode mobile (Mobile mode) dans les options du formulaire [woof_front_builder].

Lorsque la page est générée pour un téléphone, le plugin affiche ce formulaire masqué et lui ajoute deux boutons, Ouvrir le filtre (Open filter) et Fermer le filtre (Close filter). Sur ordinateur, le même formulaire s’affiche normalement. Au chargement de la page sur un téléphone, un script déplace le bouton Ouvrir le filtre (Open filter) hors du formulaire masqué, vers un emplacement visible :

  1. le conteneur affiché par le shortcode [woof_mobile], si la page en contient un ;
  2. sinon l’élément correspondant à .woocommerce-products-header, le bloc qui contient le titre de la boutique ou de la catégorie dans le modèle d’archive standard de WooCommerce.

Un appui sur le bouton ajoute la classe woof_show_filter_for_mobile au formulaire, qui le transforme en panneau plein écran fixe superposé à la page. En mode AJAX, le panneau se ferme tout seul après chaque filtrage, de sorte que le visiteur voit les nouveaux produits.

Deux faits expliquent la plupart des problèmes. Premièrement, la notion de « téléphone » est déterminée côté serveur par la fonction WordPress wp_is_mobile() à partir des en-têtes de la requête, et non d’après la largeur de l’écran. Deuxièmement, [woof_mobile] ne fait que marquer un emplacement : il n’affiche rien si la même page ne contient pas aussi un formulaire dont le mode mobile est activé.

Le bouton Ouvrir le filtre n’apparaît pas

Le modèle n’a pas d’emplacement pour lui. Les modèles du constructeur de thèmes d’Elementor et de Divi, les mises en page d’Avada, les pages personnalisées qui listent des produits avec le shortcode [products] et de nombreux thèmes sur mesure n’ont souvent pas le bloc .woocommerce-products-header. Le bouton reste alors dans le formulaire masqué. Placez [woof_mobile] exactement là où le bouton doit se trouver, en général au-dessus des produits, dans un widget ou un bloc Shortcode. C’est la correction la plus fréquente. Il n’affiche rien sur ordinateur, il peut donc rester sur la page.

Si vous ne pouvez pas placer de shortcode dans ce modèle, indiquez au bouton un élément de votre choix avec le hook woof_mobile_btn_place_container. Donnez à cet élément un ID unique (dans Elementor : Avancé → ID CSS (Advanced → CSS ID)) et utilisez-le :

/*
 * 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';
});

Utilisez un sélecteur qui ne correspond qu’à un seul élément. Une classe large comme .elementor-widget-container copie le bouton dans chaque élément correspondant de la page. Le hook n’est pas utilisé lorsque la page contient un conteneur [woof_mobile].

Autres raisons pour lesquelles le bouton manque :

  • L’emplacement est masqué sur téléphone par le thème (un en-tête ou une barre d’outils visible uniquement sur ordinateur). Choisissez un emplacement visible sur mobile.
  • Le bouton s’affiche d’abord puis disparaît après le filtrage : le conteneur [woof_mobile] se trouve à l’intérieur de la liste de produits que l’AJAX remplace. Déplacez-le au-dessus de la liste.
  • L’optimisation JavaScript retarde les scripts jusqu’au premier appui ou défilement (« retarder l’exécution de JavaScript » dans WP Rocket et les fonctions similaires). Le bouton n’est déplacé que lorsque le script du plugin s’exécute. Excluez /wp-content/plugins/woocommerce-products-filter/ du report, du différé et de la combinaison, puis videz les caches. Les détails sont dans le filtre avec WP Rocket et la mise en cache.
  • L’optimisation CSS (combinaison ou « suppression du CSS inutilisé ») a retiré les styles du plugin : le bouton existe dans la page, mais il est masqué ou sans mise en forme. Excluez aussi le CSS du plugin.
  • Vous testez sur une tablette. Safari sur iPad et Chrome sur les grandes tablettes Android demandent par défaut la version bureau des sites, ces tablettes reçoivent donc la mise en page pour ordinateur. Si le thème masque la barre latérale à la largeur d’une tablette, le filtre y est absent ; affichez la barre latérale avec du CSS ou placez le formulaire dans la zone de contenu.

Le bouton est là, mais rien ne s’ouvre

Le formulaire se trouve dans un élément masqué. Le bouton a été déplacé, mais le panneau reste le formulaire lui-même, à son emplacement d’origine. Si le thème masque la barre latérale sur téléphone avec display: none, le panneau s’ouvre dans une boîte masquée et reste invisible. Il y a trois solutions :

  • Afficher la barre latérale sur téléphone avec du CSS. Le formulaire HUSKY qu’elle contient reste masqué jusqu’à l’appui sur le bouton, mais les autres widgets de cette barre latérale deviennent visibles eux aussi ; cette solution convient donc à une barre latérale qui ne contient que le filtre.
  • Déplacer le formulaire en mode mobile hors de la barre latérale, vers la zone de contenu, par exemple au-dessus des produits.
  • Laisser le widget aux ordinateurs (son Mode mobile (Mobile mode) sur Non) et laisser le plugin placer un filtre au-dessus des produits uniquement sur téléphone : Options → Définir le filtre automatiquement → Oui, mais uniquement pour les appareils mobiles (Options → Set filter automatically → Yes, but only for mobile devices), plus Apparence → Masquer le filtre automatique par défaut → Oui (Design → Hide auto filter by default → Yes) pour obtenir un bouton afficher/masquer. Cela suppose un modèle qui exécute la boucle de produits standard de WooCommerce.

Une règle type pour la première solution, avec le sélecteur adapté à votre thème :

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

Il en va de même lorsque le filtre se trouve dans le tiroir hors-champ (off-canvas) d’un thème ou dans une fenêtre contextuelle Elementor : le tiroir ou la fenêtre a sa propre visibilité et ses propres scripts, et le panneau ne peut pas s’ouvrir depuis l’intérieur. Utilisez soit le tiroir, soit le mode mobile de HUSKY, pas les deux.

Le sid contient une espace. Une syntaxe de thème visuel comme sid="flat_grey woof_auto_3_columns" fonctionne pour l’apparence du formulaire, mais dans la version 3.4.6 le bouton mobile ne trouve pas un formulaire dont le sid comporte deux mots. Utilisez un sid d’un seul mot pour un formulaire en mode mobile.

Il y a deux copies du filtre. Les constructeurs de pages contiennent souvent une section pour l’ordinateur et un doublon pour le mobile, masqués par la visibilité responsive. Les deux sont dans le HTML, seulement cachés par le CSS, si bien que deux formulaires aux identifiants identiques se perturbent : des sections ne s’ouvrent plus, deux icônes de filtre apparaissent, ou le bouton ouvre la copie que vous ne voyez pas. Gardez un seul filtre par page et laissez le mode mobile gérer les téléphones.

Une erreur de script. Ouvrez la page sur le téléphone, ou dans l’émulation d’appareil du navigateur après un rechargement, et consultez la console du navigateur. Une erreur dans un script chargé avant celui de HUSKY l’arrête aussi.

Mise en page mobile sur ordinateur, mise en page bureau sur téléphone

Comme la décision est prise à la génération de la page, un cache de pages qui conserve une seule copie pour tout le monde sert ce qu’a reçu le premier appareil venu. Les visiteurs sur ordinateur reçoivent alors le bouton Ouvrir le filtre (Open filter) et un formulaire masqué, ou les visiteurs sur téléphone reçoivent la barre latérale complète sans bouton, et cela change après chaque vidage du cache. La correction se trouve dans le cache, pas dans le filtre :

  • WP Rocket : activez la mise en cache mobile et Fichiers de cache distincts pour les appareils mobiles (Separate cache files for mobile devices).
  • LiteSpeed Cache : activez Mettre en cache le mobile (Cache Mobile).
  • Cache de pages Cloudflare, Varnish ou cache de l’hébergeur : mettez en cache par type d’appareil, ou excluez les pages de la boutique et des catégories.

Videz tous les caches après la modification. Il en va de même pour la visibilité mobile de l’extension de panneau coulissant (slideout) et pour Définir le filtre automatiquement (Set filter automatically) avec les valeurs Oui, mais uniquement pour les appareils mobiles (Yes, but only for mobile devices) et Oui, mais uniquement pour les ordinateurs (Yes, but only for desktop), qui utilisent elles aussi wp_is_mobile().

Pour la même raison, redimensionner la fenêtre d’un navigateur de bureau ne fait jamais passer le filtre en mode mobile. Testez sur un vrai téléphone, déconnecté, ou dans l’émulation d’appareil du navigateur avec un rechargement de la page.

Problèmes à l’intérieur du panneau ouvert

Les listes déroulantes sont repliées, vides ou ouvrent le clavier. Les listes déroulantes Chosen et SelectWoo calculent leur largeur au chargement de la page, alors que le formulaire est encore masqué, et elles sont accompagnées d’un champ de recherche qui fait apparaître le clavier du téléphone. La solution la plus propre est Apparence → Habillage des listes déroulantes → Natif (Design → Drop-down skin → Native) : les téléphones affichent alors leur propre liste de sélection, sans champ de recherche et sans problème de largeur. Pour conserver Chosen ou SelectWoo, donnez-leur une largeur minimale :

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

Le panneau est transparent, caché sous un en-tête fixe, ou son texte est invisible. Le panneau est légèrement transparent par défaut et utilise z-index: 9999, valeur que certains en-têtes fixes dépassent. Ajustez-le dans votre CSS personnalisé :

/* 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;
}

Si le panneau s’ouvre toujours sous l’en-tête (l’en-tête se trouve dans un contexte d’empilement au-dessus duquel le panneau ne peut pas monter), ajoutez padding-top: 90px; à la première règle, afin que le bouton Fermer le filtre (Close filter) commence sous l’en-tête.

Le panneau se ferme après chaque appui. Avec l’envoi automatique et l’AJAX, chaque choix lance le filtrage, et le panneau se ferme pour montrer les résultats. Si les visiteurs combinent souvent plusieurs options, désactivez l’envoi automatique pour ce formulaire, [woof sid="mobile" mobile_mode=1 autosubmit=0], afin qu’ils fassent leurs choix puis appuient sur le bouton de filtrage.

Petits défauts sur iPhone. Un texte indicatif mal aligné dans le champ de recherche textuelle se corrige avec .woof_container .woof_container_inner input[type="search"] { line-height: normal !important; }. Les compteurs de produits des filtres de type étiquette qui s’éloignent de leurs libellés se corrigent avec .woof_container_label .woof_list_label li { position: relative; }.

Modifier le bouton

L’apparence du bouton se règle dans l’onglet Apparence (Design) : Image du bouton de filtre mobile (Image for mobile filter button), Texte du bouton de filtre mobile (Text for mobile filter button), Image pour fermer le filtre mobile (Image to close mobile filter) et Texte pour fermer le filtre mobile (Text to close mobile filter). Saisissez -1 dans un champ d’image pour n’afficher que le texte, ou dans un champ de texte pour n’afficher que l’icône. L’espacement et la couleur relèvent du simple CSS sur .woof_show_mobile_filter, par exemple .woof_show_mobile_filter { margin: 10px 0 20px; color: #796699; }.

Pour les étapes de configuration de base, consultez comment afficher le filtre sur les appareils mobiles ; pour tous les attributs du shortcode principal, la référence de [woof].

Liste de vérification

  • Un seul formulaire de filtre sur la page, avec le mode mobile activé (option du widget, ou mobile_mode=1 avec un sid d’un seul mot, ou option du constructeur frontal).
  • [woof_mobile] placé là où le bouton doit se trouver, en dehors de la liste de produits, à un endroit visible sur téléphone.
  • Le formulaire lui-même ne se trouve pas dans une barre latérale, un tiroir ou une fenêtre contextuelle masqués sur téléphone.
  • Le JavaScript et le CSS du plugin sont exclus du report, du différé, de la combinaison et de la suppression du CSS inutilisé.
  • Le cache de pages conserve des copies distinctes pour les appareils mobiles, et tous les caches ont été vidés.
  • Testé sur un vrai téléphone ou avec l’émulation d’appareil et un rechargement, déconnecté.

Si le filtre ne s’affiche toujours pas sur téléphone, ouvrez un sujet sur le forum d’assistance HUSKY en indiquant le lien de la page, les réglages du shortcode ou du widget que vous utilisez, et les erreurs de la console du navigateur.