Shortcodes

Version actuelle : 1.8.5

Cette extension fournit des Shortcodes qui génèrent à la fois des formulaires de recherche et des pages de résultats pour les moteurs de recherche SearchWP. C'est utile si vous n'êtes pas à l'aise (ou capable) de modifier directement les fichiers de thème pour implémenter vos formulaires de recherche et boucles de résultats.

Après avoir activé Shortcodes, les éléments suivants seront à votre disposition :

Shortcode	Attribut(s)
`searchwp_search_form` Affiche un formulaire de recherche pour un moteur de recherche spécifique	`target` — L'action du formulaire (Défaut : le permalien existant) `engine` — Nom du moteur de recherche (Défaut : `default`) `var` — Nom de la variable de requête de recherche (Défaut : `swpquery`) `button_text` — Texte du bouton du formulaire (Défaut : `Search`) `hide_button` — Soit « true » soit « false », masque le bouton de soumission du formulaire de recherche `placeholder` — Texte d'espace réservé pour l'entrée du formulaire (Défaut : `Search`) `live_search` — Soit « true » soit « false », force l'activation/désactivation de la recherche Ajax en direct pour ce formulaire, en ignorant la valeur du paramètre global « Activer la recherche en direct »
`searchwp_search_results` Affiche la liste des résultats de recherche une fois qu'une recherche a été soumise	`engine` — Nom du moteur de recherche (Défaut : `default`) `var` — Nom de la variable de requête de recherche (Défaut : `swpquery`) `posts_per_page` — Nombre de publications à afficher par page Notez qu'il ne s'agit pas d'un Shortcode auto-fermant, le balisage de chaque résultat de recherche doit être imbriqué à l'intérieur, voir l'exemple ci-dessous
`searchwp_search_result_link` Affiche un lien vers le résultat de recherche actuel avec le texte du titre du résultat	`direct` — Soit « true » soit « false », lorsque true, lie directement au permalien, s'il s'agit d'une pièce jointe, lie directement à son URL, pas à la page parente
`searchwp_search_result_excerpt` Affiche l'extrait du résultat de recherche actuel	Aucun
`searchwp_search_results_none` Sortie si aucun résultat de recherche n'a été trouvé	Aucun Notez qu'il ne s'agit pas d'un Shortcode auto-fermant, le balisage de chaque résultat de recherche doit être imbriqué à l'intérieur, voir l'exemple ci-dessous
`searchwp_search_results_pagination` Affiche la pagination des résultats de recherche	`engine` — Nom du moteur de recherche (Défaut : `default`) `direction` — Soit « prev » soit « next » `link_text` — Le texte à utiliser dans le lien `var` — Nom de la variable de requête de recherche (Défaut : `swpquery`)
`searchwp_search_results_paginate_links` Affiche les liens paginés pour les résultats de recherche	`engine` — Nom du moteur de recherche (Défaut : `default`) `var` — Nom de la variable de requête de recherche (Défaut : `swpquery`) En plus de ce qui précède, les arguments de `paginate_links` sont également pris en charge.
`searchwp_search_result_image` Affiche l'image mise en avant pour le résultat actuel	`size` — Taille de l'image (Défaut : `thumb`)
`searchwp_search_result_permalink` Affiche le permalien du résultat actuel avec le texte du permalien du résultat	`direct` — Lier directement aux fichiers multimédias (Défaut : `'true'`)
`searchwp_total_results` Affiche le nombre total de résultats pour la recherche actuelle	`engine` — Nom du moteur de recherche (Défaut : `default`) `var` — Nom de la variable de requête de recherche (Défaut : `swpquery`) `text` — Le texte à utiliser avec le nombre de résultats. Prend en charge les espaces réservés `%total%` et `%query%` pour un formatage précis.`[searchwp_total_results text="Trouvé %total% résultats pour %query%"]` se convertit en « Trouvé 0 résultats pour exemple de recherche ».

Voici un exemple d'implémentation complète des Shortcodes qui recherche dans un moteur supplémentaire nommé 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

Vous pouvez personnaliser les attributs selon le tableau ci-dessus.

Journal des modifications

1.8.5

[Correction] L'attribut Label FOR ne correspondait pas à l'ID de l'entrée lors de l'utilisation d'une variable de recherche personnalisée.

1.8.4

[Nouveau] Ajout d'une option pour masquer le bouton de soumission.

1.8.3

[Nouveau] Compatibilité avec la recherche Ajax en direct.
[Amélioration] Le Shortcode searchwp_total_results prend en charge les personnalisations de texte.

1.8.2

[Correction] Empêche les erreurs dues à la récursion de Shortcode.
[Mise à jour] Mise à jour de l'outil de mise à jour.

1.8.1

[Correction] L'attribut posts_per_page n'était pas reflété lors de l'utilisation de SearchWP 4.

1.8.0

[Nouveau] Nouveau Shortcode searchwp_search_results_paginate_links pour les liens paginés.
[Nouveau] Nouveau Shortcode searchwp_search_result_image pour l'affichage de l'image mise en avant du résultat.
[Nouveau] Nouveau Shortcode searchwp_search_result_permalink pour l'affichage du permalien du résultat.
[Mise à jour] Mise à jour de l'outil de mise à jour.

1.7.0

[Nouveau] Compatibilité avec SearchWP 4.

1.6.1

[Correction] Problème de gestion des guillemets.

1.6

[Nouveau] Nouveau Shortcode : searchwp_total_results pour afficher le nombre total de résultats de recherche.
[Nouveau] Ajoute l'argument placeholder au Shortcode searchwp_search_form.
[Mise à jour] Mise à jour de l'outil de mise à jour.

1.5.4

[Correction] Vérifications supplémentaires pour empêcher la redéclaration de fonction dans des cas limites.
[Mise à jour] Mise à jour de l'outil de mise à jour.

1.5.3

[Nouveau] Nouveau filtre : searchwp_shortcodes_engine.
[Nouveau] Nouveau filtre : searchwp_shortcodes_paginate_links.
[Nouveau] Nouveau filtre : searchwp_shortcodes_pagination_prev.
[Nouveau] Nouveau filtre : searchwp_shortcodes_pagination_next.
[Mise à jour] Updater mis à jour.

1.5.1

[Nouveau] Nouveau Shortcode [searchwp_search_result_excerpt_global].
[Nouveau] Nouveau Shortcode [searchwp_search_result_excerpt_document].
[Amélioration] Échappement affiné pour mieux s’associer à la mise en surbrillance des termes.

1.5

[Amélioration] Prise en charge des mises à jour automatiques basées sur votre clé de licence SearchWP.

1.2.1

[Nouveau] Ajout d’un certain nombre d’actions lors de la sortie.

1.2

[Changement] Permettre la définition de la variable GET dans l’attribut Shortcode, entre autres choses.

1.1

[Correction] Correction d’un problème où les attributs n’étaient pas transmis au rappel du Shortcode.

1.0

Version initiale.