Blade
Blade to silnik szablonów używany głównie z frameworkiem Laravel. Umożliwia programistom tworzenie przejrzystych, czytelnych szablonów za pomocą składni, która w prosty i intuicyjny sposób rozszerza PHP. Szablony Blade ułatwiają typowe zadania, takie jak wyświetlanie danych i zarządzanie układem, usprawniając tworzenie dynamicznych stron internetowych.
Konfiguracja
Aby używać szablonów Blade z Blockstudio, zainstaluj pakiet illuminate/view firmy Laravel za pomocą Composer. Działają wersje od 8 do 12.
composer require illuminate/view
Następnie dodaj filtr do pliku functions.php motywu, aby wskazać Blockstudio, jak renderować szablony Blade. Blockstudio automatycznie zbiera wszystkie szablony Blade i mapuje ich ścieżki, dzięki czemu możesz używać składni kropkowej Blade w dyrektywach include i układach. Blockstudio\Blade_Renderer tworzy fabrykę widoków na podstawie illuminate/view i buforuje skompilowane widoki w tymczasowym katalogu systemowym.
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
);
Warstwa pośrednia jenssegers/blade używana we wcześniejszych wersjach tej strony nie działa z illuminate/view 10 i nowszymi wersjami (“Target class [blade.compiler] does not exist”). Jeśli jest zainstalowana, Blade_Renderer używa zamiast niej pakietu illuminate/view, który został dołączony.
Zmienne szablonów
Szablony Blade będą miały dostęp do następujących zmiennych:
| Zmienna | Opis |
|---|---|
$a |
Alias dla $attributes |
$attributes |
Atrybuty bloku |
$b |
Alias dla $block |
$block |
Dane powiązane z samym blokiem |
$c |
Alias dla $context |
$context |
Kontekst bloku (np. e.g, ID wpisu, typ wpisu w pętli) |
Użycie
Aby użyć Blade jako szablonu bloku, utwórz plik index.blade.php w katalogu bloku. Blockstudio będzie wtedy automatycznie używać tego pliku do renderowania bloku.
<div class="my-block">
@if($a['title'])
<h2>{{ $a['title'] }}</h2>
@endif
@if($a['content'])
<p>{{ $a['content'] }}</p>
@endif
</div>