Blade
Blade es un motor de plantillas que se usa principalmente con el framework Laravel. Permite a los desarrolladores crear plantillas expresivas y claras con una sintaxis que amplía PHP de forma sencilla e intuitiva. Las plantillas Blade facilitan tareas habituales como mostrar datos y gestionar diseños, lo que ayuda a agilizar el desarrollo de páginas web dinámicas.
Configuración
Para usar plantillas Blade con Blockstudio, instale el paquete illuminate/view de Laravel con Composer. Funcionan las versiones 8 a 12.
composer require illuminate/view
A continuación, añada un filtro al archivo functions.php de su tema para indicarle a Blockstudio cómo representar las plantillas Blade. Blockstudio recopila automáticamente todas las plantillas Blade y asigna sus rutas, lo que permite usar la sintaxis de puntos de Blade para las inclusiones y los diseños. Blockstudio\Blade_Renderer construye la fábrica de vistas a partir de illuminate/view y almacena en caché las vistas compiladas en el directorio temporal del 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
);
El adaptador jenssegers/blade que usaban las versiones anteriores de esta página falla con illuminate/view 10 y posteriores (“La clase de destino [blade.compiler] no existe”). Si está instalado, Blade_Renderer usa en su lugar el paquete illuminate/view que este incluye.
Variables de plantilla
Sus plantillas Blade tendrán acceso a las siguientes variables:
| Variable | Descripción |
|---|---|
$a |
Un alias de $attributes |
$attributes |
Los atributos del bloque |
$b |
Un alias de $block |
$block |
Datos relacionados con el bloque |
$c |
Un alias de $context |
$context |
El contexto del bloque (e.g, ID de entrada y tipo de entrada dentro de un bucle) |
Uso
Para usar Blade en la plantilla de su bloque, cree un archivo index.blade.php en el directorio del bloque. Blockstudio usará automáticamente este archivo para representar el bloque.
<div class="my-block">
@if($a['title'])
<h2>{{ $a['title'] }}</h2>
@endif
@if($a['content'])
<p>{{ $a['content'] }}</p>
@endif
</div>