HS Product Filters: guía de uso

Cambio entre ediciones: Free 1.2 / Pro 0.2. Crear o editar páginas dedicadas de filtros, vinculaciones de URL legibles, indexación selectiva, títulos y descripciones requiere Pro. Free mantiene el noindex automático y sigue mostrando sin cambios las páginas SEO ya guardadas. Quitar Pro no elimina ni modifica esas configuraciones.

Para Free 1.2 / Pro 0.2. Prueba en una copia de pruebas antes de publicar los cambios. La presentación compatible es un catálogo de Product Filters mediante shortcode en una página de WordPress. No sustituye un archivo existente de WooCommerce ni un widget de productos de Elementor.

Crea tu primer catálogo

1. Instala el ZIP de Product Filters en un sitio con WooCommerce activo. El paquete actual requiere WordPress 6.8 o posterior y PHP 8.2 o posterior. Las combinaciones verificadas y sus límites se indican más abajo.
2. Abre HookSpark → Product Filters y crea un conjunto. Dale un nombre que entiendan tus clientes: el catálogo lo utiliza como título.
3. Elige la categoría de producto que define la colección o utiliza todo el catálogo. En Subcategorías, elige Include subcategories («Incluir subcategorías», valor predeterminado de conjuntos nuevos y existentes) o Direct category assignments only(«Solo asignaciones directas a la categoría»). Esta elección se aplica tanto al ámbito del catálogo como a los filtros de categoría. El ámbito se mantiene cuando el visitante restablece sus selecciones. Un producto asignado expresamente a una categoría padre y a una hija puede coincidir con cualquiera de las asignaciones directas; solo se cuenta una vez.
4. Selecciona hasta ocho fuentes de filtro. Las fuentes disponibles son categorías, etiquetas, marcas de WooCommerce cuando estén registradas y atributos globales de producto. Crea primero en WooCommerce los atributos globales que falten. Los atributos personalizados específicos de un producto no son fuentes de filtro en esta versión preliminar.
5. Utiliza la vista previa para probar combinaciones. Muestra hasta seis tarjetas de productos coincidentes; el total cuenta todas las coincidencias. En la vista previa del editor, las listas largas se limitan a 30 valores.
6. Guarda el conjunto y actívalo cuando esté listo. Copia el shortcode generado en un bloque Shortcode de una página de WordPress. Utiliza una sola cuadrícula en esa página. Publica la página mediante el proceso habitual de WordPress.
7. Abre la página sin iniciar sesión, prueba los filtros y la ordenación y compruébala después en un teléfono.

Un shortcode habitual es [hs_product_filters set="YOUR_SET_ID"]. Copia el valor real del editor; el nombre del conjunto no es su identificador. Para una página SEO vinculada expresamente, sigue la guía SEO.

Cómo se encuentran los productos coincidentes

Varios valores del mismo filtro son alternativas: Plum o Lavender. Los filtros distintos se combinan: Plum y Small. Un producto variable debe tener una única variación disponible que cumpla a la vez todos los atributos, el precio y la disponibilidad seleccionados. Tener una variación Plum/Small y otra Lavender/Medium no hace que el producto padre coincida con Plum/Medium.

Una variación configurada con cualquier valor puede coincidir con los valores asignados al producto padre para ese atributo. Se incluyen las categorías ascendentes cuando el conjunto incluye subcategorías. La vista previa admite productos simples y variables; no evalúa actualmente productos agrupados, externos o de tipos personalizados.

El catálogo incluye productos publicados, visibles públicamente, comprables y con precio. Se excluyen los protegidos con contraseña. Se respeta el ajuste de WooCommerce para ocultar productos agotados. Si ese ajuste oculta un artículo, seleccionar Agotado no lo hace visible.

Cada producto padre aparece una sola vez. Su tarjeta utiliza la imagen, el precio y el enlace de la variación coincidente más barata. Si esa variación no tiene imagen, WooCommerce utiliza la del producto padre; si tampoco existe, muestra su imagen de sustitución habitual. La misma alternativa se aplica a la vista previa de administración. Esta explica además que todos los filtros seleccionados deben coincidir con una misma variación o producto simple, identifica la variación coincidente más barata y enumera sus atributos junto al identificador. Esos datos de diagnóstico no se añaden a las tarjetas públicas. El visitante sigue el enlace a la ficha normal de WooCommerce para elegir o comprar. Filtrar no cambia cantidades del carrito, existencias ni precios del catálogo.

