# Felhasználók lekérdezése

> A Felhasználók lekérdezése típus fülei: szerepkör, bevonás és kizárás, egyéb, meta lekérdezés, dátum és földrajzi keresés.

A **Felhasználók lekérdezése** típussal egyedi lekérdezést készítesz a WordPress-felhasználókra, és csak azok jelennek meg a Listing sablonban, akik megfelelnek a feltételeknek.

A lekérdezést a **JetEngine → Lekérdezéskészítő** oldalon az **Új hozzáadása** gombbal hozod létre. Az **Általános beállítások** blokk (név, leírás, lekérdezés típusa, egyéni lekérdezés-ID, gyorsítótár, REST API-végpont) minden típusnál közös, lásd a [Lekérdezéskészítő áttekintését](https://hub.hellowp.io/hu/plugins/jet-engine/query-builder-attekintes/). Az alsó blokk fülei: **Felhasználói szerepkör**, **Bevonás/Kizárás**, **Egyéb**, **Meta lekérdezés**, **Dátumlekérdezés** és **Geo Search**.

![A felhasználók lekérdezésének szerepkör füle](./kepek/query-builder-felhasznalok-szerepkor.webp)

*A felhasználók lekérdezésének szerepkör füle* (https://minta-bolt.hu/wp-admin/admin.php?page=jet-engine-query&query_action=add)

A képen a **Felhasználói szerepkör** fül három mezője látszik.

## Felhasználói szerepkör

| Beállítás | Mit csinál |
|---|---|
| **Szerepkör** | A kiválasztott szerepkörök. Csak az a felhasználó kerül be, aki mindegyik kiválasztott szerepkörrel rendelkezik. |
| **Szerepkör a listában** | Az a felhasználó kerül be, akinek legalább egy ilyen szerepköre van. |
| **Kizárt szerepkörök** | Az a felhasználó kimarad, akinek legalább egy ilyen szerepköre van. |

## Bevonás/Kizárás

- **Bevonás**: a listába kerülő felhasználók azonosítói.
- **Kizárás**: a listából kizárt felhasználók azonosítói.

## Egyéb

| Beállítás | Mit csinál |
|---|---|
| Keresés | Csak azok a felhasználók jelennek meg, akiknél az alapértelmezett mezők (például belépési név, e-mail, URL) valamelyikében szerepel a megadott érték. A keresés helyét a **Keresési oszlopok** adja. A `*` jellel keresési szabályt adhatsz meg: `*a` az „a”-val kezdődő, `a*` az „a”-ra végződő, `*a*` az „a”-t tartalmazó értékeket találja. |
| Keresési oszlopok | A felhasználóhoz kapcsolt mezők, amelyekben a keresett értéket keresi. |
| Darabszám | A listába kerülő felhasználók száma. |
| Eltolás | Az elejéről kihagyott felhasználók száma. |
| Oldal | Úgy működik, mintha lapozás lenne: megadott oldalszámnál az azon az oldalon lévő felhasználók kerülnek be. |
| Rendezés alapja | Melyik érték szerint rendezze a felhasználókat. |
| Rendelés | Növekvő vagy csökkenő sorrend. |

## Meta lekérdezés

A felhasználók meta mezőinek értéke szerint szűr. A feltételek a közös feltételblokkot használják: lásd az [összehasonlító műveletekről és adattípusokról szóló fejezetet](https://hub.hellowp.io/hu/plugins/jet-engine/query-builder-operatorok-es-tipusok/), ott vannak a műveletek, az adattípusok, az üres dinamikus érték kihagyása és a csoportok is.

Dinamikus címkét is használhatsz. Például a „Current terms” makró haladó beállításaiban a „Queried User” környezetet választva és tartalék értékként a „Nem található” szöveget megadva a lekérdezés csak a megtekintett felhasználó elemeit mutatja, és ha nincs találat, a tartalék szöveg jelenik meg.

## Dátumlekérdezés

A felhasználó létrehozásának vagy módosításának dátuma szerint szűr.

| Beállítás | Mit csinál |
|---|---|
| Év, Hónap, Nap | A megadott évben, hónapban vagy napon létrehozott vagy módosított felhasználók. |
| Után | A megadott dátum után létrehozott vagy módosított felhasználók. |
| Előtt | A megadott dátum előtt létrehozott vagy módosított felhasználók. |
| Inclusive | Alapból kikapcsolt. Bekapcsolva az **Után** és **Előtt** mezőben megadott dátum is a tartományba esik. |
| Összehasonlítás | Hogyan hasonlítsa az Év, Hónap és Nap mezőket a létrehozás vagy módosítás dátumához. |
| Oszlop | A létrehozás vagy a módosítás dátumát vegye figyelembe. |

## Geo Search

A lekérdezés a hely alapján szűr: azokat a felhasználókat adja vissza, akiknek a megfelelő mezőkben tárolt koordinátái a megadott sugarú körön belül vannak. Az adatokat nem kell térképen megjeleníteni, listában is használhatók.

A fülön a **Select location** mező alatt térkép látszik: kattints rá a keresés középpontjának kiválasztásához. A térkép a beállításokban kiválasztott térképszolgáltatótól függ.

| Beállítás | Mit csinál |
|---|---|
| Address Field | Egy előre létrehozott címmező meta mezője. Lehet egy „Map” típusú meta mező, vagy két mező, amelyek a szélességet és hosszúságot vesszővel elválasztva tárolják. |
| Distance | A keresési sugár a kiválasztott középpont körül. |
| Units | A távolság egysége: mérföld vagy kilométer. |

Ha minden fülön beállítottad, amit akartál, a **Lekérdezés hozzáadása** gombbal mentsd a lekérdezést.

Gyakorlati példa: [felhasználók lekérdezése és szakértők megjelenítése a rácsban](https://hub.hellowp.io/hu/plugins/jet-engine/query-builder-felhasznalok-lekerdezese/).