İçeriğe geç

Başlarken

Bu kılavuz, Blockstudio kurulumunu yapmanıza ve ilk özel bloğunuzu oluşturmanıza yardımcı olur.

Kurulum

Kabuk
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:

PHP
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
<?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:

Kod
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:

JSON
{
  "$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:

PHP
<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:

Twig
<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:

CSS
.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:

Bir Blok Kitaplığı Oluşturma

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.