Recuentos, precios y ordenación

El número junto a un valor cuenta productos padre distintos. Tiene en cuenta los demás grupos de filtros, pero ignora el grupo actual para que el comprador vea alternativas. Añadir varios valores del mismo grupo no cuenta varias veces un producto padre.

El precio mínimo y el máximo se incluyen en el intervalo y utilizan el precio mostrado de WooCommerce con la precisión de moneda configurada, de cero a seis decimales. Utiliza punto o coma decimal, sin separadores de miles. Se rechaza un intervalo invertido. Los precios inválidos conservan el valor introducido y muestran un mensaje junto al campo, con un resumen de errores enlazado. Al aplicar, el foco pasa al primer precio inválido; en móvil se abre el panel para corregirlo. Las integraciones fiscales y de moneda deben probarse en el contexto real de cada tienda.

Las opciones de disponibilidad son cualquiera, con existencias, con pedidos pendientes y agotado. Se puede ordenar según el catálogo, por precio ascendente o descendente y por novedades. La cuadrícula pública muestra doce productos por página.

Cambia o borra las selecciones

Con JavaScript, los controles actualizan la cuadrícula sin recargar toda la página. El botón Aplicar filtros también funciona mediante navegación normal. La URL registra las selecciones aplicadas y Atrás y Adelante del navegador las restauran. Si se solapan actualizaciones, una respuesta antigua no puede sustituir una selección más reciente. Las actualizaciones automáticas mantienen el foco del teclado en el control actual, incluso si pasas al siguiente mientras hay una solicitud pendiente. Aplicar, restablecer y cambiar de página llevan el foco a los resultados actualizados; los errores de validación tienen prioridad.

Los valores seleccionados aparecen encima de la cuadrícula como etiquetas que puedes quitar. Quita una para conservar las demás selecciones; el catálogo vuelve a la primera página. Restablecer recupera el catálogo original o el filtro único asignado a una página SEO. En pantallas de hasta 650 px, Filtrar productos abre un panel modal. Las selecciones siguen siendo un borrador hasta pulsar Aplicar filtros. Cancelar cambios, Escape o cerrar desde el fondo descarta el borrador, recupera los filtros aplicados y devuelve el foco al botón de apertura. Pasar al ancho de escritorio también cancela el borrador. Los recuentos reflejan el estado aplicado y se actualizan al aplicar; no hay un recuento en tiempo real del borrador. Sin JavaScript, el formulario desplegable habitual sigue siendo utilizable.

Una combinación sin coincidencias muestra controles para recuperarse. Quita una etiqueta, amplía el rango de precios o restablece los filtros. Una página filtrada inválida o vacía devuelve 404 y noindex; eso no significa que se haya eliminado la página original de WordPress. Si falla una solicitud AJAX, se conservan los resultados anteriores con un mensaje de error y un botón para reintentar la actualización. El reintento repite la operación fallida, incluida la eliminación de una etiqueta de filtro. Una solicitud nueva sustituye las respuestas y los errores anteriores.

SEO y URL legibles

Crea una página normal de WordPress con un slug legible para una colección útil de un solo filtro y vincúlala en SEO landing pages («Páginas de destino SEO»). Tú controlas su título, descripción e interruptor de indexación. Guardar la vinculación no publica la página ni modifica la visibilidad del sitio de WordPress.

Solo una página exacta, no vacía y habilitada expresamente puede ser apta para indexación. Los filtros adicionales, límites de precio, ordenación y paginación siguen con noindex y no heredan la descripción editorial. El plugin no genera miles de rutas legibles para combinaciones arbitrarias. Consulta la guía de configuración SEO y recuperación antes de habilitar la indexación.

Gestiona los conjuntos con seguridad

