본문으로 건너뛰기

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에서 뷰 팩토리를 구성하고 시스템 임시 디렉터리에 컴파일된 뷰를 캐시합니다.

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

이 페이지의 이전 버전에서 사용하던 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이 블록 렌더링에 이 파일을 자동으로 사용합니다.

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

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