Tanımları dışa ve içe aktarma (JSON)
6 dk okuma
Massbase › Tools › Export & import, tanımları tek bir dosyayla bir siteden diğerine kopyalar. Kaydedilmiş alan değerleri dahil değildir; değerleri taşımak için WordPress dışa aktarma dosyaları (WXR) ve kopyalar sayfasına bakın.

Dışa aktarma
- Massbase › Tools ekranını açın. Export & import sekmesi varsayılandır.
- Export kartında istediklerinizi işaretleyin. En az bir öğesi olan her tür, adı ve sayısıyla başlıklandırılmış kendi kutusunu alır; örneğin Field Groups (3). Her öğe etiketini ve anahtarını gösterir.
- Bir türün tüm öğelerini seçmek için kutu başlığını işaretleyin.
- Select all en üstte her şeyi seçer.
- Düğmenin yanındaki sayaç %d selected gösterir.
- Download JSON düğmesine tıklayın. Tarayıcı
wpmcf-export-YYYY-MM-DD.jsondosyasını kaydeder.
Henüz hiçbir şey oluşturmadıysanız kart Nothing to export yet der.
Download JSON düğmesi, en az bir öğe işaretlenene kadar devre dışı kalır.
Dosyanın görünümü
{
"format": "wpmcf-export",
"version": 1,
"plugin_version": "1.0.0",
"exported_at": "2026-10-03T12:58:39+00:00",
"post_types": [],
"taxonomies": [],
"options_pages": [],
"field_groups": []
}- Dört bölümün tamamı her zaman bulunur; seçmediğiniz bölümler boş listelerdir.
- Alan grupları alanlarını (alt alanlar, koşullu mantık, ayarlar ve doğrulamayla birlikte), konum kurallarını ve grup ayarlarını taşır. Her alanın bir
uiddeğeri vardır; bu, yeniden adlandırıldıktan sonra bile içe aktarıcının alanı tanımasını sağlayan kalıcı bir tanımlayıcıdır. - Oluşturma ve değiştirme tarihleri dışa aktarılır ancak içe aktarmada yok sayılır: hedef site kendi tarihlerini korur.
- Dosya okunabilir ve fark (diff) dostudur (düzenli biçimlendirilmiş; kaçışlanmış eğik çizgi veya Unicode yok).
İçe aktarma
- Import kartında Choose JSON file düğmesine tıklayın ve bu eklentinin oluşturduğu bir dosyayı seçin. (Yalnızca
.jsondosyaları.) - Önizleme hemen başlar. Henüz hiçbir şey kaydedilmez. Preview listesi her tanım için bir satır gösterir:
Rozet | Anlamı |
|---|---|
New | Bu sitede yok ve oluşturulacak. |
Replace | Mevcut ve değiştirilecek (yalnızca Replace existing definitions açıkken). |
Kept | Mevcut ve dokunulmayacak. |
Error | İçe aktarılamıyor. İleti nedenini söyler. |
Her satır etiketi, anahtarı, türü ve bir iletiyi gösterir. Uyarılar satırın altında turuncu renkte, dosya genelindeki uyarılar listenin üstündeki bir bildirimde görünür.
- Üzerine yazma konusunda karar verin. Replace existing definitions varsayılan olarak kapalıdır; bu yüzden bu sitede zaten var olan tanımlar olduğu gibi korunur. Onları değiştirmek için açın. Anahtarı çevirdiğinizde önizleme yeniden yüklenir.
- Import N definition(s) düğmesine tıklayın. Önizlemede oluşturulacak veya değiştirilecek bir şey yokken düğme devre dışıdır.
- Result listesi önizlemenin yerini alır; rozetler Created, Replaced, Kept ve Error olur. Bir bildirim Import finished. der; en az bir satır başarısız olduysa Import finished with errors. See the list below.