Busca conjuntos por nombre en la lista. Copiar uno crea una copia inactiva para ajustarla antes de utilizarla. Mover un conjunto a la papelera requiere su nombre; restaurarlo lo deja inactivo. Un conjunto desactivado, inexistente o en la papelera muestra un aviso de indisponibilidad y un enlace a la tienda habitual en lugar de mostrar su antiguo catálogo.

Los cambios sin guardar activan un aviso al salir del editor. Si se rechaza un guardado, se conservan los valores introducidos y se identifica el primer campo inválido. Si alguien guarda otra revisión antes, recarga y compara la configuración más reciente antes de reintentar. No des por hecho que tu formulario desactualizado haya sobrescrito su trabajo.

Recupera una configuración anterior

Abre un conjunto guardado y busca Previous configurations («Configuraciones anteriores») debajo de la vista previa. Se conservan las diez últimas configuraciones modificadas de ese conjunto. Elige Load revision … as a draft («Cargar revisión… como borrador») para revisar el nombre, las fuentes y la categoría anteriores. Esto no cambia el catálogo guardado. El borrador recuperado está inactivo: revísalo, guarda cuando esté listo y actívalo expresamente si es necesario.

Guardar el borrador recuperado conserva la configuración a la que sustituye para poder recuperarla también. Se rechazan los guardados simultáneos en conflicto. Si una categoría o fuente antigua ya no existe, el editor explica el problema y muestra la configuración actual. Los ajustes de páginas SEO y los demás conjuntos no cambian. Los conjuntos duplicados empiezan con su propio historial vacío; mover uno a la papelera conserva su historial. No se pueden reconstruir versiones anteriores a la instalación de esta función.

La versión preliminar admite hasta 100 conjuntos, incluidos los de la papelera, y 100 vinculaciones SEO. Son límites de implementación, no niveles de planes de pago. No conserves copias de prueba innecesarias en la configuración de producción.

Demo y compatibilidad

La demo de Product Filters utiliza productos ficticios de estudio e ilustraciones e imágenes de producto originales. La demo personal de administración dura una hora, con un subsitio de WordPress aislado y una cuenta restringida. Permite configurar filtros y las páginas SEO facilitadas; no concede permisos generales para publicar páginas, subir archivos, instalar plugins o gestionar la red. Las páginas de demo permanecen con noindex. Las URL de sesión personal caducan.

Combinaciones verificadas: WordPress 6.8 con WooCommerce 10.6.0 y WordPress 7.1.1 con WooCommerce 11.1.0, ambas en PHP 8.2.29. Las comprobaciones de plataforma mínima utilizan el ZIP de distribución instalado y cubren filtros, SEO, conservación de datos durante el ciclo de vida y una prueba básica de navegador. Son pruebas de esos entornos, no una certificación de todas las versiones superiores a los mínimos. Existen comprobaciones automatizadas de filtrado nativo con shortcode en una página, política SEO, coincidencia de variaciones y demo multisitio. Yoast SEO 28.5 y Rank Math 1.0.278 superaron las pruebas de metadatos, robots, canonical y sitemap XML real por HTTP con WordPress 7.1.1, WooCommerce 11.1.0 y PHP 8.2.29. Yoast 27.9 y Rank Math 1.0.278 también las superaron en la plataforma mínima. Yoast 28.5 requiere WordPress 6.9 o posterior y no se forzó su instalación en 6.8. No se han verificado otras versiones. Varias cuadrículas, adaptadores de archivos o maquetadores, integraciones multilingües y otros proveedores de varias monedas quedan fuera del alcance verificado.

Los catálogos grandes aún requieren optimización. El motor actual examina el catálogo pertinente en cada evaluación; procesar en lotes reduce las consultas, pero no elimina ese trabajo. Una medición local con 50.000 productos simples tardó unos 10 segundos. No utilices esa medición como garantía del alojamiento ni como afirmación de que esté listo para grandes tiendas.

Diagnóstico

