FacetWP Relevanssi Integration Addon

Una caja de búsqueda que no encuentra lo que el visitante teclea

Tienes un listado con filtros y, aun así, hay visitantes que ignoran las facetas y escriben directamente lo que buscan. Relevanssi ataca ese problema porque mantiene su propio índice de búsqueda en la base de datos, y este complemento permite que la faceta de búsqueda de FacetWP lo use.

Ten claro desde el principio que no sustituye a ninguno de los dos plugins: necesitas FacetWP y Relevanssi (la versión gratuita o Relevanssi Premium; Relevanssi Light no está soportado). El add-on es solo el puente entre ambos.

Recorrido con FacetWP Relevanssi Integration Addon: de la búsqueda por defecto a la faceta con índice propio

Paso 1, activar el complemento. Relevanssi se engancha a la búsqueda del núcleo de WordPress, así que la integración no es opcional: sin el add-on, las facetas de búsqueda y la página de resultados del sitio no funcionan bien.

Paso 2, elegir el motor en cada faceta. Al activarlo, cada faceta de tipo Search muestra una opción nueva, "Relevanssi", dentro del ajuste "Search engine". Hay que seleccionarla faceta por faceta: si no, no devolverá resultados. Si por algún motivo prefieres el motor "WP Default", la única vía es desactivar Relevanssi en la página donde está esa faceta.

Paso 3, decidir qué pasa con la página /?s=. Si la página de resultados del sitio tiene facetas, con lo anterior basta. Si no las tiene, no mostrará resultados, y la solución es desactivar FacetWP en esa página.

Paso 4, probar. FacetWP pide a Relevanssi los IDs de las entradas que debe mostrar, así que, si algo sale raro, empieza por los ajustes de Relevanssi. Su función "Admin search" (en el Escritorio) te deja ver los resultados con la configuración actual. Y si una palabra concreta no da resultados, revisa la lista de stopwords en Ajustes > Relevanssi > Stopwords: son palabras que se quitan del índice y nunca devuelven nada.

Tres dudas antes de montarlo

¿Funciona con Relevanssi Light?

No. La integración cubre Relevanssi gratuito y Relevanssi Premium, pero no Light.

¿Puedo dejar la faceta con el motor por defecto de WordPress?

Solo desactivando Relevanssi en la página donde esté la faceta. Mientras Relevanssi esté activo ahí, la faceta debe usar el motor "Relevanssi".

Mi página de resultados no tiene facetas, ¿qué hago?

No mostrará resultados con el add-on activo. Desactiva FacetWP en esa página para que vuelva a funcionar.

Tope de 500 resultados y una base de datos que crece

Por rendimiento, con "Throttle searches" activado (Ajustes > Relevanssi > Searching, y viene activado por defecto), Relevanssi devuelve como máximo 500 resultados, y la faceta de búsqueda hereda ese límite. Puedes desactivarlo, pero si la consulta de tu plantilla de listado maneja muchos posts, el rendimiento puede resentirse. También puedes bajar el tope con un filtro sobre pre_option_relevanssi_throttle_limit en el functions.php de tu child theme (el valor por defecto es 500). Relevanssi recomienda no bajar de 200, porque con valores bajos los resultados pierden relevancia, y el filtro solo funciona si "Throttle searches" sigue activado.

Otro límite es el espacio: Relevanssi puede necesitar cientos de MB. Como estimación razonable, multiplica por tres el tamaño de tu tabla wp_posts. En un hosting con poco espacio para tablas, o en un sitio con decenas de miles de entradas y recursos justos, puede dar problemas.

Cuando FacetWP Relevanssi Integration Addon da cero resultados por un shortcode escondido

La opción de Relevanssi "Create custom search result snippets" genera extractos a partir del contenido de las entradas. Si alguna de las páginas que salen en los resultados contiene un shortcode del Listing Builder, o un bloque, módulo, widget o elemento con una plantilla de listado de FacetWP, esas consultas extra pueden interferir y provocar un "sin resultados" inesperado.

Peor aún: si esa consulta recupera la misma página en la que está, se produce un bucle infinito que puede agotar la memoria y dejar sin respuesta la página, el sitio o incluso el servidor. Si tus resultados no aparecen o hay páginas colgadas, busca ese tipo de contenido entre los resultados y exclúyelo de la búsqueda desde los ajustes de Relevanssi.