Ismétlő mező az űrlapban

Az állandó mezőszámú űrlap sok esetben elég. Ha viszont a látogatónak annyi sort kell kitöltenie, ahányra szüksége van (például vendégek nevét), ismétlődő mezőcsoportot teszel az űrlapba. A látogató sorokat vehet fel és törölhet, a beküldött adatot pedig egy bejegyzés ismétlő metamezőjébe mentheted, és máshol megjelenítheted.

Az űrlapot a JetEngine → Űrlapok menüben szerkeszted, az oldalra pedig Elementorral vagy a blokkszerkesztővel teszed be.

Az ismétlő keretének felvétele

Az ismétlő két részből áll: Repeatable Field Group Start és Repeatable Field Group End. A kettő közé tett mezők alkotják az ismétlődő sort.

1. Nyisd meg a JetEngine → Űrlapok oldalt, és hozz létre új űrlapot, vagy nyiss meg egy meglévőt.
2. Az Add Field gombbal vegyél fel egy mezőt, és a Type értéke legyen Repeatable Field Group Start.
3. Töltsd ki a beállításokat (lásd lent), majd kattints az Apply Changes gombra.
4. Vegyél fel egy újabb mezőt, a Type értéke legyen Repeatable Field Group End, és kattints az Apply Changes gombra.
5. A két mező közé tedd az ismétlődő sor mezőit, például két szövegmezőt a vezeték- és keresztnévnek.
6. Kattints a Publish (vagy Update) gombra.

Fontos, hogy az ismétlő mezőinek a nevei megegyezzenek az ismétlő metamező almezőinek neveivel, ha az adatot el akarod menteni.

A csoport kezdőmezőjének beállításai

Beállítás	Mit csinál
Name	A mező neve. Kisbetűvel, szóköz nélkül írd (kötőjel vagy aláhúzás jó). Jegyezd meg, később kell.
Label	A sor neve, amelyet a látogató lát.
Description	Rövid magyarázat arról, mire való a sor.
Manage repeater items count	Hogyan adódnak hozzá a sorok. Manually: a látogató egy gombbal ad hozzá sort, a gomb felirata az Add New Item Label mezőben van. Dynamically (get a count from the form field): a sorok száma egy másik űrlapmező értékével egyenlő.
Required	Kötelező-e kitölteni.
Calculate repeater row value	Hogyan számolódjon a sorok értéke. By Default: csak a sorok számát adja. Custom: egyedi képlettel számol minden sorra, és az eredmény az összes sor értékének összege.
Calculation formula	A képlet. Jobbra látod az űrlap összes mezőjének nevét, ezeket másolhatod be. Összeadhatsz, kivonhatsz, szorozhatsz, oszthatsz.
Default	A mezők alapértéke.
Add Prev Page Button	Többoldalas űrlapnál „Previous Page” gombot tesz az űrlapra.
Field Visibility	Ki látja ezt a részt: mindenki, csak a bejelentkezettek vagy csak a nem bejelentkezettek.
Custom CSS Class	Egyedi CSS-osztály a megjelenés módosításához.

Elementorban az űrlap Stílus fülén külön lenyíló szakasz szól az ismétlők kinézetéről.

Számolt mezők az ismétlővel

Kétféleképpen használhatsz számolt (Calculated) mezőt az ismétlővel.

A számolt mező az ismétlőn belül van. A mező annyiszor ismétlődik, ahány sort a látogató felvesz, és minden sorra külön mutatja az eredményt. Ha például két szám meződ (adults és children) és egy számolt meződ van, a képlet:

%FIELD::adults%+%FIELD::children%

Ez a „adults” mező értékét adja a „children” mező értékéhez.

A számolt mező az ismétlőn kívül van. A Calculation Formula mezőbe a csoport kezdőmezőjének nevét írd, például:

%FIELD::start%

Ilyenkor a mező az ismétlő sorainak összesített értékét mutatja. A látogató által beírt értékek a Repeatable Field Group Start mező Calculation formula képlete szerint számolódnak soronként, és az eredmények összegét látja a látogató.

Az űrlap és az ismétlő metamező összekötése

A beküldött sorok automatikusan bekerülhetnek egy bejegyzés ismétlő metamezőjébe.

Az ismétlő metamező létrehozása

1. Nyisd meg a JetEngine → Metaboxok oldalt, és kattints az Új hozzáadása gombra.
2. Add meg a metabox címét, a Meta doboz célja legyen Bejegyzés, és válaszd ki a bejegyzéstípust.
3. Kattints az Új metamező gombra. Add meg a Címke és a Név/ID értékét (a nevet jegyezd meg), az Objektum típusa legyen Mező, a Mező típusa pedig Ismétlő.
4. Vegyél fel annyi almezőt, ahányat az űrlap ismétlője tartalmaz (példa: „Keresztnév” és „Vezetéknév”). Az almező Type értéke egyezzen az űrlapmezők típusával, a nevük pedig az űrlapmezők nevével.
5. Add meg a leírást és a mező szélességét, majd kattints a Metabox hozzáadása gombra.

Az űrlap összekötése

1. Nyisd meg a JetEngine → Űrlapok oldalt, és az űrlapot, amelyben az ismétlő van.
2. A Post-submit Actions / Notifications Settings szakaszban kattints az Add Notification gombra.
3. A Type legyen Insert/Update Post.
4. A Post Type az a bejegyzéstípus legyen, amelyhez a metamezőt rendelted.
5. A Post Status lehet például Published.
6. A Fields Map listában minden összekötendő mezőnél válaszd a Post Meta lehetőséget, és az új mezőkbe írd be a metamező, illetve az ismétlő almezőinek nevét.
7. Kattints az Apply Changes, majd az űrlap frissítéséhez az Update gombra.

Az eredmény ellenőrzése

Nyisd meg az űrlapot tartalmazó oldalt, vegyél fel néhány sort, és küldd be az űrlapot. A bejegyzéstípus listájában minden beküldés új bejegyzést hoz létre. Ha megnyitod a legfrissebbet, a beírt adatok az ismétlő metamezőben vannak.

A mentett adat más oldalon is megjeleníthető a Dynamic Repeater elemmel.