Kapcsolódó elemek összekapcsolása űrlappal

A kapcsolatokat a weboldalról, űrlappal is kezelheted. Ez a fejezet a JetEngine saját űrlapjaival (JetEngine → Űrlapok) dolgozik. Az űrlap két utólagos művelettel (post-submit action) dolgozik: az Insert/Update Post hozza létre vagy frissíti a bejegyzést, a Connect Relation Items pedig a kapcsolatot. A feliratok a JetEngine űrlapmodul felületén angolul is látszhatnak, ezért az alábbi leírás az angol neveket is megadja.

A példákban az Ország a szülő, a Túra a gyermek bejegyzéstípus. A mezők nevében (Name) csak kisbetűs latin betű, kötőjel és aláhúzás lehet, szóköz nem.

Meglévő gyermekek hozzárendelése egy szülőhöz

1. A JetEngine → Űrlapok oldalon kattints az Új hozzáadása gombra, és add meg az űrlap címét.
2. Az alapból létrejövő Hidden Field és Submit Button maradjon. A rejtett mező beállításait ne módosítsd: ez adja a szülő azonosítóját.
3. Kattints az Add Field gombra, és vegyél fel egy lista jellegű mezőt, például Checkboxes Field-et (több kiválasztható érték). Add meg a nevét, a címkéjét, és ha kell, a leírását és a kötelező jelölést.
4. A Fill Options From mezőben válaszd a Posts forrást, a bejegyzéstípus a gyermek típus (Túra).
5. A Default mező Dynamic tags gombjával nyiss meg egy ablakot, és állítsd be: Source: „Related items”; From Relation: a kapcsolat; From Object: a gyermek (a mezőben a már kapcsolt gyermekek legyenek kipipálva); Initial Object ID From: marad az Aktuális objektum ID-ja. Kattints a Done gombra.
6. Szükség esetén állítsd be a további mezőket (Add Prev Page Button, Field Visibility, egyedi CSS-osztály), és az Apply Changes gombbal mentsd a mezőt. A Submit Button feliratát is átírhatod.
7. A Post-submit Actions / Notifications Settings fülön szerkeszd az alapértelmezett Send Email műveletet (ceruza ikon): a típus Insert/Update Post, a Post Type a szülő bejegyzéstípus, az állapot lehet üres, a mezőleképezés marad. Az Apply Changes gombbal mentsd.
8. Az Add Notification gombbal vegyél fel még egy műveletet: típus Connect Relation Items, a Relation a kapcsolat, a Parent Item ID a rejtett mező, a Child Item ID a gyermeklistát mutató mező, az Update Context értéke „We updating parent items for the child object”. Apply Changes.
9. A Messages Settings részben átírhatod a felhasználónak megjelenő üzeneteket.
10. Kattints a Publish gombra.

Az űrlapot a szülő önálló sablonjába teheted: Crocoblock → Theme Builder, a szülő sablonjának Szerkesztés gombja, majd tedd fel a Form widgetet, a szolgáltató legyen JetEngine, és válaszd ki az űrlapot. Beállítható a mezők elrendezése, a címke HTML-címkéje, a beküldés típusa és a gyorsítótárazás. Tedd közzé.

A frontenden a szülő oldalán megjelenik az űrlap, a kapcsolt gyermekek kipipálva. A beküldés után a kipipált elemek bekerülnek a szülő gyermeklistájába.

Figyelem

Ha a szülőhöz már vannak kapcsolt gyermekek, az űrlapon kipipálva jelennek meg. Ha kiveszed a pipát, és beküldöd az űrlapot, a gyermek leválik a szülőről.

Új szülő létrehozása gyermekek kapcsolásával

1. Hozz létre új űrlapot, és töröld az alapértelmezett mezőket.
2. Vegyél fel egy Text Field-et a szülő nevének (például az ország nevének).
3. Vegyél fel egy Checkboxes Field-et a gyermekek kiválasztásához: a Fill Options From a Posts, a bejegyzéstípus a gyermek típus.
4. Add hozzá a Submit Button-t.
5. A Post-submit Actions részben az alapértelmezett Send Email műveletet cseréld Insert/Update Post műveletre. A műveletek sorrendje számít: fentről lefelé futnak, és új bejegyzésnél előbb be kell szúrni a bejegyzést. A bejegyzéstípus a szülő típus, az állapot Published, a mezőleképezésben a szövegmező a Post Title, a jelölőnégyzet marad az alapértéken.
6. Vegyél fel egy Connect Relation Items műveletet: a kapcsolat, a megfelelő Parent Item ID és Child Item ID, az Update Context üres.
7. Mentsd (Publish), tedd az űrlapot egy oldalra a Form widgettel, és próbáld ki.

A beküldés után az új szülő bejegyzés szerkesztőoldalán a kijelölt gyermekek kapcsolva vannak.

Szülő hozzárendelése egy gyermekhez

1. Új űrlap, a rejtett mező marad. Vegyél fel egy listamezőt, például Radio Field-et (csak egy szülő választható).
2. A Fill Options From a Posts, a bejegyzéstípus a szülő típus.
3. A Default mező Dynamic tags ablakában a Source „Related items”, a From Relation a kapcsolat, a From Object a szülő, a Initial Object ID From az Aktuális objektum ID-ja.
4. Az Insert/Update Post művelet bejegyzéstípusa most a gyermek típus.
5. A Connect Relation Items műveletben a Parent Item ID a rádiómező, a Child Item ID a rejtett mező (post_id), az Update Context értéke „We updating children items for the parent object”.
6. Mentsd, és tedd az űrlapot a gyermek bejegyzéstípus önálló sablonjába.

A beküldés után a gyermek szerkesztőoldalán a szülő kapcsolva van.

Új gyermek létrehozása szülő kijelölésével

1. Új űrlap; töröld az alapértelmezett mezőket. Vegyél fel egy Text Field-et az új gyermek nevének (például tour-name), és egy Radio Field-et a szülő kiválasztásához (Posts forrás, a szülő bejegyzéstípus). Add hozzá a Submit Button-t.
2. Az Insert/Update Post műveletet tedd az első helyre (új bejegyzésnél ez fontos; frissítő űrlapnál, ahol a rejtett mező adja a bejegyzés azonosítóját, a sorrend nem számít). A bejegyzéstípus a gyermek típus, az állapot Published, a mezőleképezésben a névmező legyen a Post Title.
3. A Connect Relation Items műveletben a Parent Item ID a szülőt kiválasztó mező, a Child Item ID az inserted_post_id, az Update Context üres.
4. Mentsd, és tedd az űrlapot egy tetszőleges oldalra.

A beküldés után létrejön az új gyermek bejegyzés, és a szülő kapcsolva van hozzá.

Kapcsolatok leválasztása űrlappal: Kapcsolódó elemek leválasztása űrlappal.