İçeriğe geç

Dennis · 14 Mart 2026

Blockstudio 7.1

Blockstudio 7.1, v7 yeniden yazımından sonraki ilk özellik sürümüdür. v7 temeli yeniden kurarken 7.1; veritabanı katmanı, sunucu işlevleri, zamanlanmış görevler ve CLI gibi blokları daha fazlasına dönüştüren parçaları ekliyor. Artık bir blok klasörü eksiksiz bir uygulama olabilir.

İşte yeniliklerin tümü.

Bileşenler

Düzenleyicilerin ekleyicide kullandığı bloklarla geliştiricilerin başka şeyler oluşturmak için yapı taşı olarak kullandığı bloklar arasında hep bir gerilim olmuştur. Bir kart, rozet, istatistik bileşeni, form alanı. Bunların tam Blockstudio işlem hattına (öznitelikler, şablonlar, varlıklar, Tailwind) ihtiyacı vardır; ancak ekleyicide görünmeleri için hiçbir neden yoktur.

7.1, bu sorunu çözmek için bileşenleri sunuyor. block.json dosyanızda "component": true ayarını yapın; blok tüm derleme işlem hattından geçer ancak WordPress blok türü kayıt defterine kaydedilmez. Ekleyicide görünmez, JavaScript’e gönderilen düzenleyici verilerinde yer almaz; ancak programatik işleme için tamamen kullanılabilir durumdadır.

JSON
{
  "name": "my-theme/card",
  "title": "Card",
  "blockstudio": {
    "component": true,
    "attributes": [
      { "id": "title", "type": "text" },
      { "id": "description", "type": "textarea" }
    ]
  }
}

Bunları PHP üzerinden işleyin:

PHP
bs_render_block([
  'name' => 'my-theme/card',
  'data' => ['title' => 'My Card', 'description' => 'Card content.'],
]);

Ya da yeni HTML etiket sözdizimini kullanın:

HTML
<bs:my-theme-card title="My Card" description="Card content." />

Blok etiketleri

Bloklar artık birbirinin yerine kullanılabilen iki sözdizimiyle HTML etiketleri olarak gömülebilir:

HTML
<bs:acme-hero title="Welcome" />
<block name="acme/hero" title="Welcome" />

İkisi de aynı çıktıyı üretir. İkisi de Blockstudio blokları ve temel WordPress bloklarıyla çalışır. Blok şablonlarının içinde herhangi bir ek ayar gerektirmeden otomatik olarak işlenirler. Böylece doğrudan şablonunuzda diğer bloklardan tüm düzenleri oluşturabilirsiniz:

Twig
<div class="my-page">
  <bs:mytheme-card title="Featured" />
  <block name="core/separator" />
  <bs:core-heading level="2">Section Title</bs:core-heading>
  <block name="core/group">
    <block name="core/paragraph">Inside a core group block.</block>
    <bs:mytheme-cta variant="primary" />
  </block>
</div>

İki sözdizimi de serbestçe iç içe kullanılabilir. Blockstudio blokları tam işlem hattından (şablonlar, Tailwind, varlıklar) geçerek işlenir. Temel bloklar, Sayfalar ve Desenler işlevini sağlayan aynı işleyiciler kullanılarak WordPress üzerinden işlenir.

Sayfa düzeyinde işleme (yazı içeriği, bileşen alanları) için bunu blockstudio.json içinde etkinleştirin:

JSON
{ "blockTags": { "enabled": true } }

İzin ve ret listeleri, joker karakter kalıplarıyla hangi blokların etiketler aracılığıyla işlenebileceğini denetler. data-* ve html-* öznitelikleri, işlenen bloğun kök HTML öğesine aktarılır. Özel işleyiciler blockstudio/block_tags/renderers filtresiyle kaydedilebilir.

Arka planda etiket ayrıştırıcısı, DOMDocument’in yerini tamamen alan yeni ve hafif bir dize tarayıcısıdır. Derinlik takibiyle iç içe etiketleri, yinelemeli kapsayıcı blokları ve tek geçişte karma sözdizimini işler. Karşılaştırma testlerinde 1,000 düz etiketi 2.4ms’de, 100 iç içe geçme düzeyini 3.7ms’de ayrıştırır; hem DOMDocument’den hem de WordPress’ın WP_HTML_Tag_Processor özelliğinden sürekli daha hızlıdır. Aynı ayrıştırıcı, Sayfalar ve Desenler için ham HTML öğe ayrıştırmasını da üstlenerek daha önce <p>, <div> ve diğer HTML öğelerini işleyen DOMDocument tabanlı ayrıştırıcının yerini alır.

