İçeriğe geç

CLI

Blockstudio, terminalden blokları, dosya tabanlı sayfaları, veritabanı kayıtlarını, RPC işlevlerini, cron işleri, ayarları ve WPML dil yapılandırmasını yönetmek için WP-CLI komutlarını kaydeder.

Bloklar

Tüm blokları listeleme

Kabuk
wp bs blocks list
Kod
+----------------------------+---------------------+-----------+------------------------+
| name                       | title               | component | category               |
+----------------------------+---------------------+-----------+------------------------+
| my-theme/hero              | Hero                |           | my-theme               |
| my-theme/card              | Card                | yes       | my-theme               |
| my-theme/newsletter        | Newsletter          |           | my-theme               |
+----------------------------+---------------------+-----------+------------------------+

Yalnızca bileşenlere göre filtreleme

Kabuk
wp bs blocks list --components

JSON olarak çıktı verme

Kabuk
wp bs blocks list --format=json

Kayıtlı alanları doğrulama

Kabuk
wp bs blocks validate 42
wp bs blocks validate 42 57 --format=json

Belirtilen gönderi kimliklerinin kayıtlı içeriğini, iç içe innerBlocks öğeleri de dahil olmak üzere, bs_validate_block() kullanarak denetler. Blokları işleyip görüntülemez, eşitlenmiş desen başvurularını genişletmez veya gönderileri değiştirmez. Blockstudio uzantıları olmayan bilinmeyen bloklar atlanır.

Varsayılan tabloda gönderi kimliği, sıfır tabanlı blok yolu, blok adı, bulgu kodu, alan yolu, kaynak ve ileti listelenir. JSON ayrıca özgün value ve expected değerlerini de içerir. İç içe bir bloğun blok yolu 0/1, alan yolu ise cards/2/style olabilir; bunlar ayrı yollardır.

Bulgu yoksa komut 0, bulgu varsa 1 ile çıkar. JSON çıktısı, başarılı durumda [] dahil olmak üzere düz bir listedir; böylece komut 1 ile çıksa bile otomasyon bu listeyi okuyabilir. Gönderilerin veya kimliklerin bulunmaması ve table ya da json dışındaki biçimler hata oluşturur. Doğrulama başlamadan önce tüm kimlikler denetlenir.

Blokları işleme ve görüntüleme

Kabuk
wp bs blocks render
wp bs blocks render my-theme/hero my-theme/card
wp bs blocks render my-theme/card --attributes='{"variant":"wide"}'
wp bs blocks render my-theme/card --attributes=@card.json --format=json

Kayıtlı blokları bir sayfanın yaptığı gibi işler ve şablonlarının oluşturduğu her PHP bildirimi, uyarıyı, kullanımdan kaldırma bildirimini ve fırlatılan hatayı raporlar. Bir tema, yüklü Blockstudio karşı bloklarını hızlıca test etmek için komutu CI’da çalıştırabilir. Ad belirtilmezse bileşenler dahil tüm kayıtlı bloklar işlenir ve görüntülenir.

Her blok, blok yorumundan blockstudio.attributes ile, düzenleyicinin kaydettiği biçimde, WP-CLI ön yüz bağlamında do_blocks() aracılığıyla işlenip görüntülenir; ekleyici önizlemesi kullanılmaz. İşleme için sorgulanan herhangi bir gönderi ayarlanmaz. Dinamik adacıklar yalnızca yer tutucuları yerine gerçek şablon gövdelerini işler; şablonlardan gelen arızi çıktılar rapora dahil edilmez.

Komut gönderileri veya alan değerlerini kendisi kaydetmez; ancak şablonlarınızı ve işleme hook’larınızı sıradan PHP olarak çalıştırır. Bunlar veri yazabilir, harici hizmetleri çağırabilir veya başka yan etkilere yol açabilir. Komutu özel bir test sitesinde, güvenilir kodla çalıştırın; salt okunur bir yalıtım alanı değildir.

Bir işlemenin öznitelikleri her blok için ayrı ayrı seçilir:

Durum Öznitelikler
example Bloğun block.json öğesinin example.attributes değeri; ekleyici önizlemesinin kullandığı değerler.
defaults Her alanın default değeri. example.attributes olmayan bloklarda kullanılır; komut her biri için bir satır yazdırır.
attributes Örneğin yerine geçen --attributes değerleri.

