Opis
Nie wymaga wtyczki SearchWP, ale korzysta z niej, gdy jest dostępna. Pełną dokumentację można znaleźć na stronie searchwp.com.
SearchWP Live Ajax Search umożliwia wyszukiwanie live w formularzach wyszukiwania przy użyciu technologii AJAX. Wtyczka SearchWP Live Ajax Search ma być najlepszym przyjacielem dewelopera, dlatego stara się nie przeszkadzać, ale jednocześnie pozwala dostosować każdy aspekt swojego działania. Z założenia współpracuje z dowolnym motywem WordPressa, a do wyświetlania wyników używa programu wczytującego szablony. Podejście oparte na szablonach umożliwia płynne dostosowywanie implementacji wtyczki SearchWP Live Search bez przebijania się przez gąszcz kilkudziesięciu opcji.
Optymalne działanie z wtyczką SearchWP (która jednak nie jest niezbędna)
Wtyczki SearchWP Live Ajax Search najlepiej używa się w połączeniu z SearchWP, ale nie jest to wymagane. Jeśli wtyczka SearchWP jest zainstalowana i włączona, wtyczkę SearchWP Live Ajax Search można dostosować tak, aby korzystała z dowolnej wyszukiwarki w każdym formularzu wyszukiwania osobno.
Dostosowywanie
Implementację wtyczki SearchWP Live Ajax Search można w znacznym stopniu dostosować, w tym przy użyciu dowolnej liczby konfiguracji zdefiniowanych przez dewelopera. Wyniki są oparte na programie wczytującym szablony, dzięki czemu SearchWP Live Ajax Search w niczym nie przeszkadza i pozwala opracować szablon wyników tak jak każdy inny plik motywu WordPressa.
Wszystko opiera się na dodaniu jednego atrybutu danych HTML5 (data-swplive="true"
) do pola wejściowego formularza wyszukiwania. W przypadku wszystkich formularzy wyszukiwania wygenerowanych za pomocą funkcji get_search_form()
dzieje się to automagicznie.
Obsługa widżetu
Wtyczka SearchWP Live Ajax Search jest dostarczana z widżetem, który umożliwia wstawianie formularzy wyszukiwania live w dowolnym miejscu.
Zrzuty ekranu
Bloki
Wtyczka dodaje 1 blok.
- Search Form The best WordPress search you can find.
Instalacja
- Pobierz wtyczkę i rozpakuj pliki
- Prześlij katalog
searchwp-live-search
do katalogu~/wp-content/plugins/
- Włącz wtyczkę za pośrednictwem menu „Wtyczki” w WordPressie
- Opcjonalnie dostosuj konfigurację: pełna dokumentacja
- Opcjonalnie dostosuj szablon wyników: pełna dokumentacja
Najczęściej zadawane pytania
-
Dokumentacja?
-
Oczywiście! Pełna dokumentacja
-
Jak dodać wyszukiwanie live do formularza wyszukiwania?
-
SearchWP Live Ajax Search automatycznie włącza się we wszystkich formularzach wyszukiwania wygenerowanych za pomocą funkcji
get_search_form()
. Można temu zapobiec przy użyciu następującego filtru:add_filter( 'searchwp_live_search_hijack_get_search_form', '__return_false' );
Jeśli chcesz ręcznie włączyć wtyczkę SearchWP Live Ajax Search we własnym formularzu wyszukiwania, dodaj następujący atrybut danych do odpowiedniego elementu
input
:data-swplive="true"
-
Jak są generowane wyniki wyszukiwania?
-
Domyślnie SearchWP Live Ajax Search korzysta z domyślnej wyszukiwarki SearchWP, jeśli używasz wtyczki SearchWP. Jeśli nie masz SearchWP, dostarczane są natywne wyniki wyszukiwania z WordPressa. Jeśli chcesz dostosować wyszukiwarkę używaną przez wtyczkę SearchWP, dodaj następujący atrybut do elementu
input
formularza:data-swpengine="supplemental"
, zastępując element „supplemental” nazwą preferowanej wyszukiwarki. -
Jak dostosować szablon wyników?
-
SearchWP Live Ajax Search korzysta z programu wczytującego szablony. W katalogu wtyczki znajdziesz katalog
templates
, który zawiera pliksearch-results.php
– on właśnie służy standardowo do wyświetlania wyników wyszukiwania. Aby dostosować wyprowadzane przez niego dane wyjściowe, po prostu utwórz katalog o nazwiesearchwp-live-ajax-search
w katalogu motywów i skopiuj do tego katalogu pliksearch-results.php
. SearchWP Live Ajax Search będzie następnie używać tego pliku zamiast pliku dostarczonego z wtyczką. Plik ten możesz dostosować tak samo jak inne pliki szablonów motywu.SearchWP Live Ajax Search generuje również dwa zestawy stylów. Podstawowy zestaw stylów po prostu przygotowuje kontener wyników, aby umożliwić jego prawidłowe spozycjonowanie. Drugi zestaw stylów kontroluje wygląd. To rozdzielenie zastosowano, aby maksymalnie uprościć dostosowywanie. Można wyłączyć domyślny „motyw”, usuwając odpowiedni arkusz stylów z kolejki, a także wyłączyć podstawowy arkusz CSS. Więcej informacji jest dostępnych w dokumentacji.
-
Jak dostosować spinner?
-
SearchWP Live Ajax Search korzysta z filtru –
searchwp_live_search_configs
– który pozwala w pełni dostosować używaną konfigurację. Wystarczy dodać nowy klucz do tablicy przekazywanej przez ten filtr, dowolnie dostosowując wartościdefault
.
Recenzje
Kontrybutorzy i deweloperzy
„SearchWP Live Ajax Search” jest oprogramowaniem open source. Poniższe osoby miały wkład w rozwój wtyczki.
ZaangażowaniWtyczka „SearchWP Live Ajax Search” została przetłumaczona na 5 języków. Podziękuj tłumaczom za ich wkład.
Przetłumacz wtyczkę “SearchWP Live Ajax Search” na swój język.
Interesuje cię rozwój wtyczki?
Przeglądaj kod, sprawdź repozytorium SVN lub czytaj dziennik rozwoju przez RSS.
Rejestr zmian
1.8.3
- Wyeliminowano problemy z wtyczkami do buforowania, które występowały w niektórych przypadkach.
- Dodano możliwość wczytania własnego szablonu z określonej przez użytkownika ścieżki katalogu.
1.8.2
- Naprawiono integrację z Relevanssi Premium.
1.8.1
- Naprawiono niepoprawne wyniki występujące w niektórych przypadkach podczas korzystania z własnego szablonu wyszukiwania live.
1.8.0
- Dodano formularze wyszukiwania.
- Dodano obsługę własnych źródeł wyszukiwania z wtyczki SearchWP.
- Ulepszono istniejące i dodano nowe dostosowania na stronie ustawień wtyczki Live Ajax Search.
- Zaktualizowano pliki tłumaczeń.
- Naprawiono lokalizację odnośnika Ustawienia na liście wtyczek w przypadku włączenia wtyczki SearchWP.
1.7.6
- Zmieniono wygląd strony ustawień i strukturę menu, aby zapewnić bezproblemową współpracę z aktualną wersją wtyczki SearchWP.
1.7.5
- Zmieniono styl wizualny strony ustawień administratora, aby pasował do aktualnej wersji wtyczki SearchWP.
1.7.4
- Naprawiono występujące w niektórych przypadkach znikanie przycisku ustawień zaawansowanych widżetu bez wyświetlania ustawień.
- Naprawiono nadpisywanie treści w przypadku ustawienia w konfiguracji własnego elementu nadrzędnego.
1.7.3
- Dodano system powiadomień wtyczki, aby umożliwić otrzymywanie najnowszych aktualizacji z wtyczki SearchWP.
1.7.2
- Dodano zgodność z nadchodzącą wersją wtyczki SearchWP Modal Search Form.
- Rozwiązano problem ze starszą wersją wtyczki SearchWP.
1.7.1
- Naprawiono tłumaczenia wtyczki.
1.7.0
- Dodano nową stronę administratora Ustawienia, aby umożliwić łatwiejsze kontrolowanie sposobu działania wtyczki.
- Wprowadzono znaczącą modyfikację kodu w celu polepszenia wydajności.
1.6.3
- Poprawiono sanityzację argumentu pola wyszukiwania „swpengine”.
- Ujednolicono ograniczenia dostępu bezpośredniego obowiązujące w klasach w całej wtyczce.
1.6.2
- Ograniczono argumenty przekazywane do zapytania w przypadku korzystania z natywnego wyszukiwania WordPressa.
1.6.1
- Naprawiono powiadomienie PHP wprowadzone w wersji 1.6.0
1.6.0
- Dodano obsługę bloku formularza wyszukiwania w edytorze bloków (Gutenberg)
1.5.0
- Dodano obsługę zmiennych zapytania post_status, post_type i posts_per_page w przypadku niekorzystania z wtyczki SearchWP
- Zaktualizowano źródło tłumaczeń, zaktualizowano tłumaczenia z poprawioną domeną tekstową
- Zmodyfikowano proces pakietu
- Zaktualizowano zależności pakietu
1.4.6
- Dodano zgodność z wtyczką SearchWP 4
1.4.5
- Rozwiązano problem z obsługą fraz cytowanych
- Rozwiązano problem z typami wpisów, które są wykluczane z wyszukiwania po zarejestrowaniu (dotyczy tylko wyszukiwania za pomocą wtyczki SearchWP)
1.4.4
- Rozwiązano problem z plikiem bundle.js występujący w niektórych przypadkach
1.4.3
- Poprawiono zgodność z wtyczką SearchWP przez blokowanie filtrów, gdy SearchWP wykonuje wyszukiwanie
- Poprawa zgodności z wtyczką SearchWP Modal Search Form
1.4.2
- Rozwiązano problem (błąd JavaScript) występujący, gdy konfiguracja własna wyłącza spinner
1.4.1
- Rozwiązano problem, który mógł uniemożliwiać prawidłowe stosowanie dostosowań spinnera
1.4
- Usunięto typ wpisu z domyślnego szablonu wyników
- Rozwiązano problem z encjami HTML w wyszukiwanym ciągu znaków
- Zaktualizowano źródło tłumaczeń i tłumaczenia
- Zaktualizowano proces kompilacji bundlera
- Zaktualizowano dostępność w stosownych przypadkach
- Oczekujące wyszukiwania są automatycznie anulowane po zmianie danych wejściowych wyszukiwania
1.3.1
- Poprawiono literówkę w wywołaniu funkcji szablonu wyników
1.3.0
- Wiele ulepszeń dostępności (podziękowania dla @geoffreycrofte)
- Dodano komunikat w przypadku nieosiągnięcia minimalnej liczby znaków
- Dodano tłumaczenie na język niemiecki (podziękowania dla @stefan-meier)
- Dodano tłumaczenie na język polski (podziękowania dla @boguslawski-piotr)
- Dodano tłumaczenie na język niderlandzki (podziękowania dla Stefana G.)
- Zaktualizowane źródło tłumaczeń
1.2.0
- Zmodyfikowano proces kompilacji, aby był prostszy
- Obsługa debugowania skryptów (podziękowania dla mgratch)
- Usunięto wymóg działania formularza w celu polepszenia integracji z innym kodem (podziękowania dla mgratch)
- Rozwiązano problem, który uniemożliwiał uruchomienie wyszukiwania po zbyt szybkim ponownym wejściu (podziękowania dla pierrestoffe)
1.1.8
- Dodano opcję konfiguracji zapobiegającą anulowaniu funkcji AJAX po naciśnięciu klawisza Enter
- Dodano kilka działań ułatwiających dostosowywanie
- Dodano filtr umożliwiający dostosowanie lokalizacji szablonu wyników
1.1.7
- Rozwiązano problem z brakującą nazwą wyszukiwarki
1.1.6
- Rozwiązano problem, który uniemożliwiał wielu instancjom wyszukiwania live na jednej stronie korzystanie z różnych wyszukiwarek
1.1.5
- Rozwiązano problem, w wyniku którego właściwość
results_destroy_on_blur
nie była poprawnie stosowana, jeśli używana była konfiguracja własna, ale ta właściwość nie była w niej zdefiniowana
1.1.4
- Dodano szereg zdarzeń JavaScript, aby ułatwić dalszą rozbudowę/integrację
1.1.3
- Rozwiązano problem z procesem kompilacji, który wprowadzał nieaktualną wersję zasobów JavaScript wtyczki
1.1.2
- Wyniki nie ograniczają się już do wbudowanych typów wpisów
- Dodano opcję konfiguracji
results_destroy_on_blur
, aby zapobiec automatycznemu usuwaniu okna wyników po kliknięciu poza panelem wyników
1.1.1
- Rozwiązano problem, który uniemożliwiał wyświetlanie uzupełniających wyszukiwarek SearchWP w konfiguracji widżetu
- Dodano tłumaczenie na język francuski
- Dodano tłumaczenie na język serbski
1.1
- Zdefiniowano domyślne statusy wpisów w przypadku korzystania z natywnego wyszukiwania WordPressa
- Nowy filtr
searchwp_live_search_query_args
umożliwiający manipulowanie argumentami zapytania przed wyszukiwaniem - Naprawiono przesunięcie związane z pozycjonowaniem wyników u góry pola wyszukiwania
1.0.6
- Czyszczenie ostrzeżeń PHP
1.0.5
- Nowe działanie:
searchwp_live_search_alter_results
- Dodano obsługę Relevanssi (zgodnie z implementacją WordPress Live Search wykonaną przez Dave’a)
1.0.4
- Poprawiono nazwę katalogu domyślnego szablonu wyników na
searchwp-live-ajax-search
zgodnie z dokumentacją - Ulepszenie: ukrywanie pola wyników w przypadku opróżnienia zapytania (podziękowania dla Lennarda Voogdta)
- Rozwiązano problem, w wyniku którego w przypadku integracji z wtyczką SearchWP w wynikach nie były wyświetlane media
1.0.3
- Rozwiązano problem, w wyniku którego zwracany był fałszywy zestaw braku wyników (podziękowania dla Lennarda Voogdta)
1.0.2
- Rozwiązano problem polegający na tym, że naciśnięcie klawisza Enter/Return uniemożliwiało przekazanie zapytania wyszukiwania na stronę wyników
- Naprawiono wynik fałszywie dodatni mogący występować w przypadku stałej DOING_AJAX (podziękowania dla justinsainton)
- Usunięto niepotrzebne wywołanie funkcji get_the_ID() w domyślnym szablonie wyników (podziękowania dla justinsainton)
- Dodano obsługę znaków ucieczki do bezpośredniego odnośnika i nazwy typu wpisu w domyślnym szablonie wyników (podziękowania dla justinsainton)
- Wykorzystanie przetłumaczonego ciągu z rdzenia WordPressa zamiast ciągu własnego (podziękowania dla justinsainton)
- Zwiększono priorytet filtra get_search_form w celu uwzględnienia istniejących filtrów
1.0.2
- Dodano tłumaczenie na język serbsko-chorwacki (podziękowania dla Andrijany Nikolic)
1.0.1
- Rozwiązano problem z adresem URL katalogu
- Naprawiono błąd indexOf (JavaScript)
1.0
- Pierwsze wydanie!