Blade
Blade é um mecanismo de templates usado principalmente com o framework Laravel. Ele permite que desenvolvedores criem templates expressivos e limpos usando uma sintaxe que estende PHP de forma simples e intuitiva. Os templates Blade facilitam tarefas comuns, como exibir dados e gerenciar layouts, ajudando a simplificar o desenvolvimento de páginas Web dinâmicas.
Configuração
Para usar templates Blade com Blockstudio, instale o pacote illuminate/view de Laravel com Composer. As versões de 8 a 12 funcionam.
composer require illuminate/view
Em seguida, adicione um filtro ao arquivo functions.php do seu tema para indicar a Blockstudio como renderizar templates Blade. Blockstudio coleta automaticamente todos os templates Blade e mapeia seus caminhos, permitindo usar a sintaxe de ponto de Blade para includes e layouts. Blockstudio\Blade_Renderer monta a fábrica de views a partir de illuminate/view e armazena em cache as views compiladas no diretório temporário do 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
);
O wrapper jenssegers/blade usado em versões anteriores desta página falha com illuminate/view 10 e posteriores (“Target class [blade.compiler] does not exist”). Se estiver instalado, Blade_Renderer usará o pacote illuminate/view que ele trouxe consigo.
Variáveis de template
Seus templates Blade terão acesso às seguintes variáveis:
| Variável | Descrição |
|---|---|
$a |
Um alias para $attributes |
$attributes |
Os atributos do bloco |
$b |
Um alias para $block |
$block |
Dados relacionados ao próprio bloco |
$c |
Um alias para $context |
$context |
O contexto do bloco (e.g., ID do post, tipo de post quando estiver em um loop) |
Uso
Para usar Blade no template do seu bloco, crie um arquivo index.blade.php no diretório do bloco. Blockstudio usará esse arquivo automaticamente para renderizar o bloco.
<div class="my-block">
@if($a['title'])
<h2>{{ $a['title'] }}</h2>
@endif
@if($a['content'])
<p>{{ $a['content'] }}</p>
@endif
</div>