Blade
Blade è un motore di template usato principalmente con il framework Laravel. Consente agli sviluppatori di creare template espressivi e puliti usando una sintassi che estende PHP in modo semplice e intuitivo. I template Blade agevolano attività comuni come la visualizzazione dei dati e la gestione dei layout, semplificando lo sviluppo di pagine web dinamiche.
Configurazione
Per usare i template Blade con Blockstudio, installate il pacchetto illuminate/view di Laravel con Composer. Sono supportate le versioni dalla 8 alla 12.
composer require illuminate/view
Poi aggiungete un filtro al file functions.php del tema per indicare a Blockstudio come renderizzare i template Blade. Blockstudio raccoglie automaticamente tutti i template Blade e ne associa i percorsi, consentendovi di usare la sintassi con punto di Blade per include e layout. Blockstudio\Blade_Renderer assembla la factory delle viste a partire da illuminate/view e memorizza nella cache le viste compilate nella directory temporanea di sistema.
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
);
Il wrapper jenssegers/blade usato nelle versioni precedenti di questa pagina non funziona con illuminate/view 10 e versioni successive (“Target class [blade.compiler] does not exist”). Se è installato, Blade_Renderer usa invece il pacchetto illuminate/view incluso al suo interno.
Variabili dei template
I vostri template Blade avranno accesso alle seguenti variabili:
| Variabile | Descrizione |
|---|---|
$a |
Alias di $attributes |
$attributes |
Gli attributi del blocco |
$b |
Alias di $block |
$block |
Dati relativi al blocco stesso |
$c |
Alias di $context |
$context |
Il contesto del blocco (e.g., ID dell’articolo, tipo di articolo quando si è all’interno di un loop) |
Utilizzo
Per usare Blade nel template del vostro blocco, create un file index.blade.php nella directory del blocco. Blockstudio userà quindi automaticamente questo file per renderizzare il blocco.
<div class="my-block">
@if($a['title'])
<h2>{{ $a['title'] }}</h2>
@endif
@if($a['content'])
<p>{{ $a['content'] }}</p>
@endif
</div>