Vai al contenuto

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.

Shell
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.

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
);

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.

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

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