# 템플릿 파일로 재사용 가능한 패턴 만들기

페이지와 동일한 HTML를 삽입기에 바로 추가하세요.

## 등록 코드 대신 템플릿 파일

`pattern.json` 로 폴더와 템플릿을 만드세요. Blockstudio가 `register_block_pattern()` 상용구 코드 없이 등록합니다.

패턴을 삽입하면 실제 편집 가능한 블록이 만들어집니다. 사용자는 이를 바탕으로 레이아웃을 맞춤 설정하고 소스는 버전 관리할 수 있습니다.

[패턴 구문](https://blockstudio.dev/ko/docs/pages-and-patterns/patterns/)

index.php

```
<div>
  <h2>Pricing</h2>
  <p>Simple, transparent pricing.</p>
  <block name="core/columns">
    <block name="core/column"><h3>Starter</h3></block>
    <block name="core/column"><h3>Pro</h3></block>
  </block>
</div>
```

## 페이지와 동일한 구문

표준 HTML은 코어 블록에 매핑되고, 블록 태그는 나머지를 처리합니다.

## 자동 등록

템플릿과 pattern.json를 추가하면 자동으로 표시됩니다.

## 완전히 편집 가능

사용자는 삽입한 각 패턴을 개별적으로 맞춤 설정할 수 있습니다.

## 분류 및 검색 가능

카테고리와 키워드로 패턴을 쉽게 찾을 수 있습니다.

## 모든 블록과 중첩 수준 지원

코어 블록, 사용자 지정 블록 또는 Blockstudio 블록을 원하는 깊이로 사용하세요.

## 게시물 유형 제한

패턴이 사용될 게시물 유형을 제한하세요.

## 블록 연결

패턴을 블록 유형과 연결해 추천 항목으로 표시하세요.

## 버전 관리

Git에서 패턴 파일을 추적하고 여러 환경에 배포하세요.

## pattern.json로 구성

`pattern.json` 에서 제목, 설명, 카테고리, 키워드, 뷰포트 너비, 게시물 유형, 블록 유형을 설정하세요. 같은 파일에서 삽입기 표시 여부도 제어할 수 있습니다.

카테고리로 패턴을 분류하고, 키워드로 검색할 수 있게 하며, 뷰포트 너비로 미리보기 크기를 제어합니다.

[패턴 구성](https://blockstudio.dev/ko/docs/pages-and-patterns/patterns/)

pattern.json

```
{
  "name": "pricing-table",
  "title": "Pricing Table",
  "description": "Two-column pricing layout",
  "categories": ["featured", "commerce"],
  "keywords": ["pricing", "plans", "table"],
  "viewportWidth": 1200,
  "blockTypes": ["core/group"],
  "postTypes": ["page", "landing"]
}
```

## Blade 및 Twig 소스

패턴, 페이지 또는 Site Editor 템플릿을 `index.php` 대신 `index.blade.php` 또는 `index.twig` 로 작성하세요. Blade는 `Blockstudio\Blade_Renderer` 를 통해 렌더링되며 `illuminate/view` 는 8~12이고, Twig에는 Timber가 필요합니다.

소스는 요청 컨텍스트 없이 컴파일되므로 동적 변수가 없습니다. 엔진에 내장된 함수와 필터에 사용하세요.

[템플릿 엔진](https://blockstudio.dev/ko/docs/pages-and-patterns/#template-engines)

patterns/pricing/index.blade.php

```
<div>
  <h2>{{ strtoupper('Pricing') }}</h2>
  <p>Simple, transparent pricing.</p>
</div>
```

## 편집자가 선택할 수 있는 사용자 지정 템플릿

슬러그가 템플릿 계층 구조에 속하지 않는 `template.json` 는 사용자 지정 템플릿이 됩니다. `postTypes` 에 게시물 유형을 나열하면 편집자가 템플릿 선택기에서 해당 템플릿을 고를 수 있습니다.

`Blockstudio\Site_Templates` 는 PHP의 소스를 읽고 컴파일하므로, 테스트와 배포 검사는 컴파일된 마크업을 검사하고 요청된 항목에 `selection_errors()` 를 호출할 수 있습니다.

[Site Editor 템플릿 안내](https://blockstudio.dev/ko/guides/site-editor-templates/)

templates/page-landing/template.json

```
{
  "slug": "page-landing",
  "title": "Landing Page",
  "description": "Full-width page without a header",
  "postTypes": ["page"]
}
```

## 사용자 지정 검색 경로

필터를 사용하면 예를 들어 플러그인에서 페이지, 패턴, Site Editor 템플릿의 루트를 추가할 수 있습니다.

## 논리적 검색 소스

미리보기, 오버레이, 생성된 테마는 하나의 테마 폴더 대신 구성된 파일 목록을 Blockstudio에 전달할 수 있습니다.

## 수명 주기 후크

패턴 등록 후, 그리고 페이지 게시물이 생성, 업데이트, 동기화 또는 조정된 후에 액션이 실행됩니다.

## 패턴 API

Blockstudio\Patterns::patterns() 및 get_pattern()는 PHP에 등록된 패턴을 읽습니다.

Plus

## 공식 확장 키트

프리미엄 사이트 템플릿, AI 시스템 지침, 비공개 Discord 커뮤니티를 제공합니다. 한 번 구매하면 업데이트를 평생 받을 수 있습니다.

- 500개 이상의 사이트 템플릿
- AI 시스템 지침
- 평생 업데이트
- 비공개 Discord 커뮤니티

[Plus 이용하기](https://blockstudio.dev/ko/plus/)