Başarısız bir satır diğerlerini asla durdurmaz: her öğe kendi başına içe aktarılır. Tools içindeki büyük bir içe aktarma güvenli biçimde durur ve nelerin kaldığını söyler; böylece devam etmek için yeniden çalıştırabilirsiniz. Dosyayı (veya siteyi) düzeltip yeniden içe aktarın; önceden işlenen öğeler bu kez yalnızca Kept olur.
Sıra ve başvurular
Öğeler şu sırayla içe aktarılır: yazı türleri, taksonomiler, seçenek sayfaları, alan grupları. Bu sıra, bir alan grubunun aynı dosyanın oluşturduğu bir yazı türüne yerleştirilmesini ve aynı dosyadaki bir yazı türü ile bir taksonominin birbirine başvurmasını sağlar. Ne dosyada ne de sitede bulunan öğelere yapılan başvurular hatadır.
Bir alan grubuna ne olur
Bir alan grubunu içe aktarmak, editörde kaydetmekle aynı koddan geçer:
- Yeni bir grubun tablosu hemen oluşturulur. Çok sayıda yeni grup içeren bir dosya biraz zaman alır.
- Bir grubu değiştirmek, grubu kaydetmenin yapacağı gibi sütun ekler, yeniden adlandırır, türünü değiştirir ve kaldırır. Çok büyük bir tablo bunun yerine arka planda değiştirilir; satır bu durumda şu uyarıyı taşır: The table is large, so the database change runs in the background. The new definition is used once it is done.
- Kaldırılan bir alandaki veriler silinmez. Bkz. Bir alan grubunu güvenle değiştirme.
- Doğru plana sahip olmayan bir sitede, gelişmiş bir alan türü içeren grup başarısız olur: Field "pics": the Gallery field type is not included in your plan.
- Bir terime işaret eden konum kuralları (yazı kategorisi, yazı taksonomisi) terimin id değerini saklar ve kimlikler siteden siteye farklıdır. İçe aktardıktan sonra bu kuralları kontrol edin.
Dosyayı kendiniz yazarken anahtarlar ve uid'ler
Anahtarlar, WordPress'in slug'ları temizlediği şekilde temizlenir: küçük harfler, rakamlar, tireler ve alt çizgiler. Bad Key! gibi bir anahtar badkey olarak içe aktarılır.
uid değeri olmayan alanlar sorun değildir. Var olan bir grubun üzerine içe aktardığınızda (Replace existing definitions açık), uid değeri olmayan bir alan, aynı uid yerine aynı key değerine sahip alanın saklanan uid değerini yeniden kullanır; böylece içe aktarıcı aynı alanı görür ve hiçbir sütun silinmez veya yeniden oluşturulmaz. Dosyada bir uid değerini yine de koruyun; bir alan anahtarını yeniden adlandırdığınızda, içe aktarıcıya bunun aynı alan olduğunu söyleyen uid değeridir. Yeni bir anahtarı olan ve uid değeri olmayan alan yeni bir alandır.
Download JSON ile oluşturulan dosyalarda her zaman uid'ler bulunur.
Karşılaşabileceğiniz iletiler
Dosyanın tamamı reddedilir
İleti | Neden |
|---|---|
This file is too large to import. | Tarayıcı denetimi: dosya 5 MB'tan büyük. |
The file is larger than 5 MB. | Sunucu denetimi (WP-CLI ve Local JSON için de). |
The file is not valid JSON. | JSON değil ya da nesne yerine liste olan bir JSON. |
This file is not a Massbase Custom Fields export. |
|
The file has no valid format version. |
|
This file was made by a newer version of the plugin. Update the plugin and try again. |
|
Uyarılar (içe aktarma yine de çalışır)
İleti | Anlamı |
|---|---|
Ignored unknown section "name". | Dört bölümden biri olmayan üst düzey bir anahtar. |
Skipped "Field Groups": it is not a list. | Tanım listesi olmayan bir bölüm. |
Bir tanım başarısız olur
İleti | Neden |
|---|---|
This entry is not an object and was skipped. | Liste öğesi bir tanım değil. |
This entry has no key. | Şu değer yok: |
This key appears more than once in the file; only the first entry is imported. | Aynı dosyada yinelenen anahtar. |
"fields" must be a list. |
|
Field "a": the field type "x" does not exist. | Bilinmeyen alan türü. |
Unknown location parameter "x". | Bu eklentinin tanımadığı bir konum kuralı. |
This post type key is reserved by WordPress. | Ad, çekirdeğe veya başka bir eklentiye ait. |
This entry is not in the expected format. | Bir değerin türü yanlıştı. |
Something went wrong while importing this entry. Details are in Massbase › Settings › Health. | Beklenmeyen bir hata; günlüğe yazılır. |
Geliştiriciler için
Tools ekranı şu REST rotalarını kullanır (ad alanı wpmcf/v1, yalnızca yöneticiler):
Rota | Amaç |
|---|---|
| Katalog: öğeleriyle birlikte türler. |
| Gövde |
| Gövde |
Sorun giderme
Önizleme her alan grubu için Error gösteriyor. Bir satırın iletisini açın. En yaygın nedenler, gelişmiş bir alan türü için plan eksikliği ve bu sitede var olmayan bir şeye işaret eden bir konum kuralıdır.
Grup içe aktarıldı ancak verilerim yok. Tanımlar hiçbir zaman değer içermez. Yazılar için WXR'yi, ACF verileri için ACF taşıma aracını kullanın.
Replace bir yazı türü için hiçbir şey yapmadı. Yazı türleri ve taksonomiler bütün olarak değiştirilir. Önizleme rozetini kontrol edin: Replace yazmalı, Kept değil. Kept yazıyorsa Replace existing definitions kapalıdır.
"Choose JSON file" dosyamı kabul ediyor ancak önizleme boş. Dosya geçerli ancak hiç tanım içermiyor: The file contains no definitions.
Hâlâ takıldınız mı? Destek ile iletişime geçin