Yeni alan türleri

Blok

Başka bir Blockstudio bloğuna öznitelik olarak başvurmanızı sağlayan yeni bir block alan türü. Başvurulan bloğun alanları, tıpkı özel alanlarda olduğu gibi idStructure ve overrides kullanılarak satır içinde açılır. Fark şu: şablonda değere erişildiğinde işlenmiş blok çıktısı döner.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "card",
        "type": "block",
        "block": "mytheme/card",
        "idStructure": "card_{id}"
      }
    ]
  }
}

mytheme/card içinde heading ve content alanları varsa, ana blok kenar çubuğunda card_heading ve card_content alanlarını görür. Şablonda {{ a.card }}, işlenmiş kartı çıktılar. Hem normal bloklarla hem de bileşenlerle çalışır.

HTML etiketi

Her temada, başlık düzeyinin bağlama göre değişmesi gereken bloklar vardır. Ana sayfada H1, iç sayfalarda H2. Bunu her seferinde sabit seçenekli bir seçim alanı olarak oluşturmak yerine, artık yerleşik ön ayarlara sahip özel bir html-tag alan türü var.

JSON
{
  "id": "tag",
  "type": "html-tag",
  "default": "h2",
  "tags": "heading",
  "exclude": ["h5", "h6"]
}

Ön ayarlar: heading (h1-h6), text (başlıklar + p, span, div), structural (div, section, article, aside, main, header, footer, nav), all. Özel bir dizi de iletebilirsiniz. exclude, herhangi bir ön ayardan belirli etiketleri çıkarır.

Twig
<{{ a.tag }}>{{ a.title }}</{{ a.tag }}>

Veritabanı

Bu sürümün en önemli parçası budur. Herhangi bir blok dizinine db.php dosyası ekleyin; Blockstudio beş REST CRUD uç noktası oluşturur, her yazma işlemini şemaya göre doğrular, depolama arka ucunu otomatik yönetir ve hem bir JavaScript istemcisi (bs.db()) hem de bir PHP API (Db::get()) sağlar. Geçiş dosyası, denetleyici sınıfı veya rota kaydı gerekmez.

PHP
return [
    'subscribers' => [
        'storage'    => 'table',
        'capability' => [
            'create' => true,
            'read'   => true,
            'update' => 'edit_posts',
            'delete' => 'manage_options',
        ],
        'fields' => [
            'email' => [
                'type'     => 'string',
                'format'   => 'email',
                'required' => true,
                'validate' => function ($value) {
                    if (str_ends_with($value, '@spam.com')) {
                        return 'This domain is blocked.';
                    }
                    return true;
                },
            ],
            'name' => ['type' => 'string', 'maxLength' => 100],
            'plan' => ['type' => 'string', 'enum' => ['free', 'pro']],
        ],
    ],
];

Yalnızca bu şema bile oluşturma, listeleme, alma, güncelleme ve silme uç noktalarının tümünü içeren, tamamen çalışan bir API üretir; tümünde girdi doğrulaması yapılır.

Depolama

Her biri farklı kullanım alanlarına uygun beş depolama arka ucu:

  • table: dbDelta() üzerinden yönetilen özel MySQL tablosu. Şemaya alan eklemek, sonraki sayfa yüklemesinde sütun ekler. Üretim ortamı için varsayılan seçenek.
  • sqlite: Bloğun db/ klasöründe bulunan tek bir SQLite dosyası. Gerçek SQL sorguları, eşzamanlı okumalar için WAL modu ve tamamen taşınabilir. Klasörü kopyalayın, veritabanını kopyalamış olursunuz.
  • jsonc: Düz dosyada satır başına bir JSON nesnesi. İnsan tarafından okunabilir, sürüm denetimine uygun ve git dostu.
  • meta: Belirli bir yazıya bağlı, WordPress yazı meta verisinde tutulan JSON dizisi.
  • post_type: Her kayıt, özel bir yazı türünde WordPress yazısına dönüşür. Alanlar ayrı yazı meta verisi girdileri olarak saklanır ve WP_Query ile tamamen sorgulanabilir.

İstemciler

JavaScript tarafında bs.db() size eksiksiz bir CRUD istemcisi sunar:

JavaScript
const db = bs.db('my-theme/block', 'subscribers');
const record = await db.create({ email: 'a@b.com', plan: 'pro' });
const pros = await db.list({ plan: 'pro' });
await db.update(record.id, { plan: 'free' });
await db.delete(record.id);

