Descripción
No necesita tener SearchWP, pero lo utilizará si está disponible. La documentación completa está disponible en searchwp.com.
SearchWP Live Ajax Search te permite realizar búsquedas en directo mediante AJAX en tus formularios de búsqueda. Diseñado para ser el mejor amigo de los desarrolladores, SearchWP Live Ajax Search pretende no entorpecerte, pero al mismo tiempo te permite personalizarlo todo. Está configurado para funcionar con cualquier tema de WordPress y utiliza un cargador de plantillas para mostrar los resultados. El enfoque basado en plantillas te permite personalizar a la perfección tu implementación de SearchWP Live Search sin complicarte con docenas de opciones desordenadas.
Funciona mejor con SearchWP (pero no es necesario)
SearchWP Live Ajax Search funciona mejor junto a SearchWP, pero no es necesario. Si SearchWP está instalado y activado, SearchWP Live Ajax Search puede personalizarse para utilizar cualquiera de tus motores de búsqueda por formulario de búsqueda.
Personalización
Puedes personalizar en gran medida la implementación de SearchWP Live Ajax Search, incluyendo cualquier número de configuraciones definidas por el desarrollador. Los resultados se basan en un cargador de plantillas, lo que permite a SearchWP Live Ajax Search mantenerse al margen y te permite escribir la plantilla de resultados como lo harías con cualquier otro archivo de tema de WordPress.
Todo se activa añadiendo un único atributo de datos HTML5(data-swplive="true"
) al campo de entrada de tu formulario de búsqueda. Esto ocurre automáticamente en cualquier formulario de búsqueda generado a partir de get_search_form()
.
Compatibilidad con widgets
SearchWP Live Ajax Search incluye un widget que te permite insertar formularios de búsqueda en vivo donde quieras.
Capturas
Bloques
Este plugin proporciona 1 bloque.
- Search Form The best WordPress search you can find.
Instalación
- Descarga el plugin y extrae los archivos
- Sube
searchwp-live-search
a tu directorio~/wp-content/plugins/
- Activa el plugin desde el menú «Plugins» de WordPress
- Personaliza opcionalmente la configuración: documentación completa
- Personalizar opcionalmente la plantilla de resultados: documentación completa
FAQ
-
¿Hay documentación?
-
¡Por supuesto! Documentación completa
-
¿Cómo añado la búsqueda en directo a mi formulario de búsqueda?
-
SearchWP Live Ajax Search se activará automáticamente en cualquier formulario de búsqueda generado con
get_search_form()
. Puedes evitarlo con el siguiente filtro:add_filter( 'searchwp_live_search_hijack_get_search_form', '__return_false' );
Si quieres activar manualmente la SearchWP Live Ajax Search en un formulario de búsqueda personalizado, sólo tienes que añadir el siguiente atributo data a la
entrada
que quieras enganchar:data-swplive="true"
-
¿Cómo se generan los resultados de la búsqueda?
-
Por defecto, SearchWP Live Ajax Search utiliza el motor de búsqueda predeterminado de SearchWP si utilizas SearchWP. Si no tienes SearchWP, se proporcionan resultados de búsqueda nativos de WordPress. Si deseas personalizar el motor de búsqueda que utiliza SearchWP, sólo tienes que añadir el siguiente atributo al
campo
del formulario:data-swpengine="supplemental"
sustituyendo ‘supplemental’ por el nombre del motor de búsqueda que quieras usar. -
¿Cómo personalizo la plantilla de resultados?
-
SearchWP Live Ajax Search utiliza un cargador de plantillas. En la carpeta del complemento encontrarás una carpeta de
plantillas
que incluyesearch-results.php
, que es lo que se utiliza de forma predeterminada para mostrar los resultados de la búsqueda. Para personalizar esa salida, sólo tienes que crear una carpeta llamadasearchwp-live-ajax-search
en el directorio de tu tema y copiarsearch-results.php
en esa carpeta. SearchWP Live Ajax Search utilizará ese archivo en lugar del que viene con el complemento, y podrás personalizarlo como harías con otros archivos de plantilla de tema.SearchWP Live Ajax Search también genera dos conjuntos de estilos. El primer conjunto de estilos simplemente prepara la envoltura de resultados para que se coloque correctamente. El segundo conjunto de estilos controla la apariencia visual. Esta abstracción se hizo para garantizar que la personalización sea lo más sencilla posible. Puedes desactivar el «tema» por defecto eliminando de la cola la hoja de estilos correspondiente, y también puedes desactivar el CSS básico. Más información disponible en la documentación.
-
¿Cómo personalizo el spinner?
-
SearchWP Live Ajax Search utiliza un filtro –
searchwp_live_search_configs
– que te permite personalizar completamente la configuración utilizada. Simplemente añade una nueva clave al array pasado a través de ese filtro, personalizando los valorespor defecto
a lo que quieras.
Reseñas
Colaboradores y desarrolladores
«SearchWP Live Ajax Search» es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores«SearchWP Live Ajax Search» está traducido en 5 idiomas. Gracias a los traductores por sus contribuciones.
Traduce «SearchWP Live Ajax Search» a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
1.8.4
- Adds support for SearchWP multisite search.
- Improves search results dropdown role attribute, for better accessibility.
- Adjust results width to match Gutenberg form width when the search button is inside.
- Fixes the display of the results dropdown within a custom parent element.
1.8.3
- Evita problemas con los plugins de caché en algunos casos.
- Añade compatibilidad para cargar una plantilla personalizada desde una ruta de directorio especificada por el usuario.
1.8.2
- Corrección: integración con Relevanssi Premium.
1.8.1
- Corrección: en algunos casos se obtienen resultados incorrectos al utilizar una plantilla personalizada de Live Search.
1.8.0
- Añade formularios de búsqueda.
- Añade compatibilidad con las fuentes de búsqueda personalizadas de SearchWP.
- Mejora las personalizaciones existentes y añade otras nuevas a la página de ajustes de SearchWP Live Ajax Search.
- Actualiza los archivos de traducción.
- Corrección: Ubicación del enlace de ajustes en la lista de plugins cuando SearchWP está activado.
1.7.6
- Cambia la apariencia de la página de ajustes y la estructura del menú para que funcione sin problemas con la versión actual de SearchWP.
1.7.5
- Cambia el estilo visual de la página de configuración del administrador para adaptarla a la versión actual de SearchWP.
1.7.4
- Corrección: el botón de ajustes avanzados del widget desaparece sin mostrar los ajustes en algunos casos.
- Corrección: se anula el contenido del cuerpo si se establece el elemento padre personalizado en la configuración.
1.7.3
- Añade un sistema de avisos dentro del plugin para recibir las últimas actualizaciones de SearchWP.
1.7.2
- Añade compatibilidad con la próxima versión del plugin SearchWP Modal Search Form.
- Corrección: un problema con una versión antigua del plugin SearchWP.
1.7.1
- Corrección de las traducciones del plugin.
1.7.0
- Añade una nueva página de administración de ajustes para controlar más fácilmente el comportamiento del plugin.
- Introduce una importante refactorización del código para mejorar el rendimiento.
1.6.3
- Mejora la limpieza del argumento del campo de búsqueda ‘swpengine’.
- Normaliza las restricciones de acceso directo en las clases de todo el plugin.
1.6.2
- Limita los argumentos pasados a la consulta cuando se utiliza con la búsqueda nativa de WordPress.
1.6.1
- Corrección: Aviso PHP introducido en 1.6.0
1.6.0
- Añade compatibilidad con el bloque de formulario de búsqueda en el editor de bloques (Gutenberg)
1.5.0
- Añade compatibilidad con las variables de consulta post_status, post_type y posts_per_page cuando no se utiliza SearchWP
- Actualiza el origen de la traducción, actualiza las traducciones con textdomain fijo
- Proceso de paquete refactorizado
- Actualiza las dependencias del paquete
1.4.6
- Añade compatibilidad con SearchWP 4
1.4.5
- Corrección: un problema con el soporte de frases entrecomilladas
- Corrección: un problema con los tipos de contenido que se excluyen de la búsqueda cuando se registran (sólo se aplica a las búsquedas con SearchWP)
1.4.4
- Corrección: un problema con bundle.js en algunos casos
1.4.3
- Mejora la compatibilidad con SearchWP suprimiendo los filtros cuando SearchWP realiza la búsqueda.
- Corrección de compatibilidad con el formulario de búsqueda modal de SearchWP
1.4.2
- Corrección: un problema (error de JavaScript) cuando una configuración personalizada desactiva el spinner
1.4.1
- Corrección: un problema que podía haber impedido que las personalizaciones del spinner se aplicaran correctamente
1.4
- Elimina el tipo de entrada de la plantilla de resultados por defecto
- Corrección: un problema con las entidades HTML en la cadena de búsqueda
- Actualiza la fuente de traducción y las traducciones
- Actualiza el proceso de compilación de bundler
- Actualiza a11y cuando procede
- Cancela automáticamente las búsquedas pendientes cuando se cambia la entrada de búsqueda
1.3.1
- Corrección: error tipográfico en la llamada a la función de plantilla de resultados
1.3.0
- Muchas mejoras de a11y (gracias @geoffreycrofte)
- Añade un mensaje cuando no se haya alcanzado el mínimo de caracteres
- Añadida traducción al alemán (gracias @stefan-meier)
- Añadida traducción al polaco (gracias @boguslawski-piotr)
- Añadida traducción al neerlandés (gracias Stefan G.)
- Fuente de traducción actualizada
1.2.0
- Se ha modificado el proceso de creación para que sea más sencillo
- Compatiblidad con la depuración de scripts (gracias mgratch)
- Elimina el requisito de acción del formulario para integrarlo mejor con otro código (gracias mgratch)
- Corrección: un problema que impedía que la búsqueda se disparara cuando se volvía a entrar demasiado rápido (gracias pierrestoffe)
1.1.8
- Se ha añadido una opción de configuración para evitar la cancelación de AJAX cuando se pulsa la tecla Intro
- Añadidas algunas acciones para facilitar la personalización
- Añadido filtro para personalizar la ubicación de la plantilla de resultados
1.1.7
- Corrección: faltaba el nombre del motor
1.1.6
- Corrección: un problema que impedía que varias instancias de búsqueda en directo en una misma página utilizaran motores diferentes.
1.1.5
- Corrección: se ha corregido un problema por el que
results_destroy_on_blur
no se aplicaba correctamente si se utilizaba una configuración personalizada pero dicha propiedad no estaba definida en la configuración personalizada.
1.1.4
- Se han añadido una serie de eventos JavaScript para facilitar una mayor ampliación/integración
1.1.3
- Corrección: un problema con el proceso de compilación que introducía una versión obsoleta de los activos JavaScript del plugin.
1.1.2
- Ya no se limitan los resultados a los tipos de contenido incorporados
- Añadida la opción de configuración
results_destroy_on_blur
para evitar la eliminación automática de la ventana de resultados al hacer clic fuera del panel de resultados
1.1.1
- Corrección: un problema que impedía que los motores suplementarios de SearchWP aparecieran en la configuración del Widget
- Añadida traducción al francés
- Añadida traducción al serbio
1.1
- Definir estados de entrada por defecto al usar la búsqueda nativa de WordPress
- Nuevo filtro
searchwp_live_search_query_args
para manipular los argumentos de consulta antes de las búsquedas - Corrección: un desplazamiento al posicionar los resultados en la parte superior del campo de búsqueda
1.0.6
- Limpieza de advertencias PHP
1.0.5
- Nueva acción:
searchwp_live_search_alter_results
- Añade compatibilidad con Relevanssi (basado en la implementación de Dave’s WordPress Live Search)
1.0.4
- Se ha corregido el nombre de la carpeta de la plantilla de resultados por defecto para que sea
searchwp-live-ajax-search
, tal y como aparece en la documentación. - Mejora: ocultar el cuadro de resultados cuando se vacía la consulta (gracias Lennard Voogdt)
- Corrección: un problema con los medios de comunicación no se muestra en los resultados cuando se integra con SearchWP
1.0.3
- Corrección: se ha corregido un problema por el que se devolvía un conjunto falso de no resultados (gracias Lennard Voogdt).
1.0.2
- Resuelto un problema por el que al pulsar Intro/Retorno se impedía que la consulta de búsqueda pasara a la página de resultados
- Corrección: falso positivo potencial para DOING_AJAX (gracias justinsainton)
- Eliminada la llamada innecesaria a get_the_ID() en la plantilla de resultados por defecto (gracias justinsainton)
- Añadido escape al permalink y al nombre del tipo de entrada en la plantilla de resultados por defecto (gracias justinsainton)
- Utilizar una cadena traducida del núcleo de WordPress en lugar de una personalizada (gracias justinsainton)
- Aumentar la prioridad del filtro get_search_form para acomodar los filtros existentes
1.0.2
- Añadida traducción serbocroata (gracias Andrijana Nikolic)
1.0.1
- Corrección: problema con la URL de un directorio
- Corrección: error JavaScript indexOf
1.0
- ¡Lanzamiento inicial!