İçeriğe geç

3 dosyada özel bloklar

JavaScript yok, derleme adımı yok, gereksiz kod yok.

Alanları JSON içinde tanımlayın

blockstudio anahtarını block.json içine ekleyin. text, toggle ve color gibi türlerle öznitelikleri tanımlayın. Blockstudio, metin girişlerinden tekrarlayıcılara ve kod düzenleyicilere kadar 27 alan türünü içeren düzenleyici UI arayüzünü otomatik olarak oluşturur; ayrıca kendiniz kaydettiğiniz alan türlerini de kullanabilirsiniz.

Tam JSON Şema desteği, VS Code, PhpStorm ve tüm uyumlu düzenleyicilerde otomatik tamamlama ve doğrulama sağlar.

Her alan, yeni bloklar için bir default ve alan boşken şablonun aldığı bir fallback belirleyebilir.

block.json
{
  "name": "starter/hero",
  "title": "Hero",
  "blockstudio": {
    "attributes": [
      { "id": "heading", "type": "text", "label": "Heading" },
      { "id": "showCta", "type": "toggle", "label": "Show CTA" },
      { "id": "background", "type": "color", "label": "Background" }
    ]
  }
}

3 dosyalı iş akışı

Alanlar için block.json, biçimlendirme için bir şablon ve isteğe bağlı bir stil sayfası.

React içinde PHP

RichText, InnerBlocks ve useBlockProps doğrudan PHP, Twig veya Blade içinde çalışır.

SCSS ve Tailwind

CSS, SCSS veya Tailwind kullanın. SCSS içe aktarma yollarını ve paylaşılan bir ön metni destekler; iç içe bir parçayı düzenlemek, onu içe aktaran tüm dosyaları yeniden derler.

27 alan türü

Metin, renk, görsel, tekrarlayıcı, seçim, kod düzenleyici ve daha fazlası, JSON içinde yapılandırılır.

JSON Schema

VS Code, PhpStorm ve uyumlu düzenleyicilerde otomatik tamamlama ve doğrulama.

Üç şablon dili

PHP, Twig ve Blade aynı değişkenleri ve bileşenleri paylaşır.

npm içe aktarımları

Paketleri script.js içinde içe aktarın; üretimde yerel, düzenleyicide ise CDN tabanlıdır.

Interactivity API

WordPress Etkileşim Özelliğini API tek bir bayrakla etkinleştirin.

React bileşenleri, PHP şablonlarında

Tek bir şablonda satır içi düzenleme ve statik ön yüz HTML için <RichText />, alt bloklar için <InnerBlocks /> ve sarmalayıcı için useBlockProps kullanın.

Düzenleyicide bunlar gerçek React bileşenlerine dönüşür. Ön yüzde, ziyaretçilere hiçbir JavaScript gönderilmeden sunucu tarafında HTML olarak işlenirler.

index.php
<div useBlockProps class="container">
  <RichText
    class="text-xl font-semibold"
    tag="h1"
    attribute="headline"
    placeholder="Enter headline"
  />

  <?php if ($a['showCta']): ?>
    <a href="<?= esc_url($a['ctaUrl']) ?>">
      <?= esc_html($a['ctaLabel']) ?>
    </a>
  <?php endif; ?>

  <InnerBlocks class="mt-4 p-4 border" />
</div>

PHP, Twig veya Blade ile yazın

Bildiğiniz şablon dilini kullanın. PHP kutudan çıktığı gibi çalışır, Timber yüklendikten sonra Twig çalışır ve illuminate/view 8’den 12’ye kadar Blockstudio\Blade_Renderer üzerinden Blade çalışır. Değişkenler, bileşenler ve davranış aynı kalır.

$a (öznitelikler), $b (blok), $c (bağlam) ve $innerBlocks her dilde kullanılabilir.

Twig şablonları da tam Timber bağlamını alır. Blade sayfaları, desenleri ve Site Editor şablonlarını da işler. Eski jenssegers/blade sarmalayıcısı illuminate/view 10 ve sonraki sürümlerde çalışmaz; bu nedenle onun yerine Blade_Renderer kullanın.

index.twig
<div useBlockProps class="card">
  <RichText tag="h2" attribute="title" placeholder="Card title" />
  {% if a.image %}
    <img src="{{ a.image.url|esc_url }}"
      alt="{{ a.image.alt|esc_attr }}" />
  {% endif %}
  <div class="card__body">{{ a.description|esc_html }}</div>
  <InnerBlocks allowedBlocks='["core/button"]' />
</div>

Koşullu mantık ve dinamik seçenekler

