Alan Desenleri Rehberi
Blockstudio alan sistemi tek başına basittir: blockstudio.attributes‘a bir alan ekleyin, şablonunuzda $a üzerinden erişin. Ancak gerçek bloklarda nadiren tek bir alan bulunur. İlişkili ayar grupları, diğer alanlara bağlı olarak gösterilen veya gizlenen alanlar, karmaşık satır yapıları içeren yineleyiciler ve blok düzenleyicisinin dışında sorgulanabilmesi gereken veriler bulunur.
Bu kılavuzda yaygın alan desenleri için pratik tarifler bir araya getirilmiştir. Her tarifte block.json yapılandırması ve karşılık gelen şablon kodu gösterilir. Bunları doğrudan bloklarınıza kopyalayıp ihtiyacınıza göre uyarlayın.
Koşullu Alanlar
En yaygın desen, alanları başka bir alanın değerine göre gösterip gizlemektir. Böylece yalnızca ilgili seçenekler sunularak düzenleyici sade tutulur.
Seçenekleri göstermek için açma/kapama anahtarı
Kullanıcı bir düğmeyi etkinleştirdiğinde ek ayarların göründüğü bir CTA bloğu:
{
"name": "my-theme/cta",
"title": "Call to Action",
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading", "default": "Ready to get started?" },
{ "id": "description", "type": "textarea", "label": "Description" },
{ "id": "showButton", "type": "toggle", "label": "Show Button", "default": true },
{
"id": "buttonText",
"type": "text",
"label": "Button Text",
"default": "Get Started",
"conditions": [[{ "id": "showButton", "operator": "==", "value": true }]]
},
{
"id": "buttonUrl",
"type": "link",
"label": "Button Link",
"conditions": [[{ "id": "showButton", "operator": "==", "value": true }]]
}
]
}
}
Düğme metni ve bağlantı alanları yalnızca anahtar açıkken görünür. Şablonda, içeriği oluşturmadan önce anahtarı kontrol edin:
<div useBlockProps>
<h2><?php echo esc_html( $a['heading'] ); ?></h2>
<?php if ( $a['description'] ) : ?>
<p><?php echo esc_html( $a['description'] ); ?></p>
<?php endif; ?>
<?php if ( $a['showButton'] && $a['buttonUrl'] ) : ?>
<a href="<?php echo esc_url( $a['buttonUrl']['url'] ); ?>">
<?php echo esc_html( $a['buttonText'] ); ?>
</a>
<?php endif; ?>
</div>
Alan kümelerini değiştirmek için seçim alanı
Arka plan türünün hangi alanların görüneceğini belirlediği bir hero bloğu:
{
"name": "my-theme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{
"id": "bgType",
"type": "select",
"label": "Background Type",
"default": "color",
"options": [
{ "value": "color", "label": "Solid Color" },
{ "value": "gradient", "label": "Gradient" },
{ "value": "image", "label": "Image" },
{ "value": "video", "label": "Video" }
]
},
{
"id": "bgColor",
"type": "color",
"label": "Background Color",
"conditions": [[{ "id": "bgType", "operator": "==", "value": "color" }]]
},
{
"id": "bgGradient",
"type": "gradient",
"label": "Background Gradient",
"conditions": [[{ "id": "bgType", "operator": "==", "value": "gradient" }]]
},
{
"id": "bgImage",
"type": "files",
"label": "Background Image",
"multiple": false,
"conditions": [[{ "id": "bgType", "operator": "==", "value": "image" }]]
},
{
"id": "bgVideo",
"type": "files",
"label": "Background Video",
"multiple": false,
"allowedTypes": ["video"],
"conditions": [[{ "id": "bgType", "operator": "==", "value": "video" }]]
},
{
"id": "overlay",
"type": "range",
"label": "Overlay Opacity",
"default": 50,
"min": 0,
"max": 100,
"conditions": [[{ "id": "bgType", "operator": "!=", "value": "color" }]]
}
]
}
}
Kaplama opaklığı alanı, düz renk dışındaki tüm seçeneklerde görünmek için != kullanır. Aynı anda yalnızca bir arka plan alanı görünür. color alanı rengin value, name ve slug değerlerini içeren bir dizi döndürür; bu nedenle şablon ['value'] değerini okur:
<?php
$bg_style = match ( $a['bgType'] ) {
'color' => $a['bgColor'] ? "background-color: {$a['bgColor']['value']}" : '',
'gradient' => $a['bgGradient'] ? "background: {$a['bgGradient']}" : '',
'image' => $a['bgImage'] ? "background-image: url({$a['bgImage']['url']})" : '',
default => '',
};
?>
<div useBlockProps style="<?php echo esc_attr( $bg_style ); ?>">
<?php if ( $a['bgType'] === 'video' && $a['bgVideo'] ) : ?>
<video autoplay muted loop playsinline>
<source src="<?php echo esc_url( $a['bgVideo']['url'] ); ?>" />
</video>
<?php endif; ?>
<h1><?php echo esc_html( $a['heading'] ); ?></h1>
</div>
VEYA koşulları
Birden fazla koşuldan herhangi biri doğru olduğunda alanı gösterin. Her iç dizi bir VE grubudur; dış dizi bunları VEYA ile birleştirir:
{
"id": "caption",
"type": "text",
"label": "Caption",
"conditions": [
[{ "id": "bgType", "operator": "==", "value": "image" }],
[{ "id": "bgType", "operator": "==", "value": "video" }]
]
}
Bu, bgType değeri “image” VEYA “video” olduğunda açıklama alanını gösterir.
Zincirleme koşullar
Aynı iç dizideki birden fazla koşul VE mantığıyla çalışır:
{
"id": "altText",
"type": "text",
"label": "Alt Text",
"conditions": [[
{ "id": "bgType", "operator": "==", "value": "image" },
{ "id": "bgImage", "operator": "!empty" }
]]
}
Alternatif metin alanı yalnızca bgType değeri “image” olduğunda VE bir görsel seçildiğinde görünür.
Genel koşullar
Alanları başka alan değerlerine göre değil, gönderi türüne, gönderi kimliğine veya kullanıcı rolüne göre gösterin:
{
"id": "seoTitle",
"type": "text",
"label": "SEO Title",
"conditions": [[{ "type": "postType", "operator": "==", "value": "page" }]]
}
Kullanılabilir genel koşul türleri: postType, postId, userRole, userId.
Düzenli Ayarlar
Bloklar karmaşıklaştıkça alanları mantıksal gruplar hâlinde düzenlemek, denetçiyi yönetilebilir tutar.
Görsel düzen için gruplar
Gruplar, denetçide daraltılabilir bölümler oluşturur. İsimsiz bir grup (id yok) yalnızca görsel düzen içindir; alanlarına yalın kimlikleriyle erişilir:
{
"name": "my-theme/card",
"title": "Card",
"blockstudio": {
"attributes": [
{
"type": "group",
"title": "Content",
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{ "id": "description", "type": "textarea", "label": "Description" },
{ "id": "image", "type": "files", "label": "Image", "multiple": false }
]
},
{
"type": "group",
"title": "Link",
"attributes": [
{ "id": "url", "type": "link", "label": "URL" },
{ "id": "openInNewTab", "type": "toggle", "label": "Open in New Tab" }
]
},
{
"type": "group",
"title": "Appearance",
"attributes": [
{
"id": "style",
"type": "select",
"label": "Style",
"default": "elevated",
"options": [
{ "value": "elevated", "label": "Elevated" },
{ "value": "outlined", "label": "Outlined" },
{ "value": "flat", "label": "Flat" }
]
},
{ "id": "accentColor", "type": "color", "label": "Accent Color" }
]
}
]
}
}
<div useBlockProps>
<h3><?php echo esc_html( $a['title'] ); ?></h3>
<p><?php echo esc_html( $a['description'] ); ?></p>
</div>
Alanlara doğrudan erişilir: $a['title'], $a['style'], $a['accentColor']. Gruplar yalnızca denetçi düzenini etkiler.
bs_get_group ile adlandırılmış gruplar
Bir grubun id değeri varsa alt alan kimliklerine bu değer önek olarak eklenir. Öneki kaldırmak için bs_get_group() kullanın:
{
"id": "author",
"type": "group",
"title": "Author",
"attributes": [
{ "id": "name", "type": "text", "label": "Name" },
{ "id": "role", "type": "text", "label": "Role" },
{ "id": "avatar", "type": "files", "label": "Avatar", "multiple": false }
]
}
Yardımcı olmadan alanlara $a['author_name'], $a['author_role'], $a['author_avatar'] şeklinde erişilir. Yardımcıyla:
<?php $author = bs_get_group( $a, 'author' ); ?>
<div class="author">
<?php if ( $author['avatar'] ) : ?>
<img src="<?php echo esc_url( $author['avatar']['url'] ); ?>" alt="" />
<?php endif; ?>
<p><?php echo esc_html( $author['name'] ); ?></p>
<p><?php echo esc_html( $author['role'] ); ?></p>
</div>
Aynı alan adları birden fazla grupta yer aldığında (e.g., author_name ve company_name) veya grubu tek bir birim olarak kısmi bir şablona geçirmek istediğinizde adlandırılmış gruplar kullanışlıdır.
Gruplarda ızgara düzeni
Grup alt öğelerini yan yana düzenlemek için style özelliğini kullanın:
{
"type": "group",
"title": "Dimensions",
"style": {
"display": "grid",
"grid-template-columns": "1fr 1fr",
"grid-gap": "16px"
},
"attributes": [
{ "id": "width", "type": "unit", "label": "Width", "default": "100%", "switch": false },
{ "id": "height", "type": "unit", "label": "Height", "default": "auto", "switch": false }
]
}
Denetçide iki birim alanı üst üste değil, yan yana görüntülenir. Bu düzen boyut çiftleri, kenar boşluğu/dolgu değerleri veya kavramsal olarak eşleştirilmiş iki alan için uygundur.
Ana bölümler için sekmeler
Bir blokta çok sayıda ayar olduğunda sekmeler, uzun bir grup listesine kıyasla daha düzenli bir görünüm sağlar:
{
"type": "tabs",
"tabs": [
{
"title": "Content",
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{ "id": "body", "type": "wysiwyg", "label": "Body" }
]
},
{
"title": "Media",
"attributes": [
{ "id": "image", "type": "files", "label": "Image", "multiple": false },
{ "id": "video", "type": "files", "label": "Video", "multiple": false, "allowedTypes": ["video"] }
]
},
{
"title": "Settings",
"attributes": [
{ "id": "layout", "type": "select", "label": "Layout", "options": [
{ "value": "left", "label": "Media Left" },
{ "value": "right", "label": "Media Right" }
]},
{ "id": "fullWidth", "type": "toggle", "label": "Full Width" }
]
}
]
}
Her sekmenin alanlarına üst düzey alanlar gibi erişilir: $a['title'], $a['image'], $a['layout']. Sekmeler yalnızca bir UI kapsayıcısıdır.
Yineleyici Desenleri
Yineleyiciler, kullanıcıların birden fazla alan satırı eklemesine olanak tanır. Listeler, ızgaralar, zaman çizelgeleri ve değişken sayıda öğe içeren tüm bileşenler için gereklidir.
Kısıtlamalı temel yineleyici
1 ila 6 öğeli bir özellik listesi:
{
"id": "features",
"type": "repeater",
"label": "Features",
"min": 1,
"max": 6,
"textButton": "Add Feature",
"attributes": [
{ "id": "icon", "type": "icon", "label": "Icon" },
{ "id": "title", "type": "text", "label": "Title", "default": "Feature" },
{ "id": "description", "type": "textarea", "label": "Description" }
]
}
<div useBlockProps class="grid grid-cols-3 gap-8">
<?php foreach ( $a['features'] as $feature ) : ?>
<div>
<?php if ( $feature['icon'] ) : ?>
<?php bs_render_icon( $feature['icon'] ); ?>
<?php endif; ?>
<h3><?php echo esc_html( $feature['title'] ); ?></h3>
<p><?php echo esc_html( $feature['description'] ); ?></p>
</div>
<?php endforeach; ?>
</div>
Özel satır etiketleri
Varsayılan olarak, daraltılmış yineleyici satırlarında genel bir etiket gösterilir. Bunun yerine bir alan değerini göstermek için textMinimized kullanın:
{
"id": "team",
"type": "repeater",
"label": "Team Members",
"textMinimized": { "id": "name", "fallback": "Team Member" },
"attributes": [
{ "id": "name", "type": "text", "label": "Name" },
{ "id": "role", "type": "text", "label": "Role" },
{ "id": "photo", "type": "files", "label": "Photo", "multiple": false }
]
}
Bir satır daraltıldığında “Row 1” yerine kişinin adı gösterilir. Ad alanı boşsa fallback kullanılır. Ayrıca prefix ve suffix dizeleri de ekleyebilirsiniz.
Yineleyiciler içindeki koşullar
Yineleyicinin içindeki alanlar, aynı satırdaki diğer alanlara yalın id değerlerini kullanarak başvurabilir (önek gerekmez):
{
"id": "links",
"type": "repeater",
"label": "Links",
"attributes": [
{ "id": "label", "type": "text", "label": "Label" },
{ "id": "url", "type": "link", "label": "URL" },
{
"id": "isExternal",
"type": "toggle",
"label": "External Link"
},
{
"id": "externalNote",
"type": "message",
"label": "Note",
"description": "External links open in a new tab with rel=\"noopener\".",
"conditions": [[{ "id": "isExternal", "operator": "==", "value": true }]]
}
]
}
Yineleyicinin içinden dış alanlara başvurma
Yineleyicinin içindeki bir koşulun, yineleyici dışındaki bir alanı kontrol etmesi gerektiğinde "context": "main" ekleyin:
{
"id": "showDescriptions",
"type": "toggle",
"label": "Show Descriptions",
"default": true
},
{
"id": "items",
"type": "repeater",
"label": "Items",
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{
"id": "description",
"type": "textarea",
"label": "Description",
"conditions": [[{
"id": "showDescriptions",
"operator": "==",
"value": true,
"context": "main"
}]]
}
]
}
"context": "main" olmadan koşul, yineleyici satırının içindeki bir showDescriptions alanını arardı. Bununla koşul, kök düzeyindeki anahtarı kontrol eder.
Tekrarlayıcıların içindeki sekmeler
Tekrarlayıcıların içinde sekmeler kullanılamaz: tekrarlayıcı satırındaki bir tabs alanı, alanları yerine düzenleyicide bir bildirim gösterir ve PHPStan uzantısı bunu bildirir. Bunun yerine satırın alanlarını düz tutun. Uzun satırlarda özel bir satır etiketi (textMinimized), daraltılmış satırların okunabilir kalmasını sağlar; satır içindeki koşullar da yukarıdaki örüntülerde gösterildiği gibi yalnızca bazı satırların ihtiyaç duyduğu alanları gizleyebilir.
Mevcut satırların daraltılmış başlaması için tekrarlayıcıda "minimized": true ayarını yapın. Yeni eklenen satırlar hemen açılır. Genişletilmiş istisnalar, düzenleyici yeniden yüklendiğinde bu tarayıcıda hatırlanır; bu bir düzenleme tercihidir, kaydedilmiş yazı içeriği değildir.
minimized olmayan tekrarlayıcılar, varsayılan olarak genişletilmiş olma davranışını sürdürür.
Medya Desenleri
Alternatifli tek görsel
{
"id": "image",
"type": "files",
"label": "Image",
"multiple": false
}
<?php if ( $a['image'] ) : ?>
<img
src="<?php echo esc_url( $a['image']['url'] ); ?>"
alt="<?php echo esc_attr( $a['image']['alt'] ); ?>"
<?php if ( isset( $a['image']['sizes']['full-width'], $a['image']['sizes']['full-height'] ) ) : ?>
width="<?php echo esc_attr( $a['image']['sizes']['full-width'] ); ?>"
height="<?php echo esc_attr( $a['image']['sizes']['full-height'] ); ?>"
<?php endif; ?>
/>
<?php endif; ?>
Varsayılan returnFormat, "object" değeridir; bu da ID, title, alt, caption, description, href, url ve sizes sağlar. sizes, boyutları (sizes['large-width'], sizes['large-height']) ile birlikte kayıtlı her görsel boyutunun URL bilgisini (sizes['large']) içerir. Tam liste için Oluşturma Öznitelikleri bölümüne bakın.
Sınırlı galeri
{
"id": "gallery",
"type": "files",
"label": "Gallery",
"multiple": true,
"max": 6,
"allowedTypes": ["image"]
}
<?php if ( $a['gallery'] ) : ?>
<div class="grid grid-cols-3 gap-4">
<?php foreach ( $a['gallery'] as $image ) : ?>
<img
src="<?php echo esc_url( $image['url'] ); ?>"
alt="<?php echo esc_attr( $image['alt'] ); ?>" />
<?php endforeach; ?>
</div>
<?php endif; ?>
Anahtarlı, devre dışı bırakılabilir görsel
switch özelliği, kullanıcıların değeri silmeden alanı devre dışı bırakmasını sağlayan bir göz simgesi ekler:
{
"id": "logo",
"type": "files",
"label": "Logo",
"multiple": false,
"switch": true
}
<?php
$is_disabled = ! empty( $a['_disabled'] ) && in_array( 'logo', $a['_disabled'], true );
if ( $a['logo'] && ! $is_disabled ) : ?>
<img src="<?php echo esc_url( $a['logo']['url'] ); ?>" alt="" />
<?php endif; ?>
Kullanıcı, yüklenen dosyayı kaldırmadan logoyu kapatabilir. Yeniden etkinleştirildiğinde aynı dosya geri gelir.
Döndürülen biçim seçenekleri
Dosyalar alanının ne döndüreceğini kontrol edin:
// Full object (default)
{ "id": "photo", "type": "files", "returnFormat": "object", "multiple": false }
// $a['photo']['url'], $a['photo']['alt'], $a['photo']['sizes']['full-width'], etc.
// Just the ID
{ "id": "photo", "type": "files", "returnFormat": "id", "multiple": false }
// $a['photo'] = 42
// Just the URL
{ "id": "photo", "type": "files", "returnFormat": "url", "multiple": false }
// $a['photo'] = "https://example.com/photo.jpg"
wp_get_attachment_image() işlevini kendiniz çağırmanız gerektiğinde "id" kullanın. Basit arka plan görselleri için "url" kullanın. Diğer tüm durumlarda "object" (varsayılan) kullanın.
"returnFormat": "id" ile içe aktarılan "buckshair-home" gibi bir dize başvurusu değiştirilmeden aktarılır. Düzenleyici, tekrarlayıcı satırları da dâhil olmak üzere, küçük resmi olmayan bir yedek kart gösterir. Sayfayı açmak veya kaydetmek, skaler bir başvuruyu diziye dönüştürmez. Ek kimlikleri ve dize başvurularından oluşan karma listeler de çalışır; medya kütüphanesinde yalnızca pozitif ek kimlikleri aranır.
Blockstudio, özel dize başvurularını eklere dönüştürmez. Siteler arasında taşınabilir adlar kullanırken bunları kendi oluşturma filtrenizde veya şablonunuzda çözümleyin. Medya kütüphanesinde bir yedek seçildiğinde, her zamanki gibi ek kimliği kaydedilir.
Dinamik Seçenekler
Gönderilerden doldurma
Yayımlanmış tüm sayfaları listeleyen bir seçim alanı:
{
"id": "linkedPage",
"type": "select",
"label": "Linked Page",
"stylisedUi": true,
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "page",
"post_status": "publish",
"posts_per_page": -1
}
}
}
Alan, sayfa başlıklarını otomatik olarak etiket, gönderi kimliklerini ise değer olarak doldurur. Eşlemeyi özelleştirmek için doldurma yapılandırmasında returnFormat kullanın:
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "page" },
"returnFormat": { "value": "ID", "label": "post_title" }
}
Taksonomi terimlerinden doldurma
{
"id": "category",
"type": "select",
"label": "Category",
"stylisedUi": true,
"populate": {
"type": "query",
"query": "terms",
"arguments": {
"taxonomy": "category",
"hide_empty": true
}
}
}
PHP işlevinden doldurma
{
"id": "postType",
"type": "select",
"label": "Post Type",
"populate": {
"type": "function",
"function": "get_post_types",
"arguments": { "public": true }
}
}
Doldurulan ek seçeneklerle statik seçenekler
Sabit kodlanmış seçenekleri dinamik olanlarla birleştirin. Doldurulan seçeneklerin nerede görüneceğini kontrol etmek için position kullanın:
{
"id": "source",
"type": "select",
"label": "Source",
"options": [
{ "value": "manual", "label": "Manual Entry" },
{ "value": "latest", "label": "Latest Posts" }
],
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "page" },
"position": "after"
}
}
Önce statik seçenekler, ardından dinamik olarak doldurulan sayfalar görünür.
Sorgular için Veri Depolama
Varsayılan olarak alan değerleri, post_content içindeki blok özniteliklerinde saklanır. WP_Query ile sorgulanamazlar. Gönderileri alan değerine göre filtrelemeniz veya sıralamanız gerektiğinde depolama kullanın.
Sorgulanabilir alanlar için gönderi metaverisi
{
"id": "featured",
"type": "toggle",
"label": "Featured",
"storage": {
"type": "postMeta",
"postMetaKey": "is_featured"
}
},
{
"id": "priority",
"type": "number",
"label": "Priority",
"default": 0,
"min": 0,
"max": 100,
"storage": {
"type": "postMeta",
"postMetaKey": "priority_score"
}
}
Artık öne çıkan gönderileri sorgulayabilirsiniz:
$featured = new WP_Query( array(
'meta_query' => array(
array(
'key' => 'is_featured',
'value' => '1',
),
),
'orderby' => 'meta_value_num',
'meta_key' => 'priority_score',
'order' => 'DESC',
) );
Meta anahtarları show_in_rest ile otomatik kaydedilir; bu nedenle REST API içinde de kullanılabilirler.
İkili depolama
Hem blok özniteliklerinde hem de gönderi metaverisinde saklayın. Blok özniteliği, değeri şablonlarda $a üzerinden erişilebilir tutarken gönderi metaverisi değerin sorgulanmasını sağlar:
{
"id": "eventDate",
"type": "date",
"label": "Event Date",
"storage": {
"type": ["block", "postMeta"],
"postMetaKey": "event_date"
}
}
Genel değerler için seçenek depolaması
Her yerde aynı olması gereken site genelindeki ayarlar için seçenek depolamasını kullanın:
{
"id": "companyName",
"type": "text",
"label": "Company Name",
"storage": {
"type": "option",
"optionKey": "site_company_name"
}
}
Değer wp_options içinde saklanır ve her yerden get_option('site_company_name') ile erişilebilir. Kullanıcı bu alanı herhangi bir blok örneğinde düzenlediğinde değer genel olarak güncellenir.
Yeniden Kullanılabilir Alan Tanımları
Birden fazla blok aynı alan yapısını paylaştığında, yapıyı bir kez özel alan olarak tanımlayıp her yerde kullanın.
Özel alan oluşturma
Temanızın blockstudio/fields/ dizininde bir field.json oluşturun:
theme/
└── blockstudio/
└── 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" },
{ "id": "style", "type": "select", "label": "Button Style", "default": "primary", "options": [
{ "value": "primary", "label": "Primary" },
{ "value": "secondary", "label": "Secondary" },
{ "value": "outline", "label": "Outline" }
]}
]
}
Özel alanı kullanma
"type": "custom/cta" ile herhangi bir blokta bu alana başvurun:
{
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{ "type": "custom/cta" }
]
}
}
CTA alanları bloğa satır içi olarak eklenir. Bunlara doğrudan erişin: $a['label'], $a['url'], $a['style'].
idStructure ile önekli özel alanlar
Aynı özel alanı birden çok kez kullanırken kimliklere önek eklemek için idStructure ekleyin:
{
"blockstudio": {
"attributes": [
{ "type": "custom/cta", "idStructure": "primary_{id}" },
{ "type": "custom/cta", "idStructure": "secondary_{id}" }
]
}
}
İlk CTA’nın alanları primary_label, primary_url, primary_style olur. İkincininkiler secondary_label olur ve böyle devam eder.
Varsayılanları geçersiz kılma
Özel bir alana başvururken belirli alanları özelleştirin:
{
"type": "custom/cta",
"idStructure": "hero_{id}",
"overrides": {
"label": { "default": "Get Started", "label": "CTA Label" },
"style": { "default": "primary" }
}
}
Geçersiz kılmalar, özgün tanımın üzerine birleştirilir. Varsayılanları, etiketleri, koşulları veya başka herhangi bir özelliği değiştirebilirsiniz.
Görüntüleme Desenleri
Boş değer kontrolleri
Çoğu alan türü boş olduğunda false döndürür. Görüntülemeden önce her zaman kontrol edin:
<?php if ( $a['title'] ) : ?>
<h2><?php echo esc_html( $a['title'] ); ?></h2>
<?php endif; ?>
Sayılar için 0 geçerli bir değerdir. “Boş” ile “sıfır” değerlerini ayırt etmeniz gerekiyorsa katı karşılaştırma kullanın:
<?php if ( $a['count'] !== 0 || $a['count'] !== false ) : ?>
<span><?php echo esc_html( $a['count'] ); ?></span>
<?php endif; ?>
returnFormat: both ile seçim alanı
Hem değere (mantık için) hem de etikete (görüntüleme için) ihtiyaç duyduğunuzda:
{
"id": "status",
"type": "select",
"label": "Status",
"returnFormat": "both",
"options": [
{ "value": "active", "label": "Active" },
{ "value": "paused", "label": "On Hold" },
{ "value": "closed", "label": "Closed" }
]
}
<?php if ( $a['status'] ) : ?>
<span class="badge badge--<?php echo esc_attr( $a['status']['value'] ); ?>">
<?php echo esc_html( $a['status']['label'] ); ?>
</span>
<?php endif; ?>
Öznitelikler alanından veri öznitelikleri
attributes alan türü, kullanıcıların özel veri öznitelikleri eklemesini sağlar:
{
"id": "dataAttrs",
"type": "attributes",
"label": "Data Attributes",
"link": true,
"media": true
}
<div useBlockProps <?php bs_render_data_attributes( $a['dataAttrs'] ); ?>>
Content here.
</div>
Alan değerlerinden CSS değişkenleri
Seçilen alanlardan özel CSS özellikleri oluşturun:
{
"id": "textColor", "type": "color", "label": "Text Color"
},
{
"id": "fontSize", "type": "unit", "label": "Font Size", "default": "1rem"
}
<div useBlockProps style="<?php bs_render_variables( $a, array( 'textColor', 'fontSize' ) ); ?>">
<p>Styled content.</p>
</div>
Bu işlem style="--text-color: #333; --font-size: 1rem;" çıktısını verir (alan kimlikleri kebab-case biçimine dönüştürülür). Değişkenleri CSS içinde kullanın:
p {
color: var(--text-color);
font-size: var(--font-size);
}
Sonraki Adımlar
- Öznitelikleri kaydetme:
id,type,label,default,help,positionveconditionsözellikleri. - Alan türleri başvurusu: her alan türünün tüm özelliklerini içeren otomatik oluşturulmuş başvuru.
- Koşullu mantık: işleçler, genel koşullar, özel koşul filtreleri ve yineleyici bağlamı.
- Seçenekleri doldurma: dinamik seçenek alanları için sorgu, işlev, özel ve getirme modları.
- Özel alanlar:
field.json, keşif yolları,blockstudio/fieldsfiltresi ve gelişmişidStructuredesenleri. - Görüntüleme:
$a,$b,$c, boş değerler ve yardımcı işlevler.