Shortcodes

Versión actual: 1.8.5

Esta extensión proporciona Shortcodes que generan formularios de búsqueda y páginas de resultados para los motores de búsqueda de SearchWP. Es útil si no se siente cómodo (o no puede) editar los archivos del tema directamente para implementar su(s) formulario(s) de búsqueda y bucles de resultados.

Después de activar Shortcodes, tendrá disponibles los siguientes:

Shortcode	Atributo(s)
`searchwp_search_form` Genera un formulario de búsqueda para un motor de búsqueda específico	`target` — La acción del formulario (por defecto es el permalink existente) `engine` — Nombre del motor de búsqueda (por defecto es `default`) `var` — El nombre de la variable de la consulta de búsqueda (por defecto es `swpquery`) `button_text` — Texto del botón del formulario (por defecto es `Search`) `hide_button` — "true" o "false", oculta el botón de envío del formulario de búsqueda `placeholder` — Texto del marcador de posición de entrada del formulario (por defecto es `Search`) `live_search` — "true" o "false", habilita/deshabilita forzadamente la Búsqueda Ajax en Vivo para este formulario, ignorando el valor de la configuración global "Habilitar Búsqueda en Vivo"
`searchwp_search_results` Genera la lista de resultados de búsqueda una vez que se ha enviado una búsqueda	`engine` — Nombre del motor de búsqueda (por defecto es `default`) `var` — El nombre de la variable de la consulta de búsqueda (por defecto es `swpquery`) `posts_per_page` — Cuántos posts por página mostrar Tenga en cuenta que este no es un Shortcode autocerrado, el marcado para cada resultado de búsqueda debe anidarse en su interior, vea el ejemplo a continuación
`searchwp_search_result_link` Genera un enlace al resultado de búsqueda actual con el texto del título del resultado	`direct` — "true" o "false", cuando es verdadero enlaza directamente al permalink, si es un adjunto enlaza directamente a su URL, no a la página principal
`searchwp_search_result_excerpt` Genera el extracto del resultado de búsqueda actual	Ninguno
`searchwp_search_results_none` Salida si no se encontraron resultados de búsqueda	Ninguno Tenga en cuenta que este no es un Shortcode autocerrado, el marcado para cada resultado de búsqueda debe anidarse en su interior, vea el ejemplo a continuación
`searchwp_search_results_pagination` Genera la paginación de los resultados de búsqueda	`engine` — Nombre del motor de búsqueda (por defecto es `default`) `direction` — "prev" o "next" `link_text` — El texto a usar en el enlace `var` — El nombre de la variable de la consulta de búsqueda (por defecto es `swpquery`)
`searchwp_search_results_paginate_links` Genera enlaces paginados para los resultados de búsqueda	`engine` — Nombre del motor de b uevoacute;squeda (El valor predeterminado es `default`) `var` — El nombre de la variable de consulta de b uevoacute;squeda (El valor predeterminado es `swpquery`) Adem uevoacute;s de lo anterior, tambi uevoacute;n se admiten argumentos de `paginate_links`.
`searchwp_search_result_image` Muestra la imagen destacada del resultado actual	`size` — Tama uevoacute;o de la imagen (El valor predeterminado es `thumb`)
`searchwp_search_result_permalink` Muestra el permalink del resultado actual con el texto del permalink del resultado	`direct` — Si se enlaza directamente a archivos multimedia (El valor predeterminado es `'true'`)
`searchwp_total_results` Muestra el n uevoacute;mero total de resultados de la b uevoacute;squeda actual	`engine` — Nombre del motor de b uevoacute;squeda (El valor predeterminado es `default`) `var` — El nombre de la variable de consulta de b uevoacute;squeda (El valor predeterminado es `swpquery`) `text` — El texto que se utilizar uevoacute; junto con el n uevoacute;mero de resultados. Admite los marcadores de posici uevoacute;n `%total%` y `%query%` para un formato preciso.`[searchwp_total_results text="Found %total% results for %query%"]` se convierte en "Found 0 results for example search".

