Başlarken
Bu kılavuz, Blockstudio kurulumunu yapmanıza ve ilk özel bloğunuzu oluşturmanıza yardımcı olur.
Kurulum
Composer aracılığıyla (Önerilen)
composer require blockstudio/blockstudio
Blockstudio, composer/installers aracılığıyla eklenti olarak kurulabilir veya doğrudan bir temanın içine dahil edilebilir. Tüm kurulum yöntemleri için Composer belgelerine bakın.
Composer kurulumları güncellemeleri Composer üzerinden alır. Yerleşik GitHub güncelleyicisi otomatik olarak devre dışı bırakılır.
Elle Kurulum
En son sürümü GitHub adresinden indirin
Zip dosyasını WordPress eklenti dizininize yükleyin ve eklentiyi etkinleştirin. Elle yapılan kurulumlar, yerleşik GitHub güncelleyicisi aracılığıyla WordPress panosunda otomatik güncelleme bildirimleri alır.
Her iki kurulum yöntemi de Markdown, YAML ve güncelleyici kütüphanelerinin özel kopyalarını ve bunların bağımlılıklarını paketler. Başka bir eklenti veya tema tarafından sağlanan sürümleri kullanmaz ya da değiştirmez. Uygulamanız bu kütüphanelerden birini doğrudan kullanıyorsa kendi Composer bağımlılığınızı kurun; Blockstudio tarafından paketlenen kopyalar dahili kullanıma yöneliktir, herkese açık bir PHP API değildir.
Kimliği Doğrulanmış Güncelleme Denetimleri
Elle yapılan kurulumlarda GitHub denetimleri varsayılan olarak anonim yapılır. Aynı dış IP ağ geçidini paylaşan birkaç site, GitHub anonim API kotasını tüketebilir ve güncellemeleri denetlerken HTTP 403 yanıtları alabilir. 7.7.4 üzerinden, wp-config.php içinde kişisel bir erişim belirteci yapılandırın; bunu WordPress yüklenmeden önce GitHub içine ekleyin:
define('BLOCKSTUDIO_GITHUB_TOKEN', 'your-github-token');
Belirtecin yalnızca herkese açık depo bilgilerine erişmesi yeterlidir. Yazma izinleri vermeyin. Belirteci sunucu tarafındaki yapılandırmada tutun; sürüm denetiminden, blockstudio.json, blok özniteliklerinden ve ön yüz kodundan uzak tutun. Güncelleyici, kimliği doğrulanmış denetimler ve sürüm indirmeleri için belirteci paketlenmiş GitHub istemcisine iletir. İlgisiz depolara ve diğer indirme sunucularına yapılan isteklerde belirteç kullanılmaz.
Ortam tarafından yönetilen gizli bilgiler için bir MU eklentisi belirteci sağlayabilir veya geçersiz kılabilir:
<?php
add_filter('blockstudio/updater/token', function ($token) {
return getenv('BLOCKSTUDIO_GITHUB_TOKEN') ?: $token;
});
Filtre, Blockstudio güncelleyicisini başlatırken tema yüklenmeden önce çalışır. functions.php yerine bir MU eklentisine kaydedin. Boş bir dize döndürmek, sabit tanımlanmış olsa bile kimlik doğrulamayı devre dışı bırakır. Boş veya dize olmayan değerler denetimleri anonim bırakır. Belirteçler isteğe bağlıdır; belirteç olmadan mevcut güncelleme davranışı değişmez. Composer kurulumları güncellemeler için yine Composer kullanır ve bu güncelleyiciyi başlatmaz.
İlk Bloğunuzu Oluşturma
1. Bir Blok Dizini Oluşturun
Temanızda yeni bir dizin oluşturun:
my-theme/
blockstudio/
my-first-block/
block.json
index.php
2. Blok Şemasını Tanımlayın
Blok yapılandırmanızı içeren block.json dosyasını oluşturun:
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "my-theme/my-first-block",
"title": "My First Block",
"category": "common",
"icon": "star-filled",
"blockstudio": {
"attributes": [
{
"id": "heading",
"type": "text",
"label": "Heading",
"default": "Hello World"
},
{
"id": "content",
"type": "textarea",
"label": "Content"
}
]
}
}
3. Şablonu Oluşturun
Görüntüleme için index.php dosyasını oluşturun:
<div class="my-first-block">
<h2><?php echo $a['heading']; ?></h2>
<p><?php echo $a['content']; ?></p>
</div>
Twig Şablonlarını Kullanma
Blockstudio, Twig şablonlarını kutudan çıktığı gibi destekler. Bunun yerine index.twig kullanmanız yeterlidir:
<div class="my-first-block">
<h2>{{ a.heading }}</h2>
<p>{{ a.content }}</p>
</div>
Stilleri Ekleme
Aynı klasörde bir style.css dosyası oluşturun:
.my-first-block {
padding: 2rem;
background: #f5f5f5;
}
Blok kullanıldığında Blockstudio bu stil sayfasını otomatik olarak kuyruğa ekler.
Çeviriler
Blockstudio düzenleyici denetimleri ve yönetici genel bakışı, WordPress aracılığıyla blockstudio metin alanı için JavaScript çevirilerini yükler. Uygun bir dil paketi kurun veya çeviri aracınızla wp-content/languages/plugins/ içinde betik çevirisi JSON dosyaları oluşturun. Kullanılabilir çevirisi olmayan dizeler İngilizce kalır. Bu işlem Blockstudio arayüzünü çevirir; bloklarınızda tanımladığınız içeriği veya alan etiketlerini çevirmez.
Sonraki Adımlar
Bloğunuz artık WordPress düzenleyicisinde kullanıma hazır. Şunlar hakkında bilgi edinmek için belgeleri incelemeye devam edin:
- Alan Türleri – Kullanılabilir tüm alan türleri
- Bileşenler – InnerBlocks, RichText ve daha fazlası
- Tailwind Entegrasyonu – Tailwind CSS kullanımı
- Kancalar – Filtreler ve eylemlerle işlevselliği genişletme
Tek bir bloktan tam kapsamlı bir kitaplığa geçin: tasarım belirteçleri, bölüm kalıbı, tekrarlayıcılar, görseller ve sayfa kompozisyonu.