==, !=, includes, empty ve karşılaştırmalar gibi işleçlerle alanları gösterin veya gizleyin. Koşulları VEYA mantığıyla birleştirin.

Seçenekler başka bir alana bağlı olabilir. {attributes.post_type.value} ifadesini populate argümanlarına ekleyin; bu alan değiştiğinde liste yeniden yüklenir. Editör yazarken yazıları aramak için fetch: true ekleyin.

type: custom ve blockstudio/blocks/attributes/populate filtresiyle bloklar arasında tek bir seçenek listesini paylaşın; satın alma kontrolü gibi kendi genel koşullarınızı da blockstudio/blocks/conditions üzerinden kaydedin.

block.json
{
  "name": "starter/posts",
  "title": "Posts",
  "blockstudio": {
    "attributes": [
      {
        "id": "post_type",
        "type": "select",
        "label": "Post type",
        "options": [
          { "value": "page", "label": "Pages" },
          { "value": "post", "label": "Posts" }
        ]
      },
      {
        "id": "selected_post",
        "type": "select",
        "label": "Post",
        "populate": {
          "type": "query",
          "query": "posts",
          "arguments": { "post_type": "{attributes.post_type.value}" }
        }
      },
      {
        "id": "style",
        "type": "select",
        "label": "Style",
        "populate": { "type": "custom", "custom": "cardStyles" },
        "conditions": [[
          { "type": "purchasedProduct", "operator": "==", "value": "yes" }
        ]]
      }
    ]
  }
}

Yönetilebilir kalan tekrarlayıcılar

min ve max değerlerini ayarlayın, yeni blokları default satırla başlatın ve mevcut satırları minimized ile daraltın. textMinimized, daraltılmış bir satırı ad gibi kendi alanlarından biriyle etiketler.

Satırlar, iç içe tekrarlayıcılar da dahil olmak üzere sekmeler dışındaki tüm alan türlerini kabul eder. Bir satır içindeki koşul, satır dışındaki bir alanı "context": "main" ile kontrol eder; <RichText /> ve <MediaPlaceholder /> ise attribute değeri repeaterId[index].fieldId olan tek bir satırı düzenler.

block.json
{
  "name": "starter/team",
  "title": "Team",
  "blockstudio": {
    "attributes": [
      {
        "id": "members",
        "type": "repeater",
        "label": "Team members",
        "min": 1,
        "max": 12,
        "minimized": true,
        "textMinimized": { "id": "name", "fallback": "Team member" },
        "attributes": [
          { "id": "name", "type": "text", "label": "Name" },
          { "id": "bio", "type": "richtext", "label": "Bio" }
        ]
      }
    ]
  }
}

Yeniden kullanılabilir alan kümeleri

Bir alan grubunu field.json içinde bir kez tanımlayın ve "type": "custom/cta" ile herhangi bir blokta kullanın. Alanlar satır içine yerleştirilir; böylece şablonlar bunları diğer tüm özellikler gibi okur.

hero_{id} gibi bir idStructure ile aynı kümeyi iki kez kullanın ve overrides ile her blok için etiketleri, varsayılanları veya koşulları değiştirin. block alan türü aynı işlemi bütün bir blokla yapar: bloğun alanlarını satır içine genişletir ve işlenmiş HTML değerini döndürür.

fields/cta/field.json
{
  "name": "cta",
  "title": "Call to action",
  "attributes": [
    { "id": "label", "type": "text", "label": "Button label", "default": "Learn more" },
    { "id": "url", "type": "link", "label": "Button URL" }
  ]
}

Derleme adımı olmadan ES modülleri

script.js ekleyin, ES modülü olarak yüklenir. npm paketlerini npm: önekiyle içe aktarın; Blockstudio bunları üretim için yerel olarak indirir.

Düzenleyicide anında önizleme sunulurken ön yüz, harici bağımlılık olmadan ve yalnızca bir kez sıraya alınan yerel modülleri kullanır.

Stil sayfaları da aynı şekilde içe aktarılır. import "npm:swiper@11.0.0/swiper.min.css" dosyayı indirir ve birden fazla blok kullansa bile her sürüm için kuyruğa yalnızca bir kez ekler.

script.js
import Swiper from "npm:swiper@11.0.0";
import "npm:swiper@11.0.0/swiper.min.css";

for (const el of document.querySelectorAll(".swiper")) {
  new Swiper(el, {
    slidesPerView: 3,
    spaceBetween: 20,
    loop: true,
  });
}

Şablonların ötesinde blok etiketleri