--attributes, depolama anahtarlarına göre alan değerlerini içeren bir JSON nesnesi veya böyle bir nesne içeren dosyanın yoluyla birlikte @ alır ve tam olarak bir blok adı gerektirir. Örnekte bulunmayan şablon dallarına, örneğin varyantlara, ulaşmak için kullanın. Yalnızca ekleyici önizlemesinde yer tutucu görseller oluşturan örnek değerler atlanır ve örneğin innerBlocks işlenip görüntülenmez.

Kod
+---------------------+----------+------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------+------+
| block               | case     | level      | message                                                                       | file                                                                         | line |
+---------------------+----------+------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------+------+
| smoke/deprecated    | defaults | Deprecated | strlen(): Passing null to parameter #1 ($string) of type string is deprecated | /wordpress/wp-content/themes/smoke-theme/blockstudio/deprecated/index.php    | 1    |
| smoke/undefined-key | example  | Warning    | Undefined array key "subtitle"                                                | /wordpress/wp-content/themes/smoke-theme/blockstudio/undefined-key/index.php | 2    |
+---------------------+----------+------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------+------+

Tabloda her sorun için bir satır bulunur. JSON çıktısı, sorun bulunmayanlar dahil işlenen ve görüntülenen her blok için bir giriş içerir; böylece otomasyon kullanılan durumu okuyabilir:

JSON
[
  {
    "block": "smoke/branch",
    "case": "attributes",
    "problems": [
      {
        "level": "Warning",
        "message": "Undefined array key \"width\"",
        "file": "/wordpress/wp-content/themes/smoke-theme/blockstudio/branch/index.php",
        "line": 2
      }
    ]
  }
]

level, Notice, Warning, Deprecated veya Error değerlerinden biridir. Örneğin bir döngüde aynı dosya ve satırda yinelenen bir sorun, her blok için bir kez raporlanır. @ ile susturulan sorunlar raporlanmaz. WordPress, yalnızca WP_DEBUG etkin olduğunda _deprecated_function() bildirimleri gibi kendi kullanımdan kaldırma bildirimlerini oluşturur.

Sorun bulunmazsa komut 0, aksi durumda 1 ile çıkar. Bilinmeyen blok adları, okunamayan veya geçersiz --attributes ve table ya da json dışındaki biçimler hata oluşturur; ilk blok işlenip görüntülenmeden önce tüm adlar denetlenir.

Sayfalar

Dosya tabanlı sayfa eşitlemesi açıkça yapılır. Olağan WordPress istekleri hiçbir zaman sayfaların tamamını keşfetmez veya sayfa yazılarını yazmaz. Soğuk bir çalışma zamanı, rotaları geri yüklemek için koleksiyon manifestlerini bir kez okuyabilir; ancak içeriği eşitlemez.

Kabuk
wp bs pages sync

Komut, istenen envanterin tamamını uzlaştırır ve keşfedilen, oluşturulan, güncellenen, değişmeden kalan, kilitlenen, korunan, kaldırılan ve başarısız olan sayfaları raporlar. Eşleşen parmak izleri, gönderi veya post-meta yazımı yapılmamasını sağlar.

Tablo çıktısı, gönderi kimlikleriyle birlikte değiştirilen, kilitlenen, içeriği korunan ve kaldırılan sayfaları adlandırır. JSON; sayfa adı, anahtar, gönderi kimliği ve temizleme eylemini içeren pages.<name>.preserved, pages.<name>.overwritten ve removedPages girdilerini içerir. Anahtarlara göre birleştirme sonrasında gönderi aynıysa, revizyon oluşturmadan veya değiştirilme zaman damgasını ilerletmeden değişmemiş olarak raporlanır.

Mevcut yayın durumları korunur; dosya tarafından yönetilen başlık ve kısa ad değişiklikleri uyarı olarak yazdırılır. Bkz. Gönderi Alanı Sahipliği.

Anahtarlı düzenleyici içeriğini korumak yerine yönetilen içeriği değiştirmek için --authoritative, saklanan kaynak kimliğinden bağımsız olarak geçişi tam uzlaştırma olarak bildirmek için --full kullanın. Her iki durumda da her geçiş envanterin tamamını karşılaştırır:

Kabuk
wp bs pages sync --authoritative --full

Tam rapora ihtiyaç duyan dağıtım betikleri için:

Kabuk
wp bs pages sync --format=json

