SearchWP Live Ajax Search

Beschreibung

Erfordert nicht SearchWP, nutzt es aber, sofern es verfügbar ist. Die vollständige Dokumentation findest du auf searchwp.com.

SearchWP Live Ajax Search ermöglicht eine AJAX-basierte Live-Suche für deine Suchformulare. SearchWP Live Ajax Search wurde als bester Freund des Entwicklers entwickelt. Es soll dir nicht im Weg stehen, aber dir gleichzeitig die Möglichkeit geben, alles individuell anzupassen. Es kann mit jedem WordPress-Theme verwendet werden und nutzt einen Template-Loader, um die Ergebnisse anzuzeigen. Dank des templatebasierten Ansatzes kannst du deine Implementierung von SearchWP Live Search nahtlos anpassen, ohne dich mit Dutzenden von unübersichtlichen Optionen herumschlagen zu müssen.

Funktioniert am besten mit SearchWP (SearchWP ist aber nicht erforderlich)

SearchWP Live Ajax Search verwendest du am besten in Verbindung mit SearchWP, dies ist aber nicht zwingend erforderlich. Wenn SearchWP installiert und aktiviert ist, kannst du SearchWP Live Ajax Search pro Suchformular so anpassen, dass es eine beliebige deiner Suchmaschinen verwendet.

Individuelle Anpassung

Du kannst die Implementierung von SearchWP Live Ajax Search in hohem Maße anpassen und eine beliebige Anzahl von Konfigurationen vornehmen, die durch den Entwickler festgelegt werden. Die Ergebnisse basieren auf einem Template-Loader, sodass SearchWP Live Ajax Search dir nicht in die Quere kommt und du in das Ergebnis-Template wie in jede andere WordPress-Themedatei schreiben kannst.

Alles wird durch das Hinzufügen eines einzigen HTML5-Datenattributs(data-swplive="true") in das Eingabefeld deines Suchformulars gesteuert. Dies geschieht auf magische Weise automatisch für alle Suchformulare, die mit get_search_form() erstellt werden.

Widget-Unterstützung

SearchWP Live Ajax Search beinhaltet ein Widget, mit dem du Live-Suchformulare überall dort einfügen kannst, wo du möchtest.

Screenshots

  • Ergebnis-Dropdown in SearchWP Live Ajax Search
  • Einstellungsseite in SearchWP Live Ajax Search
  • Formular-Einstellungsseite in SearchWP Live Ajax Search
  • Formular-Einbettungsoptionen in SearchWP Live Ajax Search

Blöcke

Dieses Plugin unterstützt 1 Block.

  • Search Form The best WordPress search you can find.

Installation

  1. Lade das Plugin herunter und entpacke die Dateien
  2. Lade searchwp-live-search in dein Verzeichnis ~/wp-content/plugins/ hoch
  3. Aktiviere das Plugin über das Menü „Plugins“ in WordPress
  4. Optionales Anpassen der Konfiguration: vollständige Dokumentation
  5. Optionales Anpassen des Ergebnis-Templates: vollständige Dokumentation

FAQ

Dokumentation?

Ja, natürlich! Vollständige Dokumentation

Wie füge ich eine Live-Suche zu meinem Suchformular hinzu?

SearchWP Live Ajax Search aktiviert sich automatisch in allen Suchformularen, die mit get_search_form() erstellt wurden. Das kannst du mit dem folgenden Filter verhindern:

add_filter( 'searchwp_live_search_hijack_get_search_form', '__return_false' );

Wenn du SearchWP Live Ajax Search manuell in einem individuellen Suchformular aktivieren möchtest, füge einfach das folgende Datenattribut zu der Eingabe hinzu, für die du einen Hook setzen möchtest: data-swplive="true"

Wie werden die Suchergebnisse generiert?

Standardmäßig verwendet SearchWP Live Ajax Search die SearchWP-Standardsuchmaschine, wenn du SearchWP einsetzt. Wenn du SearchWP nicht nutzt, werden die nativen Suchergebnisse von WordPress angezeigt. Wenn du die von SearchWP verwendete Suchmaschine anpassen möchtest, füge einfach das folgende Attribut zur Formulareingabe hinzu: data-swpengine="supplemental". Ersetze „supplemental“ durch den Namen der von dir gewünschten Suchmaschine.

