Crea tu primera búsqueda facetada
Esta guía rápida crea un filtro y una lista de resultados en vivo. Usa contenido publicado representativo para que los recuentos y las coincidencias sean significativos.
Requisitos previos
- Un archivo compatible o una consulta personalizada existente.
- Al menos dos elementos publicados con valores diferentes en una taxonomía o en un campo personalizado corto.
- Permiso para editar los ajustes del tema y la página o plantilla de destino.
Configura el contexto
- Abre Settings → POM Theme → Content model → Faceted search.
- Activa Enable faceted search si está desactivada.
- En la tabla de contexto, localiza la consulta que quieres filtrar.
- Selecciona Edit facets.
- Selecciona Add facet.
- Introduce una Label orientada al cliente.
- Elige Checkboxes como Type.
- Elige la Source correcta y, a continuación, introduce su clave.
- Mantén Operator como OR para esta primera prueba.
- Deja Enabled activa y selecciona Save facets.
- Vuelve a la tabla de contexto y selecciona Reindex context.
Espera hasta que se complete el progreso de indexación.
En un sitio con Polylang, la indexación mantiene cada publicación traducida en su idioma asignado. Comprueba el listado en cada idioma publicado después de reindexar. Una consulta guardada con un idioma explícito conserva esa restricción; de lo contrario, el filtrado sigue el idioma de la página actual, incluidas las actualizaciones por AJAX. El contenido sin idioma asignado permanece disponible para las consultas que lo incluyan.
El filtrado público usa contenido publicado y no protegido con contraseña, y respeta las reglas de permisos de tipo de publicación del tema para el visitante actual. Estas restricciones también se aplican a los recuentos y a las sugerencias de autocompletado. El interruptor de la función en Theme Options controla la activación de Faceted Search; el contexto seleccionado también debe estar activado. Desactivar un contexto lo hace no disponible para las solicitudes de búsqueda públicas.
Monta la página
Para Gutenberg y un contexto de consulta guardada:
- Edita la página de destino y añade Faceted Search Facet.
- Elige el Search context configurado y la Facet. La vista previa usa valores de ejemplo; no ejecuta una búsqueda pública.
- Añade Listings. En Content, establece Content source como Saved query y elige la misma Saved query.
- En Pagination and filters, activa Use Faceted Search y mantén Submit mode como Automatic.
- Añade Faceted Search Counts y Faceted Search Reset, seleccionando el mismo Search context.
- Añade Faceted Search Pager cuando la consulta pueda devolver más de una página.
- Guarda la página y abre su vista previa en el frontend para probar los filtros.
En Legacy Page Builder, añade Faceted Search Facet con el Facet ID generado y, a continuación, Listings (Feed) usando la opción correspondiente Query type / Custom queries. Activa Use with faceted search? y mantén Facet submit mode como Automatic. Añade los controles correspondientes de Counts, Reset y Pager y guarda.
Los bloques nativos usan el mismo motor de búsqueda que los shortcodes de Legacy. La administración de Page Builder puede estar desactivada sin desactivar su renderizado público. Un formulario Finder independiente puede compartir la consulta guardada, pero sus filtros y resultados permanecen independientes de Faceted Search. Usa un contexto interactivo de Faceted Search por página.
Comprueba el resultado
Abre la página pública en una ventana privada del navegador. Confirma que:
- la lista sin filtrar contiene los elementos esperados;
- cada recuento de casilla de verificación es plausible;
- seleccionar un valor reduce las tarjetas;
- la URL incorpora un parámetro
pf_; - Faceted Search Reset restaura el conjunto inicial.
Si el filtro está vacío, consulta Depurar una faceta. Para un diseño de producción, continúa con Crear un listado filtrable.