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
wp bs blocks list
+----------------------------+---------------------+-----------+------------------------+
| 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
wp bs blocks list --components
JSON olarak çıktı verme
wp bs blocks list --format=json
Kayıtlı alanları doğrulama
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
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.
+---------------------+----------+------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------+------+
| 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:
[
{
"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.
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:
wp bs pages sync --authoritative --full
Tam rapora ihtiyaç duyan dağıtım betikleri için:
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
wp bs db schemas
+-------------------+-------------+---------+---------------------+
| 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
# 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:
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:
wp bs db migrate my-theme/app subscribers --to=storh
Tek şemalı bloklar için:
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:
wp bs db list my-theme/app subscribers --format=json
RPC
Tüm işlevleri listeleme
wp bs rpc list
+-------------------+-------------+--------+----------------+---------+
| 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
wp bs rpc call my-theme/app subscribe --email=user@example.com
Çıktı JSON biçimindedir:
{
"success": true
}
Parametreler --key=value işaretleri olarak iletilir:
wp bs rpc call my-theme/app load_more --offset=10 --limit=5
Cron
Tüm işleri listeleme
wp bs cron list
+-------------------+----------+----------+---------------------+
| 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
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
wp bs settings list
Belirli bir ayarı alma
wp bs settings get tailwind/enabled
wp bs settings get assets/enqueue
Tailwind
HTML biçiminden CSS biçimine derleme
wp bs tailwind compile '<div class="flex items-center p-4">'
Dosyadan derleme
wp bs tailwind compile --file=template.html
Önbellek yönetimi
wp bs tailwind cache path # show cache directory
wp bs tailwind cache clear # clear compiled cache
SCSS
SCSS biçiminden CSS biçimine derleme
wp bs scss compile '$color: red; .test { color: $color; }'
Dosyadan derleme
wp bs scss compile --file=styles.scss
Özel Alanlar
Kayıtlı tüm özel alanları listeleme
wp bs fields list
+-------+----------------+---------------------------+
| name | title | fields |
+-------+----------------+---------------------------+
| hero | Hero Section | heading, description, cta |
| card | Card | title, image, link |
+-------+----------------+---------------------------+
Varlıklar
Tüm varlıkları listeleme
wp bs assets list
Türe göre filtreleme
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:
# 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
wp bs content pull
Çekme işlemini yapılandırılmış tek bir yazı türü veya taksonomiyle sınırlayın:
wp bs content pull --post-type=team_member
wp bs content pull --taxonomy=category
UID’leri veya dosyaları yazmadan önizleyin:
wp bs content pull --dry-run
Dosyaları veritabanına gönderme
wp bs content push
Yazmadan uygulama planını önizleyin:
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:
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
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
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
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
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
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
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:
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
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.