# A JetSearch áttekintése és az Ajax Search elem szakaszai

> Mit tud a JetSearch, melyik szerkesztőben milyen szakaszokból áll az Ajax Search blokk, widget és elem, és miben különbözik a három.

A JetSearch dinamikus keresőt ad a WordPress-weboldalhoz. A találatokat az oldal újratöltése nélkül, gépelés közben mutatja, az egész webhelyen: bejegyzésekben, oldalakban, egyéni bejegyzéstípusokban, egyéni mezőkben, kategóriákban, címkékben és osztályozások (taxonomy) kifejezéseiben. A találatokat relevancia szerint rendezi.

A bővítmény három nagy egységre bontható:

- **Ajax Search**: a keresőmező a látogatónak. Blokk (blokkszerkesztő), widget (Elementor) vagy elem (Bricks). Általában keresőmező, gomb és ikon.
- **Search Query**: az Ajax Search egyik szakasza, amely megmondja, hol keressen és milyen sorrendben adja a találatokat: egyéni lekérdezés vagy kiválasztott források (egyéni bejegyzéstípusok, bejegyzések, oldalak, WooCommerce-termékek), rendezés relevancia, dátum, szerző stb. szerint, számláló.
- **Találati terület**: a keresőmező alatt megjelenő lista és a külön eredményoldal. Alapból relevancia szerint rendezett, de ár vagy dátum szerint is rendezhető. A találatok a **Listing Grid**, **Posts** vagy **Smart Posts List** widgettel mutathatók a legszebben.

