Przejdź do treści

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.

Powłoka
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.

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

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.

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

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