워드프레스 블록 테마 – theme.json

워드프레스 블록 테마에서 theme.json 을 이용한 전역 설정과 스타일 설정에 대해서 살펴보겠습니다.

기본 구조

{
“$schema”: “https://schemas.wp.org/trunk/theme.json”,
“version”: 2,
“settings”: {},
“styles”: {},
“customTemplates”: {},
“templateParts”: {},
“patterns”: []
}

이 theme.json은 블록 테마는 물론 클래식 테마에서도 사용이 될 수 있다고 합니다. 테마를 개발하면서 theme.json 을 사용하겠다고 결정하고 파일을 생성해 놓을 경우, 필수 항목은 version 입니다.

{
“version”: 2
}

최소한 버전은 지정해주고 파일을 만들어 줘야합니다.

그외 필수는 아니지만, $schema 정도까지 적어두는게 좋습니다.

{
“$schema”: “https://schemas.wp.org/trunk/theme.json”,
“version”: 2
}

이렇게 해 두면 theme.json 파일의 최소 기준은 만족되지만, 아무런 설정이 없는 상태가 되는겁니다. patterns, settings, styles, customTemplates, templateParts 등 테마가 준비해 둔 값들을 설정해야겠지요.

Settings 부터…

settings 항목에도 하위 항목으로 많은 항목들이 있습니다.

{
“version”: 2,
“settings”: {
“appearanceTools”: false,
“border”: {},
“color”: {},
“custom”: {},
“dimensions”: {},
“layout”: {},
“position”: {},
“shadow”: {},
“spacing”: {},
“typography”: {},
“useRootPaddingAwareAlignments”: false,
“blocks”: {}
}
}

appearanceTools 항목은 true, false 로 설정을 할 수 있습니다. 워드프레스 자체에 있는 Appearance > Editor 에서 수정을 가능하게 할 것인가를 단번에 지정할 수 있습니다.

만약, false 면 false라고 작성할 필요도 없습니다. 기본 값이 false입니다.

만약, true 라고 설정하면 border, color 등등 모두 Editor에서 수정이 가능하다는 뜻입니다.

수정 가능하게 열어둘 항목이 몇 개 되지 않는다면, appearanceTools 를 false 로 설정하고 border, color 등 각 항목에 직접 하나하나 true로 설정해 주면 됩니다.

반대로 true 라고 설정해 놓고 특정 항목만 false로 지정해 줄 수도 있습니다.

워드프레스 관리자 페이지에서 Appearance > Editor 로 테마를 편집하면 바뀐 정보는 wp_posts 테이블에 post_type 이 wp_template_part 라고 설정되어 post_content 에 저장됩니다.