Bunun yanında üç yardımcı araç da gelir:

  • bs.cache: get, set, invalidate ve clear özelliklerine sahip, bellek içi bir sorgu önbelleği. Tüm sorgu ve değişiklik çağrıları arasında paylaşılır.
  • bs.query(key, fn, options): Önbelleğe alma, istek yinelemesini önleme ve yapılandırılabilir staleTime özelliklerini herhangi bir eşzamansız işlevin etrafına ekler. Bir istek sürerken aynı anahtarla yapılan birden çok çağrı aynı promise değerini döndürür.
  • bs.mutate(options): Otomatik geri alma ile iyimser değişiklikleri yönetir. Tepkisel bir durum nesnesi, bir eylem (create, update, delete) ve iyimser veriler iletin. UI anında güncellenir. Sunucu çağrısı başarısız olursa durum, değişiklik öncesindeki anlık görüntüsüne döner.

Birlikte tam okuma/yazma döngüsünü kapsarlar: önbelleğe alınmış okumalar için bs.query, iyimser yazmalar için bs.mutate, elle denetim için bs.cache.

PHP tarafında Db sınıfı aynı işlemleri sunar:

PHP
use Blockstudio\Db;

$db = Db::get('my-theme/block', 'subscribers');
$db->create(['email' => 'a@b.com', 'plan' => 'pro']);
$db->list(['plan' => 'pro']);

Doğrulama

Doğrulama hataları, Zod’ın fieldErrors biçiminden esinlenen, her alan için ayrı hata dizileri olarak döner. Aynı alanda birden fazla kural başarısız olabilir ve bu yapı, hataları ön uçtaki form alanlarıyla eşleştirmeyi kolaylaştırır:

JSON
{
  "data": {
    "status": 400,
    "errors": {
      "email": ["Must be a valid email address.", "This domain is blocked."],
      "plan": ["Must be one of: free, pro."]
    }
  }
}

Yerleşik kuralların kapsamadığı durumlar için özel validate geri çağrıları sunucu tarafında çalışır: alan adı engelleme, alanlar arası doğrulama ve harici aramalar.

Kullanıcıya özel veriler

Yapılacaklar, favoriler veya taslaklar gibi kullanıcıya özel veriler için userScoped değerini true olarak ayarlayın; gerisini Blockstudio halleder. Bir user_id sütunu ekler, oluşturma sırasında bunu otomatik ayarlar ve tüm sorguları geçerli kullanıcıya göre filtreler. Güncellemeler ve silmelerde sahiplik denetlenir. Elle user_id alanı, before_create kancası veya RPC içinde filtreleme gerekmez. Tek satır yapılandırma yeterlidir. post_type depolama kullanıldığında userScoped, ayrı bir sütun yerine post_author ile eşleşir.

PHP
return [
    'storage'    => 'sqlite',
    'userScoped' => true,
    'fields'     => [ /* ... */ ],
];

Gerçek zamanlı yoklama

Şemanızda 'realtime' => true ayarını yapın; istemci değişiklikleri otomatik olarak yoklar. Sunucuda bir şey değiştiğinde Interactivity API deposu güncellenir ve UI, sizin tarafınızda herhangi bir JavaScript değişikliği olmadan yeniden işlenir. Özel durum anahtarları ve aralıklar için 'realtime' => ['key' => 'todos', 'interval' => 5000] ile yapılandırın. Yoklama, istekleri hafif tutmak için karma karşılaştırması kullanır ve tarayıcı sekmesi gizlendiğinde duraklar.

Güvenlik, kancalar, taşınabilirlik

Genel uç noktalar, otomatik eklenen bir X-BS-Token CSRF başlığıyla korunur. Örneğin gelen web kancaları için gerçekten kimlik doğrulaması gerektirmeyen erişime ihtiyacınız varsa 'open' kullanın.

Yaşam döngüsü kancaları her yazma işleminden önce ve sonra çalışır. Bunları satır içinde db.php içinde veya genel olarak WordPress eylemleriyle tanımlayın.

Alanlar, bs_db_form() aracılığıyla şema güdümlü form işleme için component anahtarı tanımlayabilir.

SQLite veya JSONC depolamayla uygulamanın tamamı tek klasörde bulunur: kod, mantık, erişim denetimi ve veriler. Dağıtmak için klasörü kopyalayın.

RPC

