HUSKY - WooCommerce Product Filter Professional

Filtro de productos de WooCommerce no se muestra en móvil: causas y soluciones

El filtro funciona en el ordenador, pero en el teléfono la barra lateral ha desaparecido, el botón Abrir filtro (Open filter) nunca aparece, o aparece y no hace nada. Cuando el filtro de productos de WooCommerce no se muestra en móvil, casi nunca está roto. El modo móvil de HUSKY tiene tres piezas: el servidor decide que el visitante usa un teléfono, un script coloca el botón en su sitio y un toque abre el formulario como un panel a pantalla completa. Cada pieza puede quedar bloqueada por el tema, un constructor de páginas, una caché o un optimizador. Esta guía muestra qué pieza ha fallado y cómo solucionarlo.

Cómo funciona el modo móvil de HUSKY

Muchos temas no muestran la barra lateral en los teléfonos. Si el filtro es un widget de la barra lateral y no hay nada más configurado, eso solo ya explica que falte. El modo móvil es la forma que tiene el plugin de dar a los teléfonos un botón que abre el filtro. No hay un interruptor «móvil» global en los ajustes; el modo móvil se activa en cada formulario de filtro:

  • Widget: establece Modo móvil (Mobile mode) en Si (Yes) en el widget de HUSKY.
  • Shortcode: [woof sid="mobile" mobile_mode=1]. El atributo sid es obligatorio; sin él, mobile_mode se ignora.
  • Front builder: activa Modo móvil (Mobile mode) en las opciones del formulario [woof_front_builder].

Cuando la página se genera para un teléfono, el plugin imprime ese formulario oculto y le añade dos botones, Abrir filtro (Open filter) y Cerrar filtro (Close filter). En los ordenadores el mismo formulario se muestra como de costumbre. Cuando la página se carga en un teléfono, un script mueve el botón Abrir filtro (Open filter) fuera del formulario oculto a un lugar visible:

  1. el contenedor que imprime el shortcode [woof_mobile], si la página tiene uno;
  2. en caso contrario, el elemento que coincide con .woocommerce-products-header, el bloque con el título de la tienda o de la categoría en la plantilla de archivo estándar de WooCommerce.

Un toque en el botón añade la clase woof_show_filter_for_mobile al formulario, que lo convierte en un panel fijo a pantalla completa sobre la página. En modo AJAX el panel se cierra solo después de cada filtrado, de modo que el visitante ve los productos nuevos.

Dos hechos explican la mayoría de los problemas. Primero, el servidor decide qué es un «teléfono» con wp_is_mobile() de WordPress a partir de las cabeceras de la solicitud, no por el ancho de pantalla. Segundo, [woof_mobile] solo marca un lugar: no muestra nada si la misma página no tiene también un formulario con el modo móvil activado.

El botón Abrir filtro no aparece

La plantilla no tiene un lugar para él. Las plantillas del theme builder de Elementor y Divi, los diseños de Avada, las páginas personalizadas que listan productos con el shortcode [products] y muchos temas a medida suelen carecer del bloque .woocommerce-products-header. El botón se queda entonces dentro del formulario oculto. Coloca [woof_mobile] exactamente donde deba estar el botón, normalmente encima de los productos, en un widget o bloque de Shortcode. Esta es la solución más habitual. No imprime nada en los ordenadores, así que puede quedarse en la página.

Si no puedes colocar un shortcode en esa plantilla, dirige el botón a un elemento propio con el hook woof_mobile_btn_place_container. Dale a ese elemento un ID único (en Elementor: Avanzado → ID CSS (Advanced → CSS ID)) y úsalo:

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

Usa un selector que coincida con un solo elemento. Una clase amplia como .elementor-widget-container copia el botón en cada elemento coincidente de la página. El hook no se usa cuando la página tiene un contenedor [woof_mobile].

