İçeriğe geç

Blade

Blade, öncelikle Laravel çatısıyla kullanılan bir şablon motorudur. Geliştiricilerin, PHP’yi basit ve sezgisel bir şekilde genişleten bir söz dizimiyle ifade gücü yüksek, temiz şablonlar oluşturmasını sağlar. Blade şablonları, veri görüntüleme ve düzen yönetimi gibi yaygın görevleri kolaylaştırarak dinamik web sayfalarının geliştirilmesini hızlandırır.

Kurulum

Blockstudio ile Blade şablonlarını kullanmak için Composer ile Laravel’nin illuminate/view paketini yükleyin. 8 ile 12 arasındaki sürümler çalışır.

Kabuk
composer require illuminate/view

Ardından, Blockstudio’e Blade şablonlarını nasıl işleyeceğini bildirmek için temanızın functions.php dosyasına bir filtre ekleyin. Blockstudio tüm Blade şablonlarını otomatik olarak toplar ve yollarını eşler; böylece include ve layout işlemlerinde Blade’ın nokta söz dizimini kullanabilirsiniz. Blockstudio\Blade_Renderer, görünüm fabrikasını illuminate/view üzerinden oluşturur ve derlenmiş görünümleri sistemin geçici dizininde önbelleğe alır.

PHP
add_filter(
    "blockstudio/blocks/render",
    function ($value, $block) {
        $blockPath = $block->path;
        if (str_ends_with($blockPath, ".blade.php")) {
            if (!Blockstudio\Blade_Renderer::available()) {
                return 'Error: Blade is not installed. Please run "composer require illuminate/view".';
            }
            $data = $block->blockstudio["data"];
            $bladeData = $data["blade"];

            return Blockstudio\Blade_Renderer::render(
                $bladeData["path"],
                $bladeData["templates"][$block->name],
                [
                    "a" => $data["attributes"],
                    "attributes" => $data["attributes"],
                    "b" => $data["block"],
                    "block" => $data["block"],
                    "c" => $data["context"],
                    "context" => $data["context"],
                ]
            );
        }

        return $value;
    },
    10,
    2
);

Bu sayfanın önceki sürümlerinde kullanılan jenssegers/blade sarmalayıcısı, illuminate/view 10 ve sonraki sürümlerde çalışmaz (“Target class [blade.compiler] does not exist”). Yüklüyse Blade_Renderer, onunla birlikte gelen illuminate/view paketini kullanır.

Şablon Değişkenleri

Blade şablonlarınız aşağıdaki değişkenlere erişebilir:

Değişken Açıklama
$a $attributes için bir takma ad
$attributes Bloğun öznitelikleri
$b $block için bir takma ad
$block Bloğun kendisiyle ilgili veriler
$c $context için bir takma ad
$context Bloğun bağlamı (döngü içindeyken e.g., yazı kimliği, yazı türü)

Kullanım

Blok şablonunuzda Blade kullanmak için bloğunuzun dizininde bir index.blade.php dosyası oluşturun. Blockstudio daha sonra bloğu işlerken bu dosyayı otomatik olarak kullanır.

PHP
<div class="my-block">
  @if($a['title'])
    <h2>{{ $a['title'] }}</h2>
  @endif

  @if($a['content'])
    <p>{{ $a['content'] }}</p>
  @endif
</div>