# Ügyfelek widget: kategóriaszűrő és AJAX szűrő

> Az Ügyfelek widget logói kategóriák szerint szűrhetők: a szűrő beállításai, a Normál és az AJAX típus különbsége, korlátozások.

Az **Ügyfelek** widget (az Elementor panelen a **Listing** csoportban) az ügyfelek logóit mutatja rácson vagy masonry elrendezésben. Sok logónál a kategóriagombok segítenek: a látogató egy kattintással a számára érdekes ügyfelekre szűkíthet. A widget ingyenes, a **Kategória szerinti szűrés** és a **Szűrő típusa** a Pro változat része.

## Mielőtt elkezdesz

- Kapcsold be az **Ügyfelek** widgetet a **The Plus Addons → Widgets** oldalon, az ügyfél bejegyzéstípust pedig a **The Plus Addons → Listing** oldal **Post types** részén (**Clients**).
- Az ügyfelek a **Tp Clients** menüben vannak. A szűrő a **Tp Clients Category** kategóriákból épül, ezért minden ügyfélhez rendelj legalább egyet. Az üres kategória nem jelenik meg a szűrősoron.

![A Tp Clients bejegyzések listája, mindegyik mellett a kategóriájával](./kepek/galeria-csapat-velemenyek-2-ugyfelek-lista.webp)

