##  Űrlapfigyelők a Wordpressben 

Ez az útmutató bemutatja, hogyan kötheted össze a weboldaladon lévő meglévő HTML-alapú kontakt- vagy egyéb űrlapokat a ListaMester csoportokkal, az Űrlapfigyelők funkció segítségével.

# Űrlapfigyelők – külső HTML űrlapok és ListaMester feliratkozás

A ListaMester WordPress bővítmény **Űrlapfigyelők** funkciója lehetővé teszi, hogy a honlapodon már meglévő, **ListaMester űrlapvarázslótól független** HTML űrlapok kitöltésekor a látogatók adatát egy kiválasztott ListaMester **csoportba** feliratkoztasd a ListaMester nyilvános API-ján keresztül.

**FONTOS** Ez a funkció **nem** helyettesíti a ListaMester saját, beágyazható űrlapjait és shortcode-jait. A klasszikus beillesztési módokról továbbra is a megszokott útmutatóban olvashatsz: [Feliratkozási űrlap beillesztése WORDPRESS honlapba](https://www.listamester.hu/utmutato-listamesterhez/urlapok/feliratkozasi-urlap-beillesztese-wordpress-honlapba).

## Előfeltételek

1. A ListaMester WordPress bővítmény telepítve és engedélyezve van.
2. A bővítmény **Beállítások** menüjében megadtad a **felhasználói azonosítót** és az **API kulcsot**, és a kapcsolat sikeres (ugyanez a beállítás kell a ListaMester API-hívásokhoz is).
3. A célcsoportban szerepelnek a kívánt **adatmezők** (név, e-mail, egyedi mezők).

## Hol találod a WordPress adminban?

A bal oldali menüben: **Listamester** → **Űrlapfigyelők** (az **Űrlapok** menüpont alatt, a második helyen).

## Munkamenet: első űrlapfigyelő létrehozása

1. Nyisd meg a **Űrlapfigyelők** oldalt.
2. Az **Új űrlapfigyelő** résznél adj meg egy **nevet** (csak a saját azonosításodhoz – pl. „Kapcsolat űrlap – hírlevél csoport”).
3. Válaszd ki a **ListaMester csoportot** a legördülő listából (a csoportnevek betűrendben jelennek meg).
4. Állítsd be, hogy az űrlapfigyelő **aktív** legyen-e (jelölőnégyzet).
5. **Include oldalak** (opcionális): soronként egy **URL-út** (path), pl. `/kapcsolat`. Ha üresen hagyod, az űrlapfigyelő **minden nyilvános oldalon** figyelheti a megfelelő űrlapokat.
6. **Exclude oldalak**: olyan útvonalak, ahol **nem** fusson a figyelő. Alapértelmezésként szerepelnek a belépési / admin útvonalak (pl. `/wp-admin`, `/wp-login.php`). Szükség szerint bővítheted.
7. Kattints a **Létrehozás** gombra.
8. A mentés után a bővítmény lekéri a kiválasztott csoport **adatmezőit** a ListaMester API-ból, és eltárolja az űrlapfigyelőnél. Ha a ListaMesterben később változtatsz a mezőkön, használd az **Adatmezők frissítése** gombot, vagy nyisd meg szerkesztésre az űrlapfigyelőt.

## Hogyan működik a honlap látogatói oldalán?

Ha legalább egy **aktív** űrlapfigyelő van, a bővítmény egy kis JavaScript programot tölt be a nyilvános oldalakra. Ez figyeli a megfelelő `<form>` elemeket (beleértve sok, JavaScript által később betöltött űrlapot is).

- Az űrlapot csak akkor veszi figyelembe, ha van benne legalább egy `input[type=email]` mező (kötelező az e-mail a feliratkozáshoz).
- Ha a űrlap `action` attribútuma közvetlenül a **listamester.hu** domainre mutat, az űrlapot **kihagyja** (dupla feliratkozás elkerülése).
- A beküldéskor a script összegyűjti az input mezők nevét, értékét és a címkét (label), majd a saját WordPress oldaladon futó **REST API** végpontra küldi JSON-ban.
- A szerver ezt az adatot a ListaMester **SubscribeToGroup** hívássá alakítja, és felviszi a kiválasztott csoportba.

**Technikai részlet:** A feldolgozó végpont a WordPress REST API része, tipikus címe: /wp-json/listamester/v1/capture (ugyanazon a domainen, ahol a honlap fut). A böngésző a beküldés pillanatában néha „félbehagyott” kérésként mutathatja ezt a sort, ha az oldal azonnal továbbnavigál – ez nem feltétlenül jelenti, hogy a szerver nem dolgozta fel a kérést. A bővítmény a `fetch` hívásnál `keepalive` beállítást használ, hogy ilyen esetekben is megbízhatóbb legyen a küldés.

## Mezőleképezés (mapping): melyik űrlapmező melyik ListaMester mező?

A szerver a következő szabályokkal próbálja összepárosítani a begyűjtött mezőket a csoport mezőivel. Az összehasonlítások **kis- és nagybetűt nem néznek**, és a szövegeket **trim**-eli.

| Feltétel | Eredmény |
|---|---|
| A mező az e-mail típusú input (a DOM-ban az első ilyen számít e-mailnek) | ListaMester `email` mező |
| A mező `name` attribútuma vagy a címke szövege egyezik a tipikus „név” aliasokkal (pl. `name`, `your-name`, `név`, `neved`…) | ListaMester `name` mező |
| A `name` vagy a címke szövege megegyezik egy ListaMester **adatmező megnevezésével** (ahogy a csoportban szerepel) | Annak a mezőnek az API azonosítója (pl. `field12345`) |
| A név mezőt nem sikerült így felismerni, de van szöveges (`text`) input | Első ilyen mező értéke kerül `name`-ként (tartalék) |

A címkéknél figyelembe van véve, ha a végén **kettőspont** vagy **\*** szerepel (pl. „Telefonszám:”). Hosszú távon érdemes a ListaMesterben és az űrlapon is ugyanazt a mezőnevet használni, vagy a címkét egyeztetni a ListaMester mező megnevezésével.

## Aktív / inaktív állapot

Minden űrlapfigyelőnek van **aktív** állapota. Inaktív űrlapfigyelő **nem** tölti be a frontend figyelőt, és a háttérben sem dolgozza fel a rögzítést. A listában gyorsan át lehet kapcsolni az **Aktiválás / Inaktiválás** gombbal.

## Gyakori kérdések

### Miért nem jelenik meg a feliratkozó a csoportban?

- Ellenőrizd, hogy az űrlapfigyelő **aktív**, és az oldal **nincs** kizárva az exclude listában.
- Legyen **e-mail mező** az űrlapon.
- Frissítsd az **adatmezőket** a ListaMesterben változás után (**Adatmezők frissítése**).
- A **Beállításokban** megadott API adatoknak érvényesnek kell lenniük.

### Működik Contact Form 7, Ninja Forms, Calculated Fields Form stb. űrlapokkal?

A legtöbb szabványos HTML űrlappal igen, amennyiben van e-mail mező, és a beküldés lefut a böngészőben. Egyes bővítmények teljes oldalas újratöltéssel vagy átirányítással küldenek – ilyenkor a háttér-kérés továbbra is megtörténhet, de a böngésző hálózati nézete néha nem mutatja részletesen a választ.

Ez a dokumentum a ListaMester WordPress bővítmény **Űrlapfigyelők** funkciójához készült. A klasszikus ListaMester űrlap beillesztésről lásd: [Feliratkozási űrlap beillesztése WORDPRESS honlapba](https://www.listamester.hu/utmutato-listamesterhez/urlapok/feliratkozasi-urlap-beillesztese-wordpress-honlapba).