Ugrás a tartalomra
Útmutatók

Ajaxos keresés WordPress bővítmény nélkül

A WordPress alapból egyszerű keresést kínál, amelyet a weboldaladon használhatsz. Elegánsabb és gyorsabb az ajaxos keresés, amely a teljes oldal újratöltése nélkül jeleníti meg a találatokat.

Ajaxové vyhľadávanie bez WordPress pluginu

A WordPress alapból egyszerű keresést kínál, amelyet a weboldaladon használhatsz, akár vizuális szerkesztővel készíted az oldalt, akár WordPress sablont vásároltál. Beírod a keresett szót vagy kifejezést, és a találati oldalon megjelenik minden releváns oldal, bejegyzés stb.

Elegánsabb és gyorsabb keresést tesz lehetővé az Ajax, amely a teljes oldal újratöltése nélkül tölti be a találatokat. Ebben az útmutatóban megmutatom, hogyan készíts ajaxos keresést további WordPress bővítmény telepítése nélkül, PHP, Ajax és jQuery segítségével. Nem kell aggódnod, ha nem tudsz programozni: a teljes kódot és azt, hogy hová kell beilleszteni, úgy írom le, hogy programozási tapasztalat nélkül is boldogulj.

A bekezdés alatti kép az útmutató alapján elkészült keresés előnézetét mutatja. A kódban lévő megjegyzéseknek köszönhetően egy átlagos, programozni nem tudó WordPress-felhasználó is testre szabhat néhány dolgot. A nagyobb módosításokhoz azonban legalább alapszintű PHP-tudás kell.

Saját ajaxos keresés WordPress bővítmény nélkül
Saját ajaxos keresés találatai egy WordPress weboldalon

Mi az az Ajax?

Az AJAX (Asynchronous JavaScript and XML) olyan webfejlesztési technika, amellyel a látogatók a teljes oldal újratöltése nélkül használhatják a weboldalt. Így az Ajaxszal a szervertől lekért adatok gyorsabban betöltődnek, mert az oldal többi részét (pl. fejléc, lábléc, ...) nem kell újra betölteni.

Az Ajax előnye a kért adatok gyors betöltése és a kisebb szerverterhelés, mivel kevesebb adatot kell feldolgozni – így pénzt is spórolsz, amelyet a nagyobb teljesítményért a tárhelyszolgáltatónak fizetnél. Végül, de nem utolsósorban az Ajax jobb felhasználói élményt is nyújt a weboldaladon.

Az Ajaxról a WordPress kapcsán itt olvashatsz bővebben.

Az ajaxos keresés lehetőségei és funkciói

Mivel ezt az ajaxos keresést magunk programozzuk, tetszés szerint alakítható. Nem korlátoznak a bővítmények szűkös beállításai – teljes kontrollod van a kód felett.

  1. Egyezés a címben, kivonatban és tartalomban – A keresett szó/kifejezés alapján a cím, a kivonat vagy a tartalom teljes vagy részleges egyezése szerint jelennek meg a találatok az összes (kódban kiválasztott) bejegyzéstípusban.
  2. Tetszőleges bejegyzéstípusok – Te döntöd el, mi kerüljön a keresésbe: csak oldalak, bejegyzések, termékek vagy minden együtt. Bármilyen bejegyzéstípust választhatsz, az egyedi bejegyzéstípusokat (CPT) is.
  3. Testreszabható találatok – A kód feletti teljes kontrollnak köszönhetően te döntöd el, mi jelenjen meg a találatok között. Csak a bejegyzés címe, vagy a kiemelt kép és a kategóriák is?
  4. Üzenet a kérés feldolgozása közben – A keresés után kérés megy a szerverre, amely feldolgozza, és visszaküldi a találatokat. Ezalatt a keresőmező alatt megjelenik a „Keresés...” szöveg.
Ajaxos keresés - Keresés...
Ajaxos keresés példa - a találatok keresése folyamatban
  1. Callback, ha nincs találat – Ha a keresésnek nincs releváns találata, a „Nincs találat” szöveg jelenik meg.
Ajaxos keresés - nincs találat
Ajaxos keresés példa - nincs találat üzenet

Saját ajaxos keresés - kódok és lépések

Először hozz létre egy egyszerű keresőűrlapot, amely egy szövegmezőt és egy gombot tartalmaz.

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

Az űrlapot a weboldal bármely pontjára elhelyezheted. Ha vizuális szerkesztőkkel (page builderekkel), például Divi Builderrel, Breakdance-szel, Elementorral vagy Oxygen Builderrel készíted az oldalt, a HTML-kódot code block modullal illesztheted be.

WordPress sablonoknál általában nem tudsz közvetlenül HTML-kódot hozzáadni, ezért a legjobb megoldás egy gyermeksablon telepítése, és a HTML-kód hookkal való elhelyezése a kívánt helyen. A teljes kódot az aktív gyermeksablon functions.php fájljába illeszd be. A gyermeksablon alternatívájaként telepítheted a Code Snippets WordPress bővítményt (ingyenes verzió), és abba illesztheted a teljes kódot.

TIPP! Ne maradj le a WordPress bővítmény és WordPress sablon akciókról.

A keresőmezőt és a találatokat az alábbi CSS-sel formáztam. A CSS-t ízlésed szerint módosíthatod.

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

Végül még egy lépés szükséges: a kód fő részének hozzáadása, amely az Ajax-hívást és a találatok megjelenítését végzi. A gyermeksablonod functions.php fájljába illeszd be az alábbi kódot. Ahogy fentebb említettem, a Code Snippets bővítménnyel is hozzáadhatod.

<?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();
}

A fenti kód a következőket biztosítja:

  • Ha legalább 3 betűt írsz a keresőmezőbe, és az utolsó karakter után 600 ms szünet következik, aszinkron kérés megy a szerverre. Egy-két betű alapján keresni nincs sok értelme – az egyezés túl tág lenne. A 600 ms-os szünet biztosítja, hogy kényelmesen beírd a teljes szót/kifejezést, mielőtt megjelennének a találatok.
  • Bejegyzések és oldalak találatai jelennek meg. Ezt módosíthatod aszerint, mit szeretnél a keresésbe bevonni. A kódban a 'post_type' => array('page','post') részben a 'page','post' értéket bármilyen bejegyzéstípusra cserélheted.

Remélem, hogy ez az útmutató segít, és az ajaxos keresés megkönnyíti a látogatóknak a tartalom megtalálását a weboldaladon.

A cikk szerzője

Peter Dudák

A wp-zlavy.sk alkotója és üzemeltetője vagyok, ahol egy helyen találod a legtöbb WordPress kedvezményt. Szeretem a cserkészetet, a programozást, a WordPresst és mindent, ami vele kapcsolatos.