Przejdź do treści
Poradniki

Wyszukiwanie AJAX bez wtyczki WordPress

WordPress oferuje proste wbudowane wyszukiwanie, którego możesz użyć na swojej stronie. Bardziej eleganckie i szybsze jest wyszukiwanie AJAX, dzięki któremu wyniki ładują się bez przeładowania całej strony.

Ajaxové vyhľadávanie bez WordPress pluginu

WordPress oferuje proste wbudowane wyszukiwanie, którego możesz użyć na stronie, niezależnie od tego, czy tworzysz ją w edytorze wizualnym, czy kupiłeś motyw WordPress. Wpisujesz szukane słowo lub całą frazę, a na stronie wyników wyświetlają się wszystkie pasujące strony, wpisy itp.

Bardziej elegancki i szybszy sposób wyszukiwania na stronie umożliwia AJAX, który ładuje wyniki bez przeładowania całej strony. W tym poradniku pokażę Ci, jak stworzyć wyszukiwanie AJAX bez instalowania kolejnej wtyczki WordPress, z użyciem PHP, AJAX i jQuery. Nie musisz się niczego obawiać, nawet jeśli nie umiesz programować. Cały kod i to, gdzie go wkleić, opiszę tak, by poradził sobie nawet początkujący bez doświadczenia w programowaniu.

Obrazek pod tym akapitem pokazuje podgląd gotowego wyszukiwania z tego poradnika. Dzięki komentarzom w kodzie część rzeczy dostosuje nawet zwykły użytkownik WordPressa, który nie programuje. Większe zmiany wymagają jednak przynajmniej znajomości PHP.

Własne wyszukiwanie AJAX bez wtyczki WordPress
Przykładowe wyniki własnego wyszukiwania AJAX na stronie WordPress

Czym jest AJAX?

AJAX (Asynchronous JavaScript and XML) to technika tworzenia stron, która pozwala odwiedzającym korzystać ze strony bez przeładowywania jej w całości. Dzięki temu dane, o które prosimy serwer przez AJAX, ładują się szybciej, bo nie trzeba wczytywać pozostałych części strony (np. nagłówka, stopki, ...).

Zaletą AJAX jest szybkie ładowanie żądanych danych i mniejsze obciążenie serwera, który przetwarza mniej danych, co pozwala też zaoszczędzić pieniądze, które dopłacałbyś firmie hostingowej za większą wydajność. Nie bez znaczenia jest też lepsze doświadczenie użytkownika na Twojej stronie.

Więcej o AJAX w kontekście WordPressa przeczytasz tutaj.

Możliwości i funkcje wyszukiwania AJAX

Ponieważ to wyszukiwanie AJAX będzie napisane ręcznie, można je dowolnie dostosować do potrzeb. Nie ograniczają Cię skromne ustawienia dostępnych wtyczek – masz pełną kontrolę nad kodem.

  1. Dopasowanie w tytule, zajawce i treści – Po wyszukaniu słowa/frazy wyświetlą się wyniki na podstawie pełnego lub częściowego dopasowania w tytule, zajawce lub treści wszystkich typów wpisów (wybranych w kodzie).
  2. Dowolny wybór typów wpisów – To od Ciebie zależy, co obejmie wyszukiwanie: tylko strony, wpisy, produkty, czy wszystko razem. Możesz wybrać dowolny typ wpisów, łącznie z własnymi typami treści (CPT).
  3. Dostosowanie wyników wyszukiwania – Dzięki pełnej kontroli nad kodem sam decydujesz, co pojawi się w wynikach. Tylko tytuł wpisu, czy także obrazek wyróżniający lub kategorie?
  4. Komunikat podczas przetwarzania żądania – Po wyszukaniu słowa/frazy żądanie trafia na serwer, który je przetwarza i odsyła wyniki. W tym czasie pod polem wyszukiwania wyświetla się tekst „Szukam...”.
Wyszukiwanie AJAX - Szukam...
Przykład wyszukiwania AJAX - trwa wyszukiwanie wyników
  1. Callback, gdy nie ma dopasowania – Jeśli wyszukiwanie nie da żadnego trafnego wyniku, wyświetli się tekst „Nic nie znaleziono”.
