WP-CLI komutları

Tüm komutlar wp wpmcf ile başlar. Eklenti etkin olduğunda ve WP-CLI WordPress'i yüklediğinde kullanılabilirler. Ekranlarla aynı işi tarayıcı sınırları olmadan yaparlar (5 MB yükleme formu yok, cron gerekmez); bu yüzden dağıtımlara ve büyük sitelere uygundur.

Çok siteli (multisite) kurulumda komutun doğru site için çalışması için --url=<site url> ekleyin; kurulumunuzun gerektirdiği yerlerde --user=<admin> de ekleyin.

wp wpmcf export

wp wpmcf export [--kinds=<list>] [--items=<list>] [--file=<path>]

Ne --kinds ne de --items verilirse her şey dışa aktarılır. --kinds ve --items birlikte kullanılabilir. Çıktı, Tools ekranının indirdiği belgeyle aynıdır (bkz. Dışa ve içe aktarma (JSON)).

wp wpmcf export > definitions.json
wp wpmcf export --kinds=field_groups --file=field-groups.json
wp wpmcf export --items=field_groups:book_details,post_types:book --file=book.json

Var olmayan bir öğe sessizce dışarıda bırakılır.

wp wpmcf import

wp wpmcf import <file> [--overwrite] [--dry-run]

wp wpmcf import definitions.json --dry-run
wp wpmcf import definitions.json
wp wpmcf import definitions.json --overwrite

Çıktı; kind, key, action (create, update, skip, error) ve message sütunlarından oluşan bir tablo ve ardından tek satırlık bir özettir:

| kind         | key              | action | message                                    |
| field_groups | book_details     | skip   | Already exists on this site and was kept.  |
Success: 0 created, 0 replaced, 1 kept, 0 failed.

Satır, --dry-run ile şöyle görünür: Dry run: 1 to create, 0 to replace, 1 kept, 0 failing.

Çıkış durumu: dosya düzeyinde bir sorun (Cannot read <file>., The file is not valid JSON., hatalı biçim veya daha yeni bir sürüm) hatayla ve 1 çıkış koduyla durur. Yalnızca bazı öğeler başarısız olursa komut özetle birlikte bir Warning yazdırır ve yine 0 koduyla çıkar; bu yüzden betiklerde tabloyu veya özet satırını kontrol edin. Ekrandaki kurallar ve sınırlar aynen geçerlidir.

wp wpmcf json

Local JSON için bkz. Local JSON ve sürüm kontrolü.

wp wpmcf json status
wp wpmcf json sync [<item>...] [--all]

Öğe adı ve --all olmadan sync, Name the items to sync, or pass --all. mesajıyla durur. Sonuç bir içe aktarma raporu gibi yazdırılır.

wp wpmcf json status
wp wpmcf json sync --all
wp wpmcf json sync field_groups:book_details post_types:book

Bir dağıtım betiği genellikle wp wpmcf json sync --all ile biter.

wp wpmcf acf

ACF taşıma için bkz. ACF'den taşıma. ACF verileri hiçbir zaman değiştirilmez.

wp wpmcf acf report
wp wpmcf acf migrate [--dry-run] [--groups=<keys>]

wp wpmcf acf report
wp wpmcf acf migrate --groups=group_5f3a1b2c4d5e6,group_5f3a1b2c4d7f8

Başka bir taşıma çalışırken komut başlamayı reddeder (A migration is already running.). Taşınacak bir şey yoksa report şunu yazdırır: No ACF data found. ve migrate şu mesajla durur: No ACF data was found on this site. Tekil değerlerle ilgili sorunlar uyarıdır; komut yine de Success ve sorun sayısıyla biter. Ekranın gösterdiği durum (ilerleme, atlanan değerler) aynıdır; bu yüzden tam listeyi okumak için sonradan Tools ekranını açabilirsiniz.

wp wpmcf tasks

Arka plan görevleri için bkz. Arka plan görevleri.

wp wpmcf tasks list
wp wpmcf tasks run <id>

run yalnızca durumu active olan görevlerde çalışır: aksi halde Task <id> is paused; activate it first. (veya failed, completed). Bilinmeyen bir ID için Task not found. ile durur. Görevler Pro özelliklerinden (Programatik SEO, veri tablosu içe aktarmaları ve eşitlemeleri, yapay zekâ ile zenginleştirme, dönüştürme) gelir; bu yüzden bunlar olmadan ücretsiz bir sitede liste boştur.

wp wpmcf code

wp wpmcf code list
wp wpmcf code sync

PHP'de wpmcf_register_field_group() ile kaydedilen alan gruplarını listeler ve eşitler. Bu, geliştirici araçlarıyla birlikte Entegrasyonlar bölümünde belgelenmiştir.

Kuyruğu komut satırından çalıştırma

Arka plan işleri (ekrandan başlatıldığında ACF taşıma, görev partileri, kod gruplarının eşitlenmesi) Action Scheduler üzerinde, wpmcf grubunda çalışır. WP-Cron'un güvenilir olmadığı sunucularda kuyruğu bir sistem cron işiyle çalıştırın:

wp action-scheduler run --group=wpmcf

Sorun giderme

'wpmcf' is not a registered wp command. Eklenti o sitede etkin değil ya da yanlış klasördesiniz veya yanlış siteyi hedefliyorsunuz (--path, --url).

Komut büyük sitede yavaş. acf migrate ve tasks run işi tek süreçte yapar. Komut için PHP'nin memory_limit değerini artırın: php -d memory_limit=1G $(which wp) wpmcf acf migrate.

import bir uyarı yazdırdı ve betik devam etti. Başarısız olan öğeler çıkış kodunu değiştirmez. Özet satırında failed veya failing ifadesini kontrol edin ve betiğinizi buna göre durdurun.