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.
{
"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.
<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.
<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><div useBlockProps class="card">
<RichText tag="h2" attribute="title" placeholder="Card title" />
@if ($a['description'])
<div class="card__body">{{ $a['description'] }}</div>
@endif
<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.
{
"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" }
]]
}
]
}
}add_filter('blockstudio/blocks/attributes/populate', function ($options) {
$options['cardStyles'] = [
['value' => 'light', 'label' => 'Light'],
['value' => 'dark', 'label' => 'Dark'],
];
return $options;
});
add_filter('blockstudio/blocks/conditions', function ($conditions) {
$conditions['purchasedProduct'] = user_has_purchased(123) ? 'yes' : 'no';
return $conditions;
});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.
{
"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" }
]
}
]
}
}<div useBlockProps class="team">
<?php foreach ($a['members'] as $index => $member): ?>
<article>
<h3><?= esc_html($member['name']) ?></h3>
<RichText
tag="p"
attribute="members[<?= $index ?>].bio"
placeholder="Short bio"
/>
</article>
<?php endforeach; ?>
</div>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.
{
"name": "cta",
"title": "Call to action",
"attributes": [
{ "id": "label", "type": "text", "label": "Button label", "default": "Learn more" },
{ "id": "url", "type": "link", "label": "Button URL" }
]
}{
"name": "starter/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{ "type": "custom/cta", "idStructure": "primary_{id}" },
{
"type": "custom/cta",
"idStructure": "secondary_{id}",
"overrides": {
"label": { "default": "Contact us" }
}
},
{
"id": "card",
"type": "block",
"block": "starter/card",
"idStructure": "card_{id}"
}
]
}
}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.
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.
{
"blockTags": {
"enabled": true,
"prefixes": {
"acme": ["acme"],
"ui": ["acme-ui"]
},
"deny": ["acme-ui/admin-*"]
}
}<div useBlockProps class="acme-features">
<acme-card
title="Fast"
text="Rendered on the server."
data-track="card"
/>
<ui-button label="Get started" href="/start" html-id="start" />
</div>Ö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.
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