Blade
Blade ist eine Template-Engine, die hauptsächlich mit dem Laravel-Framework verwendet wird. Sie ermöglicht Entwicklern, ausdrucksstarke und übersichtliche Vorlagen mit einer Syntax zu erstellen, die PHP auf einfache und intuitive Weise erweitert. Blade-Vorlagen erleichtern gängige Aufgaben wie die Datendarstellung und Layoutverwaltung und vereinfachen so die Entwicklung dynamischer Webseiten.
Einrichtung
Um Blade-Vorlagen mit Blockstudio zu verwenden, installiere das Paket illuminate/view von Laravel mit Composer. Die Versionen 8 bis 12 funktionieren.
composer require illuminate/view
Füge anschließend deiner Theme-Datei functions.php einen Filter hinzu, der Blockstudio mitteilt, wie Blade-Vorlagen gerendert werden sollen. Blockstudio erfasst automatisch alle Blade-Vorlagen und ordnet ihre Pfade zu. So kannst du Blades Punktsyntax für Includes und Layouts verwenden. Blockstudio\Blade_Renderer erstellt die View Factory aus illuminate/view und speichert kompilierte Views im temporären Systemverzeichnis zwischen.
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
);
Der Wrapper jenssegers/blade, den frühere Versionen dieser Seite verwendeten, funktioniert mit illuminate/view 10 und höher nicht mehr („Target class [blade.compiler] does not exist“). Wenn er installiert ist, verwendet Blade_Renderer stattdessen das Paket illuminate/view, das es mitgebracht hat.
Template-Variablen
Deine Blade-Vorlagen haben Zugriff auf die folgenden Variablen:
| Variable | Beschreibung |
|---|---|
$a |
Ein Alias für $attributes |
$attributes |
Die Attribute des Blocks |
$b |
Ein Alias für $block |
$block |
Daten zum Block selbst |
$c |
Ein Alias für $context |
$context |
Der Kontext des Blocks (e.g, Beitrags-ID, Beitragstyp innerhalb einer Schleife) |
Verwendung
Um Blade für das Template deines Blocks zu verwenden, erstelle eine index.blade.php-Datei im Verzeichnis deines Blocks. Blockstudio verwendet diese Datei dann automatisch, um den Block darzustellen.
<div class="my-block">
@if($a['title'])
<h2>{{ $a['title'] }}</h2>
@endif
@if($a['content'])
<p>{{ $a['content'] }}</p>
@endif
</div>