# 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.

[Alan türleri başvurusu](https://blockstudio.dev/tr/docs/blocks/attributes/field-types/)

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.

[Bileşenleri keşfedin](https://blockstudio.dev/tr/docs/blocks/react-components/)

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.

[Şablon dilleri](https://blockstudio.dev/tr/docs/blocks/templating/blade/)

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.

[Koşullu mantık](https://blockstudio.dev/tr/docs/blocks/attributes/conditional-logic/)

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.

[Tekrarlayıcı desenleri](https://blockstudio.dev/tr/guides/field-patterns/#repeater-patterns)

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.

[Özel alanlar](https://blockstudio.dev/tr/docs/blocks/attributes/custom-fields/)

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.

[Varlık işleme](https://blockstudio.dev/tr/docs/blocks/assets/)

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.

[Kılavuzu okuyun](https://blockstudio.dev/tr/guides/block-tags/)

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

[Plus edinin](https://blockstudio.dev/tr/plus/)