Bazen CRUD yeterli olmaz. Özel sunucu mantığına ihtiyaç duyarsınız: yapılacak işi değiştirme, bildirim gönderme, istatistikleri toplama. rpc.php bunun içindir. Bir PHP işlevi tanımlayın, bunu ön uçtan bs.fn() ile çağırın; Blockstudio, REST uç noktasını, kimlik doğrulamayı, CSRF korumasını ve JSON serileştirmesini halleder. Bu yaklaşım tRPC‘den esinlenmiştir: yordamlar sunucu tarafında tanımlanır ve istemciden adlarıyla çağrılır.

PHP
return [
    'subscribe' => function (array $params): array {
        $email = sanitize_email($params['email']);
        return ['success' => true];
    },
];
JavaScript
const result = await bs.fn('subscribe', { email: 'user@example.com' });

Satır içi betikler (script-inline.js), adını betik etiketindeki data-block özniteliğinden otomatik olarak algılar; bu nedenle elle belirtmeniz gerekmez. Modül betikleri ise üçüncü bağımsız değişken olarak iletir.

Erişim denetimi seçenekleri arasında public (CSRF ile), 'open' (korumasız), yetenek dizeleri veya diziler bulunur. İşlev başına HTTP yöntemi denetimi, yaşam döngüsü kancaları ve hem JS hem de PHP üzerinden bloklar arası çağrı desteklenir.

Cron

Arka plan görevleri bir cron.php dosyasında tanımlanır. Bir zamanlama ve geri çağırım ayarlayın; Blockstudio bunları başlangıçta WordPress Cron ile kaydeder. Eklenti devre dışı bırakıldığında tüm zamanlamalar düzgünce kaldırılır.

PHP
return [
    'cleanup' => [
        'schedule' => 'daily',
        'callback' => function () {
            $db = Db::get('my-theme/app', 'logs');
            // delete old entries
        },
    ],
    'sync' => [
        'schedule' => 'hourly',
        'callback' => function () {
            // pull from external API
        },
    ],
];

Yerleşik tüm WordPress zamanlamaları ve cron_schedules filtresi aracılığıyla özel aralıklar desteklenir.

CLI

Yeni bir wp bs komutu, Blockstudio özelliklerinin tümünü kapsar: bloklar, veritabanı, RPC, cron, ayarlar, Tailwind derlemesi, SCSS derlemesi, özel alanlar ve varlık yönetimi.

Kabuk
wp bs blocks list --components
wp bs db schemas
wp bs db create my-theme/app subs --email=a@b.com
wp bs db list my-theme/app subs --plan=pro --format=json
wp bs rpc call my-theme/app subscribe --email=a@b.com
wp bs cron run my-theme/app cleanup
wp bs tailwind compile --file=template.html
wp bs scss compile --file=style.scss
wp bs fields list
wp bs assets list --type=global
wp bs settings get tailwind/enabled

Tüm komutlar betik kullanımı için --format=json seçeneğini destekler.

Tekrarlayıcı iyileştirmeleri

Nesne alanları için textMinimized

Daraltılmış tekrarlayıcı satırları artık nesne alanı değerlerini doğru şekilde işler. Önceden textMinimized bir bağlantı alanına yöneltildiğinde [object Object] gösteriliyordu. Artık Blockstudio, alan türüne göre doğru alt özelliği otomatik okur: bağlantılar için title, renkler ve gradyanlar için value, simgeler için icon. İstediğiniz alt özelliği okumak için açıkça bir key özelliği de ayarlayabilirsiniz.

JSON
{
  "type": "repeater",
  "textMinimized": { "id": "href", "fallback": "Add a link" },
  "attributes": [{ "id": "href", "type": "link" }]
}

RichText ve MediaPlaceholder

Her iki şablon bileşeni de artık tekrarlayıcı alanlarının içinde çalışır; doğru satırı hedeflemek için köşeli ayraç gösterimi kullanılabilir. Böylece tekrarlayıcının her satırında başlıkları ve paragrafları satır içinde düzenleyebilir, medya yükleme alanları ekleyebilirsiniz.

Twig
{% for item in a.items %}
  <div class="card">
    <MediaPlaceholder attribute="items[{{ loop.index0 }}].image" />
    <RichText tag="h2" attribute="items[{{ loop.index0 }}].heading" />
    <RichText tag="p" attribute="items[{{ loop.index0 }}].content" />
  </div>
{% endfor %}

idStructure ile özel alan koşulları