Síntoma	Qué comprobar
Catálogo no disponible	Confirma el identificador del shortcode, el conjunto guardado y su activación. Si corresponde, restaura el conjunto desde la papelera y actívalo después.
Falta un atributo	Utiliza un atributo global de WooCommerce, asigna sus términos a productos y selecciónalo en el conjunto.
Falta la variación esperada	Comprueba que una misma variación cumpla todos los criterios, tenga precio y esté disponible según los ajustes de visibilidad de la tienda.
Se rechaza una URL antigua	Puede que se haya eliminado la fuente o el término al que apuntaba. Actualiza la vinculación y los enlaces pertinentes.
El título SEO es genérico	Un filtro adicional, la ordenación o el número de página pueden convertir la URL en una combinación de navegación en lugar de la página de destino exacta.
Sigue apareciendo noindex después de habilitar la página	Comprueba la visibilidad del sitio de WordPress y las restricciones existentes del plugin SEO. El interruptor de Product Filters no puede eliminarlas.
La vista previa es lenta	Mide el catálogo real y las extensiones instaladas; el índice para catálogos grandes sigue en desarrollo.
El guardado informa de un cambio simultáneo	Recarga la configuración más reciente, compara los cambios y guarda después de revisarlos.

Desactivar el plugin conserva su configuración y no elimina productos de WooCommerce ni páginas nativas. La salida del shortcode requiere que el plugin esté activo; quítalo o sustitúyelo si retiras una página de catálogo. Eliminar el plugin no borra automáticamente los productos del comerciante. Guarda una copia de seguridad antes de actualizar o limpiar. Se verificó la conservación de configuración, vinculaciones SEO, historial y papelera al desactivar y reactivar, actualizar de 0.8.2 a 0.8.3, repetir la instalación y desinstalar y reinstalar con WordPress 6.8 / WooCommerce 10.6.0 y el paquete real 0.8.3-dev. Una activación nueva no crea ni habilita conjuntos de filtros. Esto no certifica todas las combinaciones de terceros.

Adapta el aspecto a tu tema

El catálogo de filtros hereda la fuente y el color de texto de su entorno. Los controles y las tarjetas utilizan los valores base y de contraste de la paleta de WordPress cuando existen. Los estilos se aplican a las clases de HookSpark. El shortcode gestiona su propia cuadrícula y no cambia el estilo de la cuadrícula de tienda del tema. Los adaptadores de archivos nativos y de maquetadores siguen sin verificarse.

