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