Dennis · 2026년 2월 7일
Introducing Blockstudio 7
Blockstudio 7이 출시되었습니다. 프로젝트 역사상 가장 큰 릴리스로, 전체 코드베이스를 처음부터 완전히 다시 작성했습니다. 모든 클래스와 훅, 코드 한 줄 한 줄을 현대적인 PHP, WordPress 코딩 표준과 장기적인 유지보수성을 중심으로 새로 구축했습니다.
하지만 단순한 리팩터링이 아닙니다. Blockstudio 7에는 파일 기반 페이지와 패턴, 글 메타 저장 시스템, SEO 통합, 모든 기능을 뒷받침하는 완전히 새로운 HTML-블록 파서와 같은 주요 기능이 추가되었습니다. 또한 이제 Blockstudio는 완전히 무료 오픈 소스입니다.
새로운 기능을 모두 살펴보겠습니다.
무료 오픈 소스
저는 Blockstudio를 2020부터 개발하며 수십 차례 릴리스했습니다. 사용자들은 좋아했지만, 상용 WordPress 블록 프레임워크의 시장 적합성을 찾기는 늘 어려웠습니다.
상황을 바꾼 것은 LLM입니다. 이제 AI 코딩 어시스턴트는 블록 코드를 작성할 만큼 뛰어나지만, 작업하려면 깔끔한 파일 기반 구조가 필요합니다. WordPress 블록 마크업은 복잡합니다. 직렬화된 HTML 주석에 JSON 속성이 포함되고 DOM 구조와 뒤섞여 있습니다. 사람이 다루기도 어렵고 LLM이 올바르게 처리하기는 더 어렵습니다.
Blockstudio의 파일 우선 접근 방식은 언제나 단순함을 목표로 했습니다. 폴더에 block.json와 PHP 템플릿을 두는 방식입니다. 데이터베이스 항목도, React도, 빌드 단계도 필요 없습니다. v7에서는 이 철학을 한층 발전시켰습니다. HTML-블록 파서를 사용하면 일반 HTML를 작성해 유효한 블록 마크업으로 자동 변환할 수 있습니다. 모든 항목은 파일 시스템에 그대로 저장됩니다. 데이터베이스 쓰기는 파일 템플릿을 통해 실행되는 PHP API 또는 CLI로 명시적으로 요청한 페이지 동기화뿐입니다.
Blockstudio를 오픈 소스로 만드는 것은 자연스러운 다음 단계입니다. LLM이 Blockstudio 코드를 더 많이 학습할수록 더 잘 생성합니다. 공개 코드베이스와 문서, 어떤 도구에서든 사용할 수 있도록 미리 구축된 AI 컨텍스트 파일을 제공하면 AI 지원 WordPress 개발에 최적의 환경을 만들 수 있습니다.
전체 플러그인은 누구나 사용하고 포크하며 기여할 수 있도록 GitHub에서 제공됩니다. 라이선스 키도, 유료 장벽도, 기능 제한도 없습니다.
새로운 기능
파일 기반 페이지
7.0의 가장 큰 추가 기능 중 하나입니다. 이제 전체 WordPress 페이지를 파일 템플릿으로 정의할 수 있으며, 페이지 동기화 API 또는 CLI를 실행하면 데이터베이스에 기본 블록 콘텐츠로 동기화됩니다.
page.json와 템플릿 파일이 있는 폴더를 만드세요:
{
"name": "about",
"title": "About Us",
"slug": "about",
"postStatus": "publish"
}
<div class="about-page">
<h1>About Us</h1>
<p>Welcome to our site.</p>
</div>
wp bs pages sync를 실행하면 Blockstudio가 HTML를 WordPress 블록으로 파싱하고 데이터베이스에서 페이지를 만들거나 업데이트합니다.
키 기반 블록 병합
템플릿을 동기화하면 보통 사용자가 수정한 내용이 덮어써집니다. key 속성을 사용하면 동기화 중에도 사용자 콘텐츠를 보존할 수 있습니다:
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>
키가 일치하는 블록은 템플릿이 업데이트되어도 사용자가 수정한 콘텐츠를 유지합니다. 키가 없는 블록은 모두 교체됩니다.
블록 바인딩
키를 사용하는 대신 WordPress 코어의 블록 바인딩 API을 사용해 블록을 글 메타에 직접 연결할 수 있습니다. 이는 Blockstudio 기능이 아니라 기본 제공 WordPress API입니다. Blockstudio는 metadata 속성을 생성된 블록 마크업에 전달하기만 합니다. 콘텐츠는 블록 마크업 대신 메타에 저장되므로 템플릿 동기화로 사용자 수정 사항이 사라지지 않습니다. 데이터는 WP_Query를 통해 쿼리할 수도 있고 REST API에서도 사용할 수 있습니다.
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
Default Title
</h1>
두 방식을 하나의 템플릿에서 함께 사용할 수 있습니다.
편집 제어
페이지에서 blockEditingMode와 templateLock를 사용해 사용자가 수정할 수 있는 항목을 제어할 수 있습니다:
{
"name": "landing",
"title": "Landing Page",
"blockEditingMode": "contentOnly",
"templateLock": "all"
}
페이지 구조를 잠그면서도 사용자가 텍스트와 미디어를 편집할 수 있게 합니다. 템플릿의 blockEditingMode 속성을 사용하면 개별 요소에 페이지 수준 설정을 재정의할 수 있습니다.
글 ID에 고정
postId를 사용해 페이지 템플릿을 기존 WordPress 글에 연결하면 중복 페이지를 방지하고 템플릿이 항상 올바른 글을 업데이트하도록 할 수 있습니다:
{
"name": "home",
"title": "Home",
"postId": 2
}
자세한 내용은 페이지 문서를 참조하세요.
파일 기반 패턴
페이지와 마찬가지로 이제 블록 패턴도 파일 템플릿으로 정의할 수 있습니다. HTML에 패턴을 작성하면 Blockstudio가 이를 블록 마크업으로 파싱해 기본 제공 WordPress 블록 패턴으로 등록합니다. 블록 삽입기에 표시되며 사용자는 어디에나 배치할 수 있습니다.
{
"name": "hero-section",
"title": "Hero Section",
"categories": ["featured"],
"keywords": ["hero", "banner"]
}
<div class="hero">
<h1>Welcome</h1>
<p>Get started today.</p>
</div>
페이지와 달리 패턴은 데이터베이스 항목을 만들지 않습니다. 페이지가 로드될 때마다 메모리에 등록됩니다. 자세한 내용은 패턴 문서를 참조하세요.
HTML-블록 파서
페이지와 패턴은 모두 표준 HTML 템플릿을 WordPress 블록 마크업으로 변환하는 새로운 HTML 파서를 사용합니다. 그룹과 열 같은 컨테이너 블록, 문단과 제목 같은 리프 블록을 자동으로 처리합니다. 파서는 트레이트 기반 렌더러 아키텍처를 사용하므로 blockstudio/parser/renderers 필터를 통해 다른 블록 유형을 쉽게 지원할 수 있습니다:
add_filter( 'blockstudio/parser/renderers', function ( $renderers, $parser ) {
$renderers['acme/hero'] = function ( $element, $attrs, $parser ) {
$content = $parser->get_inner_html( $element );
$html = '<div class="acme-hero">' . $content . '</div>';
return array(
'blockName' => 'acme/hero',
'attrs' => $attrs,
'innerBlocks' => array(),
'innerHTML' => $html,
'innerContent' => array( $html ),
);
};
return $renderers;
}, 10, 2 );
등록한 뒤에는 모든 페이지 또는 패턴 템플릿에서 블록을 사용할 수 있습니다:
<block name="acme/hero" background="/hero.jpg">
<h1>Welcome to our site</h1>
</block>
저장소
필드는 이제 블록 속성 외에도 글 메타나 사이트 옵션에 값을 저장할 수 있습니다. 중요한 변경 사항입니다:
{
"id": "subtitle",
"type": "text",
"label": "Subtitle",
"storage": {
"type": "postMeta"
}
}
글 메타에 값을 저장하면 다음을 할 수 있습니다:
WP_Query및meta_query을 사용해 필드 값으로 글 쿼리- 헤드리스 환경에서는 REST API를 통해 필드 데이터에 액세스
- SEO 도구와 캐싱 계층 등 다른 플러그인과 데이터 공유
전역 사이트 전체 설정을 위해 옵션 테이블에 값을 저장할 수도 있습니다:
{
"id": "phone",
"type": "text",
"label": "Phone Number",
"storage": {
"type": "option",
"optionKey": "company_phone"
}
}
전체 API는 저장소 문서를 참조하세요.
사용자 정의 필드
재사용 가능한 필드 정의를 여러 블록에서 공유할 수 있습니다. 필드 집합을 한 번 정의한 뒤 어떤 블록에서든 참조하세요. 여러 블록이 동일한 필드 구조를 공유할 때 반복을 줄일 수 있습니다.
blockstudio 디렉터리에 field.json를 만드세요:
{
"name": "hero",
"title": "Hero Section",
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
{ "id": "description", "type": "textarea", "label": "Description" }
]
}
그런 다음 custom/ 접두사를 사용해 모든 블록에서 참조하세요:
{
"blockstudio": {
"attributes": [
{ "type": "custom/hero", "idStructure": "hero_{id}" }
]
}
}
idStructure 속성은 각 필드 ID 앞에 접두사를 붙입니다. 따라서 heading는 hero_heading가 됩니다. overrides 키를 사용하면 인스턴스별로 개별 필드 속성을 재정의할 수도 있습니다.
사용자 정의 필드 문서를 참조하세요.
Tailwind CSS v4
Tailwind 지원 기능을 v4용으로 완전히 다시 구축했습니다. 이전 방식처럼 CDN를 통해 클라이언트 측에서 컴파일하고 글 저장 시 디스크에 저장하는 대신(v6 방식), Blockstudio 7은 프런트엔드 요청이 있을 때마다 TailwindPHP를 통해 서버 측에서 Tailwind를 컴파일합니다. Node.js도, CLI도 필요 없고 빌드 단계도 없습니다.
컴파일에는 후보 기반 캐싱을 사용합니다. Blockstudio가 최종 HTML에서 모든 CSS 클래스 이름을 추출하고, 이를 CSS 설정과 함께 정렬하고 해시한 뒤 캐시 파일을 확인합니다. 주변 HTML가 변경되어도(논스, 타임스탬프, 동적 콘텐츠 등) 동일한 클래스는 동일한 캐시 결과를 냅니다.
설정에는 Tailwind v4의 CSS 우선 구문을 사용합니다. blockstudio.json에서 직접 또는 blockstudio/tailwind/css 필터를 통해 사용자 정의 테마와 유틸리티 클래스를 정의하세요:
add_filter('blockstudio/tailwind/css', function ($css) {
return $css . '
@theme {
--color-brand: #4f46e5;
}
@layer utilities {
.container-narrow {
max-width: 48rem;
margin-inline: auto;
}
}
';
});
블록 편집기에서는 번들로 제공되는 Tailwind CDN 스크립트가 입력하는 동안 실시간 미리보기를 제공합니다. classes 필드 유형은 모든 Tailwind 유틸리티의 자동 완성을 지원합니다. 프런트엔드에서는 서버에서 컴파일한 CSS를 항상 사용하며, </head> 앞에 인라인 스타일 태그로 삽입합니다.
전체 설정 방법은 Tailwind 문서를 참조하세요.
인터랙티비티 API
이제 Blockstudio에서 WordPress 인터랙티비티 API를 지원합니다. block.json에서 활성화하세요:
{
"blockstudio": {
"interactivity": true
}
}
템플릿에 data-wp-* 지시어를 추가하세요:
<div useBlockProps
data-wp-interactive="myBlock"
data-wp-context='{ "isOpen": false }'>
<button data-wp-on--click="actions.toggle"
data-wp-bind--aria-expanded="context.isOpen">
Toggle
</button>
<div data-wp-bind--hidden="!context.isOpen">
This content is toggled by the button.
</div>
</div>
스토어 로직을 담은 script.js를 만드세요:
import { store, getContext } from '@wordpress/interactivity';
store('myBlock', {
actions: {
toggle: () => {
const context = getContext();
context.isOpen = !context.isOpen;
},
},
});
Blockstudio는 프런트엔드와 블록 편집기 모두에서 importmap, 모듈 로딩, 지시어 처리를 담당합니다. data-wp-context를 사용하는 선언형 지시어만 포함된 블록(예: data-wp-bind--hidden 또는 data-wp-text)은 JavaScript 없이도 작동합니다. wp_interactivity_state()를 통한 서버 측 상태도 프런트엔드에서 지원됩니다.
전체 설정 방법은 인터랙티비티 문서를 참조하세요.
SEO 콘텐츠 분석
Blockstudio 블록은 동적이므로 기본적으로 SEO 플러그인에서는 필드 콘텐츠를 볼 수 없습니다. Blockstudio 7은 Yoast SEO, Rank Math, SEOPress와 자동으로 통합해 이 문제를 해결합니다. text, textarea, richtext, wysiwyg, link 필드의 텍스트 값(중첩된 리피터 행 포함)을 추출해 각 플러그인의 콘텐츠 분석에 전달합니다. 이제 SEO 플러그인에서 키워드 밀도, 가독성 및 기타 지표를 기준으로 블록 콘텐츠를 정확히 분석할 수 있습니다. 설정이 필요하지 않습니다.
리피터 기본 행
이제 리피터 필드에서 미리 채워진 행 배열이 포함된 default 속성을 지원합니다. 블록을 삽입하면 편집기와 프런트엔드 모두에서 지정된 행과 값이 리피터에 채워집니다:
{
"id": "features",
"type": "repeater",
"label": "Features",
"default": [
{ "title": "Fast", "icon": "bolt" },
{ "title": "Secure", "icon": "shield" }
],
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{ "id": "icon", "type": "text", "label": "Icon" }
]
}
min 속성은 필드 수준 기본값과도 함께 작동합니다. 리피터에 min: 3가 있고 내부 필드에 default 값이 있으면 자동 생성된 행이 비어 있는 대신 해당 기본값으로 채워집니다.
개선 사항 및 수정
- 필드 기본값이 있는 리피터
min: 자동 생성되는 최소 행에 이제 프런트엔드와 편집기 모두에서 필드 수준 기본값을 사용합니다 - Tailwind 편집기 스타일: 컴파일된 Tailwind CSS를 이제 CDN와 함께 블록 편집기 iframe에 삽입하므로 사용자 정의
@apply규칙과 테마 설정이 편집기에서 작동합니다 - AI 컨텍스트 파일:
blockstudio-llm.txt를 전체 v7 문서와 중복 제거된 JSON 스키마(약 48k 토큰)로 구성된 정적 파일로 다시 만들었습니다. v6에서 동적으로 생성하던 방식을 대체합니다 - 코드 필드 팝아웃: 이제 코드 필드를 별도 창에서 열 수 있으며 실행 취소/다시 실행 기록과 JavaScript 구문 강조 표시가 독립적으로 작동합니다
- Tailwind v4 서버 측 컴파일: 위의 Tailwind 섹션을 참조하세요
- API 버전 3: 이제 사이트 편집기와 반응형 미리보기를 포함해 iframe 편집기에서 블록이 올바르게 렌더링됩니다
- 에셋 파일 이름에 점 표기법 사용: 에셋 접미사(
*.inline.css,*.editor.js,*.scoped.css)의 파일 이름 규칙이 더 간결해졌습니다 useBlockProps사용 시WP_Block_Supports의bs_render_block()경고 수정- 조건부 필드가 첫 로드 시 기본값을 따르지 않던 문제 수정
- 프런트엔드에서
<RichText />콘텐츠의 달러 기호가 제거되던 문제 수정 - 다른 플러그인이 등록한 분류 체계에서도
populate기능이 작동하도록 수정 - WPML 컨텍스트에서
optionsPopulatenull 오류 수정
내부 작동 방식
완전한 재작성
리팩터링이나 정리 작업이 아닙니다. 모든 클래스를 처음부터 다시 작성했습니다. 그 결과 코드베이스가 더 깔끔하고 모듈화되어 유지보수와 확장이 쉬워졌습니다.
최신 PHP
Blockstudio 7에는 PHP 8.2 이상이 필요하며, 전반적으로 최신 타입 선언을 사용합니다.
호환성을 깨는 변경 사항
주요 버전 업데이트인 7.0에는 호환성을 깨는 변경 사항이 몇 가지 포함되어 있습니다. 대부분 이전 버전과 호환되는 대체 기능이 있지만 업그레이드 전에 내용을 확인하세요. 전체 마이그레이션 가이드는 v7 마이그레이션 문서를 참조하세요.
훅 이름에 snake_case 사용
모든 PHP 훅의 이름을 camelCase에서 snake_case로 변경해 WordPress 코어의 규칙에 맞췄습니다:
// Before (v6)
add_filter('blockstudio/settings/blockEditor/cssClasses', function() {
return ['my-stylesheet'];
});
// After (v7)
add_filter('blockstudio/settings/block_editor/css_classes', function() {
return ['my-stylesheet'];
});
이전 camelCase 이름도 계속 사용할 수 있지만 업데이트를 권장합니다.
필드 스위치의 기본값은 꺼짐
switch 속성의 기본값이 이제 false이 아닌 true입니다. v6에서는 모든 필드 왼쪽 가장자리에 기본적으로 켜져 있는 보이지 않는 토글이 있었습니다. v7에서는 스위치를 선택적으로 활성화할 수 있으며 필드 레이블에 보이는 눈 아이콘이 표시됩니다. 기본 스위치 동작에 의존했다면 필드 정의에 "switch": true를 추가하세요.
에셋 파일 이름에 점 표기법 사용
이제 에셋 접미사에 대시 대신 점을 사용합니다(style.inline.css 대신 style-inline.css). 이전 대시 표기법도 계속 작동하지만 앞으로는 점 표기법을 권장합니다.
npm 가져오기 접두사
ES 모듈 가져오기에서 이제 blockstudio/ 대신 npm:를 사용합니다:
// Before (v6)
import confetti from "blockstudio/canvas-confetti@1.6.0";
// After (v7)
import confetti from "npm:canvas-confetti@1.6.0";
이전 버전과의 호환성을 위해 blockstudio/ 접두사도 계속 지원합니다.
제거된 기능
관리 영역 및 코드 편집기. WordPress 관리 설정 페이지와 내장 블록 코드 편집기가 모두 제거되었습니다. 이제 모든 설정은 blockstudio.json 및 PHP 필터를 통해 처리되므로 설정을 블록과 함께 버전 관리할 수 있습니다.
코드 편집기는 이전 버전에서 블록을 미리 보는 데 유용했지만 실제 개발 환경과 동등한 수준에 이르지는 못했습니다. 독립형 편집기에서는 지원할 수 없어 여러 플러그인 기능의 개발이 수년간 제한되었습니다. 또한 완전한 IDE를 대체할 수는 없었습니다. 코드 편집기를 제거하면 타협 없이 파일 기반 개발에만 집중할 수 있습니다.
라이선스 키. 더 이상 필요하지 않습니다. Blockstudio는 무료 오픈 소스입니다.
블록 라이브러리. 내장된 “Blockstudio Elements” 라이브러리(Gallery, Slider, Image Comparison, Code, Icon)가 제거되었습니다. 플러그인에 함께 제공되던 미리 작성된 예제 블록입니다. 사용 중이었다면 v6의 블록 폴더를 테마의 blockstudio 디렉터리로 복사하세요.
시작하기
Blockstudio 7을 설치하고 몇 분 만에 첫 블록을 만들어 보세요. 단계별 안내는 시작 가이드를, v6에서 업그레이드하는 경우 v7 마이그레이션 가이드를 확인하세요.
전체 소스는 GitHub에서 확인할 수 있습니다. 이슈, PR, 피드백을 환영합니다.