Para cambiar colores localmente, limita el CSS personalizado al catálogo o a su sección contenedora. Por ejemplo, .my-catalog { --hs-pf-accent: #006446; --hs-pf-on-accent: #ffffff; } cambia la pareja de colores de acento solo dentro de ese contenedor. Otras propiedades opcionales son --hs-pf-surface, --hs-pf-border, --hs-pf-control-border y --hs-pf-soft. La propiedad de borde de controles afecta a los campos de precio, los selectores y la acción de cancelar del panel; el borde decorativo es independiente. Elige combinaciones legibles de texto y fondo y comprueba escritorio y móvil después de personalizar.

Revisa las páginas antes de retirar un conjunto

En la lista de conjuntos de filtros, elige Review affected pages («Revisar páginas afectadas») antes de Mover a la papelera. La lista de solo lectura combina los shortcodes explícitos de páginas nativas con las vinculaciones SEO guardadas, elimina duplicados y enlaza a los editores cuando tu cuenta puede editarlos. Incluye borradores; no muestra páginas sin permiso de lectura ni páginas en la papelera. Debes revisar por separado los archivos de plantillas y los datos internos de maquetadores. La revisión solo se ejecuta cuando la solicitas.

Mover un conjunto a la papelera requiere su nombre guardado exacto. No elimina las páginas ni su contenido editorial. El catálogo no disponible ofrece un enlace a la tienda. Restaura el conjunto como inactivo, revisa sus ajustes y actívalo cuando esté listo.

Cambio de moneda probado

Se probó FOX Currency Switcher 1.5.4 con WordPress 6.8 / WooCommerce 10.6.0 / PHP 8.2.29, USD/EUR, tipos de cambio fijos de prueba, actualización automática de tipos desactivada, almacenamiento predeterminado en transients y una página con shortcode sin caché. En esta configuración coinciden los precios nativos, las etiquetas de moneda y las comparaciones de mínimos y máximos. El selector del proveedor recarga la página y borra las selecciones hechas mediante AJAX; elige primero la moneda y aplica después los filtros. No se promete convertir automáticamente un importe de filtro ya introducido.

El almacenamiento por cookies mostró una actualización tardía y queda fuera de este resultado de aceptación. No se han verificado GeoIP, precios fijos por producto, tiendas en caché, conversión en el pago ni otros proveedores. FOX es opcional y no está incluido en el ZIP de Product Filters.

Navegación del espacio de trabajo

Utiliza All filter sets («Todos los conjuntos») para gestionar catálogos, SEO landing pages («Páginas de destino SEO») para las colecciones indexables, Start here («Empieza aquí») para la configuración y HookSpark plugins para el catálogo existente de la colección. El catálogo lee el estado local de instalación: abrirlo no activa ni instala plugins. Los cambios sin guardar conservan la confirmación compartida de salida.

Lectura del catálogo y compatibilidad

El plugin elige automáticamente cómo leer el catálogo. Los datos estándar se leen en lotes limitados. Si se detectan precios personalizados, criterios de compra, almacenes de productos o funciones de consulta personalizados, se utilizan los objetos nativos de WooCommerce. Las ofertas programadas y los datos fiscales importados no habituales también recurren al precio nativo. No hay un selector de modo que configurar. El rendimiento depende del tamaño del catálogo y de las integraciones instaladas; prueba catálogos representativos en tu entorno de pruebas. Esta candidata aún no certifica la verificación completa de publicación para grandes catálogos y concurrencia.

Si no se puede leer el catálogo, se muestra un mensaje de indisponibilidad temporal en lugar de un resultado vacío engañoso. La página normal del catálogo devuelve un error temporal del servidor con noindex y sin caché. Reintenta después de resolver la causa. Las solicitudes automáticas de filtros conservan los resultados existentes cuando falla la petición.

Ubicación de las acciones de administración: candidata 0.8.3

Crea un conjunto desde All filter sets («Todos los conjuntos») o Start here («Empieza aquí»). En el editor, Save filter set («Guardar conjunto») y Refresh preview («Actualizar vista previa») permanecen juntos debajo de la configuración; guardar es la acción principal. El shortcode para insertar el catálogo solo aparece después de guardar el conjunto. Las cuatro pestañas compartidas siguen disponibles, incluido el catálogo de plugins de HookSpark. La búsqueda permanece junto a su campo.

Cachés de páginas y CDN

Excluye de la caché de página completa todas las páginas con el shortcode de Product Filters, incluido el catálogo inicial sin filtrar y las páginas de destino SEO. Purga las copias antiguas después de añadir el shortcode o actualizar el plugin. Mantén la caché habitual para páginas ajenas al catálogo y archivos estáticos.

El plugin envía instrucciones de respuesta private/no-store y activa el indicador habitual de WordPress para omitir la caché de página antes de mostrar estas páginas. Los precios pueden depender de la moneda, los impuestos o el cliente incluso antes de elegir un filtro. Si una caché sirve HTML antes de que se ejecute WordPress o ignora esas instrucciones, debes excluir expresamente las URL. Estas instrucciones no certifican un plugin de caché o CDN concreto: comprueba la exclusión en tu entorno de pruebas.

Idioma de la interfaz

Se incluyen traducciones de interfaz al inglés y al italiano. WordPress elige el idioma público según el idioma del sitio y el del panel según la preferencia del usuario. Los mensajes de resultados utilizan singular para una coincidencia y plural para cero o varias. Los nombres de catálogo, textos de productos y etiquetas de taxonomías siguen siendo contenido tuyo; el plugin no los traduce automáticamente.

Se verificó WP Super Cache 3.1.3 en modo Simple con WordPress 6.8 / WooCommerce 10.6.0 / PHP 8.2.29: una página normal se sirvió desde caché mientras las páginas iniciales, filtradas y SEO del catálogo permanecieron actualizadas. La prueba utilizó caché solo para visitantes anónimos y coincidencia de enlaces permanentes con barra final. El modo Expert, los servicios CDN o proxy y otros proveedores requieren comprobaciones independientes. Purga cualquier caché de catálogo existente al actualizar.