Wyszukiwanie AJAX - nic nie znaleziono
Przykład wyszukiwania AJAX - komunikat nic nie znaleziono

Własne wyszukiwanie AJAX - kod i kroki

Najpierw utwórz prosty formularz wyszukiwania z polem tekstowym i przyciskiem.

<form action="/" method="get" autocomplete="off">
	<input type="text" name="s" autofocus placeholder="Vyhľadať zľavu..." id="keyword" class="input_search"> <!-- vyhľadávacie políčko -->
	<button> <!-- Tlačidlo, ktorým zabezpečíte klasické WordPress vyhľadávanie. -->
		Hľadať
	</button>
</form>
<div class="search_result" id="datafetch"></div> <!-- V tomto div elemente sa zobrazia výsledky vyhľadávania -->

Ten formularz możesz umieścić w dowolnym miejscu strony. Jeśli tworzysz stronę w edytorach wizualnych (page builderach), takich jak Divi Builder, Breakdance, Elementor czy Oxygen Builder, możesz wstawić kod HTML przez moduł code block.

W motywach WordPress zwykle nie da się dodać kodu HTML bezpośrednio, więc najlepiej zainstalować motyw potomny i za pomocą hooka umieścić kod HTML w wybranym miejscu strony. Cały kod wklej do pliku functions.php aktywnego motywu potomnego. Zamiast motywu potomnego możesz też zainstalować wtyczkę WordPress Code Snippets (wersja darmowa) i wkleić cały kod do niej.

WSKAZÓWKA! Nie przegap zniżek na wtyczki WordPress i motywy WordPress.

Pole wyszukiwania wraz z wynikami ostylowałem poniższym CSS. Możesz go dowolnie dostosować.

/* Formulár na vyhľadávanie */
. search_bar form {
	Width: 100%;
	display: flex;
	gap: 10px;
	flex-wrap: nowrap;
}

/* Vyhľadávacie políčko */
.search_bar input  {
	padding: 8px 16px;
	width: calc(100% - 80px);
	color: #666666;
	border: 1px solid #666666;
	border-radius: 5px;
	outline: none;
}

/* Tlačidlo Hľadať */
 .search_bar button {
	background-color: white;
	padding: 8px 12px;
	color: #666666;
	border: 1px solid #666666;
	border-radius: 5px;
	cursor: pointer;
}

.search_bar button:hover {
	color: #0a5888; 
	border-color: #0a5888;
	transition-duration: 0.3s;
}

/* Div element, v ktorom sa zobrazia výsledky vyhľadávania */
div.search_result {
 	display: none;
}

/* UL - zoznam výsledkov */
div.search_result ul {
	list-style: none;
	padding: 15px;
	margin: 0;
}

/* Jednotlivé položky v zozname (výsledky) */
div.search_result ul li {
	color: white;
}

/* Jednotlivé výsledky vyhľadávania (napr. jeden článok) */
li.search-result-item {
	padding: 10px 0;
	border-bottom: 1px solid #666666;
}

/* Odkazy vo výsledkoch vyhľadávania */
li.search-result-item a {
	display: flex;
align-items: center;
justify-content: flex-start;
gap: 10px;
color: white;
}

li.search-result-item a:hover {
	color: #fd834c;
}

Na koniec potrzebny jest jeszcze jeden krok – dodanie głównej części kodu, która obsługuje wywołanie AJAX i wyświetlanie wyników. Do pliku functions.php w Twoim motywie potomnym wklej poniższy kod. Jak wspomniałem wyżej, możesz go też dodać przez wtyczkę Code Snippets.

