Bejegyzés létrehozása és frissítése a frontenden

A Bejegyzés létrehozása és a Bejegyzés frissítése űrlapművelettel a frontenden lévő Űrlap elem új WordPress-bejegyzést hozhat létre, vagy meglévőt frissíthet, anélkül hogy a felhasználót a wp-adminra küldenéd.

Ilyen munkafolyamatokra használhatod: ingatlanhirdetések, apróhirdetések, tagok által beküldött bejegyzések, profiloldalak vagy ügyfélportálok. A példák egy property nevű egyéni bejegyzéstípust használnak, de a szabályok bármelyik, a webhelyen létező nyilvános bejegyzéstípusra érvényesek.

Mielőtt belekezdesz

Az űrlap építése előtt döntsd el:

• melyik bejegyzéstípust hozza létre vagy frissíti az űrlap;
• kik küldhetik be az űrlapot;
• az új bejegyzések piszkozatként, jóváhagyásra várva, közzétéve vagy más elérhető állapotban mentődjenek;
• az űrlap mely alap bejegyzésmezőket, egyéni mezőket és taxonómiákat módosíthatja;
• a feltöltött fájlok bekerüljenek-e a Médiatárba. A kiemelt kép, a melléklet-bejegyzések és sok ACF/Meta Box médiamező melléklet-azonosítót igényel.

Bejegyzés létrehozása vagy frissítése űrlapból

A létrehozás és a frissítés ugyanazt a mintát követi: felveszed a mezőket, kiválasztod az űrlapműveletet, majd hozzárendeled a mezőket a módosítandó WordPress-adatokhoz.

1. lépés: mezők felvétele a bejegyzésadatokhoz

Hozz létre az Űrlap elemben mezőt mindahhoz a bejegyzésadathoz, amelyet mentenél:

Bejegyzésadat	Ajánlott mezőtípus
Bejegyzés címe	Szöveg
Bejegyzés tartalma	Formázott szöveg (rich text)
Bejegyzés kivonata	Szövegterület
Kiemelt kép	Kép
Bejegyzés metaadata	Az egyéni mezőhöz leginkább illő mezőtípus
Taxonómia-kifejezések	Jelölőnégyzet, választógomb vagy legördülő lista

Bejegyzés metaadata

Minden módosítani kívánt metaadathoz a legmegfelelőbb mezőtípust válaszd. A Bricks a hozzárendelt metaadatot a metakulcstól és a webhelyen elérhető integrációktól függően ACF-en, Meta Boxon vagy az update_post_meta() függvényen át tárolja.

A jelölőnégyzet, a választógomb és a legördülő lista mezőknél a Bricks automatikusan betöltheti a választási lehetőségeket az ACF-ből vagy a Meta Boxból, ha:

• a mező egy megfelelő metakulcshoz van rendelve;
• az űrlapmezőnek nincsenek kézi opciói;
• az ACF vagy a Meta Box fel tudja oldani a mezőt a bejegyzéshez vagy bejegyzéstípushoz.

Ha kézi opciókat adsz az űrlapmezőhöz, a Bricks azokat használja.

Taxonómia

A kategóriákhoz, címkékhez vagy egyéni taxonómiákhoz használj jelölőnégyzetet, választógombot vagy legördülő listát. Az opciókat üresen hagyhatod: ha a mező hozzá van rendelve a Taxonómiák ismétlőben, a Bricks automatikusan feltölti a kiválasztott taxonómia kifejezéseivel.

Ha kézzel adsz meg opciókat, a beküldött értékek a kifejezések azonosítói legyenek. A Bricks a taxonómiakifejezéseket azonosító szerint menti. Ha a hozzárendelt taxonómiamező üres, a Bricks törli az adott taxonómia kifejezéseit a bejegyzésről.

2. lépés: az űrlapművelet kiválasztása

Szerkeszd az Űrlap elemet, és a Műveletek vezérlőcsoportban válaszd a Bejegyzés létrehozása vagy a Bejegyzés frissítése műveletet.