Wie kann ich das Ergebnis-Template anpassen?

SearchWP Live Ajax Search verwendet einen Template-Loader. Im Plugin-Ordner findest du einen Ordner Templates, der die Datei search-results.php enthält — sie wird standardmäßig für die Ausgabe der Suchergebnisse verwendet. Um die Ausgabe anzupassen, erstellst du einfach einen Ordner namens searchwp-live-ajax-search in deinem Theme-Verzeichnis und kopierst search-results.php in diesen Ordner. SearchWP Live Ajax Search verwendet dann diese Datei anstelle der Datei, die mit dem Plugin geliefert wird. Du kannst sie wie andere Template-Dateien eines Themes anpassen.

SearchWP Live Ajax Search gibt außerdem zwei Sätze von Stilen aus. Der erste Satz von Stilen dient dazu, den Ergebnis-Wrapper richtig zu positionieren. Der zweite Satz von Stilen steuert das visuelle Erscheinungsbild. Diese Abstraktion wurde vorgenommen, um sicherzustellen, dass die Anpassung so einfach wie möglich ist. Du kannst das Standard-„Theme“ deaktivieren, indem du das entsprechende Stylesheet aus der Warteschlange entfernst. Die zugrundeliegenden CSS kannst du ebenfalls deaktivieren. Weitere Informationen findest du in der Dokumentation.

Wie kann ich den Spinner anpassen?

SearchWP Live Ajax Search verwendet einen Filter – searchwp_live_search_configs – mit dem du die verwendete Konfiguration vollständig anpassen kannst. Füge einfach einen neuen Schlüssel zu dem Array hinzu, das durch diesen Filter übergeben wird, und passe die Standardwerte entsprechen deiner Wünsche an.

Rezensionen

8. Juli 2024 1 Antwort
After initially a bad experience with support, since they have been extremely helpful with this plugin and have provided code and knowledge bases to help do the things we want
20. Dezember 2023 1 Antwort
Установил, активировал. Вроде работает, будем разбираться.
18. Dezember 2023 1 Antwort
Great job to the developer! This is amazing. The customization options have been thought through incredibly well.
16. Mai 2023
data-swpengine attribute was exactly what I was looking for, I’ve should come here much earlier 🙂
Alle 34 Rezensionen lesen

Mitwirkende & Entwickler

„SearchWP Live Ajax Search“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:

Mitwirkende

„SearchWP Live Ajax Search“ wurde in 5 Sprachen übersetzt. Danke an die Übersetzerinnen und Übersetzer für ihre Mitwirkung.

Übersetze „SearchWP Live Ajax Search“ in deine Sprache.

Interessiert an der Entwicklung?

Durchstöbere den Code, sieh dir das SVN Repository an oder abonniere das Entwicklungsprotokoll per RSS.

Änderungsprotokoll

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

  • Verhindert in einigen Fällen Probleme mit Caching-Plugins.
  • Ermöglicht das Laden eines individuellen Templates aus einem angegebenen Verzeichnispfad.

1.8.2

  • Repariert die Integration mit Relevanssi Premium.

1.8.1

  • Behebt falsche Ergebnisse, die bei der Verwendung eines individuellen Templates für die Live-Suche in einigen Fällen auftraten.

1.8.0

  • Fügt Suchformulare hinzu.
  • Fügt Unterstützung für individuelle SearchWP-Suchquellen hinzu.
  • Verbessert bestehende und fügt neue Anpassungen auf der Einstellungsseite für Live Ajax Search hinzu.
  • Aktualisiert die Übersetzungsdateien.
  • Korrigiert die Position des Links „Einstellungen“ in der Plugin-Liste, wenn SearchWP aktiviert ist.

1.7.6

  • Ändert das Aussehen der Einstellungsseite und die Menüstruktur so, dass sie nahtlos mit einer aktuellen Version von SearchWP funktionieren.

1.7.5

  • Ändert den visuellen Stil der Einstellungsseite im Adminbereich, um sie an die aktuelle Version von SearchWP anzupassen.

1.7.4

  • Behebt, dass der Button „Erweiterte Einstellungen“ des Widgets in manchen Fällen verschwindet, ohne dass die Einstellungen angezeigt werden.
  • Behebt das Überschreiben des Body-Inhalts, wenn das individuelle übergeordnete Element in der Konfiguration festgelegt ist.