*A Tp Clients bejegyzések listája, mindegyik mellett a kategóriájával* (https://minta-bolt.hu/wp-admin/edit.php?post_type=theplus_clients)

A képen nyolc ügyfél látszik, három kategóriába (**Gyártás**, **Kereskedelem**, **Technológia**) sorolva. A menüpontok és a **Add New Item** felirat angolul maradtak a fordításban.

## A szűrő bekapcsolása

1. Szerkeszd az oldalt Elementorral, és jelöld ki az **Ügyfelek** widgetet.
2. Az **Elrendezés** legyen **Rács** vagy **Masonry**. Körhintánál a szűrő nem érhető el.
3. A **Forrás kiválasztása** maradjon **Bejegyzés típusa**. Az **Ismétlő** forrásnak, az **Ügyfelek kezelése** listának nincs kategória mezője, ezért ott a szűrősoron csak az összes gomb jelenne meg.
4. A **Kategória szerinti szűrés** szakaszban kapcsold be a **Kategória szerinti szűrés** kapcsolót.
5. A **Szűrő típusa** maradjon **Normál**.

A gombok a logók fölött jelennek meg, és egy kattintás leszűkíti a listát.

![Az Ügyfelek widget a Mind, Gyártás, Kereskedelem és Technológia szűrőgombokkal](./kepek/galeria-csapat-velemenyek-2-ugyfelek-szuro.webp)

*Az Ügyfelek widget a Mind, Gyártás, Kereskedelem és Technológia szűrőgombokkal* (https://minta-bolt.hu/gcv2-ugyfelek-szuro/)

A képen a **Mind** gomb számlálója a listázott logók számát mutatja.

## A szakasz beállításai

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **Kategória szerinti szűrés** | Megjeleníti a szűrősort. | **Elrejtés** |
| **Szűrő típusa** | **Normál**: a már az oldalon lévő logókat szűri. **AJAX**: az egész listából keres. | **Normál** |
| **Keresés típusa** | A gombok a kategóriát **Slug** vagy azonosító szerint keresik. | **Slug** |
| **Összes szűrő** | Hozzáad egy gombot, amely visszahozza az összes logót. | **Megjelenítés** |
| **Az összes szűrőkategória szövege** | Az összes gomb felirata. | **Mind** |
| **Kategóriaszűrő stílusa** | Négy előre elkészített megjelenés. | **Style 1** |
| **Szűrőstílus rámutatáskor** | Négy rámutatási hatás. | **Style 1** |
| **Szűrés illesztése** | A szűrősor igazítása: balra, középre vagy jobbra. | Középre |

A **Stílus** fülön a **Kategória szűrése** szakaszban a szűrősor betűtípusát, színeit és térközeit állíthatod.

## Normál és AJAX szűrő

A különbség akkor látszik, ha kevesebb logót jelenítesz meg, mint amennyi ügyfeled van. A **Megjelenített bejegyzések maximális száma** (**Tartalom forrása** szakasz) például 3, az ügyfelek száma 8:

| Szűrő típusa | Működés |
|---|---|
| **Normál** | Csak a már megjelenített 3 logó között keres, és elrejti, amelyik nem egyezik. Azonnali, szerverkérés nélkül. |
| **AJAX** | Az összes 8 ügyfélből kéri le az egyezőket, és közülük legfeljebb 3-at mutat. |

Normál szűrőnél tehát nem találhatsz meg olyan ügyfelet, amely nincs az oldalon. Ha azt szeretnéd, hogy a szűrő mindenkit elérjen, emeld meg a **Megjelenített bejegyzések maximális száma** értékét, hogy minden ügyfél látszódjon.

## Hogyan viselkedik

- Az **Mind** gomb számlálója a jelenleg listázott logók számát mutatja.
- Az a kategória, amelyben nincs ügyfél, nem jelenik meg a gombok között.
- A **Kihagyott bejegyzések száma** és a **Kategória kiválasztása** (**Tartalom forrása**) előre kiszűrheti az ügyfeleket, így azok kategóriája sem kerül a gombok közé.
- Körhintára váltva a szűrő szakasz eltűnik a panelről.

## Korlátozások

- Az **AJAX** szűrőtípus ebben a kiadásban nem működik: kattintáskor a logók szürke helyőrző blokkokká változnak, és a lista nem frissül. A szerver elutasítja a kérést, mielőtt a szűrő lefutna. Ez a **Keresés típusa** mindkét értékénél (**Slug** és azonosító) így van. Használd a **Normál** típust.
- Az AJAX szűrőre épülő funkciók, például a kategóriaszűrő megosztható URL-je is érintettek.
- A **Normál** szűrő nem találja meg azt az ügyfelet, amely nincs az oldalon.
- Se körhintánál, se **Ismétlő** forrásnál nincs szűrő.

## Megosztható URL a kategóriaszűrővel

Az elképzelés: a látogató kategóriát választ, az oldal címe ehhez igazodik, és a megosztott linken a következő ember ugyanazt a szűrt nézetet kapja. A beállítás helye:

1. Az **Elrendezés** legyen **Rács** vagy **Masonry**, a **Forrás kiválasztása** pedig **Bejegyzés típusa**.
2. A **Kategória szerinti szűrés** szakaszban kapcsold be a **Kategória szerinti szűrés** kapcsolót.
3. A **Szűrő típusa** legyen **AJAX**. Az **URL engedélyezése** csak AJAX szűrővel, vagy a **Továbbiak betöltése** gombbal jelenik meg.
4. Az **Extra opciók** szakaszban kapcsold be az **URL engedélyezése** kapcsolót.

Ebben a kiadásban ez nem működik. A kategóriagombra kattintva az oldal címe nem változik, a logók szürke helyőrző blokkokká alakulnak, és a lista nem szűrődik. Az oldal újratöltése sem segít. Oka az AJAX szűrő: a böngésző kérését a szerver elutasítja, mielőtt a szűrő lefutna, így nincs eredmény, és cím sem íródik. Mivel az **URL engedélyezése** a kategóriaszűrőnél más úton nem működik, a megosztható cím sem jön létre. Ugyanez a kapcsoló a **Továbbiak betöltése** gombbal működik.

Mit használj helyette:

| Amit szeretnél | Amit ma használhatsz |
|---|---|
| Link, amely egy választott kategóriát mutat | Adj a kategóriának külön oldalt vagy szekciót egy második **Ügyfelek** widgettel, és a **Tartalom forrása** szakasz **Kategória kiválasztása** mezőjében add meg azt a kategóriát. Az oldal saját címe ekkor a megosztható link. |
| Link, amely az első adagnál több logót mutat | A **További bejegyzésopciók → Továbbiak betöltése** és az **URL engedélyezése** együtt: ez ír megosztható címet. |
| Működő kategóriaszűrő egy oldalon | A **Szűrő típusa** maradjon **Normál**: helyesen szűr, csak megosztható címet nem készít. |

Az **URL engedélyezése** Pro funkció, és körhintánál, valamint **Ismétlő** forrásnál nem érhető el.

## Hibaelhárítás

**A logók szürke blokkokká változnak, és ott maradnak.** A **Szűrő típusa** **AJAX**. Állítsd **Normál**-ra, és frissítsd az oldalt.

**Kategória választása után semmi sem látszik.** Normál szűrőnél csak az oldalon lévő logók között keres. Emeld meg a **Megjelenített bejegyzések maximális száma** értékét.

**Nincs szűrősor.** Ellenőrizd, hogy a Pro változat aktív, az elrendezés nem **Körhinta**, a forrás **Bejegyzés típusa**, és a **Kategória szerinti szűrés** be van kapcsolva.

**Hiányzik egy kategória a gombok közül.** Nincs benne közzétett ügyfél, vagy a **Kategória kiválasztása** már kizárta az ügyfeleit.

**Nincs Szűrő típusa legördülő.** Kapcsold be előbb a **Kategória szerinti szűrés** kapcsolót, és ellenőrizd, hogy a forrás **Bejegyzés típusa**.