Blade
Blade — это механизм шаблонов, который в основном используется с фреймворком Laravel. Он позволяет разработчикам создавать выразительные и понятные шаблоны с помощью синтаксиса, который простым и интуитивно понятным образом расширяет PHP. Шаблоны Blade упрощают типовые задачи, такие как вывод данных и управление макетом, помогая оптимизировать разработку динамических веб-страниц.
Настройка
Чтобы использовать шаблоны Blade с Blockstudio, установите пакет illuminate/view от Laravel с помощью Composer. Подходят версии с 8 по 12.
composer require illuminate/view
Затем добавьте фильтр в файл functions.php вашей темы, чтобы указать Blockstudio, как отображать шаблоны Blade. Blockstudio автоматически собирает все шаблоны Blade и сопоставляет их пути, позволяя использовать точечный синтаксис Blade для подключений и макетов. Blockstudio\Blade_Renderer собирает фабрику представлений из illuminate/view и кэширует скомпилированные представления во временной системной директории.
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
);
Обертка jenssegers/blade, использовавшаяся в более ранних версиях этой страницы, не работает с illuminate/view 10 и более поздними версиями (“Target class [blade.compiler] does not exist”). Если она установлена, Blade_Renderer вместо нее использует пакет illuminate/view, который поставлялся вместе с ней.
Переменные шаблонов
В шаблонах Blade доступны следующие переменные:
| Переменная | Описание |
|---|---|
$a |
Псевдоним для $attributes |
$attributes |
Атрибуты блока |
$b |
Псевдоним для $block |
$block |
Данные, относящиеся к самому блоку |
$c |
Псевдоним для $context |
$context |
Контекст блока (e.g, ID записи, тип записи внутри цикла) |
Использование
Чтобы использовать Blade в шаблоне блока, создайте файл index.blade.php в каталоге блока. После этого Blockstudio будет автоматически использовать этот файл для отображения блока.
<div class="my-block">
@if($a['title'])
<h2>{{ $a['title'] }}</h2>
@endif
@if($a['content'])
<p>{{ $a['content'] }}</p>
@endif
</div>