
Blockstudio 7 çıktı. Bu, projenin tarihindeki en büyük sürüm: tüm kod tabanının baştan sona yeniden yazımı. Her sınıf, her kanca ve her kod satırı; modern PHP, WordPress kodlama standartlarına ve uzun vadeli sürdürülebilirliğe odaklanılarak sıfırdan yeniden oluşturuldu.

Ancak bu yalnızca bir yeniden düzenleme değil. Blockstudio 7; dosya tabanlı sayfalar ve desenler, yazı meta veri depolama sistemi, SEO entegrasyonu ve tüm bunları destekleyen yepyeni bir HTML-blok ayrıştırıcısı gibi önemli yeni özellikler sunuyor. Üstelik Blockstudio artık tamamen ücretsiz ve açık kaynak.

Yeniliklerin tümüne göz atalım.

## Ücretsiz ve açık kaynak

Blockstudio üzerinde 2020 tarihinden beri çalışıyor, yıllar içinde onlarca sürüm yayımlıyorum. Kullananlar ürünü sevdi, ancak ticari bir WordPress blok çerçevesi için pazarda yer bulmak hep zordu.

Dengeyi değiştiren LLM'ler oldu. Yapay zekâ kodlama asistanları artık blok kodu yazabilecek kadar iyi, ancak çalışabilmeleri için temiz, dosya tabanlı yapılara ihtiyaçları var. WordPress blok işaretlemesi karmaşık: içine JSON öznitelikleri yerleştirilmiş serileştirilmiş HTML yorumları, DOM yapısıyla iç içe. İnsanların doğru yazması zor, LLM'ler içinse daha da zor.

Blockstudio dosya öncelikli yaklaşımı her zaman işleri basit tutmak için tasarlandı: bir klasörde bir `block.json` ve bir PHP şablonu. Veritabanı girdisi yok, React yok, derleme adımı yok. v7 ile bu yaklaşım daha da ileri gidiyor. HTML-blok ayrıştırıcısı, düz HTML yazmanıza ve bunun otomatik olarak geçerli blok işaretlemesine dönüştürülmesine olanak tanıyor. Her şey dosya sisteminde kalıyor. Veritabanına yalnızca PHP API veya CLI üzerinden açıkça istenen sayfa eşitlemeleri yazılıyor; bunlar da dosya şablonları tarafından yürütülüyor.