A műveletek sorrendje számít. Ha egy művelet hibát ad, a Bricks leállítja a többi művelet feldolgozását. Az Átirányítás művelet mindig a lista végére kerül, hogy a többi kiválasztott művelet előbb lefuthasson.

3. lépés: a művelet beállítása

Új bejegyzés létrehozásakor a Bejegyzés létrehozása vezérlőcsoportban válaszd ki a bejegyzéstípust, amelyhez új bejegyzést akarsz létrehozni.

Meglévő bejegyzés frissítésekor a Bejegyzés frissítése vezérlőcsoportban válaszd ki a frissítendő bejegyzést. Ha a Frissítendő bejegyzés mezőt üresen hagyod, az aktuális bejegyzés frissül. Ha az űrlap lekérdezési ciklusban van, a Bricks a beküldött ciklusobjektum azonosítóját használja, így minden ismétlődő űrlap a saját ciklusbeli elemét frissíti.

Mindkét művelethez tartozik egy Bejegyzés állapota beállítás. A létrehozásnál az üresen hagyott érték mellett a WordPress alapértelmezett beszúrási viselkedése érvényesül. A frissítésnél az üres érték megtartja a bejegyzés jelenlegi állapotát.

Ha a Bejegyzés létrehozása bejelentkezett felhasználónál fut le, ő lesz a bejegyzés szerzője. Ha kikapcsolod a jogosultság-ellenőrzést, és névtelen beküldést engedélyezel, a Bricks a webhely első szuperadminisztrátorát rendeli szerzőnek.

4. lépés: a mezők hozzárendelése

Az utolsó és legfontosabb lépés az űrlapmezők összekapcsolása a beküldéskor módosítandó bejegyzésadatokkal. A hozzárendelés vezérlői szintén a Bejegyzés létrehozása és a Bejegyzés frissítése vezérlőcsoportban vannak.

Egyszerű bejegyzésadatok hozzárendelése

Az egyszerű adatoknál, vagyis a bejegyzés címénél, tartalmánál, kivonatánál és a kiemelt képnél csak ki kell választanod a megfelelő űrlapmezőt a legördülő listából.

A kiemelt képhez és a melléklet-bejegyzésekhez olyan mezőket használj, amelyek a Médiatárba mentik a feltöltést, hogy a Bricks a feltöltött melléklet azonosítójával dolgozhasson.

A Bricks a WordPress kiemelt kép logikájának hívása előtt ellenőrzi, hogy a hozzárendelt érték képmelléklet-azonosító-e. Ha a hozzárendelt mezőnek nincs értéke, a Bricks eltávolítja a kiemelt képet.

Metaadat hozzárendelése

A bejegyzés metaadatának űrlapmezőn át történő módosításához vegyél fel egy elemet a Bejegyzés metaadata alatt, és add meg:

• Metakulcs: a frissítendő egyéni mező kulcsa. A Bricks mentés előtt megtisztítja a kulcsot.
• Metaérték: az az űrlapmező, amelynek beküldött értékét menteni kell.
• Tisztítási módszer: hogyan tisztítsa a Bricks a beküldött értéket mentés előtt.

Az elérhető tisztítási módszerek: szöveg, egész szám, lebegőpontos szám, e-mail, URL és bejegyzésbarát HTML. Azokat az értékeket, amelyeket az ACF vagy a Meta Box nem kezel, a Bricks a WordPress bejegyzés-metaadatába menti.

ACF és Meta Box kezelése

Ahol lehet, a Bricks az ACF-mezőket az update_field(), a Meta Box mezőket az rwmb_set_meta() függvénnyel frissíti, nem csak nyers metaadatot ír. Ez azoknál a mezőtípusoknál fontos, amelyek meghatározott értékformát várnak.