Komutun ayrıştırdığı her sayfa, bloklarının sakladığı ancak hiçbir zaman görüntülemediği öznitelikler açısından denetlenir: Blockstudio bloğunun alan olarak tanımlamadığı veya kök öğesine aktarmadığı, tanımlanmamış bir class gibi öznitelikler. Tablo çıktısı her sayfa ve blok için bir uyarı verir, dropped sütunu bunları sayar ve JSON raporu bunları pages.<name>.droppedAttributes altında listeler. Kaynağı değişmeyen sayfalar yeniden ayrıştırılmaz; bu nedenle bir sonraki değişikliklerinde veya ayrıştırıcıyı değiştiren bir yükseltmeden sonraki ilk eşitlemede raporlanırlar.

Komut, keşif veya uzlaştırma bir hata bildirdiğinde başarısız olarak çıkar. Sayfalar bölümünde PHP API ve dağıtım kimliği sözleşmesine bakın.

Veritabanı

Şemaları listeleme

Kabuk
wp bs db schemas
Kod
+-------------------+-------------+---------+---------------------+
| block             | schema      | storage | fields              |
+-------------------+-------------+---------+---------------------+
| my-theme/app      | subscribers | table   | email, name, plan   |
| my-theme/app      | logs        | jsonc   | action, details     |
| my-theme/app      | events      | storh   | title, status       |
+-------------------+-------------+---------+---------------------+

CRUD işlemleri

Kabuk
# List records
wp bs db list my-theme/app subscribers

# List with filters
wp bs db list my-theme/app subscribers --plan=pro --limit=10

# Get a single record
wp bs db get my-theme/app subscribers 1

# Create a record
wp bs db create my-theme/app subscribers --email=a@b.com --plan=pro

# Update a record
wp bs db update my-theme/app subscribers 1 --plan=enterprise

# Delete a record
wp bs db delete my-theme/app subscribers 1

Tek şemalı bloklarda şema adı varsayılan olarak default olur:

Kabuk
wp bs db list my-theme/leads

JSONC kayıtlarını Storh biçimine taşıma

Bir şemada zaten bir db/{schema}.jsonc dosyası varsa ve bu kayıtları Storh dosya arka ucuna taşımak istiyorsanız migrate kullanın:

Kabuk
wp bs db migrate my-theme/app subscribers --to=storh

Tek şemalı bloklar için:

Kabuk
wp bs db migrate my-theme/app --to=storh

Komut, tamsayı kayıt kimliklerini korur, uploads/blockstudio/db/{block-scope}/{schema}/ konumuna yazar, Storh dizinlerini yeniden oluşturur, hedef depoyu doğrular ve kaynak .jsonc dosyasını yerinde bırakır.

Çıktı biçimleri

Tüm listeleme komutları --format=table (varsayılan), --format=json ve --format=csv biçimlerini destekler:

Kabuk
wp bs db list my-theme/app subscribers --format=json

RPC

Tüm işlevleri listeleme

Kabuk
wp bs rpc list
Kod
+-------------------+-------------+--------+----------------+---------+
| block             | function    | public | capability     | methods |
+-------------------+-------------+--------+----------------+---------+
| my-theme/app      | subscribe   | yes    |                | POST    |
| my-theme/app      | stats       |        | edit_posts     | POST    |
| my-theme/app      | get_status  |        |                | GET,POST|
+-------------------+-------------+--------+----------------+---------+

Bir işlevi çağırma

Kabuk
wp bs rpc call my-theme/app subscribe --email=user@example.com

Çıktı JSON biçimindedir:

JSON
{
  "success": true
}

Parametreler --key=value işaretleri olarak iletilir:

Kabuk
wp bs rpc call my-theme/app load_more --offset=10 --limit=5

Cron

Tüm işleri listeleme

Kabuk
wp bs cron list
Kod
+-------------------+----------+----------+---------------------+
| block             | job      | schedule | next_run            |
+-------------------+----------+----------+---------------------+
| my-theme/app      | cleanup  | daily    | 2026-03-17 00:00:00 |
| my-theme/app      | sync     | hourly   | 2026-03-16 15:00:00 |
+-------------------+----------+----------+---------------------+

Bir işi elle çalıştırma

Kabuk
wp bs cron run my-theme/app cleanup

Bu işlem, zamanlamadan bağımsız olarak geri çağrıyı hemen yürütür. Test ve hata ayıklama için kullanışlıdır.

Ayarlar

Tüm ayarları gösterme

Kabuk
wp bs settings list