<?php
add_action( 'wp_footer', 'ajax_fetch' ); // Hook, ktorý určuje že kód sa má načítať vo footri
function ajax_fetch() { ?>
<script type="text/javascript">
function debounce(func, delay) { // funkcia, ktorá zabezpečuje odosielanie požiadavky až po 600ms
  let timeoutId;
  return function() {
    const context = this;
    const args = arguments;
    clearTimeout(timeoutId);
    timeoutId = setTimeout(() => {
      func.apply(context, args);
    }, delay);
  };
}
jQuery("input#keyword").keyup(debounce(function() { // funkcia, ktorá zabezpečuje zobrazenie elementu s výsledkami vyhľadávania po napísaní aspoň 2 písme do inputu
	let keyword = jQuery(this).val().toLowerCase();
	if (keyword.length > 2) { // podmienka, ktorá zabezpečuje, aby sa požiadavky na server posielali, až keď sú napísané v inpute apsoň dve písmená
		jQuery('#datafetch').html('<ul><li>Hľadá sa ...</li></ul>'); // Hláška, ktorá sa zobrazí počas čakania na odpoveď servera
		jQuery.ajax({ // ajaxové volanie
			url: '<?php echo admin_url('admin-ajax.php'); ?>',
			type: 'post',
			data: { action: 'data_fetch', keyword: keyword },
			success: function(data) {
				jQuery('#datafetch').html(data);
			}
		});
		jQuery("#datafetch").show();
		jQuery("#datafetch").css('overflow', 'auto');
		jQuery(".search_bar").css('background-color', 'rgba(0,0,0,0.85)');
	} else {
		jQuery("#datafetch").hide();
		jQuery(".search_bar").css('background-color', 'rgba(0,0,0,0.10)');
	}
}, 600)); // hodnota, ktorá určuje po akom dlhom čase sa pošle požiadavka na server v milisekundách
</script>
<?php }

// ajax funkcia
add_action('wp_ajax_data_fetch', 'data_fetch'); // endpoint pre prihlásených používateľov
add_action('wp_ajax_nopriv_data_fetch', 'data_fetch'); // endpoint pre neprihlásených používateľov
function data_fetch(){
	$the_query = new WP_Query( 
		array( 'posts_per_page' => -1, // Počet výsledkov vyhľadávania (-1 = všetky relevantné výsledky vyhľadávania) 
			  's' => strtolower(esc_attr( $_POST['keyword'] )), 
			  'post_type' => array('page','post'), // Typy postu medzi ktorými sa bude vyhľadávať
			  'post_status' => 'publish', // Vyhľadávanie len medzi publikovanými príspevkami
			 ) 
	);
    if( $the_query->have_posts() ) :
        echo '<ul>';
        while( $the_query->have_posts() ): $the_query->the_post(); ?>
            <li class="search-result-item">
				<a href="<?php echo esc_url( get_permalink() ); ?>">
					<img src="<?php echo get_the_post_thumbnail_url($post_id); ?>" width="87.5px" height="50px"> // Ilustračný obrázok
					<div><?php the_title(); ?></div> // Titulok postu
				</a>
			</li>

        <?php endwhile;
       echo '</ul>';
		else : {
			echo '<ul><li>Nič sa nenašlo.</li></ul>'; // Hláška, ktorá sa zobrazí v prípade nulovej zhody
		}
        wp_reset_postdata();  
	endif;
    die();
}

Powyższy kod zapewnia:

  • Po wpisaniu co najmniej 3 liter w pole wyszukiwania i 600 ms przerwy po ostatnim znaku do serwera wysyłane jest asynchroniczne żądanie. Wyszukiwanie po jednej czy dwóch literach nie ma sensu – dopasowanie byłoby zbyt szerokie. Przerwa 600 ms pozwala spokojnie wpisać całe słowo/frazę, zanim pojawią się wyniki.
  • Wyświetlają się wyniki z wpisów i stron. Możesz to zmienić zależnie od tego, co ma obejmować wyszukiwanie. W kodzie 'post_type' => array('page','post') możesz zmienić 'page','post' na dowolny typ wpisu.

Mam nadzieję, że ten poradnik Ci pomoże, a wyszukiwanie AJAX ułatwi odwiedzającym znajdowanie treści na Twojej stronie.

Autor artykułu

Peter Dudák

Jestem twórcą i właścicielem serwisu wp-zlavy.sk, gdzie znajdziesz najwięcej promocji WordPress w jednym miejscu. Lubię harcerstwo, programowanie, WordPressa i wszystko, co z nim związane.