blockstudio.json içinde kısa bir öneki bir ad alanına eşleyin veya bir takma ad filtresiyle tek bir etiketi tek bir bloğa bağlayın; ardından <acme-card>, acme/card öğesini işler. blockTags.enabled seçeneğini etkinleştirerek yazı içeriği ve bileşenlerdeki etiketleri, allow ve deny desenleriyle sınırlandırılmış biçimde işleyin.

data-* özellikleri bloğun kök öğesine ulaşır; html-* özellikleri de önek olmadan oraya gelir. blockstudio/block_tags/builders ile kendi etiket oluşturucularınızı ekleyin ve migrate-block-tags komutuyla kısaltmaları taşınabilir <bs:acme-card> yazımına dönüştürün.

blockstudio.json
{
  "blockTags": {
    "enabled": true,
    "prefixes": {
      "acme": ["acme"],
      "ui": ["acme-ui"]
    },
    "deny": ["acme-ui/admin-*"]
  }
}

Özel alan türleri

Kendi alan denetiminizi kaydedin ve yerleşik bir alan gibi kullanın.

Blok adacıkları

Tüm sayfayı önbelleğe alın ve ziyaretçinin isteği sırasında tek bir bloğu işleyin.

Koşullu kayıt

Bir bloğu yalnızca belirli bir yazı türü, kullanıcı rolü veya başka bir genel koşul için kaydedin ya da ihtiyaç duyduğu bir eklenti veya eklenti sürümü eksikse kaydını atlayın.

Yazı meta verileri ve seçenekler

Değerleri blok özniteliklerinin yanı sıra yazı meta verilerinde veya seçeneklerde saklayın.

Koşullu mantık

Eşitlik, dahil olma, boşluk ve karşılaştırmaları kullanarak alanları değerlere göre gösterin.

Dinamik veri kaynakları

Seçenekleri yazılardan, kullanıcılardan, terimlerden, işlevlerden veya API’lerden doldurun.

Geçersiz Kılmalar

Paylaşılan bir bloğun adıyla override: true ayarlayarak özellikleri kimliğe göre birleştirin, varlıkları eşleşen dosya adlarıyla değiştirin ve şablonu değiştirin. Twig şablonları, tek tek blokları extends ile geçersiz kılabilir.

Varyasyonlar

Alan değerlerini önceden belirleyen varyasyonları block.json içinde tanımlayın ve bunları yöneten alanı hidden ile gizleyin.

Bileşenler

Yalnızca PHP veya blok etiketleriyle oluşturulan bir blok için component: true ayarlayın. Alanları, şablonları, varlıkları ve Tailwind öğesini korur ancak blok ekleyicide hiç görünmez.

InnerBlocks kuralları

namespace/*, category: ve @theme belirteçlerine sahip bloklara izin verin, iç şablonu bir select seçeneğinden değiştirin ve filtreyle ön yüzdeki sarmalayıcıyı kaldırın.

Kod alanı varlıkları

asset: true değerine sahip bir kod alanı, düzenleyici girdisini o blok için CSS, SCSS veya JavaScript biçimine dönüştürür ve kapsamı %selector% aracılığıyla örnekle sınırlar.

Dosya adına göre varlıklar

*.view.js yalnızca ön yüzde yüklenir; global-, admin- ve block-editor- önekleri ise dosyayı sırasıyla her sayfada, wp-admin’de veya blok düzenleyicide yükler.

Simgeler ve blok klasörleri

Bir bloğa özel bir SVG veya HTML simgesi verin, keşif konumunu blockstudio/path filtresiyle değiştirin ve Blockstudio\Build::init() ile klasör ekleyin.

ACF ve Meta Box değerleri

Şablonlar $post_id alır; böylece get_field() ve rwmb_get_value() düzenlenen yazıyı okur, refreshOn ise kaydetmenin ardından önizlemeyi yeniler.

Query Loop bağlamı

Bir Query Loop içinde $block[‘context’][‘postId’] mevcut öğeyi izlerken $block[‘postId’] görüntülenen yazı olarak kalır.

WPML

wp bs wpml config, metin alanlarını çevrilebilir olarak işaretleyen wpml-config.xml dosyasını yazar; alanlarda saklanan görseller de alternatif metinleri ve açıklamalarıyla birlikte WPML çeviri işlerine katılır.

Plus

Resmî uzantı kiti

Premium site şablonları, yapay zekâ sistem talimatları ve özel bir Discord topluluğu. Tek seferlik satın alma, ömür boyu güncellemeler.

  • 500+ site şablonu
  • Yapay zekâ sistem talimatları
  • Ömür boyu güncellemeler
  • Özel Discord topluluğu