Blockstudio'ı açık kaynak yapmak doğal bir sonraki adım. LLM'ler Blockstudio koduyla ne kadar çok eğitilirse kod üretmede o kadar iyileşiyorlar. Açık bir kod tabanı, açık belgeler ve her aracın kullanabileceği önceden hazırlanmış bir [yapay zekâ bağlam dosyası](https://blockstudio.dev/tr/docs/dev/ai/): yapay zekâ destekli WordPress geliştirme için en iyi ortam böyle oluşturulur.

Eklentinin tamamı, herkesin kullanması, çatallaması ve katkıda bulunması için [GitHub](https://github.com/inline0/blockstudio) üzerinde mevcut. Lisans anahtarı yok, ödeme duvarı yok, özellik kısıtlaması yok.

## Yeni özellikler

### Dosya tabanlı sayfalar

Bu, 7.0 sürümündeki en büyük yeniliklerden biri. Artık bütün WordPress sayfalarını, sayfa eşitleme API veya CLI komutunu çalıştırdığınızda yerel blok içeriği olarak veritabanıyla eşitlenen dosya şablonları biçiminde tanımlayabilirsiniz.

`page.json` ve bir şablon dosyası içeren bir klasör oluşturun:

```json title="page.json"
{
  "name": "about",
  "title": "About Us",
  "slug": "about",
  "postStatus": "publish"
}
```

```php title="index.php"
<div class="about-page">
  <h1>About Us</h1>
  <p>Welcome to our site.</p>
</div>
```

`wp bs pages sync` komutunu çalıştırarak Blockstudio aracının HTML dosyasını WordPress bloklarına ayrıştırmasını ve veritabanındaki sayfayı oluşturmasını ya da güncellemesini sağlayın.

#### Anahtarlı blok birleştirme

Şablonlar eşitlendiğinde kullanıcı düzenlemeleri normalde üzerine yazılırdı. `key` özniteliği, eşitlemeler boyunca kullanıcı içeriğini koruyarak bu sorunu çözer:

```html title="index.php"
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>
```

Eşleşen anahtarlara sahip bloklar, şablon güncellendiğinde kullanıcı tarafından düzenlenmiş içeriklerini korur. Anahtarı olmayan bloklar tamamen değiştirilir.

#### Blok bağlamaları

Anahtarlara alternatif olarak, blokları doğrudan yazı meta verilerine bağlamak için WordPress çekirdeğinin [Blok Bağlamaları API](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-bindings/) özelliğini kullanabilirsiniz. Bu bir Blockstudio özelliği değil, yerel bir WordPress API özelliğidir. Blockstudio yalnızca `metadata` özniteliğini oluşturulan blok işaretlemesine aktarır. İçerik blok işaretlemesi yerine meta verilerde bulunur; böylece şablon eşitlemeleri kullanıcı düzenlemelerini asla silmez. Veriler ayrıca `WP_Query` üzerinden sorgulanabilir ve REST API aracılığıyla kullanılabilir.

```html title="index.php"
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
  Default Title
</h1>
```

Her iki yaklaşım da aynı şablonda kullanılabilir.

#### Düzenleme denetimleri

Sayfalar, kullanıcıların neleri değiştirebileceğini denetlemek için `blockEditingMode` ve `templateLock` destekler:

```json title="page.json"
{
  "name": "landing",
  "title": "Landing Page",
  "blockEditingMode": "contentOnly",
  "templateLock": "all"
}
```

Bu özellik, kullanıcıların metin ve medyayı düzenlemesine izin verirken sayfa yapısını kilitler. Şablondaki `blockEditingMode` özniteliğiyle tek tek öğelerde sayfa düzeyindeki ayar geçersiz kılınabilir.

#### Yazı kimliklerine sabitleme

Bir sayfa şablonunu mevcut bir WordPress yazısına bağlamak, yinelenen sayfaları önlemek ve şablonun her zaman doğru yazıyı güncellemesini sağlamak için `postId` kullanın:

```json title="page.json"
{
  "name": "home",
  "title": "Home",
  "postId": 2
}
```

Ayrıntıların tamamı için [Sayfalar belgelerine](https://blockstudio.dev/tr/docs/pages-and-patterns/pages/) bakın.

### Dosya tabanlı desenler

Sayfalara benzer şekilde artık blok desenlerini dosya şablonları olarak tanımlayabilirsiniz. Deseninizi HTML içinde yazın; Blockstudio bunu blok işaretlemesine dönüştürüp yerel bir WordPress blok deseni olarak kaydeder. Desenler blok ekleyicide görünür ve kullanıcılar tarafından istedikleri yere yerleştirilebilir.

```json title="pattern.json"
{
  "name": "hero-section",
  "title": "Hero Section",
  "categories": ["featured"],
  "keywords": ["hero", "banner"]
}
```

```html title="index.php"
<div class="hero">
  <h1>Welcome</h1>
  <p>Get started today.</p>
</div>
```

Sayfalardan farklı olarak desenler veritabanı girdisi oluşturmaz. Her sayfa yüklemesinde belleğe kaydedilirler. [Desenler belgelerine](https://blockstudio.dev/tr/docs/pages-and-patterns/patterns/) bakın.

### HTML-blok ayrıştırıcısı

Hem sayfalar hem de desenler, standart HTML şablonlarını WordPress blok işaretlemesine dönüştüren yeni bir HTML ayrıştırıcısıyla çalışır. Bu ayrıştırıcı kapsayıcı blokları (gruplar ve sütunlar gibi) ve yaprak blokları (paragraflar ve başlıklar gibi) otomatik olarak işler. Ayrıştırıcı, trait tabanlı bir oluşturucu mimarisi kullanır; böylece `blockstudio/parser/renderers` filtresi aracılığıyla ek blok türleri için destek eklemek kolaylaşır:

```php title="functions.php"
add_filter( 'blockstudio/parser/renderers', function ( $renderers, $parser ) {
    $renderers['acme/hero'] = function ( $element, $attrs, $parser ) {
        $content = $parser->get_inner_html( $element );
        $html    = '<div class="acme-hero">' . $content . '</div>';

        return array(
            'blockName'    => 'acme/hero',
            'attrs'        => $attrs,
            'innerBlocks'  => array(),
            'innerHTML'    => $html,
            'innerContent' => array( $html ),
        );
    };

    return $renderers;
}, 10, 2 );
```

Kaydedildikten sonra bloğu herhangi bir sayfa veya desen şablonunda kullanabilirsiniz:

```html title="index.php"
<block name="acme/hero" background="/hero.jpg">
  <h1>Welcome to our site</h1>
</block>
```

### Depolama

Alanlar artık blok özniteliklerine ek olarak değerlerini yazı meta verilerinde veya site seçeneklerinde saklayabiliyor. Bu önemli bir yenilik:

```json title="block.json"
{
  "id": "subtitle",
  "type": "text",
  "label": "Subtitle",
  "storage": {
    "type": "postMeta"
  }
}
```

Yazı meta verilerindeki değerlerle şunları yapabilirsiniz:

- `WP_Query` ve `meta_query` kullanarak yazıları alan değerlerine göre sorgulama
- Başsız kurulumlar için alan verilerine REST API üzerinden erişme
- SEO araçları ve önbellekleme katmanları gibi diğer eklentilerle veri paylaşma

Genel, site genelindeki ayarlar için değerleri seçenekler tablosunda da saklayabilirsiniz:

```json title="block.json"
{
  "id": "phone",
  "type": "text",
  "label": "Phone Number",
  "storage": {
    "type": "option",
    "optionKey": "company_phone"
  }
}
```

Ayrıntıların tamamı için [Depolama belgelerine](https://blockstudio.dev/tr/docs/blocks/storage/) bakın: API.

### Özel alanlar

Yeniden kullanılabilir alan tanımları artık birden fazla blok arasında paylaşılabilir. Bir alan kümesini bir kez tanımlayın, ardından herhangi bir blokta kullanın. Böylece birden fazla blok aynı alan yapısını paylaştığında tekrarların önüne geçilir.

blockstudio dizininizde bir `field.json` oluşturun:

```json title="fields/hero/field.json"
{
  "name": "hero",
  "title": "Hero Section",
  "attributes": [
    { "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
    { "id": "description", "type": "textarea", "label": "Description" }
  ]
}
```

Ardından `custom/` önekini kullanarak bunu herhangi bir blokta kullanın:

```json title="block.json"
{
  "blockstudio": {
    "attributes": [
      { "type": "custom/hero", "idStructure": "hero_{id}" }
    ]
  }
}
```

`idStructure` özelliği her alan kimliğinin başına eklenir; böylece `heading`, `hero_heading` haline gelir. Ayrıca `overrides` anahtarıyla tek tek alan özelliklerini örnek bazında geçersiz kılabilirsiniz.

Ayrıntılar için [Özel Alanlar belgelerine](https://blockstudio.dev/tr/docs/blocks/attributes/custom-fields/) bakın.

### Tailwind CSS v4

Tailwind desteği v4 için baştan sona yeniden oluşturuldu. CDN aracılığıyla istemci tarafında derleyip yazı kaydedildiğinde diske kaydetmek (v6 yaklaşımı) yerine Blockstudio 7, her ön yüz isteğinde Tailwind'i [TailwindPHP](https://github.com/dnnsjsk/tailwindphp) aracılığıyla sunucu tarafında derliyor. Node.js yok, CLI yok, derleme adımı gerekmiyor.

Derleme, aday tabanlı önbellekleme kullanır: Blockstudio son HTML içindeki tüm CSS sınıf adlarını çıkarır, bunları CSS yapılandırmanızla birlikte sıralayıp özetler ve önbellekte bir dosya olup olmadığını denetler. Çevresindeki HTML değişse bile (nonce'lar, zaman damgaları, dinamik içerik), aynı sınıflar önbellekte aynı sonucu verir.

Yapılandırmada Tailwind v4'ın CSS öncelikli sözdizimi kullanılır. Özel temaları ve yardımcı sınıfları doğrudan `blockstudio.json` içinde veya `blockstudio/tailwind/css` filtresi aracılığıyla tanımlayın:

```php title="functions.php"
add_filter('blockstudio/tailwind/css', function ($css) {
  return $css . '
    @theme {
      --color-brand: #4f46e5;
    }

    @layer utilities {
      .container-narrow {
        max-width: 48rem;
        margin-inline: auto;
      }
    }
  ';
});
```

Blok düzenleyicide, birlikte sunulan Tailwind CDN betiği siz yazarken canlı önizleme sağlar. `classes` alan türü, tüm Tailwind yardımcı sınıfları için otomatik tamamlama sunar. Ön yüz, satır içi stil etiketi olarak `</head>` öncesine eklenen, sunucuda derlenmiş CSS dosyasını kullanır.

Kurulumun tamamı için [Tailwind belgelerine](https://blockstudio.dev/tr/docs/tailwind/) bakın.

### Etkileşim API

Blockstudio artık [WordPress Etkileşim API](https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/) özelliğini destekliyor.
block.json içinde etkinleştirin:

```json title="block.json"
{
  "blockstudio": {
    "interactivity": true
  }
}
```

Şablonunuza `data-wp-*` yönergelerini ekleyin:

```php title="index.php"
<div useBlockProps
     data-wp-interactive="myBlock"
     data-wp-context='{ "isOpen": false }'>
  <button data-wp-on--click="actions.toggle"
          data-wp-bind--aria-expanded="context.isOpen">
    Toggle
  </button>
  <div data-wp-bind--hidden="!context.isOpen">
    This content is toggled by the button.
  </div>
</div>
```

Ardından mağaza mantığınızı içeren bir `script.js` oluşturun:

```javascript title="script.js"
import { store, getContext } from '@wordpress/interactivity';

store('myBlock', {
  actions: {
    toggle: () => {
      const context = getContext();
      context.isOpen = !context.isOpen;
    },
  },
});
```

Blockstudio, hem ön yüzde hem de blok düzenleyicide importmap'i, modül yüklemeyi ve yönerge işlemeyi yönetir. Yalnızca `data-wp-context` kullanan bildirimsel yönergelere sahip bloklar (`data-wp-bind--hidden` veya `data-wp-text` gibi), herhangi bir JavaScript olmadan çalışır. `wp_interactivity_state()` aracılığıyla sunucu tarafı durum desteği de ön yüzde kullanılabilir.

Kurulumun tamamı için [Etkileşim belgelerine](https://blockstudio.dev/tr/docs/blocks/interactivity/) bakın.

### SEO içerik analizi

Blockstudio blokları dinamiktir; bu nedenle alan içerikleri varsayılan olarak SEO eklentilerine görünmez. Blockstudio 7, Yoast SEO, Rank Math ve SEOPress için otomatik entegrasyonlarla bu sorunu çözüyor. `text`, `textarea`, `richtext`, `wysiwyg` ve `link` alanlarındaki metin değerleri (iç içe yineleyici satırları dahil) çıkarılıp her eklentinin içerik analizine aktarılır. SEO eklentileri artık blok içeriğinizi anahtar kelime yoğunluğu, okunabilirlik ve diğer ölçütler açısından doğru biçimde analiz edebilir. Yapılandırma gerekmez.

### Yineleyici varsayılan satırları

Yineleyici alanları artık önceden doldurulmuş satırlardan oluşan bir dizi içeren `default` özelliğini destekliyor. Bir blok eklendiğinde yineleyici, hem düzenleyicide hem de ön yüzde belirtilen satırlarla ve değerleriyle doldurulur:

```json title="block.json"
{
  "id": "features",
  "type": "repeater",
  "label": "Features",
  "default": [
    { "title": "Fast", "icon": "bolt" },
    { "title": "Secure", "icon": "shield" }
  ],
  "attributes": [
    { "id": "title", "type": "text", "label": "Title" },
    { "id": "icon", "type": "text", "label": "Icon" }
  ]
}
```

`min` özelliği alan düzeyindeki varsayılanlarla da çalışır: bir yineleyicide `min: 3` ve iç alanlarında `default` değerleri varsa, otomatik oluşturulan satırlar boş olmak yerine bu varsayılanlarla doldurulur.

## İyileştirmeler ve düzeltmeler

- **Alan varsayılanlarıyla yineleyici `min`**: otomatik oluşturulan minimum satırlar artık hem ön yüzde hem de düzenleyicide alan düzeyindeki varsayılan değerleri kullanıyor
- **Tailwind düzenleyici stilleri**: derlenmiş Tailwind CSS artık CDN ile birlikte blok düzenleyici iframe'ine ekleniyor; böylece özel `@apply` kuralları ve tema yapılandırması düzenleyicide çalışıyor
- **[Yapay zekâ bağlam dosyası](https://blockstudio.dev/tr/docs/dev/ai/)**: `blockstudio-llm.txt`, v6 üzerinden dinamik oluşturma yerine tüm v7 belgelerinden ve yinelenenlerden arındırılmış JSON şemalarından (~48k belirteç) derlenen statik bir dosya olarak yeniden oluşturuldu
- **Kod alanı ayrı penceresi**: kod alanı artık bağımsız geri al/yinele ve JavaScript sözdizimi vurgulamayla ayrı bir pencerede açılabiliyor
- **Tailwind v4 sunucu tarafı derlemesi**: yukarıdaki [Tailwind bölümüne](#tailwind-css-v4) bakın
- **API 3. sürüm**: bloklar artık site düzenleyicisi ve duyarlı önizlemeler dahil iframe kullanılan düzenleyicide doğru görüntüleniyor
- **Varlıklarda nokta gösterimi**: varlık son ekleri için daha temiz dosya adlandırma düzeni (`*.inline.css`, `*.editor.js`, `*.scoped.css`)
- `useBlockProps` kullanılırken `WP_Block_Supports` kaynaklı `bs_render_block()` uyarısı düzeltildi
- Koşullu alanların ilk yüklemede varsayılan değerleri dikkate almaması düzeltildi
- Ön yüzdeki `<RichText />` içeriğinden dolar işaretlerinin silinmesi düzeltildi
- `populate` özelliğinin diğer eklentiler tarafından kaydedilen taksonomilerle çalışması sağlandı
- WPML bağlamlarındaki `optionsPopulate` null hatası düzeltildi

## Kaputun altında

### Baştan sona yeniden yazım

Bu bir yeniden düzenleme veya temizlik değil. Her sınıf sıfırdan yeniden yazıldı. Sonuç, bakımı ve genişletilmesi daha kolay, daha temiz ve modüler bir kod tabanı.

### Modern PHP

Blockstudio 7, PHP 8.2+ gerektiriyor ve genelinde modern tür bildirimleri kullanıyor.

## Uyumluluğu bozan değişiklikler

Ana sürüm güncellemesi olarak 7.0, uyumluluğu bozan birkaç değişiklik içeriyor. Çoğunda geriye dönük uyumlu çözümler bulunsa da yükseltmeden önce bunları gözden geçirmelisiniz. Geçiş kılavuzunun tamamı için [v7 geçiş belgelerine](https://blockstudio.dev/tr/docs/dev/migration/v7/) bakın.

### Kanca adları artık snake_case kullanıyor

Tüm PHP kancalarının adları camelCase'ten snake_case'e değiştirildi; böylece WordPress çekirdek kurallarıyla uyum sağlandı:

```php title="functions.php"
// Before (v6)
add_filter('blockstudio/settings/blockEditor/cssClasses', function() {
    return ['my-stylesheet'];
});

// After (v7)
add_filter('blockstudio/settings/block_editor/css_classes', function() {
    return ['my-stylesheet'];
});
```

Eski camelCase adları çalışmaya devam ediyor, ancak güncellemenizi öneriyoruz.

### Alan anahtarı varsayılan olarak kapalı

`switch` özelliği artık `true` yerine varsayılan olarak `false` değerini alıyor. v6 sürümünde her alanın sol kenarında varsayılan olarak etkinleştirilmiş görünmez bir anahtar vardı. v7 sürümünde anahtar isteğe bağlıdır ve alan etiketinde görünür bir göz simgesi kullanır. Varsayılan anahtar davranışına bağlıysanız alan tanımlarınıza `"switch": true` ekleyin.

### Varlık dosyası adlarında nokta gösterimi

Varlık son eklerinde artık tire yerine nokta kullanılıyor (`style.inline.css` yerine `style-inline.css`). Eski tire gösterimi çalışmaya devam ediyor, ancak bundan sonra nokta gösterimi önerilen düzen.

### npm içe aktarma öneki

ES modülü içe aktarımlarında artık `blockstudio/` yerine `npm:` kullanılıyor:

```javascript title="script.js"
// Before (v6)
import confetti from "blockstudio/canvas-confetti@1.6.0";

// After (v7)
import confetti from "npm:canvas-confetti@1.6.0";
```

`blockstudio/` öneki geriye dönük uyumluluk için desteklenmeye devam ediyor.

### Kaldırılan özellikler

**Yönetim alanı ve kod düzenleyici.** WordPress yönetici ayarları sayfası ve yerleşik blok kod düzenleyicisi kaldırıldı. Artık tüm yapılandırma `blockstudio.json` ve PHP filtreleri üzerinden yapılıyor; böylece kurulumunuz bloklarınızla birlikte sürüm denetiminde tutuluyor.

Kod düzenleyici önceki sürümlerde blokları önizlemek için kullanışlıydı, ancak gerçek bir geliştirme ortamının tüm özelliklerini hiçbir zaman sunamadı. Eklenti özelliklerinin bazıları, bağımsız düzenleyicide desteklenemedikleri için yıllarca geliştirilmedi. Ayrıca tam teşekküllü bir IDE'nin yerini alması da mümkün değildi. Kaldırılması, eklentinin taviz vermeden tamamen dosya tabanlı geliştirmeye odaklanmasını sağlıyor.

**Lisans anahtarı.** Artık gerekmiyor. Blockstudio ücretsiz ve açık kaynak.

**Blok kütüphanesi.** Yerleşik "Blockstudio Elements" kütüphanesi (Galeri, Kaydırıcı, Görüntü Karşılaştırma, Kod, Simge) kaldırıldı. Bunlar, eklentiyle birlikte gelen önceden oluşturulmuş örnek bloklardı. Bunları kullanıyorsanız blok klasörlerini v6 dizininden temanızın blockstudio dizinine kopyalayın.

## Başlangıç

Blockstudio 7'yi yükleyin ve ilk bloğunuzu dakikalar içinde oluşturun. Adım adım anlatım için
[Başlangıç kılavuzuna](https://blockstudio.dev/tr/docs/general/getting-started/) göz atın,
ya da [v7 geçiş kılavuzuna](https://blockstudio.dev/tr/docs/dev/migration/v7/) göz atın; v6 kullanıyorsanız.

Kaynak kodunun tamamı [GitHub](https://github.com/inline0/blockstudio) üzerinde. Sorun bildirimleri, PR'lar ve geri bildirimler memnuniyetle karşılanır.