Aqu uevoacute; hay una muestra de una implementaci uevoacute;n completa de Shortcodes que busca en un motor suplementario con el nombre my_test_engine:

	<h3>Search Form</h3>
	[searchwp_search_form engine="my_test_engine" target="http://example.com/supplemental-search/" var="swpquery" button_text="Find Results"]

	<div class="search-results-wrapper">
	[searchwp_total_results text="Found %total% results for %query%" engine="my_test_engine" var="swpquery"]
	[searchwp_search_results engine="my_test_engine" var="swpquery" posts_per_page=10]
	<h2>[searchwp_search_result_link direct="true"]</h2>
	[searchwp_search_result_excerpt]
	[/searchwp_search_results]
	</div>

	<div class="no-search-results-found">
	[searchwp_search_results_none]
	No results found, please search again.
	[/searchwp_search_results_none]
	</div>

	<div class="search-results-pagination">
	[searchwp_search_results_pagination direction="prev" link_text="Previous" var="swpquery" engine="my_test_engine"]
	[searchwp_search_results_pagination direction="next" link_text="Next" var="swpquery" engine="my_test_engine"]
	</div>

view raw gistfile1.html hosted with ❤ by GitHub

Puede personalizar los atributos seg uevoacute;n la tabla anterior.

Registro de Cambios

1.8.5

[Correcci uevoacute;n] El atributo FOR de la etiqueta no coincide con el ID de entrada cuando se utiliza una variable de b uevoacute;squeda personalizada.

1.8.4

[Nuevo] Se ha a uevoacute;adido la opci uevoacute;n para ocultar el bot uevoacute;n de env uevoacute;o.

1.8.3

[Nuevo] Compatibilidad con la b uevoacute;squeda Ajax en vivo.
[Mejora] El shortcode searchwp_total_results admite personalizaciones de texto.

1.8.2

[Correcci uevoacute;n] Evita errores debido a la recursi uevoacute;n de Shortcodes.
[Actualización] Actualizador actualizado.

1.8.1

[Correcci uevoacute;n] El atributo posts_per_page no se refleja al usar SearchWP 4.

1.8.0

[Nuevo] Nuevo Shortcode searchwp_search_results_paginate_links para enlaces paginados.
[Nuevo] Nuevo Shortcode searchwp_search_result_image para mostrar la imagen destacada del resultado.
[Nuevo] Nuevo Shortcode searchwp_search_result_permalink para mostrar el permalink del resultado.
[Actualización] Actualizador actualizado.

1.7.0

[Nuevo] Compatibilidad con SearchWP 4.

1.6.1

[Correcci uevoacute;n] Problema con el manejo de comillas.

1.6

[Nuevo] Nuevo Shortcode: searchwp_total_results para mostrar el n uevoacute;mero total de resultados de b uevoacute;squeda.
[Nuevo] A uevoacute;ade el argumento placeholder al Shortcode searchwp_search_form.
[Actualización] Actualizador actualizado.

1.5.4

[Correcci uevoacute;n] Comprobaciones adicionales para evitar la redeclaraci uevoacute;n de funciones en casos extremos.
[Actualización] Actualizador actualizado.

1.5.3

[Nuevo] Nuevo filtro: searchwp_shortcodes_engine.
[Nuevo] Nuevo filtro: searchwp_shortcodes_paginate_links.
[Nuevo] Nuevo filtro: searchwp_shortcodes_pagination_prev.
[Nuevo] Nuevo filtro: searchwp_shortcodes_pagination_next.
[Actualización] Actualizador actualizado.

1.5.1

[Nuevo] Nuevo Shortcode [searchwp_search_result_excerpt_global].
[Nuevo] Nuevo Shortcode [searchwp_search_result_excerpt_document].
[Mejora] Se ha refinado el escape para que combine mejor con el resaltado de términos.

1.5

[Mejora] Soporte para actualizaciones automáticas basado en tu clave de licencia de SearchWP.

1.2.1

[Nuevo] Se han añadido varias acciones durante la salida.

1.2

[Cambio] Permitir que la variable GET se establezca en el atributo Shortcode, entre otras cosas.

1.1

[Corrección] Se ha corregido un problema por el cual los atributos no se pasaban a la devolución de llamada del Shortcode.

1.0

Versión inicial.