Twig
Twig은 PHP을 위한 유연하고 빠르며 안전한 템플릿 엔진입니다. 개발자는 템플릿에 간결하고 읽기 쉬운 코드를 작성해 생산성과 유지 관리성을 높일 수 있습니다. Twig은 강력하면서도 사용하기 쉬운 템플릿을 만드는 다양한 기능을 지원하므로, 견고하고 재사용 가능한 템플릿이 필요한 프로젝트에 적합합니다.
설정
Blockstudio에서 Twig 템플릿을 사용하려면 Composer로 Twig을 포함하는 timber/timber 패키지를 설치해야 합니다. Blockstudio은 Timber 설치 여부를 자동으로 감지하고 블록에서 Twig 템플릿을 사용할 수 있게 합니다.
셸
composer require timber/timber
Timber을 설치하면 Blockstudio이 블록 폴더에 있는 index.twig 파일의 렌더링을 자동으로 처리합니다.
템플릿 변수
모든 Twig 파일에서 Timber 컨텍스트를 사용할 수 있습니다. 여기에는 일반적인 WordPress 데이터와 함수, 그리고 Blockstudio 관련 변수가 포함됩니다.
| 변수 | 설명 |
|---|---|
a |
attributes의 별칭 |
attributes |
블록의 속성 |
b |
block의 별칭 |
block |
블록 자체와 관련된 데이터(postId, postType, context 등 포함) |
c |
context의 별칭 |
context |
블록의 컨텍스트(루프 내의 e.g, postId, postType) |
isEditor |
블록이 편집기에서 렌더링 중이면 true인 불리언 값 |
isPreview |
블록이 삽입 도구 미리보기에서 렌더링 중이면 true인 불리언 값 |
사용법
블록 템플릿에 Twig을 사용하려면 블록 디렉터리에 index.twig 파일을 만들기만 하면 됩니다. 그러면 Blockstudio이 블록 렌더링에 이 파일을 자동으로 사용합니다.
Twig
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>