Belirli bir ayarı alma

Kabuk
wp bs settings get tailwind/enabled
wp bs settings get assets/enqueue

Tailwind

HTML biçiminden CSS biçimine derleme

Kabuk
wp bs tailwind compile '<div class="flex items-center p-4">'

Dosyadan derleme

Kabuk
wp bs tailwind compile --file=template.html

Önbellek yönetimi

Kabuk
wp bs tailwind cache path    # show cache directory
wp bs tailwind cache clear   # clear compiled cache

SCSS

SCSS biçiminden CSS biçimine derleme

Kabuk
wp bs scss compile '$color: red; .test { color: $color; }'

Dosyadan derleme

Kabuk
wp bs scss compile --file=styles.scss

Özel Alanlar

Kayıtlı tüm özel alanları listeleme

Kabuk
wp bs fields list
Kod
+-------+----------------+---------------------------+
| name  | title          | fields                    |
+-------+----------------+---------------------------+
| hero  | Hero Section   | heading, description, cta |
| card  | Card           | title, image, link        |
+-------+----------------+---------------------------+

Varlıklar

Tüm varlıkları listeleme

Kabuk
wp bs assets list

Türe göre filtreleme

Kabuk
wp bs assets list --type=global
wp bs assets list --type=admin
wp bs assets list --type=editor
wp bs assets list --type=registered

Betik yazma

Tüm komutlar, kolayca boru hattına aktarmak için --format=json seçeneğini destekler:

Kabuk
# Export all subscribers as JSON
wp bs db list my-theme/app subscribers --format=json > subscribers.json

# Count records
wp bs db list my-theme/app subscribers --format=json | jq length

# Batch delete
wp bs db list my-theme/app logs --format=json | \
  jq -r '.[].id' | \
  xargs -I {} wp bs db delete my-theme/app logs {}

Content Sync

Content Sync, izin verilen WordPress içeriğini dosyalara aktarır ve bu dosyaları veritabanına uygular. Açıkça çalıştırılır ve CLI odaklıdır; sayfa yüklenirken veya yönetici başlatılırken eşitleme yapmaz.

Yapılandırma, dosya biçimi ve dosya tabanlı veritabanı içeriğinin ne zaman uygun olduğuna ilişkin kılavuz için Content Sync bölümüne bakın.

Veritabanı içeriğini dosyalara çekme

Kabuk
wp bs content pull

Çekme işlemini yapılandırılmış tek bir yazı türü veya taksonomiyle sınırlayın:

Kabuk
wp bs content pull --post-type=team_member
wp bs content pull --taxonomy=category

UID’leri veya dosyaları yazmadan önizleyin:

Kabuk
wp bs content pull --dry-run

Dosyaları veritabanına gönderme

Kabuk
wp bs content push

Yazmadan uygulama planını önizleyin:

Kabuk
wp bs content push --dry-run

Artık dosyalarda bulunmayan, içerik kümesinin sahip olduğu veritabanı yazılarını ve terimlerini budayın:

Kabuk
wp bs content push --prune --yes

--prune ile Blockstudio önce tüm dosya değişikliklerini uygular, ardından dosyalarda artık bulunmayan, içerik kümesinin sahip olduğu öğeleri kaldırır. --yes mevcut değilse yıkıcı budama işlemini çalıştırmayı reddeder.

Durumu denetleme

Kabuk
wp bs content status

Tablo, dosya tabanlı her öğenin unchanged, would-update, missing-db, conflict, locked veya orphaned olarak durumunu bildirir.

Statik Önceden Oluşturma

Önbelleğin kendisi için Statik Önceden Oluşturma bölümüne bakın; bu komutlar önbelleği yönetir.

Eski girdileri ısıtma

Kabuk
wp bs prerender warm

Eski herkese açık URL’leri kuyruğa ekler, ardından kalıcı ısıtma kuyruğundan en fazla warm.concurrency işi yeniden işler ve JSON özetiyle birlikte queued, processed, warmed, skipped ve failed sayılarını yazdırır. İçerik ve site değişiklikleri, yeni işleri otomatik olarak kuyruğa ekler. Daha büyük bir kuyruğu azaltmak için komutu yeniden çalıştırın veya zamanlanmış ısıtıcının çalışmasını bekleyin; görüntülenemeyen bir URL eski kalır ve sonraki çalıştırmada yeniden kuyruğa alınır. graph modunda site başına URL ısıtıcı devre dışıdır ve komut hiçbir şeyi kuyruğa eklemez.

