Átállás az ACF-ről és a CPT UI-ról a JetEngine-re

Ha az oldalad metamezőit az Advanced Custom Fields (ACF), az egyedi bejegyzéstípusait pedig a Custom Post Type UI (CPT UI) kezeli, az átállás a JetEngine-re nem jár adatvesztéssel. A módszer azon alapul, hogy a WordPress az egyedi bejegyzéstípusokat, taxonómiákat és metaadatokat akkor is megtartja az adatbázisban, ha az őket regisztráló bővítményt eltávolítod. Ha a JetEngine-ben ugyanazt a slugot és ugyanazt a metakulcsot használod, a meglévő tartalom magától felismerhető.

Nincs hivatalos, egykattintásos automatikus átvitel, ez egy a gyakorlatban bevált eljárás. Mielőtt belekezdesz, készíts teljes mentést a weboldalról és az adatbázisról, mert hiba esetén csak a mentésből tudod visszaállítani az oldalt.

Előfeltétel: az ACF és/vagy a CPT UI be van állítva, a JetEngine pedig telepítve és aktív.

Egyedi bejegyzéstípus átvitele

1. Nyisd meg a JetEngine → Bejegyzéstípusok oldalt, és kattints az új típus hozzáadására.
2. A Bejegyzéstípus slug mezőbe pontosan azt a slugot írd, amelyet a CPT UI-ban használtál.
3. Töltsd ki a Bejegyzéstípus neve mezőt, és mentsd a típust a Bejegyzéstípus hozzáadása gombbal.

https://minta-bolt.hu/wp-admin/admin.php?page=jet-engine-cpt&cpt_action=add

Amint a slug egyezik, a JetEngine felismeri a meglévő bejegyzéseket, és azok átkerülnek az új típushoz.

Ha a slug megváltozik

Ha a bejegyzéseket másik slugú JetEngine-típusba akarod áttenni:

1. Telepítsd és aktiváld a Post Type Switcher bővítményt.
2. Menj a CPT UI-os bejegyzéstípus listájára, és minden bejegyzésnél, a cím fölé víve az egeret, kattints a Gyorsszerkesztés hivatkozásra. Válaszd ki a megfelelő JetEngine-bejegyzéstípust.
3. Töröld a régi, CPT UI-os bejegyzéstípust.
4. A JetEngine → Bejegyzéstípusok oldalon nyisd meg a kívánt típust szerkesztésre, és nyisd ki az Advanced Settings szakaszt. Kapcsold be a Rewrite kapcsolót, és a Rewrite Slug mezőbe írd be a CPT UI-ban használt eredeti slugot.

ACF-metamezők átvitele

Az ACF-mezőket kézzel kell újra létrehozni a JetEngine-ben.

1. Nyisd meg a JetEngine → Metaboxok oldalt, és add hozzá az új metaboxot.
2. Írd be a Meta doboz címe mezőbe a metabox nevét, és a Meta doboz célja listában válaszd ki a forrást (jelen esetben „Bejegyzés”).
3. Ha kell, állítsd be a Láthatósági feltételek szakaszt. A Bekapcsolás bejegyzéstípusoknál mezőben megadhatod, melyik bejegyzéstípusnál jelenjen meg a metabox.
4. A Metamezők szakaszban az Új metamező gombbal vedd fel a szükséges mezőket.

https://minta-bolt.hu/wp-admin/admin.php?page=jet-engine-meta&cpt_meta_action=add

A kulcs: a JetEngine-mező Name/ID értékének pontosan egyeznie kell az ACF-mező Field Name (mezőnév) értékével. Ha a kulcsok egyeznek, a meglévő bejegyzések adatai betöltődnek, és semmit nem kell újra beírni. Miután ellenőrizted, hogy az adatok jól látszanak, az ehhez a bejegyzéstípushoz tartozó ACF-mezőket és mezőcsoportokat törölheted.

Taxonómiák átvitele

1. Nyisd meg a JetEngine → Taxonómiák oldalt, és hozz létre új egyedi taxonómiát.
2. A Taxonómia slug mezőbe a CPT UI-os taxonómia slugját írd.
3. A Bejegyzés típusa mezőben válaszd ki a hozzá tartozó bejegyzéstípusokat.
4. Ne vegyél fel kifejezéseket kézzel, a taxonómia maradjon üres.

https://minta-bolt.hu/wp-admin/admin.php?page=jet-engine-cpt-tax&cpt_tax_action=add

Az eredeti taxonómia kifejezései a bejegyzés-hozzárendelésekkel együtt automatikusan átkerülnek az új taxonómiához. Ezután az eredeti taxonómiát törölheted a CPT UI-ból.

A régi bővítmények eltávolítása

Mielőtt a CPT UI-t és az ACF-et kikapcsolod és törlöd, ellenőrizd, hogy:

• a bejegyzések helyesen jelennek meg a JetEngine típusaiban;
• a metamezők adatai az elülső és a hátsó oldalon is helyesen látszanak;
• a taxonómia kifejezései és a hozzárendelések sértetlenek.

Nem kell mindent egyszerre átvinni: a bejegyzéstípusok, a metamezők és a taxonómiák egymástól függetlenül is átvihetők, attól függően, hogy az oldalon melyik bővítmény mit kezelt.

Korlátozás: ismétlő mezők

Az ACF és a JetEngine alapjaiban más formátumban tárolja az ismétlő (repeater) mezők adatait:

	ACF	JetEngine
Sorok száma	Külön metamezőben tárolódik	Nem tárolódik külön
Sorok értékei	Soronként sorszámmal tárolva	Egyetlen összefűzött tömbben
Mezőkulcs formátuma	ismetlo_neve_0_almezo	ismetlo_neve és az almező

Az ismétlő mezőkre jelenleg nincs közvetlen átviteli út. Az adatokat az átállás után kézzel kell újra felvenni, vagy közösségi megoldást kell keresni.

Gyakori kérdések

Megmaradnak a bejegyzéseim a CPT UI-ról a JetEngine-re váltáskor? Igen, ha a JetEngine-típust a CPT UI-os típussal azonos slugon hozod létre, a WordPress felismeri a meglévő bejegyzéseket.

Törölhetem rögtön az ACF-et és a CPT UI-t? Nem. Előbb ellenőrizd, hogy a bejegyzések, metamezők és taxonómiák jól működnek a JetEngine-ben.

Vihetem csak az ACF-mezőket, vagy csak a CPT UI-os típusokat? Igen, külön is átvihetők.

Miért működik a slug szerinti egyeztetés? A WordPress az egyedi bejegyzéstípusokat, taxonómiákat és metaadatokat az eredeti bővítmény eltávolítása után is az adatbázisban tartja, ezért a JetEngine ugyanazon slugok és metakulcsok mellett felismeri a meglévő tartalmat.

Példa: ACF-mezők átvitele a JetEngine-be

Az alábbi példában egy „Ingatlanok” bejegyzéstípushoz tartozó ACF-mezőcsoportot viszünk át, amely „Szöveg”, „Jelölőnégyzet” és „Kép” mezőt tartalmaz. Más mezőtípusok átviteléhez egyedi kód is kellhet.

Az ACF-mezők ellenőrzése

Nyisd meg az ACF → Field Groups oldalt, és nyisd meg az átvinni kívánt mezőcsoportot. A Location Rules fülön látod, melyik bejegyzéstípushoz tartozik a csoport, ugyanehhez a típushoz kell majd a JetEngine-metaboxot hozzáadni.

• Szöveg mező: jegyezd fel a Field Name értékét (például a „Property Style” címkéjű mező mezőnevét).
• Jelölőnégyzet mező: a Field Name (például amenities) mellett jegyezd fel a Choices (lehetőségek) tartalmát is, például: „Ingyenes Wi-Fi”, „Medence”, „Parkoló”, „Kerti étkező”. A Return Value értéke „Value” legyen.
• Kép mező: a Field Name (például property_image) mellett nézd meg a Return Format beállítást, amelynek „Image URL” értéket kell mutatnia. A Library beállítás tetszőleges.

A JetEngine-metabox létrehozása

1. Nyisd meg a JetEngine → Metaboxok oldalt, és add hozzá az új metaboxot.
2. Írd be a Meta doboz címe mezőbe a metabox nevét, és a Meta doboz célja listában válaszd a „Bejegyzés” értéket.
3. A Láthatósági feltételek szakasz Bekapcsolás bejegyzéstípusoknál mezőjében add meg a megfelelő bejegyzéstípust (itt „Ingatlanok”).
4. A Metamezők szakaszban kattints az Új metamező gombra.
5. Szöveg mező: add meg a címkét, a Name/ID mezőbe másold be az ACF szövegmezőjének Field Name értékét, a mező típusa legyen „Text”.
6. Jelölőnégyzet mező: új metamező, a Name/ID egyezzen az ACF Field Name értékével, a típusa „Checkbox”. A forrás legyen „Bulk Manual Input”, így az összes lehetőséget egyben, soronként beírhatod az ACF-ben szereplő formában. Kapcsold be a Save as array kapcsolót.
7. Kép mező: új metamező, a Name/ID egyezzen az ACF Field Name értékével, a típusa „Media”. A Value format értéke legyen „Media ID”.
8. A mentéshez kattints a Metabox hozzáadása gombra.

Ellenőrzés és takarítás

Nyisd meg az érintett bejegyzéstípus egyik bejegyzését. Mivel az adat átkerült az ACF-ből a JetEngine-be, a metaadatok mind a JetEngine, mind az ACF mezőiben megjelennek. Ha minden rendben működik, az ACF → Field Groups oldalon a Kuka (Trash) gombbal törölheted az átvitt mezőcsoportot.