A médiamezőkhöz a fájlfeltöltő mezők a Médiatárba mentsék a fájlokat. A Bricks a létrehozás/frissítés művelet előtt feldolgozza ezeket a feltöltéseket, így a hozzárendelt mezők megkaphatják a melléklet-azonosítókat.

ACF csoportmezőknél a Bricks fel tudja oldani a beágyazott metakulcsokat, és frissíti a szülő csoport értékét, hogy a beágyazott adat szerkezete megmaradjon.

Taxonómiák

A taxonómia hozzárendelése egyszerű: a Taxonómiák alatt válaszd ki a frissítendő taxonómiát és a hozzá tartozó űrlapmezőt.

A kifejezéseket nem kell kézzel felvenned, kivéve, ha korlátozni szeretnéd a választékot. A Bricks automatikusan feltölti az űrlapmezőt a kiválasztott taxonómia kifejezéseivel, ha a hozzárendelt mezőnek nincsenek kézi opciói.

Biztonság és ellenőrzés

A Bricks a létrehozás/frissítés művelet előtt is lefuttatja a szokásos űrlapbeküldési ellenőrzéseket:

• Az AJAX-beküldésnek érvényes Bricks űrlap-nonce-t kell tartalmaznia.
• A beküldött mezőazonosítóknak meg kell egyezniük az űrlapbeállításokban létező mezőkkel. A váratlan vagy ismétlődő azonosítókat a Bricks elutasítja.
• A kötelező mező, a maximális hossz, a méztál (honeypot) és a bekapcsolt captcha ellenőrzése a műveletek előtt lefut.
• A művelet a szerveroldalon ismét ellenőrzi a jogosultságokat, hacsak ki nem kapcsoltad.

Ha a jogosultság-ellenőrzés be van kapcsolva, a jogosulatlan felhasználóknak az űrlap meg sem jelenik. Ha a Bejegyzés létrehozása vagy a Bejegyzés frissítése vezérlőcsoportban egyéni hibaüzenetet adtál meg, a Bricks azt jeleníti meg.

Gyakori megoldások

Beküldött bejegyzések jóváhagyásra

Használd a Bejegyzés létrehozása műveletet, hagyd bekapcsolva a jogosultság-ellenőrzést a megbízható, bejelentkezett felhasználóknak, és a Bejegyzés állapota legyen Függőben vagy Piszkozat. Csak azokat a mezőket rendeld hozzá, amelyeket a felhasználók szerkeszthetnek.

A szerzők a saját bejegyzéseiket szerkesztik

Használd a Bejegyzés frissítése műveletet, hagyd üresen a Frissítendő bejegyzés mezőt egy egyedi bejegyzéssablonban, és tartsd bekapcsolva a jogosultság-ellenőrzést. A WordPress csak akkor engedi a frissítést, ha az aktuális felhasználó szerkesztheti az adott bejegyzést.

Lekérdezési cikluson belüli elemek frissítése

Tedd a frissítő űrlapot a lekérdezési cikluson belülre, és hagyd üresen a Frissítendő bejegyzés mezőt. A Bricks elküldi a ciklusobjektum azonosítóját, és a megfelelő ciklusbeli elemet frissíti.

Mellékletbejegyzések létrehozása feltöltésekből

Állítsd a bejegyzéstípust Melléklet értékre, és használj a Médiatárba mentő fájlfeltöltő mezőt. A Bricks az első megtalált feltöltött mellékletet használja, és a hozzárendelt mezőkön át frissítheti a címét, tartalmát, kivonatát, állapotát, metaadatait és kifejezéseit.

Szűrők

A Bricks sok ACF- és Meta Box-mezőtípust alapból támogat, de minden egyedi beállítás más. A hozzárendelt metaértékeket mentés előtt ezekkel a szűrőkkel módosíthatod:

• bricks/form/create_post/meta_value
• bricks/form/update_post/meta_value

Az űrlapműveletek általános leírását lásd az Űrlap: műveletek és egyéni fejlesztés fejezetben.