Pular para o conteúdo

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.

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

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

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.

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

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