Otros motivos por los que falta el botón:

  • El tema oculta el lugar elegido en los teléfonos (una cabecera o barra de herramientas que solo se muestra en ordenadores). Elige un lugar que sea visible en móvil.
  • El botón se muestra al principio y desaparece después de filtrar: el contenedor [woof_mobile] está dentro de la lista de productos que AJAX reemplaza. Muévelo encima de la lista.
  • La optimización de JavaScript retrasa los scripts hasta el primer toque o desplazamiento («delay JavaScript execution» en WP Rocket y funciones similares). El botón solo se mueve cuando se ejecuta el script del plugin. Excluye /wp-content/plugins/woocommerce-products-filter/ del retraso, del aplazamiento (defer) y de la combinación, y después vacía las cachés. Los detalles están en el filtro con WP Rocket y la caché.
  • La optimización de CSS (combinar o «eliminar CSS no utilizado») ha quitado los estilos del plugin, así que el botón existe en la página pero está oculto o sin estilo. Excluye también el CSS del plugin.
  • Estás probando en una tableta. Safari en iPad y Chrome en las tabletas Android más grandes solicitan por defecto la versión de escritorio de los sitios, por lo que estas tabletas reciben el diseño de escritorio. Si el tema oculta la barra lateral al ancho de una tableta, el filtro desaparece ahí; muestra la barra lateral con CSS o coloca el formulario en el área de contenido.

El botón está, pero no se abre nada

El formulario está dentro de algo oculto. El botón se ha movido fuera, pero el panel sigue siendo el propio formulario, en su lugar original. Si el tema oculta la barra lateral en los teléfonos con display: none, el panel se abre dentro de una caja oculta y sigue invisible. Hay tres salidas:

  • Mostrar la barra lateral en los teléfonos con CSS. El formulario de HUSKY que contiene sigue oculto hasta que se toca el botón, pero los demás widgets de esa barra lateral también pasan a ser visibles, así que esto conviene a una barra lateral que solo contiene el filtro.
  • Mover el formulario en modo móvil fuera de la barra lateral al área de contenido, por ejemplo encima de los productos.
  • Dejar el widget para los ordenadores (con su Modo móvil (Mobile mode) en No) y dejar que el plugin coloque un filtro encima de los productos solo en los teléfonos: Opciones → Configurar filtro automáticamente → Si, pero solo en dispositivos moviles (Options → Set filter automatically → Yes, but only for mobile devices), más Diseño → Ocultar filtro automático por defecto → Si (Design → Hide auto filter by default → Yes) para tener un botón de mostrar/ocultar. Esto requiere una plantilla que ejecute el bucle de productos estándar de WooCommerce.

Una regla típica para la primera salida, con el selector adaptado a tu tema:

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

Lo mismo ocurre cuando el filtro vive dentro del panel off-canvas de un tema o de una ventana emergente de Elementor: el panel o la ventana emergente tiene su propia visibilidad y sus propios scripts, y el panel del filtro no puede abrirse desde dentro. Usa el panel del tema o el modo móvil de HUSKY, pero no ambos.

El sid contiene un espacio. Una sintaxis de skin como sid="flat_grey woof_auto_3_columns" funciona para el aspecto del formulario, pero en la 3.4.6 el botón móvil no encuentra un formulario cuyo sid tenga dos palabras. Usa un sid de una sola palabra para un formulario en modo móvil.

Hay dos copias del filtro. Los constructores de páginas suelen contener una sección para ordenador y un duplicado para móvil, ocultos con visibilidad responsive. Ambos están en el HTML y solo los oculta el CSS, así que dos formularios con los mismos identificadores se estorban entre sí: las secciones dejan de abrirse, aparecen dos iconos de filtro o el botón abre la copia que no ves. Mantén un solo filtro por página y deja que el modo móvil se encargue de los teléfonos.

Un error de script. Abre la página en el teléfono, o en la emulación de dispositivo del escritorio tras recargar, y revisa la consola del navegador. Un error en cualquier script cargado antes que el de HUSKY también lo detiene.

Diseño móvil en un ordenador, diseño de escritorio en un teléfono

Como la decisión se toma cuando se genera la página, una caché de páginas que guarda una sola copia para todos sirve lo que haya visitado primero. Entonces los visitantes de escritorio reciben el botón Abrir filtro (Open filter) y un formulario oculto, o los visitantes con teléfono reciben la barra lateral completa y ningún botón, y cambia después de cada vaciado de la caché. La solución está en la caché, no en el filtro:

  • WP Rocket: activa la caché para móviles y Archivos de caché separados para dispositivos móviles (Separate cache files for mobile devices).
  • LiteSpeed Cache: activa Caché móvil (Cache Mobile).
  • Caché de páginas de Cloudflare, Varnish o una caché del alojamiento: cachea por tipo de dispositivo o excluye las páginas de la tienda y de categorías.

