Solución de problemas de Faceted Search

Empieza por el síntoma que los visitantes pueden reproducir. Cambia una variable cada vez y vuelve a indexar siempre que la configuración afecte a los datos indexados.

No hay contextos disponibles

  • Confirma que Enable faceted search está activo.
  • Confirma que el tipo de contenido o la taxonomía prevista es pública y tiene un archivo donde sea necesario.
  • Para las colecciones guardadas, crea o verifica la consulta en Database queries.

Un contexto aparece como deshabilitado

Un contexto necesita una configuración de contexto habilitada y al menos una faceta habilitada. Selecciona Edit facets, añade o habilita una faceta válida, guarda y vuelve a indexar.

Los filtros se muestran pero no afectan a las tarjetas

  • Haz coincidir los IDs de las facetas con el mismo contexto utilizado por Listings (Feed).
  • Establece Use with faceted search? en Yes.
  • Para una consulta personalizada, selecciona la misma consulta guardada en el listado.
  • En el modo Manual, añade Faceted Search Submit con el Context ID correcto.

Faltan opciones o recuentos

  • Verifica la clave de origen comparándola con contenido publicado real.
  • Comprueba las restricciones de inclusión/exclusión de términos y Zero-count choices.
  • Confirma que Counts está habilitado si se esperan recuentos.
  • Guarda y ejecuta Reindex context.

Para un filtro problemático concreto, sigue Debug one facet.

Las tarjetas pierden campos después de filtrar

Habilita el elemento necesario en Indexed native fields o añade su clave meta en Indexed metas y vuelve a indexar. Marca una meta como Gallery solo cuando la plantilla de resultados la muestre como una galería.

El orden no hace nada

Utiliza un valor de ordenación compatible. El precio y la valoración necesitan datos de producto compatibles; la distancia necesita un punto de proximidad seleccionado. Una ordenación meta personalizada debe existir en Managed meta sorting y utilizar su ID declarado.

El paginador y los resultados no coinciden

Utiliza Faceted Search Pager, no la paginación normal del listado. Confirma que hay una instancia de resultados prevista y un paginador para ella. Prueba desde una URL limpia sin parámetros pf_page, pf_loaded_pages o pfb_ obsoletos.

El mapa o la proximidad no están disponibles

  • Añade la clave del navegador en Settings → POM Theme → Integrations → Google Maps.
  • Verifica los dominios de referencia permitidos y las APIs de Google Maps requeridas.
  • Comprueba el adaptador de ubicación y los valores válidos de latitud/longitud.
  • Vuelve a indexar después de cambiar los datos de ubicación o la configuración.

Una URL compartida no se restaura

Confirma que el contexto y los IDs de facetas generados siguen existiendo. Vuelve a crear el estado con los controles visibles y copia la nueva URL en lugar de editar los parámetros pf_ a mano.

Verificación final

Después de corregir la configuración, prueba en una ventana privada: resultados iniciales, cada faceta por separado, una combinación, resultados vacíos, restablecer, ordenación, páginas posteriores, Atrás/Adelante y una URL copiada.