Saltar al contenido

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.

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

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

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.

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

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