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

Előfeltételek

A ListaMester WordPress bővítmény telepítve és engedélyezve van.
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).
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

Nyisd meg a Űrlapfigyelők oldalt.
Az Új űrlapfigyelő résznél adj meg egy nevet (csak a saját azonosításodhoz – pl. „Kapcsolat űrlap – hírlevél csoport”).
Válaszd ki a ListaMester csoportot a legördülő listából (a csoportnevek betűrendben jelennek meg).
Állítsd be, hogy az űrlapfigyelő aktív legyen-e (jelölőnégyzet).
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.
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.
Kattints a Létrehozás gombra.
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.