Rotozoom Product Filter — Manual

Filtrado de productos AJAX ultrarrápido para WooCommerce. Product Filter permite a tus clientes acotar tu catálogo por categoría, precio, atributos, stock y valoración — los resultados se actualizan al instante, sin recargar la página.

• Versión gratuita: filtrado AJAX completo en todos los atributos de producto (sin límite), control deslizante de precio, filtros de stock/en oferta/novedades/valoración, contexto de categoría, y compatibilidad con temas clásicos, de bloques y XStore.
• Versión Pro: coincidencia con todos los valores seleccionados de un atributo (lógica Y), tus propias opciones de productos por página, un color exacto para cada valor de muestra, y una caché de resultados para un filtrado repetido más rápido. Pro requiere la edición descargada de rotozoom.com, que instala Rotozoom Connect automáticamente — allí inicias sesión con tu cuenta de Rotozoom.
• Precio Pro: 47 € / año por sitio, IVA incl.

---

Para principiantes: qué hace este plugin

Cuando una tienda tiene más de un puñado de productos, los clientes necesitan una forma de encontrar rápidamente lo que buscan. Un filtro es el panel — normalmente a la izquierda de la página de la tienda — con casillas y controles deslizantes como Precio, Color o Marca. A medida que el cliente marca casillas, la cuadrícula de productos se reduce.

Product Filter añade este panel a tu tienda y lo hace instantáneo: la cuadrícula se actualiza en el momento en que se marca una casilla, sin recargar la página. También conserva los filtros elegidos en la dirección web (la URL), para que un cliente pueda guardar como favorita o compartir una vista filtrada.

Configuración

1. Prepara tus datos

Los filtros valen tanto como tus datos de producto, así que asegúrate primero de que tus productos tengan:

• Categorías asignadas (en cada producto o en Productos → Categorías).
• Atributos como Color, Talla, Potencia, Casquillo (definidos en Productos → Atributos y luego asignados a los productos).

Consejo: mantén los slugs de atributos en letras ASCII simples (por ejemplo socket, wattage). Los slugs no latinos pueden codificarse mal en la URL.

2. Coloca el filtro

El filtro aparece automáticamente en las páginas de tu tienda, categoría, etiqueta y búsqueda. Para colocarlo en otro lugar — en cualquier página o entrada — utiliza el shortcode [rotozoom_filter] (opciones: category, per_page, columns, orderby, sidebar="0", bar="0"); [rotozoom_filter_bar] muestra la barra de ordenación y productos por página por sí sola. El filtro respeta automáticamente la página en la que se encuentra — en una página de categoría filtra dentro de esa categoría.

3. Elige qué filtros mostrar

En los ajustes del plugin (Rotozoom → Product Filter) eliges qué controles aparecen — categorías, rango de precio, atributos individuales, estado de stock y valoración — y en qué orden aparecen.

Referencia de funciones

Filtrado AJAX con sincronización de la URL

Cada cambio en un filtro lanza una solicitud AJAX — una llamada en segundo plano al servidor que devuelve solo los productos coincidentes y los inserta en la cuadrícula, sin recargar toda la página. Los filtros activos se escriben en la URL, de modo que:

• El botón Atrás del navegador funciona como se espera.
• Una vista filtrada se puede guardar como favorita o compartir.
• Llegar directamente a una URL filtrada muestra los resultados correctos, ya filtrados.

Control deslizante de rango de precio

Un control deslizante de dos tiradores permite a los clientes establecer un precio mínimo y máximo. El rango abarca los precios de toda la categoría actual (incluidas sus subcategorías), o de toda la tienda en las páginas de tienda y búsqueda; no se acota a medida que se seleccionan otros filtros.

Filtros de atributos

Cada atributo de WooCommerce puede convertirse en un grupo de filtros (casillas). Los clientes pueden combinar varios — por ejemplo Casquillo: E27 y Temperatura de color: Blanco cálido — para acotar los resultados con precisión.

• Free: cada atributo puede ser un filtro — no hay límite. Los productos coinciden si tienen al menos uno de los valores seleccionados de un atributo (O).
• Pro: por cada atributo puedes elegir Todos (Y) en Secciones, por lo que los productos deben tener cada valor seleccionado — ideal para catálogos técnicos con muchas propiedades.

Filtros de stock, valoración y especiales

Filtros integrados más allá de los atributos:

• En stock — ocultar artículos agotados.
• Valoración — mostrar solo productos a partir de una valoración por estrellas (desactivado por defecto; actívalo en Sections → Section visibility).
• En oferta — resaltar promociones.
• Novedades — mostrar productos añadidos recientemente.

Contexto de página de categoría

Cuando el filtro está en un archivo de categoría, acota automáticamente los resultados a esa categoría, de modo que los clientes refinan dentro de la sección que están explorando en lugar de en toda la tienda.

Extras de Pro

• Coincidencia Y — requiere todos los valores seleccionados de un atributo.
• Productos por página — ofrece a tus clientes tus propias opciones de elementos por página.
• Colores de muestra exactos — define el color preciso mostrado para cada valor de color.
• Caché de resultados — los resultados de filtrado repetidos para visitantes no registrados se sirven desde una caché en tu propio sitio, que se actualiza cuando cambian los productos o el stock.

Free vs Pro de un vistazo

Función	Free	Pro
Filtrado AJAX con sincronización de la URL	✓	✓
Control deslizante de rango de precio	✓	✓
Filtros de stock, en oferta, novedades y valoración	✓	✓
Contexto de página de categoría	✓	✓
Filtros de todos los atributos de producto (sin límite)	✓	✓
Temas clásicos, de bloques y XStore	✓	✓
Coincidencia Y por atributo	—	✓
Opciones personalizadas de productos por página	—	✓
Color exacto por valor de muestra	—	✓
Caché de resultados	—	✓

Notas avanzadas

• Compatibilidad con XStore (Free y Pro): XStore genera las páginas de la tienda con su propio marcado; el plugin incluye una integración específica para que el filtro se enganche correctamente a la cuadrícula de productos y al AJAX de XStore. En temas estándar/genéricos el filtro funciona sin esto.
• Consultas basadas en la URL: los filtros modifican la consulta principal de productos, por lo que los resultados son consultas reales de WooCommerce (paginación, ordenación y recuentos correctos) en lugar de un truco de mostrar/ocultar del lado del cliente.
• Rendimiento: el filtrado usa el contexto de categoría para mantener las consultas acotadas y rápidas incluso en catálogos grandes.

Solución de problemas

• Un atributo no se ofrece como filtro — confirma que es un atributo global (en Productos → Atributos) y que está asignado a productos.
• Las URL filtradas parecen rotas o doblemente codificadas — comprueba que los slugs de atributos sean ASCII simple.
• El filtro se ve sin estilo en XStore — asegúrate de que el filtro esté en una página de tienda o categoría de WooCommerce y borra cualquier caché de página.

Para activar Pro (descárgalo de rotozoom.com e inicia sesión a través de Rotozoom Connect), consulta Instalar y actualizar plugins.