1.7.3

  • Fügt ein Benachrichtigungssystem innerhalb des Plugins hinzu, um die neuesten Aktualisierungen von SearchWP zu erhalten.

1.7.2

  • Fügt eine Kompatibilität mit der kommenden Version des SearchWP Modal Search Form Plugins hinzu.
  • Behebt ein Problem mit einer veralteten Version des Plugins SearchWP.

1.7.1

  • Korrigiert die Übersetzungen des Plugins.

1.7.0

  • Fügt eine neue Admin-Seite „Einstellungen“ hinzu, um das Verhalten des Plugins einfacher zu steuern.
  • Führt ein umfangreiches Code-Refactoring ein, um die Leistung zu verbessern.

1.6.3

  • Verbessert die Bereinigung des Suchfeld-Arguments „swpengine“.
  • Vereinheitlicht die direkten Zugriffsbeschränkungen in Klassen im gesamten Plugin.

1.6.2

  • Schränkt die Argumente ein, die der Abfrage übergeben werden, wenn sie mit der nativen Suche von WordPress verwendet wird.

1.6.1

  • Behebt PHP-Hinweise, die in Version 1.6.0 aufgetaucht sind

1.6.0

  • Fügt Unterstützung für den Suchformular-Block im Block-Editor (Gutenberg) hinzu

1.5.0

  • Fügt Unterstützung für die Abfragevariablen post_status, post_type und posts_per_page hinzu, wenn SearchWP nicht verwendet wird
  • Aktualisiert die Übersetzungsquelle, aktualisiert die Übersetzungen mit einer festgelegten Textdomain
  • Bundle-Prozess überarbeitet
  • Aktualisiert Bundle-Abhängigkeiten

1.4.6

  • Fügt Kompatibilität für SearchWP 4 hinzu

1.4.5

  • Behebt ein Problem mit der Unterstützung von Ausdrücken in Anführungszeichen
  • Behebt ein Problem mit Beitragstypen, die von der Suche ausgeschlossen werden, wenn sie registriert sind (gilt nur für Suchen mit SearchWP)

1.4.4

  • Behebt ein Problem mit bundle.js, das in einigen Fällen auftrat

1.4.3

  • Verbessert die Kompatibilität von SearchWP durch Unterdrückung von Filtern, wenn SearchWP die Suche durchführt
  • Korrigiert die Kompatibilität mit SearchWP Modal Search Form

1.4.2

  • Behebt ein Problem (JavaScript-Fehler), wenn eine individuelle Konfiguration den Spinner deaktiviert

1.4.1

  • Behebt ein Problem, das die korrekte Anwendung von individuellen Anpassungen des Spinners verhindert haben könnte

1.4

  • Entfernt den Beitragstyp aus dem Standard-Template für Ergebnisse
  • Behebt ein Problem mit HTML-Entities in der Zeichenfolge des Suchbegriffs
  • Aktualisiert die Übersetzungsquelle und die Übersetzungen
  • Aktualisiert den Build-Prozess des Bundlers
  • Aktualisiert die Zugänglichkeit, wo anwendbar
  • Bricht nicht abgeschlossene Suchen automatisch ab, wenn die Sucheingabe geändert wird

1.3.1

  • Behebt Tippfehler im Funktionsaufruf des Templates für Ergebnisse

1.3.0

  • Zahlreiche Verbesserungen der Zugänglichkeit (Danke an @geoffreycrofte)
  • Fügt eine Nachricht hinzu, wenn die Mindestanzahl an Zeichen nicht erreicht wurde
  • Deutsche Übersetzung hinzugefügt (Danke an @stefan-meier)
  • Polnische Übersetzung hinzugefügt (Danke an @boguslawski-piotr)
  • Niederländische Übersetzung hinzugefügt (Danke an Stefan G.)
  • Übersetzungsquelle aktualisiert

1.2.0

  • Überarbeiteter Build-Prozess für mehr Einfachheit
  • Unterstützung von Skript-Debugging (Danke an mgratch)
  • Anforderung für Formularaktionen wurde entfernt, um eine bessere Integration mit anderem Code zu ermöglichen (Danke an mgratch)
  • Ein Problem wurde behoben, das verhinderte, dass die Suche ausgelöst wurde, wenn sie zu schnell erneut eingegeben wurde (Danke an pierrestoffe)