Vacía todas las cachés después del cambio. Lo mismo se aplica a la visibilidad móvil de la extensión slideout y a Configurar filtro automáticamente (Set filter automatically) con los valores Si, pero solo en dispositivos moviles (Yes, but only for mobile devices) y Si, pero solo en escritorio (Yes, but only for desktop), que también usan wp_is_mobile().

Por la misma razón, cambiar el tamaño de la ventana de un navegador de escritorio nunca pasa el filtro al modo móvil. Prueba en un teléfono real, sin sesión iniciada, o en la emulación de dispositivo del navegador recargando la página.

Problemas dentro del panel abierto

Los desplegables aparecen colapsados, vacíos o abren el teclado. Los desplegables Chosen y SelectWoo calculan su ancho cuando se carga la página, mientras el formulario sigue oculto, y traen un campo de búsqueda que hace aparecer el teclado del teléfono. La solución más limpia es Diseño → Aspecto del desplegable → Nativo (Design → Drop-down skin → Native): los teléfonos muestran entonces su propia lista de selección, sin campo de búsqueda y sin problemas de ancho. Para conservar Chosen o SelectWoo, dales un ancho mínimo:

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

El panel es transparente, queda oculto bajo una cabecera fija o su texto es invisible. El panel es ligeramente transparente por defecto y usa z-index: 9999, que algunas cabeceras fijas superan. Ajústalo en tu CSS personalizado:

/* 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 el panel sigue abriéndose bajo la cabecera (la cabecera está en un contexto de apilamiento por encima del cual el panel no puede subir), añade padding-top: 90px; a la primera regla, para que el botón Cerrar filtro (Close filter) empiece debajo de la cabecera.

El panel se cierra tras cada toque. Con autosubmit y AJAX, cada elección ejecuta el filtro y el panel se cierra para mostrar los resultados. Si los visitantes suelen combinar varias opciones, desactiva el autosubmit para este formulario, [woof sid="mobile" mobile_mode=1 autosubmit=0], de modo que elijan y luego toquen el botón de filtrar.

Pequeños fallos en iPhone. Un marcador de posición desalineado en el campo de búsqueda de texto se corrige con .woof_container .woof_container_inner input[type="search"] { line-height: normal !important; }. Los contadores de productos de los filtros de tipo etiqueta que se separan de sus etiquetas se corrigen con .woof_container_label .woof_list_label li { position: relative; }.

Cambiar el botón

El aspecto del botón se define en la pestaña Diseño (Design): Imagen para el botón de filtro móvil (Image for mobile filter button), Texto para el botón de filtro móvil (Text for mobile filter button), Imagen para cerrar el filtro móvil (Image to close mobile filter) y Texto para cerrar el filtro móvil (Text to close mobile filter). Introduce -1 en un campo de imagen para mostrar solo texto, o en un campo de texto para mostrar solo el icono. El espaciado y el color son CSS normal sobre .woof_show_mobile_filter, por ejemplo .woof_show_mobile_filter { margin: 10px 0 20px; color: #796699; }.

Para los pasos básicos de configuración, consulta cómo mostrar el filtro en dispositivos móviles; para todos los atributos del shortcode principal, la referencia de [woof].

Lista de comprobación

  • Un solo formulario de filtro en la página, con el modo móvil activado (opción del widget, o mobile_mode=1 con un sid de una palabra, o la opción del front builder).
  • [woof_mobile] colocado donde debe estar el botón, fuera de la lista de productos, en un lugar visible en los teléfonos.
  • El propio formulario no está dentro de una barra lateral, un panel o una ventana emergente que se oculte en los teléfonos.
  • El JavaScript y el CSS del plugin están excluidos del retraso, del aplazamiento, de la combinación y de la eliminación de CSS no utilizado.
  • La caché de páginas guarda copias separadas para dispositivos móviles y se han vaciado todas las cachés.
  • Probado en un teléfono real o con emulación de dispositivo y recarga, sin sesión iniciada.

Si el filtro sigue sin mostrarse en un teléfono, abre un tema en el foro de soporte de HUSKY con el enlace de la página, los ajustes del shortcode o del widget que usas y los errores de la consola del navegador.