Az Ajax Search elem szakaszai a három szerkesztőben szinte azonosak. A beállítások jelentését a [A keresőblokk beállításai](https://hub.hellowp.io/hu/plugins/jet-search/kereso-blokk/) és [A találati terület](https://hub.hellowp.io/hu/plugins/jet-search/talalati-terulet/) fejezet írja le részletesen; itt az áttekintés és a különbségek állnak.

![Élő találatok a keresőmező alatt](./kepek/elso-lepesek-egyedi-kereso.webp)

*Élő találatok a keresőmező alatt* (https://minta-bolt.hu/kereses/)

A képen a „kerámia” szóra két találat jelent meg, alul a **See all results** hivatkozással. A mező végén az **X** ikon egy kattintással törli a beírt szöveget.

## Az elem szakaszai szerkesztőnként

| Szerkesztő | Az elem neve | A szakaszok |
|---|---|---|
| Blokkszerkesztő | **Ajax Search** blokk | **Search Input**, **Search Submit**, **Search Query**, **Search Query Includes/Excludes**, **Results Area**, **Custom Fields**, **Additional Results**, **Search Suggestions**, **Notifications**, **Advanced** |
| Elementor | **Ajax Search** widget (**Tartalom** fül) | **Search Form**, **Search Query**, **Results Area**, **Custom Fields**, **Additional Results**, **Search Suggestions**, **Notifications**; a **Stílus** fülön a szokásos Elementor-stílusbeállítások |
| Bricks | **Ajax Search** elem (**Content** fül) | **Search Form**, **Search Query**, **Results Area**, **Custom Fields**, **Additional Results**, **Search Suggestions**, **Notifications**; a **Style** fülön a szokásos Bricks-stílusbeállítások |

A blokkszerkesztőben nincs stílusfül. A blokk stílusát az ingyenes JetStyleManager bővítménnyel állíthatod: a szerkesztő jobb felső sarkában a **Block Style** gombbal.

## A szakaszok röviden

### Keresőmező és küldés gomb

- **Input Icon**: ikon a mezőben, ikonkönyvtárból, feltöltött SVG-ből vagy (blokkszerkesztőben) nyers SVG-kódból.
- **Clear Text Button Icon** (Elementor): a gépelés után megjelenő ikon, amelyre kattintva a beírt szöveg azonnal törlődik.
- **Placeholder Text**: a mezőben látszó szöveg (blokkszerkesztőben **Placeholder**).
- **Minimal Quantity of Symbols for Search**: hány karakter után induljon a keresés.
- **Allow Search by Empty String**: bekapcsolva üres mezővel is lehet keresni, ilyenkor az összes tartalom megjelenik.
- **Disable Submit on Enter**: bekapcsolva csak a küldés gomb ikonjára kattintva indul a keresés, az Enter nem küldi el.
- **Show Submit Button**, **Submit Button Label**, **Submit Button Icon**: a gomb megjelenítése, felirata és ikonja.
- **Show Categories List**: a mező mellett legördülő lista jelenik meg. Bekapcsolás után két mező jelenik meg: **Taxonomy** (melyik osztályozás kifejezései kerüljenek a listába; WooCommerce-termékkategóriák és JetEngine-es egyéni osztályozások is) és **Select Placeholder** (a lista alapszövege).
- **Responsive Form on Mobile**: mobilon külön alkalmazkodó űrlap.

### Search Query

Ugyanazok a beállítások, mint a bővítmény globális [alapértelmezett lekérdezésénél](https://hub.hellowp.io/hu/plugins/jet-search/elso-lepesek-alapertelmezett-beallitasok/). Ha a widgetben ugyanazt adod meg, mint az alapbeállításban, rövidebb lesz a keresés találati oldalának webcíme.

- **Search by current query**: az aktuális oldal tartalmában keres; archívoldalakhoz ezt is be kell kapcsolni.
- **Custom Search Results URL**: saját eredményoldal webcíme. A találatok az oldalon minden, azonos bejegyzéstípusú widgetre érvényesek.
- **Source**: a keresési területek. Ha semmi nincs kiválasztva, az egész webhelyen keres.
- **Terms** (Elementor, Bricks) vagy a **Search Query Includes/Excludes** szakasz (blokkszerkesztő): kifejezések bevonása vagy kizárása, kizárt bejegyzések.
- **Search in custom fields**: egyéni mezők neve vesszővel elválasztva.
- **Sentence search**: a teljes beírt mondatra is keres.
- **Search in taxonomy terms** és **Taxonomies**: azokat a bejegyzéseket is megtalálja, amelyekhez olyan kifejezés tartozik, amelynek nevében szerepel a keresett szöveg.
- **Results Order By** (Relevancia, ID, Szerző, Cím, Dátum, Utoljára módosítva, Véletlen, Hozzászólások száma, Menü sorrend) és **Results Order** (növekvő vagy csökkenő).
- **Posts Per Page**: hány találat látszik egy lapon. A blokkszerkesztőben külön megadható táblagépre (**Posts Per Page (Tablet)**) és mobilra (**Posts Per Page (Mobile)**) is.
- **Posts Number**: hány találatot adjon vissza egy keresés.

### Results Area

- **Listing**: a találatok sablonja (listázósablon).
- **Results Area Width**: a találati terület szélessége: **by Search Form** (az egész űrlap szélessége), **by Input Box and Categories List** (a mező és a kategórialista) vagy **Custom**. Az utóbbinál megjelenik a **Custom Width** mező.
- **Columns Number**: 1 és 10 közötti oszlopszám. A blokkszerkesztőben táblagépre és mobilra külön is beállítható (**Columns Number (Tablet)**, **Columns Number (Mobile)**).
- **Highlight Searched Text**: a beírt szöveg kiemelése a találatokban.
- **Show Post Thumbnail**, **Thumbnail Size**, **Thumbnail Placeholder**: a bélyegkép megjelenítése, mérete, és a helyettesítő kép azokhoz a bejegyzésekhez, amelyeknek nincs bélyegképük.
- **Post Content Source**: a tartalom forrása (**Post Content**, **Post Excerpt** vagy **Custom Field**; az utóbbinál megjelenik a **Custom Field Key** mező). **Post Content Length**: a tartalom hossza karakterben; 0 esetén a tartalom el van rejtve.
- WooCommerce-termékekhez: **Show Product Price**, **Show Product Rating**, **Show Add to Cart Button**.
- **Show Results Counter** és **Results Counter Text**: a találatok számának kiírása és a felirata.
- **Show All Results Button**, **All Results Button Text**, **Open Results in New Tab**: a „Összes találat” gomb, a felirata, és hogy új lapon nyíljon-e meg az eredményoldal.
- **Bullet Pagination**, **Number Pagination**, **Navigation Arrows**: a lapozás pontjai, számai és nyilai; mindegyiknél választható, hogy a fejlécben, a láblécben, mindkettőben jelenjen meg, vagy rejtve legyen. A **Navigation Arrows Type** a nyilak kinézetét adja.

### Custom Fields

Két kapcsolóval, **Show Meta Before/After Title** és **Show Meta Before/After Content**, egyéni mezők értékét a cím vagy a tartalom előtt vagy után írathatod ki. Bekapcsolás után:

- **Meta Field Position**: a mező helye.
- Egy tétel (Elementorban **Item #1**, blokkszerkesztőben az **Add new item** gombbal létrehozott elem, Bricksben **Meta Fields List**) beállításai: **Key** (a mező kulcsa a bejegyzés-meta táblában), **Label** (felirat), **Value Format** (HTML-jelöléssel; az érték helye `%s`) és **Prepare meta value with callback** (a dátum, a webcím és a kép helyes megjelenítéséhez).
- Bricksben az **Add Meta Field** gombbal további mezőt adhatsz hozzá.

### Additional Results

Itt állíthatod be, hogy a bejegyzések mellett kifejezések, felhasználók, egyéni bejegyzéstípusok vagy egyéni tartalomtípusok (CCT) is megjelenjenek további találatként.

### Search Suggestions

- **Save User Searches**: a látogatók beírt keresései mentődnek.
- **Show Search Suggestions**: a keresés közben javaslatok jelennek meg. Bekapcsolás után: **Suggestions Source** (**Popular searches** vagy **User searches**), **Max Suggestions Number**, **Suggestions Position** (**Under the form** vagy **Inside search results area**), **Suggestions Title**, **Maximum Word Length for Suggestion Item Titles** (0 esetén a teljes cím látszik).

A javaslatokról a [Javaslatok az Ajax Search elemben](https://hub.hellowp.io/hu/plugins/jet-search/javaslatok-ajax-kereso/) fejezetben olvashatsz.

### Notifications

- **Negative search results**: az üzenet, amikor nincs találat.
- **Technical error**: az üzenet, amikor a keresést nem lehet feldolgozni.

### Advanced (blokkszerkesztő)

- **Additional CSS class(es)**: saját CSS-osztályok a blokkhoz.

## Mi a teendő a beállítások után

Mentsd az oldalt, és próbáld ki a weboldalon a keresőt: írd be a legalább annyi karaktert, amennyit a **Minimal Quantity of Symbols for Search** megkövetel. A [Kereső a fejlécben és saját keresőűrlap](https://hub.hellowp.io/hu/plugins/jet-search/elso-lepesek-fejlec-es-kereso/) fejezet lépésről lépésre mutatja a keresőűrlap összeállítását és a fejlécbe illesztést.