1.1.8

  • Konfigurationsoption wurden hinzugefügt, um den AJAX-Abbruch zu verhindern, wenn die Enter-Taste gedrückt wird
  • Einige Aktionen wurden hinzugefügt, um die Anpassung zu vereinfachen
  • Ein Filter wurde hinzugefügt, um den Ort des Ergebnis-Templates anzupassen

1.1.7

  • Ein Problem mit einem fehlenden Suchmaschinen-Namen wurde behoben

1.1.6

  • Ein Problem wurde behoben, das verhinderte, dass mehrere Live-Suchinstanzen auf einer Seite verschiedene Suchmaschinen verwenden konnten

1.1.5

  • Ein Problem wurde behoben, bei dem results_destroy_on_blur nicht richtig angewendet wurde, wenn eine individuelle Konfiguration verwendet wurde, die Eigenschaft aber nicht in der individuellen Konfiguration definiert war

1.1.4

  • Eine Reihe von JavaScript-Ereignissen wurde hinzugefügt, um weitere Erweiterungen/Integrationen zu erleichtern

1.1.3

  • Ein Problem mit dem Build-Prozess wurde behoben, durch das eine veraltete Version der JavaScript-Assets des Plugins aufgetreten ist

1.1.2

  • Ergebnisse sind nicht mehr auf eingebaute Inhaltstypen beschränkt
  • Die Konfigurationsoption results_destroy_on_blur wurde hinzugefügt, um das automatische Entfernen des Ergebnisfensters zu verhindern, wenn außerhalb des Ergebnisfensters geklickt wird

1.1.1

  • Ein Problem wurde behoben, das verhinderte, dass SearchWP Supplemental-Suchmaschinen in der Widget-Konfiguration angezeigt wurden
  • Französische Übersetzung hinzugefügt
  • Serbische Übersetzung hinzugefügt

1.1

  • Definiert den Standard-Beitragsstatus bei der Verwendung der nativen WordPress-Suche
  • Neuer Filter searchwp_live_search_query_args, um Abfrage-Argumente vor der Suche zu manipulieren
  • Ein Versatz bei der Positionierung der Ergebnisse oben im Suchfeld wurde behoben

1.0.6

  • Bereinigung von PHP-Warnungen

1.0.5

  • Neue Aktion: searchwp_live_search_alter_results
  • Fügt Unterstützung für Relevanssi hinzu (basierend auf Daves Implementierung von WordPress Live Search)

1.0.4

  • Der Name des Standardordners für das Ergebnis-Template wurde korrigiert und lautet nun searchwp-live-ajax-search, wie in der Dokumentation angegeben
  • Verbesserung: Ausblenden der Ergebnisbox, wenn die Abfrage geleert wird (Danke an Lennard Voogdt)
  • Ein Problem wurde behoben, bei dem Medien bei Integration mit SearchWP nicht in den Ergebnissen angezeigt wurden

1.0.3

  • Ein Problem wurde behoben, bei dem eine falsche Reihe ohne Ergebnisse zurückgegeben wurde (Danke an Lennard Voogdt)

1.0.2

  • Ein Problem wurde behoben, bei dem das Drücken von Eingabetaste/Return verhinderte, dass die Suchanfrage an die Ergebnisseite übergeben wurde
  • Mögliche False Positives für DOING_AJAX wurden behoben (Danke an justinsainton)
  • Unnötiger Aufruf von get_the_ID() im Standard-Ergebnis-Template wurde entfernt (Danke an justinsainton)
  • Escaping für Permalink und Inhaltstyp-Namen im Standard-Ergebnis-Template wurde hinzugefügt (Danke an justinsainton)
  • Ein übersetzter String aus dem WordPress-Kern wird anstelle eines individuellen Strings verwendet (Danke an justinsainton)
  • Die Priorität für den Filter get_search_form wurde erhöht, um die bestehenden Filter zu berücksichtigen

1.0.2

  • Serbo-kroatische Übersetzung hinzugefügt (Danke an Andrijana Nikolic)

1.0.1

  • Ein Problem mit der Verzeichnis-URL wurde behoben
  • Ein indexOf-JavaScript-Fehler wurde behoben

1.0

  • Erste Veröffentlichung!