Zum Inhalt springen

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.

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

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

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.

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

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