Önbellek durumunu bildirme

Kabuk
wp bs prerender status

Etkin kimliği, dosyaları, baytları, grafik kayıtlarını, kuyruk durumunu, erken sunma haritası raporunu ve kapsam başına isabet/ıskalama/oluşturma/başarısızlık sayaçlarını bildirir.

Önbelleği temizleme

Kabuk
wp bs prerender purge

Geçerli sitenin önceden oluşturulmuş belgelerini kaldırır. Bir sonraki anonim istek veya ısıtma geçişi bunları yeniden oluşturur.

Erken sunma haritasını denetleme ve budama

Kabuk
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune

map status, kurulum genelindeki erken sunma haritasını bildirir: girdilerini ve rotalarını, eksik rota belgelerini, artık var olmayan sitelere ait orphaned girdilerini ve dizini silinmiş dead girdilerini. map prune artık sahipsiz ve geçersiz girdileri kaldırır ve kaldırılan her girdiyi nedeni ile birlikte yazdırır; --dry-run ise yazma yapmadan aynı raporu verir. Başka bir aracın sahip olduğu haritaya hiçbir zaman dokunulmaz.

WPML

Dil yapılandırmasını oluşturma

Kabuk
wp bs wpml config
wp bs wpml config --file=wp-content/themes/my-theme/wpml-config.xml

Çeviri için kayıtlı her bloğun metin alanlarını ve dosya alanlarını ek dosya kimlikleri olarak bildiren bir wpml-config.xml yazdırır veya --file ile dosyaya yazar. Mevcut bir dosyada yalnızca Blockstudio işaretçileri arasındaki bölüm değiştirilir. Nelerin bildirildiğini ve dosyanın nasıl güncel tutulacağını öğrenmek için bkz. WPML.

Blok Etiketi Taşıma

Tek başına çalışan bir betik, önek ve takma ad kısaltmalarını standart <bs:namespace-slug> yazımına dönüştürür. WordPress yüklemez ve --apply açıkça verilmedikçe yazma yapmaz:

Kabuk
php vendor/blockstudio/blockstudio/bin/migrate-block-tags.php \
  --root="$PWD" \
  --prefix-map=/tmp/project-prefixes.json \
  --known-blocks=/tmp/project-blocks.json \
  --aliases=/tmp/project-aliases.json \
  --report=/tmp/blockstudio-tag-migration.json \
  --dry-run

Önek dosyası, çağıranın sahip olduğu önekleri sıralı ad alanlarıyla eşler. Bilinen blok dosyası, kayıtlı blok adlarından oluşan bir JSON listesidir. Tam eşleşen takma adlar isteğe bağlıdır. Rapor; belirlenimci eşlemeleri, önceki/sonraki karmaları, bilinmeyen etiketleri, belirsiz takma adları, dinamik etiketleri ve yorumlarda, kod çitlerinde, <pre> veya <code> aralıklarında bulunan örnekleri içerir.

Tarayıcı; eşleştirilmiş, iç içe ve kendiliğinden kapanan işaretlemeleri, PHP dizelerindeki düz etiketler dahil, işler. Öznitelikleri korur ve yalnızca etiket adlarını değiştirir. Yorumlar ve kod örnekleri yalnızca rapora eklenir. İlgisiz özel öğeler yok sayılır. Çağıran, --allow-unresolved seçeneğini bilerek iletmedikçe bilinmeyen, belirsiz veya dinamik durumlar varken taşıma işlemi uygulanamaz. Komutun standartlaştırılmış çıktı üzerinde yeniden çalıştırılması hiçbir değişiklik yapmaz.

Standart yazımın neden var olduğunu ve hangi sorunları çözdüğünü öğrenmek için Taşıma bölümüne bakın.

Kaldırma

Kabuk
wp bs teardown

Kurulumun sahip olduğu cron olaylarını ve statik önceden oluşturma durumunu kaldırır: geçerli sitenin erken sunma haritası girdisini ve sahip olunan son girdi de silindiğinde paylaşılan advanced-cache.php yükleme dosyasıyla WP_CACHE bildirimini kaldırır. Composer ile paketlenmiş kurulumlar gibi eklenti devre dışı bırakma kancası bulunmayan kurulumlarda temiz kaldırma için bunu kullanın. Yapılandırma dosyalarına dokunulmaz.