Blade
Blade은 주로 Laravel 프레임워크에서 사용하는 템플릿 엔진입니다. 개발자는 PHP을 간단하고 직관적으로 확장하는 구문을 사용해 표현력 있고 깔끔한 템플릿을 만들 수 있습니다. Blade 템플릿은 데이터 표시와 레이아웃 관리 같은 일반적인 작업을 지원해 동적 웹 페이지 개발을 간소화합니다.
설정
Blockstudio에서 Blade 템플릿을 사용하려면 Composer로 Laravel의 illuminate/view 패키지를 설치하세요. 버전 8~12에서 작동합니다.
composer require illuminate/view
다음으로 테마의 functions.php 파일에 필터를 추가해 Blockstudio에 Blade 템플릿을 렌더링하는 방법을 알려주세요. Blockstudio은 모든 Blade 템플릿을 자동으로 수집하고 경로를 매핑하므로, Blade의 점 표기법으로 include와 레이아웃을 사용할 수 있습니다. 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>