Přeskočit na obsah
Návody

Ajaxové vyhledávání bez WordPress pluginu

WordPress v základu nabízí jednoduché vyhledávání, které můžete použít na svém webu. Elegantnější a rychlejší je ajaxové vyhledávání, díky kterému se výsledky načtou bez nutnosti znovu načíst celou stránku.

Ajaxové vyhľadávanie bez WordPress pluginu

WordPress v základu nabízí jednoduché vyhledávání, které můžete použít na svém webu, ať už používáte vizuální editor pro tvorbu webu, nebo jste si koupili WordPress šablonu. Zadáte hledané slovo nebo celou frázi a na stránce výsledků se vám podle shody zobrazí všechny relevantní stránky, články apod.

Elegantnější a rychlejší způsob vyhledávání na webu umožňuje ajax, který zajistí načtení výsledků vyhledávání bez nutnosti znovu načíst celou stránku. V tomto návodu vám ukážu, jak vytvořit ajaxové vyhledávání bez instalace dalšího WordPress pluginu, s použitím PHP, ajaxu a jQuery. Nemusíte se ničeho bát, i když neumíte programovat. Celý kód i postup, jak a kam ho vložit, popíšu tak, aby to zvládl i začátečník bez zkušeností s programováním.

Obrázek pod tímto odstavcem ukazuje náhled celého vyhledávání podle tohoto návodu. Díky komentářům v kódu si některé věci dokáže přizpůsobit i běžný uživatel WordPressu, který neumí programovat. Některé větší změny a úpravy však vyžadují znalost alespoň PHP.

Vlastní ajaxové vyhledávání bez WordPress pluginu
Ukázka výsledků vlastního ajaxového vyhledávání na WordPress webu

Co je Ajax?

AJAX (Asynchronous JavaScript and XML) je technologie webového vývoje, která návštěvníkům umožňuje pracovat s webovou stránkou bez nutnosti načítat celou stránku. Díky tomu se výsledky, které si přes ajax vyžádáme ze serveru, načtou rychleji, protože se nemusí načítat zbylé části stránky (např. header, footer, ...).

Výhodou ajaxu je rychlé načtení požadovaných dat, nižší zátěž serveru, který musí zpracovat méně dat, čímž vám i šetří peníze, které byste doplatili webhostingové společnosti za vyšší výkon. A v neposlední řadě ajax přispívá i k lepšímu uživatelskému zážitku z vašeho webu.

Více informací o ajaxu v souvislosti s WordPressem najdete zde.

Možnosti a funkce ajaxového vyhledávání

Protože toto ajaxové vyhledávání bude naprogramované, půjde ho libovolně upravovat podle potřeby. Nebudou vás omezovat limitované možnosti nastavení dostupných pluginů. Máte plnou kontrolu nad kódem.

  1. Shoda s nadpisem, shrnutím a obsahem – Po vyhledání zadaného slova/fráze se zobrazí výsledky na základě úplné nebo částečné shody v nadpisu, shrnutí nebo obsahu ve všech typech příspěvků (které si zvolíte v kódu).
  2. Libovolný výběr typů příspěvků – Je jen na vás, co do vyhledávání zahrnete. Zda to budou jen stránky, články, produkty, nebo všechno dohromady. Vybrat si můžete jakýkoli typ příspěvků, včetně vlastních typů příspěvků (CPT).
  3. Přizpůsobení výsledků vyhledávání – Díky plné kontrole nad kódem si sami určíte, co všechno se bude ve výsledcích zobrazovat. Bude to jen nadpis příspěvku, nebo i ilustrační obrázek či příslušné kategorie?
  4. Hláška během zpracování požadavku – Po vyhledání slova/fráze se odešle požadavek na server, který ho zpracuje a podle hledaného slova/fráze pošle klientovi zpět výsledky. Během tohoto procesu se pod vyhledávacím polem zobrazí text „Hledá se...“.
Ajaxové vyhledávání - Hledá se...
Ukázka ajaxového vyhledávání - hledá se výsledek
  1. Callback, pokud neexistuje žádná shoda – Pokud podle hledání neexistuje žádná relevantní shoda, vypíše se text „Nic se nenašlo".
Ajaxové vyhledávání - nic se nenašlo
Ukázka ajaxového vyhledávání - hláška nic se nenašlo

Vlastní ajaxové vyhledávání - kódy a postup

Nejprve si vytvoříte jednoduchý vyhledávací formulář, který bude obsahovat textový input a tlačítko.

<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 -->

Tento formulář můžete umístit kamkoli na web. Pokud vytváříte web ve vizuálních editorech (page builderech), jako je Divi Builder, Breakdance, Elementor nebo Oxygen Builder, můžete HTML kód vložit přes modul code block.

U WordPress témat většinou nemáte možnost přidat HTML kód přímo a nejlepším řešením je nainstalovat si child téma a pomocí hooku umístit HTML kód na vybrané místo kdekoli na webu. Celý kód vložte do souboru functions.php aktivního child tématu. Jako alternativu k child tématu si můžete nainstalovat WordPress plugin Code Snippets (free verze) a vložit celý kód do něj.

TIP! Nezmeškejte slevy na WordPress pluginy a WordPress témata.

Vyhledávací pole i s výsledky vyhledávání jsem nastyloval následujícím CSS. CSS si můžete upravit podle svých představ.

/* 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;
}

Nakonec je potřeba ještě jeden krok – přidat hlavní část kódu, která zajišťuje ajaxové volání a zobrazení výsledků vyhledávání. Do souboru functions.php ve vašem child tématu vložíme následující kód. Jak jsem zmínil výše, alternativně ho můžete vložit přes plugin 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();
}

Výše uvedený kód zajistí následující:

  • Po napsání alespoň 3 písmen do vyhledávacího pole a pauze 600 ms po posledním znaku se odešle asynchronní požadavek na server. Nemá velký smysl hledat podle jednoho nebo dvou písmen – shoda by byla příliš široká. Pauza 600 ms zajišťuje, že v klidu dopíšete celé slovo/frázi a nestane se, že ještě píšete a už se vám zobrazují výsledky.
  • Zobrazí se výsledky z článků a stránek. Ty si můžete upravit podle toho, co všechno chcete do vyhledávání zahrnout. V kódu 'post_type' => array('page','post') můžete upravit 'page','post' na libovolný typ příspěvku.

Věřím, že vám tento návod pomůže a že toto ajaxové vyhledávání návštěvníkům zefektivní hledání obsahu na vašem webu.

Autor článku

Peter Dudák

Jsem tvůrce a provozovatel webu wp-zlavy.sk, kde najdete nejvíce WordPress slev na jednom místě. Baví mě skauting, programování, WordPress a všechno, co s ním souvisí.

  • Návody

    Jak nainstalovat a aktivovat WordPress šablonu?

    Chcete vědět, jak snadno a rychle nainstalovat šablonu do svého WordPressu? Pak jste na správném místě! V tomto článku vám krok za krokem ukážeme, že to není žádná věda, i když jste ve WordPressu úplný začátečník.

    · 7 min čtení

  • Novinky a změny cen

    Bricks Builder zvyšuje ceny

    Bricksbuilder.io oznámil týden před Black Friday zvýšení cen a zavedení ročních licencí. Podle informací zveřejněných na jejich webu jsou aktuální ceny na nejlepší úrovni a nižší už nebudou.

    · 2 min čtení