Shortcodes

Aktuelle Version: 1.8.5

Diese Erweiterung bietet Shortcodes, die sowohl Suchformulare als auch Ergebnisformulare für SearchWP-Suchmaschinen generieren. Dies ist nützlich, wenn Sie sich nicht wohl fühlen (oder nicht in der Lage sind), Theme-Dateien direkt zu bearbeiten, um Ihr(e) Suchformular(e) und Ergebnis-Loops zu implementieren.

Nach der Aktivierung von Shortcodes stehen Ihnen folgende zur Verfügung:

Shortcode	Attribut(e)
`searchwp_search_form` Gibt ein Suchformular für eine bestimmte Suchmaschine aus	`target` — Die Formularaktion (Standard ist der vorhandene Permalink) `engine` — Name der Suchmaschine (Standard ist `default`) `var` — Der Name der Suchanfragevariable (Standard ist `swpquery`) `button_text` — Text des Formularbuttons (Standard ist `Search`) `hide_button` — Entweder „true“ oder „false“, blendet den Submit-Button des Suchformulars aus `placeholder` — Platzhaltertext für die Formulareingabe (Standard ist `Search`) `live_search` — Entweder „true“ oder „false“, erzwingt die Aktivierung/Deaktivierung der Live-Ajax-Suche für dieses Formular, ignoriert den Wert der globalen Einstellung „Live-Suche aktivieren“
`searchwp_search_results` Gibt die Liste der Suchergebnisse aus, nachdem eine Suche gesendet wurde	`engine` — Name der Suchmaschine (Standard ist `default`) `var` — Der Name der Suchanfragevariable (Standard ist `swpquery`) `posts_per_page` — Wie viele Beiträge pro Seite angezeigt werden sollen Beachten Sie, dass dies kein sich selbst schließender Shortcode ist. Die Markup für jedes Suchergebnis sollte darin verschachtelt sein. Sehen Sie sich das folgende Beispiel an
`searchwp_search_result_link` Gibt einen Link zum aktuellen Suchergebnis mit dem Text des Titels des Ergebnisses aus	`direct` — Entweder „true“ oder „false“. Wenn true, wird direkt zum Permalink verlinkt. Wenn es sich um einen Anhang handelt, wird direkt zur URL verlinkt, nicht zur übergeordneten Seite
`searchwp_search_result_excerpt` Gibt den Auszug für das aktuelle Suchergebnis aus	Keine
`searchwp_search_results_none` Ausgabe, wenn keine Suchergebnisse gefunden wurden	Keine Beachten Sie, dass dies kein sich selbst schließender Shortcode ist. Die Markup für jedes Suchergebnis sollte darin verschachtelt sein. Sehen Sie sich das folgende Beispiel an
`searchwp_search_results_pagination` Gibt die Paginierung von Suchergebnissen aus	`engine` — Name der Suchmaschine (Standard ist `default`) `direction` — Entweder „prev“ oder „next“ `link_text` — Der Text, der im Link verwendet werden soll `var` — Der Name der Suchanfragevariable (Standard ist `swpquery`)
`searchwp_search_results_paginate_links` Gibt paginierte Links für Suchergebnisse aus	`engine` — Name der Suchmaschine (Standard ist `default`) `var` — Der Name der Suchabfragevariable (Standard ist `swpquery`) Zusätzlich zu den oben genannten Argumenten werden auch Argumente von `paginate_links` unterstützt.
`searchwp_search_result_image` Gibt das Beitragsbild für das aktuelle Ergebnis aus	`size` — Bildgröße (Standard ist `thumb`)
`searchwp_search_result_permalink` Gibt die Permalinks für das aktuelle Ergebnis mit dem Text des Permalinks des Ergebnisses aus	`direct` — Ob direkt zu Mediendateien verlinkt werden soll (Standard ist `'true'`)
`searchwp_total_results` Gibt die Gesamtzahl der Ergebnisse für die aktuelle Suche aus	`engine` — Name der Suchmaschine (Standard ist `default`) `var` — Der Name der Suchabfragevariable (Standard ist `swpquery`) `text` — Der Text, der neben der Anzahl der Ergebnisse verwendet werden soll. Unterstützt Platzhalter `%total%` und `%query%` für präzise Formatierung.`[searchwp_total_results text="Found %total% results for %query%"]` wird zu „Found 0 results for example search“.

Hier ist ein Beispiel für eine umfassende Implementierung von Shortcodes, die eine ergänzende Engine mit dem Namen my_test_engine durchsucht:

	<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

Sie können die Attribute gemäß der obigen Tabelle anpassen.

Änderungsprotokoll

1.8.5

[Fix] Label FOR-Attribut stimmt nicht mit der Eingabe-ID überein, wenn eine benutzerdefinierte Suchvariable verwendet wird.

1.8.4

[Neu] Option zum Ausblenden des Senden-Buttons hinzugefügt.

1.8.3

[Neu] Kompatibilität mit Live Ajax Search.
[Verbesserung] Der Shortcode searchwp_total_results unterstützt Textanpassungen.

1.8.2

[Fix] Fehler durch Shortcode-Rekursion verhindert.
[Update] Updater aktualisiert.

1.8.1

[Fix] posts_per_page-Attribut wird bei Verwendung von SearchWP 4 nicht berücksichtigt.

1.8.0

[Neu] Neuer Shortcode searchwp_search_results_paginate_links für paginierte Links.
[Neu] Neuer Shortcode searchwp_search_result_image für die Ausgabe des Beitragsbildes des Ergebnisses.
[Neu] Neuer Shortcode searchwp_search_result_permalink für die Ausgabe des Permalinks des Ergebnisses.
[Update] Updater aktualisiert.

1.7.0

[Neu] Kompatibilität mit SearchWP 4.

1.6.1

[Fix] Problem bei der Handhabung von Anführungszeichen.

1.6

[Neu] Neuer Shortcode: searchwp_total_results zur Ausgabe der Gesamtzahl der Suchergebnisse.
[Neu] Fügt das Argument placeholder zum Shortcode searchwp_search_form hinzu.
[Update] Updater aktualisiert.

1.5.4

[Fix] Zusätzliche Prüfungen zur Verhinderung von Randfall-Funktionsneudefinitionen.
[Update] Updater aktualisiert.

1.5.3

[Neu] Neuer Filter: searchwp_shortcodes_engine.
[Neu] Neuer Filter: searchwp_shortcodes_paginate_links.
[Neu] Neuer Filter: searchwp_shortcodes_pagination_prev.
[Neu] Neuer Filter: searchwp_shortcodes_pagination_next.
[Update] Aktualisierter Updater.

1.5.1

[Neu] Neuer Shortcode [searchwp_search_result_excerpt_global].
[Neu] Neuer Shortcode [searchwp_search_result_excerpt_document].
[Verbesserung] Verfeinertes Escaping, um besser mit Term Highlight zu harmonieren.

1.5

[Verbesserung] Unterstützung für automatische Updates basierend auf Ihrem SearchWP-Lizenzschlüssel.

1.2.1

[Neu] Eine Reihe von Aktionen während der Ausgabe hinzugefügt.

1.2

[Änderung] GET-Variable kann unter anderem im Shortcode-Attribut gesetzt werden.

1.1

[Korrektur] Ein Problem behoben, bei dem Attribute nicht an den Shortcode-Callback übergeben wurden.

1.0

Erste Veröffentlichung.