Advanced Custom Fields'tan taşıma

WPM Fields › Tools › Migrate from ACF, Advanced Custom Fields'ın (ACF) tuttuklarını Mass Custom Fields'a kopyalar:

• alan grupları; alanları, ayarları ve konum kurallarıyla birlikte;
• ACF seçenek sayfaları, yazı türleri ve taksonomileri;
• yazıların (tüm yazı türleri), terimlerin, kullanıcıların, yorumların ve seçenek sayfalarının kaydedilmiş değerleri.

Taşıma işlemi ACF'i yalnızca okur. Bir ACF alan grubunu, bir ACF değerini veya ACF'e ait başka hiçbir satırı değiştirmez ya da silmez; bu yüzden çalıştırıp iki eklentiyi yan yana karşılaştırabilir ve yalnızca memnun kaldığınızda ACF'i devre dışı bırakabilirsiniz. Bir şey ters giderse ACF'i yeniden etkinleştirebilirsiniz ve hiçbir şey kaybolmaz.

Başlamadan önce

• Veritabanını yedekleyin. Taşıma tablolar oluşturur ve değerler yazar. ACF verilerine dokunmaz, ancak yedek almak hiçbir şeye mal olmaz.
• Mümkünse taşıma sırasında ACF'i etkin tutun. Böylece ACF'in kendi fonksiyonları, ACF'in acf-json klasörüne kaydedilen veya PHP'de kaydedilen alan grupları dahil her şeyi okumak için kullanılır. ACF zaten devre dışıysa eklenti ACF verilerini doğrudan veritabanından okur; bu yöntem yalnızca ACF ekranlarında oluşturulan grupları, yazı türlerini, taksonomileri ve seçenek sayfalarını bulur (bunlar ACF'in veritabanında bıraktığı yazılar olarak saklanır).
• ACF Pro alanları için bu sitede doğru plan gerekir. Gallery, flexible content ve clone gelişmiş alan türleridir. Bunları içeren bir plan olmadan not included in your plan olarak listelenir ve atlanır. Bkz. Planlar ve lisanslama. Repeater, group, tab ve accordion ücretsizdir.
• ACF Pro devre dışı ama ücretsiz ACF etkinse repeater, flexible content ve clone alanları okunamaz (ACF bunları kendisi yüklemez). Rapor bu durumda None of its sub-fields can be copied. der. Taşıma için ACF Pro'yu etkinleştirin ya da veritabanı okuyucusunun kullanılması için ACF'i tamamen devre dışı bırakın.

Adım adım

1. Şunu açın: WPM Fields › Tools ve Migrate from ACF sekmesini seçin. Sayfa hemen bir rapor yükler: ACF'i okuyan ve hiçbir şey yazmayan bir dry run. Sekmeyi her açışınızda yenilenir.
2. • Hiçbir şey bulunmazsa sayfa No ACF data found der.
   • Kart başlığındaki rozet ACF active veya ACF inactive der; mavi bildirim ise Advanced Custom Fields 6.x is active. veya Advanced Custom Fields is not active; its data is read from the database.
2. Field Groups listesini okuyun. Her ACF alan grubunun bir onay kutusu (hepsi işaretli), bir başlığı ve şu rozetleri vardır:

İkinci satır, yeni grubun alacağı anahtarı, alan sayısını ve kaç nesnenin kaydedilmiş değeri olduğunu gösterir, örneğin Key book_details · 6 fields · 120 posts, 3 users veya No values stored.

3. Uyarı rozeti olan satırlarda Details bölümünü açın. Sade bir dille şunları listeler:
4. • Field "Intro" (message) is not copied: Message fields only show text and store no value.
   • Location rule "block == acf/hero" is left out: Blocks are not supported as a location.
   • şu tür notlar: a select with several values becomes checkboxes, değiştirilmek zorunda kalan bir anahtar ya da No location rule can be copied, so the group gets no location and its values are not copied. Add location rules and run the migration again.
4. Post types, Taxonomies ve Options pages listelerini okuyun:

5. İstemediğiniz alan gruplarının işaretini kaldırın. Yazı türleri, taksonomiler ve seçenek sayfaları her zaman dahil edilir.
6. Start migration düğmesine tıklayın. Bir iletişim kutusu Start the ACF migration? diye sorar ve ACF verilerine dokunulmayacağını yineler. Start migration ile onaylayın.
7. Tanımlar hemen oluşturulur. Değerler ardından arka planda partiler halinde kopyalanır (bkz. Arka plan görevleri); sayfadan ayrılabilirsiniz. Çalışırken Migration progress adlı ilerleme çubuğu ve N of M objects checked metni birkaç saniyede bir güncellenir.
8. İşlem bittiğinde kart Migration finished (veya Migration canceled) ifadesini, Values of N objects were copied (M values). mesajını, oluşturulan veya korunanların listesini ve bazı değerler dönüştürülemediyse nedenleriyle birlikte N values were skipped bilgisini gösterir (ilk 100 listelenir).

İptal, devam ettirme ve yeniden çalıştırma

• Cancel migration geçerli partiden sonra durdurur. Daha önce oluşturulan ve kopyalananlar kalır; durum Migration canceled olur.
• Arka plan kuyruğu durursa (örneğin kuyruk temizlendiyse veya WP-Cron devre dışıysa) yaklaşık beş dakika ilerleme olmadığında Resume düğmesi görünür. Partileri yeniden kuyruğa alır.
• Bir taşıma çalışırken ikincisini başlatamazsınız (A migration is already running.).
• İlk çalıştırmadan sonra düğme Run migration again yazar. İkinci çalıştırmanın ne yaptığı için aşağıya bakın.

İki kez çalıştırma

İkinci çalıştırma güvenlidir ve kullanılması amaçlanmıştır; örneğin editörler ilk çalıştırmadan sonra ACF'te çalışmaya devam ettiyse:

Satırlar güncellenir, asla çoğaltılmaz: bir yazı için grup başına bir satır vardır.

Yalnızca bazı grupları kopyalamak için başlamadan önce yalnızca onları işaretleyin. Değişen alan tanımlarını almak için önce taşınmış grubu Field Groups içinde silin (bu işlem tablosunu da kaldırır), ardından yeniden taşıyın.

Tam olarak nelerin kopyalandığı

Adlar ve anahtarlar

Alan türleri

Alan ayarları

Alan grubu ayarları

Konum kuralları

ACF konum kuralları ve eklentinin kuralları aynı mantıktadır: "bu kümelerden herhangi biri, her küme tüm kurallarını gerektirir". Karşılığı olmayan bir kural kümenin tamamını kaldırır; böylece bir grup hiçbir zaman ACF'tekinden daha fazla yerde gösterilmez. Rapor, dışarıda bırakılan her kuralı listeler. Hiç küme kalmazsa grup konumsuz oluşturulur ve siz kural ekleyene kadar değerleri kopyalanmaz.

Bir gruptan en fazla 20 küme korunur.

Yazı türleri, taksonomiler ve seçenek sayfaları

• Yazı türleri ve taksonomiler: her iki eklentide de bulunan tüm etiketler, görünürlük, menü, yeniden yazma, arşiv, yetki, REST ve "supports" ayarları. Simgeler: yalnızca Dashicons aktarılır. Adı ayrılmış veya geçersiz olan bir yazı türü Cannot be copied olarak listelenir.
• Seçenek sayfaları: başlık, menü başlığı, üst öğe, yetki, simge (Dashicons), konum, açıklama, güncelle düğmesi ve güncellendi mesajı. PHP'de acf_add_options_page() ile kaydedilen sayfalar ACF etkinse dahil edilir. Değerler options_{field name} seçenek adlarından (veya sayfanın özel post_id değerinin önekinden) okunur. Sayısal bir post_id desteklenmez.
• ACF etkinken kendi yazı türleri ve taksonomileri şu anda kayıtlı olduğundan kopyalar kapalı oluşturulur (Will be created switched off) ve ACF'i devre dışı bıraktıktan sonra açtığınızda çalışmaya devam eder.
• ACF etkin değilken birbirine başvuran bir yazı türü ve taksonomi (olağan durum), bağlantıları bozulmadan tek çalıştırmada birlikte oluşturulur: denetimler aynı çalıştırmada oluşturulan adları bilir ve taksonomi kendinden önce oluşturulan yazı türlerini korur.

Değerler

Değerler, ACF'in yazdığı standart yerlerden okunur ve yeni tablolara kopyalanır:

Bir nesnenin bir gruba ait değerleri olduğu, ACF'in kendi referansı (alan anahtarına işaret eden _field_name) mevcut olduğunda kabul edilir. Diğer meta satırlarına asla dokunulmaz. Her değer dönüştürülür ve ardından sanki elle yazılmış gibi yeni alan türü tarafından denetlenir; bu yüzden alanın kabul etmediği bir değer atlanır ve listelenir (The value could not be converted and was skipped. veya The value is longer than the column allows and was skipped.).

Bilmeye değer dönüşümler:

Kopyalanan değerler yalnızca yeni alan grubu tablolarına gider. wp_postmeta tablosuna yazılmaz.

Her iki eklentiyi birlikte kullanma

Taşımadan sonra ACF'i etkin tutabilirsiniz. İki eklenti değerlerin ayrı kopyalarını tutar:

• Bir editörün ACF kutularında kaydettiği her şey hâlâ ACF'in satırlarına (wp_postmeta) gider. Mass Custom Fields'ın yazma köprüsü, ACF'in yönettiği anahtarlara bilerek dokunmaz; böylece ACF çalışmaya devam eder. ACF'te yapılan düzenlemeler, taşımayı yeniden çalıştırana kadar yeni tabloda görünmez.
• Yeni kutularda kaydedilen her şey yeni tablolara gider.
• Bir grup aynı düzenleme ekranında her iki eklentide de görünüyorsa editörler iki kutu görür. Editörlerin yeniden çalışmasına izin vermeden önce alanların hangi eklentiye ait olacağına karar verin.

ACF'i devre dışı bırakmadan önce

Bu listeyi uygulayın:

• Raporda beklenmeyen N not copied rozeti yok ve Details içindeki her notu okudunuz.
  
• N values were skipped boş veya anlaşılmış durumda.
  
• Birkaç yazı, bir terim, bir kullanıcı, bir yorum ve her seçenek sayfasını açıp değerleri ACF ile karşılaştırın.
  
• Temanız ve eklentileriniz artık ACF fonksiyonlarını çağırmıyor. get_field(), the_field() ve [acf] shortcode'u ACF olmadan bulunmaz ve bunları korumasız çağıran bir tema hata verir. Bunun yerine wpmcf_get_field(), wpmcf_the_field(), [wpmcf_field] shortcode'u, {{ }} değişkenleri veya sayfa oluşturucu dinamik etiketlerini kullanın. Bkz. Geliştirici API'si ve Entegrasyonlar. Alan anahtarıyla get_post_meta() taşınan grupların alanları için çalışmaya devam eder.
  
• kapalı oluşturulan yazı türleri ve taksonomiler, Post Types ve Taxonomies ekranlarında açılmıştır.
  
• Konumsuz oluşturulan alan grupları kurallarını almıştır.
  
• ACF'in desteklediği blok, widget ve menü konumları, şu an kullandığınız yöntemle değiştirilmiştir.
  
• Güncel bir yedeğiniz var.
  

Her şey eşleştiğinde ACF'i devre dışı bırakın. Verileri veritabanında kalır, böylece istediğiniz zaman geri dönebilirsiniz.

WP-CLI

wp wpmcf acf report
wp wpmcf acf migrate --dry-run
wp wpmcf acf migrate --groups=group_5f3a1b2c4d5e6

CLI, kopyalamanın tamamını ön planda çalıştırır. Bkz. WP-CLI.

Bilinen sınırlar

• Taşınmaz ve raporda listelenir: message alanları, diğer eklentilerin alan türleri, saklanan seçenekler arasında olmayan seçenek değerleri, 200'ü aşan repeater satırları, rgba renkler, medya ve URL simgeleri, Page Link içindeki arşiv URL'leri, sayısal post_id değerine sahip seçenek sayfaları, WPML dil son eki içeren seçenek adları ile widget veya blok değerleri.
• Flexible content ve clone alanları (bunları içeren planlarda) yukarıdaki sınırlarla taşınır.
• Yazı türleri ve taksonomiler her zaman seçtiğiniz gruplarla birlikte taşınır: bunları dışarıda bırakamazsınız.
• Taşımayı çalıştırmak alan grubu tanımlarını güncellemez (bkz. İki kez çalıştırma).

Sorun giderme

ACF kurulu olduğu halde "No ACF data found". ACF tanımlarını yazı olarak saklar. Yalnızca acf-json klasöründe veya PHP'de tanımlanan gruplar ancak ACF etkinken görünür. ACF'i etkinleştirin ve sekmeyi yeniden yükleyin.

Bir alan grubu something_2 anahtarını aldı. İlk anahtara sahip bir grup zaten var. Rapor bunu başlamadan önce belirtir.

Bir grup taşındı ama değerler gelmedi. Grubun Details bölümünü açın. No location rule can be copied... mesajı grubun konumu olmadığı, dolayısıyla değerlerin konacağı bir tablo satırı olmadığı anlamına gelir. Field Groups içinde konum kuralları ekleyin, ardından Run migration again düğmesine tıklayın.

Taşıma "running" durumunda kalıyor. Kuyruk işlenmiyor. Tools › Scheduled Actions (WordPress) ekranını açıp wpmcf/acf/migrate eylemini çalıştırın, WP-Cron'un devre dışı olmadığından emin olun veya Resume düğmesine tıklayın. Çalışan bir cron'u olmayan sunucularda wp wpmcf acf migrate komutunu kullanın.

ACF'te her şey çalışıyor ama bir yazıda yeni kutu boş. Yazının o alan için ACF referans satırı (_field_name) yoktu; bu, ACF dışında update_post_meta() ile yazılan değerlerde olur. Yazıyı ACF'te yeniden kaydedin veya değeri wpmcf_update_field() ile kopyalayın.

Bazı değerler "could not be converted" nedeniyle atlandı. Yeni alan türü, ACF'in sakladığı değeri reddeder; örneğin artık var olmayan bir seçenek, silinmiş bir ek ya da çöpe atılmış bir yazının kimliği. Verileri ACF'te düzeltin ve taşımayı yeniden çalıştırın.