idStructure kullanan bir özel alanla çalışırken, alan tanımındaki koşullar artık kimliklerini açılmış adlarla eşleşecek şekilde otomatik olarak yeniden yazar. Yazı tipi boyutu alan grubunuzda enable üzerinde bir koşul varsa ve bunu idStructure: "title_font_{id}" ile genişletirseniz, koşul artık özgün enable yerine doğru şekilde title_font_enable başvurur.

Başvuru düzeyindeki koşullar da desteklenir. Genişletilmiş tüm alanlara aynı anda uygulamak için özel alan başvurusuna conditions ekleyin.

Dinamik doldurma bağımsız değişkenleri

Doldurma bağımsız değişkenleri artık {attributes.*} sözdizimini kullanarak diğer blok özniteliklerine başvurabilir. Başvurulan öznitelik değiştiğinde seçim alanı seçeneklerini otomatik olarak yeniden getirir. Seçimleri zincirleyin: biri yazı türünü seçer, diğeri bu türdeki yazıları yükler.

JSON
{
  "id": "selected_post",
  "type": "select",
  "populate": {
    "type": "query",
    "query": "posts",
    "arguments": {
      "post_type": "{attributes.post_type}"
    }
  }
}

post_type değerini “page” yapın; ikinci seçim sayfaları yükler. “post” yapın; yazıları yükler. Herhangi bir doldurma türü ve öznitelikle çalışır.

Composer

Blockstudio artık yalnızca eklentiler dizininden değil, wp-content/ altındaki herhangi bir konumdan yüklendiğinde de çalışır. Varlık URL’leri artık plugins_url() yerine BLOCKSTUDIO_URL sabitiyle çözümlendiğinden, tema ile birlikte paketlenen kurulumlar kutudan çıktığı gibi çalışır:

PHP
require_once __DIR__ . '/vendor/autoload.php';
require_once __DIR__ . '/vendor/blockstudio/blockstudio/blockstudio.php';

composer.json çalışma zamanı bağımlılıkları sadeleştirildi. lib/ içinde zaten paketlenmiş olan kapsamlı paketler (TailwindPHP, ScssPhp, Minify) artık çalışma zamanı bağımlılıkları arasında listelenmiyor. Yalnızca php >= 8.2 ve plugin-update-checker kaldı.

Üç kurulum yöntemi de (eklenti zip’i, Composer üzerinden eklenti, Composer üzerinden temayla paketleme) aynı sonucu verir: tam WordPress etkinleştirmesi, blok kaydı ve ön yüzde işleme.

Kurulum talimatları için Composer belgelerine bakın.

Performans profili oluşturucu

Herhangi bir sayfa URL öğesine ?blockstudio-perf eklediğinizde, alt kısımda blok başına işleme sürelerini, aşama dökümlerini ve önbellek isabet oranlarını gösteren bir hata ayıklama paneli belirir. Zamanlama verileri ayrıca Server-Timing başlıkları olarak gönderilir ve tarayıcının DevTools Ağ sekmesinde görülebilir.

JSON
{ "dev": { "perf": true } }

Her sayfa yüklemesinin profilini çıkarmak için ayarlardan kalıcı olarak etkinleştirin. Yalnızca edit_posts yeteneğine sahip, oturum açmış kullanıcılar görebilir.

Kendiliğinden kapanan blok etiketleri artık bellekte de önbelleğe alınır. Aynı özniteliklere sahip aynı blok bir sayfada birden çok kez göründüğünde, sonraki işlemeler tüm şablon işlem hattını atlar.

Hata düzeltmeleri

  • PHP 8.4 kullanımdan kaldırma uyarıları: null öğesinin add_submenu_page() öğesine aktarılmasından kaynaklanan strpos() ve str_replace() kullanımdan kaldırma uyarıları düzeltildi.

Diğer

  • SCSS kod alanları: Kod alanları artık language: "scss" destekliyor. Değerler hem düzenleyicide hem de ön yüzde ScssPhp üzerinden derleniyor.
  • Standart WordPress blokları: Blockstudio dizinleri, Blockstudio bloklarının yanında @wordpress/create-block çıktısı da içerebilir. Ayrı bir eklenti kodu gerekmeden otomatik olarak kaydedilirler.

Tam yığın yaklaşımını uygulamalı görmek isterseniz Tam Yığın Bloklar kılavuzu, kullanıcıya özel bir yapılacaklar uygulamasını ve herkese açık bir bülten kaydını sıfırdan oluşturmayı adım adım anlatıyor.