Personalización con CSS del filtro de productos WooCommerce: pieles y títulos
La personalización con CSS del filtro de productos de WooCommerce suele empezar con un deseo pequeño: casillas con el color de la marca, títulos más pequeños, una lista desplegable acorde al tema o la solución para un tema que dibuja una segunda casilla junto a cada checkbox. HUSKY cubre una parte con ajustes, y el resto requiere unas pocas líneas de CSS cuando sabes dónde ponerlas y qué clases apuntar. Esta guía ofrece ambas cosas, además de las soluciones para los conflictos con temas que vemos con más frecuencia.
Primero los ajustes, después el CSS
La pestaña Design (WooCommerce → Settings → Products Filter → Diseño (Design)) cambia el aspecto sin código:
- Piel de radio y casillas de verificación (Radio and checkboxes skin): las pieles plana, mínima y cuadrada en diez colores, o Ninguno (none) para las casillas propias del navegador.
- Piel de lista desplegable (Drop-down skin): Nativa (Native), Chosen o SelectWoo.
- Piel de rango deslizador (Range-slider skin) para el ion range-slider, Usar información emergente (Use tooltip) e Icono de información emergente (Tooltip icon), las imágenes de despliegue y de ver más/menos, y la capa de carga.
Todo lo demás va en Avanzadas (Advanced) → Código (Code) → Código CSS personalizado (Custom CSS code). HUSKY imprime ese código justo después de su propia hoja de estilos en cada página donde se carga, y lo conserva en sus ajustes, por lo que las actualizaciones del plugin no lo tocan. Pega solo reglas CSS simples: las etiquetas HTML como <style> se eliminan al guardar los ajustes y las barras invertidas no se conservan de forma fiable, así que escribe el símbolo directamente (content: "✓") en lugar de un escape de CSS como \2713. El CSS adicional (Additional CSS) del Personalizador del tema o la hoja de estilos de un tema hijo funciona igual de bien. No edites nunca el archivo css/front.css del plugin: la siguiente actualización lo reemplaza.
Enlace de archivo de estilos de css frontal personalizado (Custom front css styles file link), al final de la pestaña Design, es otra herramienta. Carga tu archivo en lugar de front.css, no además de él, así que úsalo solo para una reescritura completa que parta de una copia del archivo del plugin.
Cómo hacer que tus reglas ganen
Las hojas de estilos de los temas suelen cargarse después del plugin y usan selectores largos, y algunas reglas del plugin llevan !important. Empieza cada regla con .woof, o con body .woof si el tema sigue ganando, y añade !important solo donde el plugin o el tema ya lo usen. Para dar estilo a un filtro y dejar los demás intactos, asígnale un ID con el atributo sid: [woof sid="sidebar"] añade la clase woof_sid_sidebar al formulario. Mantén el ID en una sola palabra sin espacios. Tres IDs vienen con estilos listos en la hoja de estilos del plugin: flat_grey, flat_dark y flat_white. El widget usa siempre woof_sid_widget. El filtro automático sobre los productos toma sus clases del ajuste de su piel: woof_sid_auto_shortcode con la piel Predeterminado (Default), y woof_sid_flat_grey más woof_auto_2_columns con la piel gris plana con la que empieza una instalación nueva; inspecciona el formulario para ver cuál usa tu sitio.
El mapa de clases
| Elemento | Selector |
|---|---|
| Todo el formulario del filtro | .woof, .woof_sid_<sid> |
| Un bloque de filtro | .woof_container, por tipo .woof_container_checkbox, .woof_container_radio, .woof_container_select; por taxonomía .woof_container_product_cat, .woof_container_pa_color |
| Título del bloque | .woof_container_inner h4 |
| Lista y elementos | .woof_list, .woof_list li; subcategorías .woof_childs_list |
| Casilla, etiqueta, recuento | input.woof_checkbox_term, .woof_checkbox_label, .woof_checkbox_count; seleccionado .woof_checkbox_label_selected |
| Botón de radio y etiqueta | input.woof_radio_term, .woof_radio_label |
| Botones de etiqueta | .woof_list_label .woof_label_term, seleccionado .woof_label_term.checked |
| Lista desplegable nativa | select.woof_select |
| Botones Filtrar y Restablecer | .woof_submit_search_form_container button, .woof_submit_search_form, .woof_reset_search_form |
El inspector del navegador (clic derecho sobre un elemento, Inspeccionar (Inspect)) muestra las clases exactas de tu filtro y qué regla gana. El CSS usado en el sitio de demostración es una buena fuente de ejemplos listos.
Casillas y botones de radio: color, tamaño y nitidez
Las pieles plana, mínima y cuadrada dibujan cada casilla a partir de un pequeño sprite de imagen: una sola imagen contiene los estados sin marcar, marcado y desactivado uno junto a otro, y el CSS muestra la parte correcta. Dos consecuencias: el CSS no puede cambiar el color de la casilla, y cambiar su width, su height o su escala muestra estados vecinos o la vuelve borrosa y pixelada. Elige el color de piel más cercano a tu diseño, o cambia a las casillas del navegador.
Para un color de marca o una casilla más grande, establece Piel de radio y casillas de verificación (Radio and checkboxes skin) en Ninguno (none) y da estilo a los inputs nativos. accent-color los colorea en todos los navegadores actuales:
/* Skin "none": colour and size of the browser's own boxes */
.woof .woof_list input.woof_checkbox_term,
.woof .woof_list input.woof_radio_term {
accent-color: #1f7a4d;
width: 18px;
height: 18px;
}
Si las casillas conservan el aspecto del tema después de esto, el tema da nuevo estilo a todos los checkbox del sitio; consulta la sección sobre conflictos con temas más abajo. Si mantienes una piel, aún puedes reemplazar su sprite por una copia recoloreada con la misma disposición (las imágenes están en la carpeta js/icheck/skins/ del plugin) mediante una regla background-image sobre la clase de la piel, por ejemplo .woof .icheckbox_flat-blue. Para elementos totalmente personalizados sin CSS, la extensión Smart Designer crea diseños de checkbox, radio e interruptor en el administrador; consulta cómo crear tu propio elemento de filtro.
Las casillas simples parpadean antes de que aparezca la piel
Las pieles se aplican con JavaScript después de cargar la página, así que durante un instante se ven las casillas propias del navegador. El JavaScript retrasado por un plugin de optimización alarga ese instante; consulta la optimización de JavaScript y el filtro. Con cualquier piel distinta de Ninguno (none), oculta los inputs hasta que la piel los envuelva:
/* Only with a skin other than "none": hide inputs until the skin wraps them */
.woof .woof_list li > input.woof_checkbox_term,
.woof .woof_list li > input.woof_radio_term {
visibility: hidden;
}
La piel mueve cada input a su propio elemento de casilla, por lo que la regla deja de aplicarse en cuanto la piel está lista. Con la piel en Ninguno (none) ocultaría las casillas para siempre, así que no la uses ahí.
Etiquetas largas, espaciado y botones de etiqueta
El plugin muestra cada etiqueta como un bloque en línea junto a su casilla. Cuando el nombre de una categoría o atributo es más largo que la línea, toda la etiqueta baja por debajo del checkbox. Usa una de estas dos soluciones, según el aspecto que quieras:
/* A: the text starts next to the box and wraps underneath it */
.woof .woof_list label {
display: inline !important;
}
/* B: the text stays in its own column next to the box */
.woof .woof_list label {
max-width: calc(100% - 35px);
vertical-align: top;
}
Ajusta 35px al ancho de tus casillas. En cuanto al espaciado, el plugin da a cada bloque 5 px de relleno inferior y 9 px de margen inferior, y a cada etiqueta 4 px de relleno por arriba y por abajo:
/* Tighter filter: less space between blocks and between items */
.woof .woof_container {
margin-bottom: 4px;
padding-bottom: 0;
}
.woof .woof_list label {
padding-top: 2px;
padding-bottom: 2px;
}
.woof .woof_checkbox_count {
margin-left: 6px;
color: #888;
}
Para el tipo Etiqueta (label) (términos como botones), el plugin define una caja gris claro y un estado azul al pasar el cursor y al seleccionar. Anchos iguales y tus propios colores:
.woof .woof_list_label .woof_label_term {
min-width: 60px;
}
.woof .woof_list_label li .woof_label_term:hover,
.woof .woof_list_label li .woof_label_term.checked {
background-color: #1f7a4d;
border-color: #1f7a4d;
}
La sangría y el plegado de subcategorías se tratan en árboles de categorías plegables.
Títulos: fuente, tamaño y etiqueta de encabezado
Los títulos de los bloques son elementos h4 dentro de .woof_container_inner, incluido el título del filtro de precios, por lo que heredan el estilo h4 del tema:
.woof .woof_container_inner h4 {
font-family: inherit;
font-size: 15px;
font-weight: 600;
text-transform: none;
margin-bottom: 6px;
}
Para una etiqueta distinta, por ejemplo para encajar con la jerarquía de encabezados de tu página, usa el filtro woof_title_tag. Devuelve p o span si los títulos no deben ser encabezados en absoluto:
/*
* HUSKY: print filter block titles as <h3> instead of <h4>.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_title_tag', function ($tag) {
return 'h3';
});
Las reglas escritas para h4 dejan entonces de aplicarse: el margen del propio plugin, los estilos de título de los IDs de filtro integrados flat_grey y flat_dark, y tu propio CSS. Reescríbelas para la nueva etiqueta, por ejemplo .woof .woof_container_inner h3.
El encabezado sobre todo el widget es distinto. En la barra lateral de un tema usa el marcado de título de widget que el tema define para todos los widgets; woof_widget_title_tag (por defecto h3) solo se aplica cuando el widget se imprime sin ese marcado. Para cambiar los textos de los títulos en lugar de su estilo, consulta cómo renombrar los títulos de los filtros.
Listas desplegables: Native, Chosen o SelectWoo
Cuando los estilos de un tema chocan con las listas desplegables (texto cortado, etiquetas mal colocadas en las selecciones múltiples, colores incorrectos), cambia la Piel de lista desplegable (Drop-down skin) antes de escribir CSS. Cada piel es una biblioteca distinta, y el conflicto suele desaparecer con otra. Los fragmentos que usan el filtro woof_use_chosen ya no cambian nada; decide el ajuste.
- Nativa (Native): el
selectdel navegador, con el estilo de tu tema. Apunta a.woof select.woof_select. - Chosen: la caja es
.chosen-containercon.chosen-single(simple) o.chosen-choices(múltiple), y la lista abierta.chosen-results liestá dentro del filtro, así que.woofdelimita todo. - SelectWoo: la caja es
.select2-containerdentro del filtro, pero la lista abierta se adjunta al final de la página. Las reglas para.select2-dropdownno pueden delimitarse con.woofy también afectan a otros campos SelectWoo, como el campo de país en el pago.
/* Chosen: closed box and open list */
.woof .chosen-container-single .chosen-single {
text-align: left;
background: #fff;
border-color: #ccc;
border-radius: 4px;
}
.woof .chosen-container .chosen-results li {
font-size: 15px;
color: #222;
}
Información emergente
El icono de información junto al título de un bloque abre con un clic el texto de la opción Información emergente (Tooltip) del bloque. Usa la biblioteca Tooltipster con su tema noir:
.tooltipster-sidetip.tooltipster-noir .tooltipster-box {
background: #fff;
border: 1px solid #ddd;
border-radius: 6px;
}
.tooltipster-sidetip.tooltipster-noir .tooltipster-content {
color: #333;
font-size: 14px;
}
Si aparecen cajas de información vacías, o las descripciones emergentes de otras partes del sitio se convierten en cuadrados grises, otro script de la página usa la misma biblioteca de tooltips o una que choca con ella (se ha visto con el tema Flatsome y con plugins de insignias de producto). Establece Usar información emergente (Use tooltip) en No en la pestaña Design; los iconos de información desaparecen entonces del filtro.
Los nombres que aparecen sobre las muestras de color e imagen son CSS simple (p.woof_tooltip span.woof_tooltip_data). Si uno de esos nombres cubre la muestra vecina y captura sus clics, deja que los clics lo atraviesen:
.woof p.woof_tooltip span.woof_tooltip_data {
pointer-events: none;
}
Conflictos con el tema: casillas dobles, almohadillas y alineación
Muchos temas dan estilo a todas las listas, etiquetas y checkbox de la página, el filtro incluido. Inspecciona el elemento extraño para encontrar la regla del tema y desactívala solo dentro de .woof.
- Dos casillas por elemento. El tema dibuja su propio checkbox con un pseudoelemento en las etiquetas. Las listas de HUSKY no usan pseudoelementos, así que es seguro quitarlos ahí:
.woof .woof_list label::before, .woof .woof_list label::after { display: none !important; } - Almohadillas, flechas o iconos antes de los elementos. Una regla del tema para listas de widgets añade contenido antes de cada
li:.woof .woof_list li::before { content: none !important; } - Una viñeta junto a todo el widget. El tema imprime los widgets como elementos de lista:
li.WOOF_Widget { list-style: none; }. - Campos centrados o cortados.
body .woof .woof_redraw_zone { text-align: left; }corrige el texto centrado por el tema; el contenido cortado en el borde de la barra lateral suele venir deoverflow: hiddenen el widget, así que establece.widget.WOOF_Widget { overflow: visible; }. - Casillas invisibles. Una regla del tema oculta los inputs o las casillas de la piel; prueba primero otra piel y después busca la regla en el inspector.
Para estilos distintos en móvil o mientras se ejecuta una búsqueda, consulta CSS por dispositivo y dar estilo a la página mientras se filtra.
Lista de comprobación
- Piel, piel de lista desplegable e información emergente elegidas en la pestaña Design antes de escribir CSS.
- CSS en Código CSS personalizado (Custom CSS code) o en el tema, nunca en la carpeta del plugin; reglas simples, sin escapes.
- Cada regla empieza con
.woofo con una clase.woof_sid_. - Piel Ninguno (none) más
accent-colorpara los colores de marca; sin cambiar el tamaño de las pieles con sprite. - Tras un cambio con
woof_title_tag, reglas parah4reescritas. - Cachés y optimización de CSS vaciadas antes de juzgar el resultado.
Para un diseño concreto que estas reglas no cubren, publica el enlace de la página y una descripción del aspecto deseado en el foro de soporte de HUSKY; las preguntas frecuentes sobre pequeñas personalizaciones de CSS explican qué incluir.