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.
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.
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.
<div class="my-block">
@if($a['title'])
<h2>{{ $a['title'] }}</h2>
@endif
@if($a['content'])
<p>{{ $a['content'] }}</p>
@endif
</div>