Dennis · 2026년 3월 14일
Blockstudio 7.1
Blockstudio 7.1은 v7 재작성 이후 첫 기능 릴리스입니다. v7가 기반을 다시 구축했다면, 7.1은 데이터베이스 계층, 서버 함수, 예약 작업, CLI를 추가해 블록을 더 큰 무언가로 바꿉니다. 이제 블록 폴더 하나가 완전한 애플리케이션이 될 수 있습니다.
새로운 기능을 모두 소개합니다.
컴포넌트
편집기의 삽입 도구에서 사용하는 블록과 개발자가 다른 것을 만드는 구성 요소로 사용하는 블록 사이에는 늘 긴장이 있었습니다. 카드, 배지, 통계 위젯, 양식 입력란 등이 그 예입니다. 이런 요소에는 전체 Blockstudio 파이프라인(속성, 템플릿, 에셋, Tailwind)이 필요하지만 삽입 도구에 표시될 이유는 없습니다.
7.1에서는 이를 해결하기 위해 컴포넌트가 도입됩니다. block.json에서 "component": true을 설정하면 블록은 전체 빌드 파이프라인을 거치지만 WordPress의 블록 유형 레지스트리에는 등록되지 않습니다. 삽입 도구에 나타나지 않고, JavaScript로 전송되는 편집기 데이터에도 포함되지 않지만, 프로그래밍 방식으로 렌더링할 수 있습니다.
{
"name": "my-theme/card",
"title": "Card",
"blockstudio": {
"component": true,
"attributes": [
{ "id": "title", "type": "text" },
{ "id": "description", "type": "textarea" }
]
}
}
PHP에서 렌더링합니다:
bs_render_block([
'name' => 'my-theme/card',
'data' => ['title' => 'My Card', 'description' => 'Card content.'],
]);
또는 새로운 HTML 태그 구문을 사용합니다:
<bs:my-theme-card title="My Card" description="Card content." />
블록 태그
이제 블록을 HTML 태그로 삽입할 수 있으며, 서로 바꿔 쓸 수 있는 두 가지 구문을 지원합니다:
<bs:acme-hero title="Welcome" />
<block name="acme/hero" title="Welcome" />
두 구문 모두 같은 출력을 생성합니다. 둘 다 Blockstudio 블록과 핵심 WordPress 블록에서 작동합니다. 블록 템플릿 안에서는 별도 설정 없이 자동으로 렌더링됩니다. 따라서 템플릿에서 다른 블록을 직접 조합해 전체 레이아웃을 만들 수 있습니다:
<div class="my-page">
<bs:mytheme-card title="Featured" />
<block name="core/separator" />
<bs:core-heading level="2">Section Title</bs:core-heading>
<block name="core/group">
<block name="core/paragraph">Inside a core group block.</block>
<bs:mytheme-cta variant="primary" />
</block>
</div>
두 구문은 자유롭게 서로 중첩할 수 있습니다. Blockstudio 블록은 전체 파이프라인(템플릿, Tailwind, 에셋)을 거쳐 렌더링됩니다. 핵심 블록은 WordPress를 통해 페이지 및 패턴을 구동하는 것과 동일한 렌더러를 사용해 렌더링됩니다.
페이지 수준 렌더링(게시물 콘텐츠, 위젯 영역)을 사용하려면 blockstudio.json에서 활성화하세요:
{ "blockTags": { "enabled": true } }
허용 목록과 차단 목록은 와일드카드 패턴을 사용해 태그로 렌더링할 수 있는 블록을 제어합니다. data-* 및 html-* 속성은 렌더링된 블록의 루트 HTML 요소로 전달됩니다. blockstudio/block_tags/renderers 필터를 통해 사용자 지정 렌더러를 등록할 수 있습니다.
내부적으로 태그 파서는 DOMDocument를 완전히 대체하는 새로운 경량 문자열 스캐너입니다. 깊이 추적을 통한 중첩 태그, 재귀 컨테이너 블록, 단일 패스의 혼합 구문을 처리합니다. 벤치마크에서 평면 태그 1,000개를 2.4ms에, 중첩 100단계를 3.7ms에 파싱하며, DOMDocument와 WordPress의 WP_HTML_Tag_Processor보다 일관되게 빠릅니다. 같은 파서는 페이지 및 패턴의 원시 HTML 요소 파싱도 처리하여, 이전에 <p>, <div> 및 기타 HTML 요소를 처리하던 DOMDocument 기반 파서를 대체합니다.
새 필드 유형
블록
다른 Blockstudio 블록을 속성으로 참조할 수 있는 새로운 block 필드 유형입니다. 참조된 블록의 필드는 idStructure 및 overrides을 사용해 사용자 지정 필드와 똑같이 인라인으로 확장됩니다. 차이점은 템플릿에서 값에 접근하면 렌더링된 블록 출력이 반환된다는 점입니다.
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
mytheme/card에 heading 및 content 필드가 있으면 호스트 블록의 사이드바에 card_heading 및 card_content가 표시됩니다. 템플릿에서 {{ a.card }}는 렌더링된 카드를 출력합니다. 일반 블록과 컴포넌트 모두에서 작동합니다.
HTML 태그
모든 테마에는 문맥에 따라 제목 수준이 바뀌어야 하는 블록이 있습니다. 홈페이지에서는 H1, 내부 페이지에서는 H2를 사용하는 식입니다. 매번 하드코딩된 옵션을 선택 필드로 만드는 대신, 이제 기본 프리셋이 포함된 전용 html-tag 필드 유형을 사용할 수 있습니다.
{
"id": "tag",
"type": "html-tag",
"default": "h2",
"tags": "heading",
"exclude": ["h5", "h6"]
}
프리셋: heading (h1-h6), text (제목 + p, span, div), structural (div, section, article, aside, main, header, footer, nav), all. 사용자 지정 배열을 전달할 수도 있습니다. exclude는 모든 프리셋에서 특정 태그를 제외합니다.
<{{ a.tag }}>{{ a.title }}</{{ a.tag }}>
데이터베이스
이번 릴리스의 핵심 기능입니다. 블록 디렉터리에 db.php 파일을 추가하면 Blockstudio가 다섯 가지 REST CRUD 엔드포인트를 생성하고, 모든 쓰기 작업을 스키마에 따라 검증하며, 저장소 백엔드를 자동으로 관리합니다. 또한 JavaScript 클라이언트(bs.db())와 PHP API(Db::get())를 모두 제공합니다. 마이그레이션 파일, 컨트롤러 클래스, 경로 등록은 필요하지 않습니다.
return [
'subscribers' => [
'storage' => 'table',
'capability' => [
'create' => true,
'read' => true,
'update' => 'edit_posts',
'delete' => 'manage_options',
],
'fields' => [
'email' => [
'type' => 'string',
'format' => 'email',
'required' => true,
'validate' => function ($value) {
if (str_ends_with($value, '@spam.com')) {
return 'This domain is blocked.';
}
return true;
},
],
'name' => ['type' => 'string', 'maxLength' => 100],
'plan' => ['type' => 'string', 'enum' => ['free', 'pro']],
],
],
];
이 스키마만으로도 생성, 목록 조회, 가져오기, 업데이트, 삭제 엔드포인트와 입력 검증 기능을 갖춘 완전한 API을 사용할 수 있습니다.
저장소
각기 다른 사용 사례에 적합한 다섯 가지 저장소 백엔드:
table: 사용자 지정 MySQL 테이블을dbDelta()로 관리합니다. 스키마에 필드를 추가하면 다음 페이지 로드 시 열이 추가됩니다. 프로덕션 기본값입니다.sqlite: 블록의db/폴더에 있는 단일 SQLite 파일입니다. 실제 SQL 쿼리, 동시 읽기를 위한 WAL 모드, 완전한 이식성을 제공합니다. 폴더를 복사하면 데이터베이스도 함께 복사됩니다.jsonc: 플랫 파일에 한 줄당 JSON 객체 하나를 저장합니다. 사람이 읽을 수 있고, 버전 관리가 가능하며, git에 적합합니다.meta: 특정 게시물에 연결된 WordPress의 JSON 배열입니다.post_type: 각 레코드가 사용자 지정 게시물 유형의 WordPress 게시물이 됩니다. 필드는 개별 게시물 메타 항목으로 저장되며,WP_Query로 완전히 쿼리할 수 있습니다.
클라이언트
JavaScript 측에서는 bs.db()가 완전한 CRUD 클라이언트를 제공합니다:
const db = bs.db('my-theme/block', 'subscribers');
const record = await db.create({ email: 'a@b.com', plan: 'pro' });
const pros = await db.list({ plan: 'pro' });
await db.update(record.id, { plan: 'free' });
await db.delete(record.id);
함께 제공되는 보조 유틸리티는 세 가지입니다:
bs.cache:get,set,invalidate,clear를 제공하는 메모리 내 쿼리 캐시입니다. 모든 쿼리 및 변경 호출에서 공유됩니다.bs.query(key, fn, options): 모든 비동기 함수에 캐싱, 요청 중복 제거, 설정 가능한staleTime를 적용합니다. 요청이 진행 중일 때 동일한 키로 여러 번 호출하면 모두 같은 프로미스를 반환합니다.bs.mutate(options): 자동 롤백 기능으로 낙관적 변경을 처리합니다. 반응형 상태 객체, 작업(create,update,delete), 낙관적 데이터를 전달하면 UI가 즉시 업데이트됩니다. 서버 호출이 실패하면 상태가 변경 전 스냅샷으로 돌아갑니다.
이 기능들을 조합하면 읽기와 쓰기의 전체 주기를 처리할 수 있습니다. 캐시된 읽기에는 bs.query, 낙관적 쓰기에는 bs.mutate, 수동 제어에는 bs.cache를 사용하세요.
PHP 측에서는 Db 클래스가 동일한 작업을 제공합니다:
use Blockstudio\Db;
$db = Db::get('my-theme/block', 'subscribers');
$db->create(['email' => 'a@b.com', 'plan' => 'pro']);
$db->list(['plan' => 'pro']);
유효성 검사
유효성 검사 오류는 Zod의 fieldErrors 형식을 참고해 필드별 오류 배열로 반환됩니다. 하나의 필드에서 여러 규칙이 실패할 수 있으며, 이 구조를 사용하면 프런트엔드의 양식 필드에 오류를 쉽게 연결할 수 있습니다:
{
"data": {
"status": 400,
"errors": {
"email": ["Must be a valid email address.", "This domain is blocked."],
"plan": ["Must be one of: free, pro."]
}
}
}
내장 규칙으로 처리할 수 없는 항목(도메인 차단, 필드 간 유효성 검사, 외부 조회 등)은 사용자 지정 validate 콜백을 서버 측에서 실행할 수 있습니다.
사용자별 데이터
할 일, 즐겨찾기, 초안처럼 사용자별 데이터의 경우 userScoped을 true로 설정하면 나머지는 Blockstudio가 처리합니다. user_id 열을 추가하고, 생성 시 자동으로 값을 설정하며, 모든 쿼리를 현재 사용자에 맞게 필터링합니다. 업데이트와 삭제 시에는 소유권을 확인합니다. user_id 필드를 수동으로 지정하거나, before_create 훅을 사용하거나, RPC에서 필터링할 필요가 없습니다. 설정 한 줄이면 됩니다. post_type 저장소를 사용하면 userScoped은 별도 열이 아닌 post_author에 매핑됩니다.
return [
'storage' => 'sqlite',
'userScoped' => true,
'fields' => [ /* ... */ ],
];
실시간 폴링
스키마에서 'realtime' => true을 설정하면 클라이언트가 변경 사항을 자동으로 폴링합니다. 서버에서 변경이 발생하면 Interactivity API 스토어가 업데이트되고 UI가 다시 렌더링되므로 사용자가 JavaScript을 변경할 필요가 없습니다. 사용자 지정 상태 키와 간격은 'realtime' => ['key' => 'todos', 'interval' => 5000]로 설정할 수 있습니다. 폴링은 해시 비교를 사용해 요청을 가볍게 유지하며 브라우저 탭이 숨겨져 있을 때는 일시 중지됩니다.
보안, 훅, 이식성
공개 엔드포인트는 자동 삽입되는 X-BS-Token CSRF 헤더로 보호됩니다. 수신 웹훅처럼 인증 없이 완전히 공개해야 하는 경우에는 'open'을 사용하세요.
수명 주기 훅은 모든 쓰기 작업의 전후에 실행됩니다. 훅은 db.php 안에서 인라인으로 정의하거나 WordPress 액션을 통해 전역으로 정의할 수 있습니다.
필드에 component 키를 지정하면 bs_db_form()을 통해 스키마 기반 양식을 렌더링할 수 있습니다.
SQLite 또는 JSONC 저장소를 사용하면 코드, 로직, 접근 제어, 데이터까지 애플리케이션 전체가 하나의 폴더에 들어갑니다. 배포하려면 폴더를 복사하면 됩니다.
RPC
CRUD만으로 부족할 때도 있습니다. 할 일 항목 전환, 알림 전송, 통계 집계 같은 사용자 지정 서버 로직이 필요할 수 있습니다. 이를 위한 기능이 rpc.php입니다. PHP 함수를 정의하고 프런트엔드에서 bs.fn()로 호출하면 Blockstudio가 REST 엔드포인트, 인증, CSRF 보호, JSON 직렬화를 처리합니다. 이 패턴은 tRPC에서 영감을 얻었습니다. 서버 측에서 프로시저를 정의하고 클라이언트에서 이름으로 호출합니다.
return [
'subscribe' => function (array $params): array {
$email = sanitize_email($params['email']);
return ['success' => true];
},
];
const result = await bs.fn('subscribe', { email: 'user@example.com' });
인라인 스크립트(script-inline.js)는 스크립트 태그의 data-block 속성에서 블록 이름을 자동으로 감지하므로 수동으로 전달할 필요가 없습니다. 모듈 스크립트에서는 세 번째 인수로 전달합니다.
접근 제어 옵션으로는 public(CSRF 포함), 'open'(보호 없음), 권한 문자열 또는 배열이 있습니다. 함수별 HTTP 메서드 제어, 수명 주기 훅, JS 및 PHP에서의 블록 간 호출도 모두 지원됩니다.
Cron
백그라운드 작업은 cron.php 파일에서 정의합니다. 일정과 콜백을 설정하면 Blockstudio가 초기화 시 WordPress Cron에 등록합니다. 플러그인을 비활성화하면 예약된 작업이 모두 깔끔하게 해제됩니다.
return [
'cleanup' => [
'schedule' => 'daily',
'callback' => function () {
$db = Db::get('my-theme/app', 'logs');
// delete old entries
},
],
'sync' => [
'schedule' => 'hourly',
'callback' => function () {
// pull from external API
},
],
];
내장된 모든 WordPress 일정을 지원하며, cron_schedules 필터를 통해 사용자 지정 간격도 설정할 수 있습니다.
CLI
새로운 wp bs 명령은 Blockstudio의 모든 기능을 지원합니다. 블록, 데이터베이스, RPC, cron, 설정, Tailwind 컴파일, SCSS 컴파일, 사용자 지정 필드, 에셋 관리가 포함됩니다.
wp bs blocks list --components
wp bs db schemas
wp bs db create my-theme/app subs --email=a@b.com
wp bs db list my-theme/app subs --plan=pro --format=json
wp bs rpc call my-theme/app subscribe --email=a@b.com
wp bs cron run my-theme/app cleanup
wp bs tailwind compile --file=template.html
wp bs scss compile --file=style.scss
wp bs fields list
wp bs assets list --type=global
wp bs settings get tailwind/enabled
모든 명령은 스크립트에서 사용할 수 있도록 --format=json을 지원합니다.
반복 필드 개선
객체 필드의 textMinimized
이제 접힌 반복 필드 행에서 객체 필드 값을 올바르게 처리합니다. 이전에는 링크 필드에 textMinimized을 지정하면 [object Object]이 표시되었습니다. 이제 Blockstudio가 필드 유형에 따라 올바른 하위 속성을 자동으로 읽습니다. 링크는 title, 색상과 그라데이션은 value, 아이콘은 icon를 사용합니다. 원하는 하위 속성을 읽도록 key 속성을 직접 지정할 수도 있습니다.
{
"type": "repeater",
"textMinimized": { "id": "href", "fallback": "Add a link" },
"attributes": [{ "id": "href", "type": "link" }]
}
RichText 및 MediaPlaceholder
이제 두 템플릿 컴포넌트 모두 반복 필드 안에서 작동하며, 대괄호 표기법으로 올바른 행을 지정할 수 있습니다. 반복 필드의 각 행에서 제목과 단락을 인라인 편집하고 미디어를 업로드할 수 있습니다.
{% for item in a.items %}
<div class="card">
<MediaPlaceholder attribute="items[{{ loop.index0 }}].image" />
<RichText tag="h2" attribute="items[{{ loop.index0 }}].heading" />
<RichText tag="p" attribute="items[{{ loop.index0 }}].content" />
</div>
{% endfor %}
idStructure를 사용한 사용자 지정 필드 조건
idStructure을 사용하는 사용자 지정 필드에서는 필드 정의 내 조건의 ID가 확장된 이름과 일치하도록 자동으로 다시 작성됩니다. 글꼴 크기 필드 그룹에 enable 조건이 있고 이를 idStructure: "title_font_{id}"로 확장하면 조건이 원래의 enable가 아닌 title_font_enable을 올바르게 참조합니다.
참조 수준 조건도 지원됩니다. 사용자 지정 필드 참조에 conditions을 추가하면 확장된 모든 필드에 한 번에 적용됩니다.
동적 populate 인수
이제 populate 인수에서 {attributes.*} 구문을 사용해 다른 블록 속성을 참조할 수 있습니다. 참조된 속성이 바뀌면 선택 필드가 옵션을 자동으로 다시 가져옵니다. 선택 필드를 연쇄적으로 연결해 보세요. 하나는 게시물 유형을 선택하고, 다른 하나는 해당 유형의 게시물을 불러옵니다.
{
"id": "selected_post",
"type": "select",
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "{attributes.post_type}"
}
}
}
post_type을 “page”로 바꾸면 두 번째 선택 필드에 페이지가 표시됩니다. “post”로 바꾸면 게시물이 표시됩니다. 모든 populate 유형과 속성에서 작동합니다.
Composer
이제 Blockstudio은 플러그인 디렉터리뿐 아니라 wp-content/ 아래 어디서든 로드할 수 있습니다. 에셋 URL은 plugins_url() 대신 BLOCKSTUDIO_URL 상수를 통해 확인되므로 테마에 포함한 설치에서도 별도 설정 없이 작동합니다:
require_once __DIR__ . '/vendor/autoload.php';
require_once __DIR__ . '/vendor/blockstudio/blockstudio/blockstudio.php';
composer.json 런타임 종속 항목을 정리했습니다. lib/에 이미 포함된 범위 지정 패키지(TailwindPHP, ScssPhp, Minify)는 더 이상 런타임 종속 항목으로 나열되지 않습니다. php >= 8.2와 plugin-update-checker만 남습니다.
세 가지 설치 방법(플러그인 zip, Composer을 통한 플러그인 설치, Composer을 통한 테마 포함 설치)은 모두 동일하게 작동합니다. 완전한 WordPress 활성화, 블록 등록, 프런트엔드 렌더링을 지원합니다.
설정 방법은 Composer문서를 참조하세요.
성능 프로파일러
페이지 URL에 ?blockstudio-perf을 추가하면 하단에 디버그 패널이 표시됩니다. 패널에는 블록별 렌더링 시간, 단계별 분석, 캐시 적중률이 나타납니다. 타이밍 데이터는 Server-Timing 헤더로도 전송되며 브라우저 개발자 도구의 네트워크 탭에서 확인할 수 있습니다.
{ "dev": { "perf": true } }
설정에서 영구적으로 활성화하면 페이지가 로드될 때마다 프로파일링할 수 있습니다. edit_posts 권한이 있는 로그인 사용자에게만 표시됩니다.
이제 자체 닫는 블록 태그도 메모리에 캐시됩니다. 페이지에 속성이 동일한 블록이 여러 번 나타나면 이후 렌더링에서는 템플릿 파이프라인 전체를 건너뜁니다.
버그 수정
- PHP 8.4 지원 중단 경고:
null을add_submenu_page()에 전달해 발생하던strpos()및str_replace()지원 중단 경고를 수정했습니다.
기타
- SCSS 코드 필드: 코드 필드에서
language: "scss"을 지원합니다. 편집기와 프런트엔드 모두에서 값을 ScssPhp를 통해 컴파일합니다. - 표준 WordPress 블록: Blockstudio 디렉터리에 Blockstudio 블록과 함께
@wordpress/create-block출력을 넣을 수 있습니다. 별도의 플러그인 코드 없이 자동으로 등록됩니다.
전체 스택 패턴을 실제로 확인하고 싶다면 풀스택 블록 안내서에서 사용자별 할 일 앱과 공개 뉴스레터 가입 양식을 처음부터 만드는 방법을 살펴보세요.