PHP 훅
아래에서 플러그인의 기능을 확장하거나 조정하는 데 사용할 수 있는 모든 PHP 훅의 목록을 확인할 수 있습니다.
경로
이 필터를 사용하면 블록 폴더의 경로를 조정할 수 있습니다. 기본적으로 현재 활성 테마 내의 blockstudio입니다. 또는 여러 소스 디렉터리를 사용하도록 새 인스턴스를 만들 수도 있습니다.
add_filter('blockstudio/path', function() {
$path = get_stylesheet_directory() . '/blocks';
return $path;
});
초기화
전역
이 액션은 플러그인이 모든 블록을 등록한 후 실행됩니다.
add_action('blockstudio/init', function($blocks) {
// All blocks have been registered
});
인스턴스
이 액션은 플러그인이 특정 인스턴스의 모든 블록을 등록한 후 실행됩니다.
$instance 세그먼트는 wp-content 기준 인스턴스의 상대 경로입니다.
$instance = 'themes/my-theme/client-blocks';
add_action("blockstudio/init/$instance", function() {
// All blocks of this instance have been registered
});
global/before
이 액션은 플러그인이 모든 블록을 등록하기 전에 실행됩니다.
add_action('blockstudio/init/before', function() {
// Before blocks are registered
});
global/before/$instance
이 액션은 플러그인이 특정 인스턴스의 모든 블록을 등록하기 전에 실행됩니다.
$instance = 'themes/my-theme/client-blocks';
add_action("blockstudio/init/before/$instance", function() {
// Before blocks of this instance are registered
});
블록
렌더링
이 필터를 사용하면 블록이 렌더링되기 전에 출력을 조정할 수 있습니다.
add_filter('blockstudio/blocks/render', function($content, $block, $attributes) {
// Modify the block content
return $content;
}, 10, 3);
메타
이 필터를 사용하면 block.json 파일이 등록되기 전에 해당 파일의 데이터를 조정할 수 있습니다.
add_filter('blockstudio/blocks/meta', function($meta, $block) {
if (str_starts_with($block['name'], 'marketing')) {
$meta['icon'] = 'megaphone';
}
return $meta;
}, 10, 2);
위 코드는 marketing으로 시작하는 모든 블록의 아이콘을 변경합니다.
조건
이 필터를 사용하면 블록 내에서 사용할 사용자 지정 조건을 추가할 수 있습니다. 각 조건 유형은 편집기가 조건의 value와 비교하는 값에 대응합니다. 사용자 지정 조건을 참조하세요.
add_filter('blockstudio/blocks/conditions', function($conditions) {
$conditions['myCustomCondition'] = 'expected';
return $conditions;
});
속성
이 필터는 블록이 등록되기 전에 하나의 필드 정의를 조정합니다. 필터를 거친 정의는 편집기 컨트롤과 렌더링 시 값 검증에 사용됩니다. 자세한 내용은 필터링을 참조하세요.
add_filter('blockstudio/blocks/attributes', function($attribute, $block) {
// Modify this field definition before registration.
return $attribute;
}, 10, 2);
attributes/render
이 필터는 필드 값을 블록 템플릿에 전달하기 전에 조정합니다. 필드마다 한 번 실행되며 세 가지 인수를 받습니다. $value(확정된 값), $key($a에서 사용하는 필드 키), $block(템플릿이 $block 또는 $b로 받는 블록 데이터 배열)입니다. 허용 인수는 세 개로 등록하세요. 자세한 내용은 필터링을 참조하세요.
add_filter('blockstudio/blocks/attributes/render', function($value, $key, $block) {
// Modify the value of one field before rendering.
return $value;
}, 10, 3);
attributes/files/sizes
files 필드는 각 이미지와 함께 sizes 배열을 반환합니다. 이 배열에는 URL, full의 너비와 높이, 그리고 $image['sizes']['thumbnail'] 및 $image['sizes']['thumbnail-width']와 같은 등록된 모든 이미지 크기 정보가 들어 있습니다. 각 크기마다 이미지당 wp_get_attachment_image_src() 호출이 한 번 이루어지므로 해당 필터도 계속 적용됩니다. sizes를 읽지 않는 템플릿은 목록을 제거하거나 줄일 수 있습니다.
add_filter('blockstudio/blocks/attributes/files/sizes', function($sizes, $id, $size) {
// Keep only two sizes. Return an empty array to skip them, `sizes` is then null.
return ['full', 'large'];
}, 10, 3);
$sizes는 크기 이름 목록이며, full가 첫 번째입니다(중간 크기가 등록되지 않았다면 비어 있습니다). $id는 첨부 파일 ID이고, $size는 값의 url에 요청된 크기입니다. 이 필터는 요청에 포함된 모든 files 값의 sizes 배열을 변경합니다. 필터를 사용하지 않으면 배열은 변경되지 않습니다.
크기 이름은 문자열로 반환하세요. 잘못된 항목은 무시하고, 중복된 이름은 한 번만 처리하며, 배열이 아닌 반환값이면 크기 처리를 건너뜁니다. 요청된 url과 다른 첨부 파일 속성은 변경되지 않습니다. returnFormat: "url"이 있는 files 필드에는 크기 맵을 만들지 않으므로 이 후크가 실행되지 않습니다.
attributes/validate
명시적인 bs_validate_block() 호출의 결과를 조정합니다. 예를 들어 사용자 지정 렌더 필터가 저장된 참조를 확인하는 경우에 사용할 수 있습니다. 저장하거나 렌더링할 때 자동으로 유효성을 검사하도록 설정되지는 않습니다.
add_filter('blockstudio/blocks/attributes/validate', function($findings, $name, $attrs) {
return $findings;
}, 10, 3);
결과 목록을 반환합니다. 블록에 Blockstudio 필드나 일치하는 확장 기능(null)이 없으면 필터가 호출되지 않습니다.
attributes/schema
예를 들어 사용자 지정 렌더 필터가 저장된 참조를 확인할 때, bs_block_schema()JSON 스키마를 조정합니다.
add_filter('blockstudio/blocks/attributes/schema', function($schema, $name) {
return $schema;
}, 10, 2);
스키마 배열을 반환합니다. 블록에 Blockstudio 필드나 일치하는 확장(null)이 없으면 필터가 호출되지 않습니다.
attributes/populate
이 필터를 사용하면 checkbox, select 또는 radio 필드 옵션에 사용자 지정 데이터를 추가할 수 있습니다. 자세한 내용은 옵션 채우기를 참조하세요.
이 필터는 인수 하나를 받습니다. "populate": {"type": "custom", "custom": "myCustomOptions"}에서 사용한 이름을 키로 삼아 모든 사용자 지정 데이터 세트를 담은 배열입니다.
add_filter('blockstudio/blocks/attributes/populate', function($options) {
$options['myCustomOptions'] = [
['value' => '1', 'label' => 'Option 1'],
['value' => '2', 'label' => 'Option 2'],
];
return $options;
});
components/use_block_props/render
이 필터를 사용하면 useBlockProps 콘텐츠의 출력을 조정할 수 있습니다.
모든 구성 요소 필터(use_block_props, inner_blocks 및 rich_text)는 마지막 인수로 블록을 받습니다. $block은 렌더링 중인 블록에 등록된 WP_Block_Type이므로 $block->name은 블록 이름입니다. 예를 들면 acme/hero입니다.
$props은 배열이 아니라 HTML 속성의 문자열입니다. 프런트엔드에서는 get_block_wrapper_attributes()의 결과이며, 예를 들면 class="wp-block-acme-hero my-class"입니다. 편집기에서는 요소의 class 속성입니다. 문자열을 반환하세요. 편집기에서는 반환된 문자열의 class 속성만 적용됩니다.
add_filter('blockstudio/blocks/components/use_block_props/render', function($props, $block) {
if ($block->name !== 'acme/hero') {
return $props;
}
return str_replace('class="', 'class="my-custom-class ', $props);
}, 10, 2);
components/inner_blocks/render
이 필터를 사용하면 <InnerBlocks /> 콘텐츠의 출력을 조정할 수 있습니다.
add_filter('blockstudio/blocks/components/inner_blocks/render', function($content, $block) {
return '<div class="inner-wrapper">' . $content . '</div>';
}, 10, 2);
components/inner_blocks/frontend/wrap
이 필터를 사용하면 프런트엔드에서 <InnerBlocks /> 래퍼를 제거할 수 있습니다.
add_filter('blockstudio/blocks/components/inner_blocks/frontend/wrap', function($wrap, $block) {
return false; // Remove wrapper
}, 10, 2);
components/rich_text/render
이 필터를 사용하면 <RichText /> 콘텐츠의 출력을 조정할 수 있습니다. 속성 값과 블록을 받습니다.
add_filter('blockstudio/blocks/components/rich_text/render', function($content, $block) {
return wp_kses_post($content);
}, 10, 2);
블록 태그
blockstudio/block_tags/builders
이 필터는 블록 태그와 blockstudio/parser/element_mapping을 통해 선택한 사용자 지정 블록에서 사용하는 블록 배열 빌더를 등록합니다. 각 빌더는 파싱된 속성과 원시 내부 콘텐츠를 받습니다.
add_filter('blockstudio/block_tags/builders', function($builders, $parser) {
$builders['theme/paragraph'] = function(array $attributes, string $inner) {
$attributes['content'] = trim($inner);
return [
'blockName' => 'theme/paragraph',
'attrs' => [
'blockstudio' => [
'attributes' => $attributes,
],
],
'innerBlocks' => [],
'innerHTML' => '',
'innerContent' => [],
];
};
return $builders;
}, 10, 2);
호환되는 blockstudio/block_tags/renderers 및 blockstudio/parser/renderers 필터는 이 훅 뒤에 실행되며 같은 블록 이름을 재정의할 수 있습니다.
blockstudio/block_tags/tag_aliases
이 필터를 사용하면 원시 HTML 대체 처리가 이루어지기 전에 실제 블록 이름으로 해석되는 사용자 지정 대시형 작성 태그를 등록할 수 있습니다. 테마에서 간결한 프로젝트별 태그를 제공하면서 표준 Blockstudio 또는 코어 블록을 계속 렌더링하려는 경우 유용합니다.
add_filter('blockstudio/block_tags/tag_aliases', function($aliases) {
$aliases['theme-button'] = 'bsui/button';
$aliases['theme-card'] = 'theme/card';
return $aliases;
});
<theme-button href="/download" label="Download" />
<theme-card title="Fast authoring">
<p>Children are parsed as nested blocks.</p>
</theme-card>
blockstudio/block_tags/prefixes
이 필터를 사용하면 접두사 축약형을 하나 이상의 블록 네임스페이스에 매핑할 수 있습니다. 각 키는 대시가 없는 소문자 접두사입니다. 각 값은 네임스페이스 문자열 또는 순서가 지정된 네임스페이스 목록일 수 있습니다.
add_filter('blockstudio/block_tags/prefixes', function($prefixes) {
$prefixes['theme'] = ['theme-components', 'bsui'];
return $prefixes;
});
<theme-card title="Homepage" />
<theme-button label="Get started" />
<theme-ui-feature-matrix />
<theme-card>은 theme-components/card로 해석됩니다. <theme-button>는 먼저 theme-components/button을 시도한 다음 bsui/button로 대체합니다. 명시적 blockstudio/block_tags/tag_aliases 항목은 같은 태그에서 우선하며, 해석되지 않은 접두사 태그는 변경되지 않습니다.
접두사는 조합할 수 있습니다. 접두사 태그가 직접 해석되지 않고 해당 슬러그 자체가 등록된 접두사 태그라면 해석을 재귀적으로 진행합니다. theme => ['theme-components'] 및 ui => ['bsui']이 있으면 <theme-ui-input>는 ui 접두사로 넘어가 bsui/input로 해석됩니다. 등록된 접두사 태그와 별칭 태그는 페이지 콘텐츠뿐 아니라 블록 템플릿 출력에서도 렌더링됩니다.
설정
경로
이 필터를 사용하면 blockstudio.json 파일의 경로를 조정할 수 있습니다. 기본적으로 현재 활성 테마 내의 blockstudio.json입니다.
add_filter('blockstudio/settings/path', function() {
return get_stylesheet_directory() . '/config/blockstudio.json';
});
users/ids
이 필터를 사용하면 특정 사용자 ID에 대해 편집기를 활성화할 수 있습니다.
add_filter('blockstudio/settings/users/ids', function() {
return [1];
});
users/roles
이 필터를 사용하면 특정 사용자 역할에 대해 편집기를 활성화할 수 있습니다.
add_filter('blockstudio/settings/users/roles', function() {
return ['administrator', 'editor'];
});
assets/enqueue
이 필터를 사용하면 프런트엔드와 편집기에서 에셋을 대기열에 추가할지 여부를 설정할 수 있습니다.
add_filter('blockstudio/settings/assets/enqueue', function() {
return false;
});
assets/reset/enabled
이 필터를 사용하면 WordPress 코어 블록 스타일 및 편집기 유틸리티 레이아웃 초기화를 제거할지 여부를 설정할 수 있습니다.
add_filter('blockstudio/settings/assets/reset/enabled', function() {
return true;
});
assets/reset/full_width
이 필터를 사용하면 전체 너비 편집을 사용하는 글 유형을 제어할 수 있습니다.
add_filter('blockstudio/settings/assets/reset/full_width', function() {
return ['page'];
});
assets/minify/css
이 필터를 사용하면 CSS을 축소할지 여부를 설정할 수 있습니다.
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
assets/minify/js
이 필터를 사용하면 JS을 축소할지 여부를 설정할 수 있습니다.
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
assets/process/scss
이 필터를 사용하면 .css 파일에서 SCSS을 처리할지 여부를 설정할 수 있습니다.
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
assets/process/scss_files
이 필터를 사용하면 .scss 파일을 CSS로 처리할지 여부를 설정할 수 있습니다.
add_filter('blockstudio/settings/assets/process/scss_files', function() {
return true;
});
assets/output
이 필터를 사용하면 컴파일된 블록 에셋을 저장할 위치를 제어할 수 있습니다.
add_filter('blockstudio/settings/assets/output', function() {
return 'cache';
});
assets/inline_limit
페이지마다 인라인 처리할 외부 블록 CSS의 바이트 수를 제어하는 필터입니다.
add_filter('blockstudio/settings/assets/inline_limit', function() {
return 40000;
});
cache/enabled
이 필터를 사용하면 Blockstudio 파일 기반 런타임 및 편집기 에셋 캐시를 모두 활성화하거나 비활성화할 수 있습니다.
add_filter('blockstudio/settings/cache/enabled', function() {
return false;
});
cache/path
이 필터를 사용하면 Blockstudio 파일 기반 캐시 디렉터리를 변경할 수 있습니다.
add_filter('blockstudio/settings/cache/path', function() {
return 'cache/blockstudio';
});
cache/namespace_grace
이 필터를 사용하면 폐기된 캐시 네임스페이스를 정리하기 전까지 보관할 기간을 변경할 수 있습니다.
add_filter('blockstudio/settings/cache/namespace_grace', function() {
return 777600;
});
githooks/commit
이 필터는 Blockstudio 소유의 PHPStan 커밋 훅이 활성화되어 있는지 확인합니다.
add_filter('blockstudio/settings/githooks/commit', function() {
return true;
});
content/enabled
이 필터를 사용하면 콘텐츠 동기화를 활성화하거나 비활성화할 수 있습니다.
add_filter('blockstudio/settings/content/enabled', function() {
return true;
});
content/id
이 필터를 사용하면 콘텐츠 동기화 소유권 네임스페이스를 설정할 수 있습니다.
add_filter('blockstudio/settings/content/id', function() {
return 'docs';
});
content/path
이 필터를 사용하면 콘텐츠 동기화 파일 디렉터리를 설정할 수 있습니다.
add_filter('blockstudio/settings/content/path', function() {
return 'content';
});
content/include_page_sync_managed
이 필터를 사용하면 페이지 동기화가 관리하는 글을 포함하거나 제외할 수 있습니다.
add_filter('blockstudio/settings/content/include_page_sync_managed', function() {
return false;
});
content/authors
이 필터를 사용하면 콘텐츠 동기화 작성자 처리를 구성할 수 있습니다.
add_filter('blockstudio/settings/content/authors', function() {
return 'ignore';
});
content/post_types
이 필터를 사용하면 콘텐츠 동기화 글 유형 허용 목록을 구성할 수 있습니다.
add_filter('blockstudio/settings/content/post_types', function() {
return ['team_member'];
});
content/taxonomies
이 필터를 사용하면 콘텐츠 동기화 분류 허용 목록을 구성할 수 있습니다.
add_filter('blockstudio/settings/content/taxonomies', function() {
return ['category', 'post_tag'];
});
content/media
이 필터를 사용하면 콘텐츠 동기화 미디어 처리를 구성할 수 있습니다.
add_filter('blockstudio/settings/content/media', function() {
return 'manifest';
});
tailwind/enabled
이 필터를 사용하면 Tailwind을 활성화하거나 비활성화할 수 있습니다.
add_filter('blockstudio/settings/tailwind/enabled', function() {
return true;
});
tailwind/config
이 필터를 사용하면 사용자 지정 Tailwind CSS 설정을 추가할 수 있습니다.
add_filter('blockstudio/settings/tailwind/config', function() {
return '@theme { --color-primary: pink; }';
});
tailwind/output
이 필터를 사용하면 Tailwind CSS 출력을 인라인 또는 링크 방식으로 선택할 수 있습니다.
add_filter('blockstudio/settings/tailwind/output', function() {
return 'link';
});
ui/enabled
이 필터를 사용하면 번들로 제공되는 UI 구성 요소를 활성화하거나 비활성화할 수 있습니다.
add_filter('blockstudio/settings/ui/enabled', function() {
return true;
});
editor/format_on_save
이 필터를 사용하면 저장할 때 코드 서식을 지정할지 여부를 설정할 수 있습니다.
add_filter('blockstudio/settings/editor/format_on_save', function() {
return true;
});
editor/assets
이 필터를 사용하면 편집기에 추가 에셋을 대기열에 추가할 수 있습니다.
add_filter('blockstudio/settings/editor/assets', function() {
return ['my-stylesheet', 'another-stylesheet'];
});
editor/markup
이 필터를 사용하면 편집기 끝에 추가 마크업을 추가할 수 있습니다.
add_filter('blockstudio/settings/editor/markup', function() {
return '<style>body { background: black; }</style>';
});
block_editor/disable_loading
이 필터를 사용하면 블록 편집기 내부의 블록 로딩을 비활성화할 수 있습니다.
add_filter('blockstudio/settings/block_editor/disable_loading', function() {
return true;
});
block_editor/enhance
이 필터를 사용하면 더 깔끔한 포커스 스타일과 가리키기/선택 윤곽선 같은 Blockstudio 편집기 조작 기능을 활성화할 수 있습니다.
add_filter('blockstudio/settings/block_editor/enhance', function() {
return true;
});
block_editor/css_classes
이 필터를 사용하면 클래스 필드에서 선택할 수 있도록 클래스가 포함된 스타일시트를 추가할 수 있습니다.
add_filter('blockstudio/settings/block_editor/css_classes', function() {
return ['my-stylesheet', 'another-stylesheet'];
});
block_editor/css_variables
이 필터를 사용하면 CSS 변수를 코드 필드에서 자동 완성에 사용할 수 있도록 스타일시트를 추가할 수 있습니다.
add_filter('blockstudio/settings/block_editor/css_variables', function() {
return ['my-stylesheet', 'another-stylesheet'];
});
block_editor/blocks/allow
이 필터를 사용하면 삽입 도구에서 허용되는 블록 이름을 제어할 수 있습니다.
add_filter('blockstudio/settings/block_editor/blocks/allow', function() {
return ['core/*', 'acf/*', 'my-theme/*'];
});
block_editor/blocks/deny
이 필터를 사용하면 삽입 도구에서 블록 이름을 제거할 수 있습니다.
add_filter('blockstudio/settings/block_editor/blocks/deny', function() {
return ['core/embed', 'core/freeform'];
});
block_editor/blocks/directory
이 필터를 사용하면 편집기에서 WordPress 블록 디렉터리 에셋을 활성화하거나 비활성화할 수 있습니다.
add_filter('blockstudio/settings/block_editor/blocks/directory', function() {
return false;
});
block_editor/blocks/categories/allow
이 필터를 사용하면 계속 사용할 수 있는 블록 카테고리 슬러그를 제어할 수 있습니다.
add_filter('blockstudio/settings/block_editor/blocks/categories/allow', function() {
return ['text', 'media', 'design'];
});
block_editor/blocks/categories/deny
이 필터를 사용하면 삽입 도구에서 블록 카테고리 슬러그를 제거할 수 있습니다.
add_filter('blockstudio/settings/block_editor/blocks/categories/deny', function() {
return ['embed'];
});
block_editor/blocks/categories/rename
이 필터를 사용하면 슬러그를 기준으로 블록 카테고리 레이블을 변경할 수 있습니다.
add_filter('blockstudio/settings/block_editor/blocks/categories/rename', function() {
return [
'text' => 'Writing',
'design' => 'Layout'
];
});
block_editor/blocks/categories/order
이 필터를 사용하면 삽입 도구에서 블록 카테고리 슬러그의 순서를 지정할 수 있습니다.
add_filter('blockstudio/settings/block_editor/blocks/categories/order', function() {
return ['my-theme', 'text', 'media'];
});
block_editor/blocks/styles/deny
이 필터를 사용하면 블록 이름을 기준으로 PHP이 등록한 블록 스타일을 등록 해제할 수 있습니다.
add_filter('blockstudio/settings/block_editor/blocks/styles/deny', function() {
return [
'my-theme/card' => ['outline'],
'my-theme/media' => ['framed']
];
});
block_editor/blocks/legacy_widgets/hide
이 필터를 사용하면 레거시 위젯 블록에서 추가 레거시 위젯을 숨길 수 있습니다.
add_filter('blockstudio/settings/block_editor/blocks/legacy_widgets/hide', function() {
return ['archives', 'calendar'];
});
block_editor/patterns/core
이 필터를 사용하면 WordPress 코어 블록 패턴을 활성화하거나 비활성화할 수 있습니다.
add_filter('blockstudio/settings/block_editor/patterns/core', function() {
return false;
});
block_editor/patterns/remote
이 필터를 사용하면 WordPress 패턴 디렉터리의 원격 패턴을 활성화하거나 비활성화할 수 있습니다.
add_filter('blockstudio/settings/block_editor/patterns/remote', function() {
return false;
});
block_editor/patterns/theme
이 필터를 사용하면 테마에서 제공하는 블록 패턴을 활성화하거나 비활성화할 수 있습니다.
add_filter('blockstudio/settings/block_editor/patterns/theme', function() {
return false;
});
block_editor/patterns/blockstudio
이 필터를 사용하면 Blockstudio 파일 기반 패턴을 활성화하거나 비활성화할 수 있습니다.
add_filter('blockstudio/settings/block_editor/patterns/blockstudio', function() {
return false;
});
block_editor/patterns/categories/allow
이 필터를 사용하면 계속 사용할 수 있는 패턴 카테고리 슬러그를 제어할 수 있습니다.
add_filter('blockstudio/settings/block_editor/patterns/categories/allow', function() {
return ['featured', 'buttons', 'columns'];
});
block_editor/patterns/categories/deny
이 필터를 사용하면 패턴 삽입 도구에서 패턴 카테고리 슬러그를 제거할 수 있습니다.
add_filter('blockstudio/settings/block_editor/patterns/categories/deny', function() {
return ['gallery'];
});
block_editor/patterns/categories/rename
이 필터를 사용하면 슬러그를 기준으로 패턴 카테고리 레이블을 변경할 수 있습니다.
add_filter('blockstudio/settings/block_editor/patterns/categories/rename', function() {
return [
'featured' => 'Featured Layouts'
];
});
block_editor/patterns/categories/order
이 필터를 사용하면 삽입 도구에서 패턴 카테고리 슬러그의 순서를 지정할 수 있습니다.
add_filter('blockstudio/settings/block_editor/patterns/categories/order', function() {
return ['featured', 'buttons'];
});
block_editor/media/openverse
이 필터를 사용하면 블록 편집기 미디어 삽입 도구에서 Openverse 미디어 카테고리를 활성화하거나 비활성화할 수 있습니다.
add_filter('blockstudio/settings/block_editor/media/openverse', function() {
return false;
});
block_editor/media/image_sizes/allow
이 필터를 사용하면 편집기 미디어 컨트롤에서 계속 사용할 수 있는 이미지 크기 이름을 제어할 수 있습니다.
add_filter('blockstudio/settings/block_editor/media/image_sizes/allow', function() {
return ['thumbnail', 'large'];
});
block_editor/media/image_sizes/deny
이 필터를 사용하면 편집기 미디어 컨트롤에서 이미지 크기 이름을 제거할 수 있습니다.
add_filter('blockstudio/settings/block_editor/media/image_sizes/deny', function() {
return ['medium_large'];
});
ai/enable_context_generation
이 필터를 사용하면 LLM 도구 통합을 위한 컨텍스트 파일 생성을 활성화하거나 비활성화할 수 있습니다. 활성화하면 컨텍스트 파일은 최신 블록 데이터, 현재 설치의 Blockstudio 설정, 관련된 모든 스키마 및 Blockstudio 문서를 하나의 소스로 모아 AI 개발 도구에서 사용할 수 있도록 합니다.
add_filter('blockstudio/settings/ai/enable_context_generation', function() {
return true;
});
block_tags/enabled
이 필터를 사용하면 페이지 수준의 블록 태그 렌더링을 활성화하거나 비활성화할 수 있습니다.
add_filter('blockstudio/settings/block_tags/enabled', function() {
return true;
});
block_tags/prefixes
이 필터를 사용하면 블록 태그의 접두사를 네임스페이스 축약형에 등록할 수 있습니다.
add_filter('blockstudio/settings/block_tags/prefixes', function() {
return [
'theme' => ['theme-components', 'bsui']
];
});
dev/grab/enabled
이 필터를 사용하면 요소 그래버를 활성화하거나 비활성화할 수 있습니다.
add_filter('blockstudio/settings/dev/grab/enabled', function() {
return false;
});
dev/perf
이 필터를 사용하면 성능 프로파일러를 활성화하거나 비활성화할 수 있습니다.
add_filter('blockstudio/settings/dev/perf', function() {
return false;
});
dev/canvas/enabled
이 필터를 사용하면 캔버스를 활성화하거나 비활성화할 수 있습니다.
add_filter('blockstudio/settings/dev/canvas/enabled', function() {
return false;
});
dev/canvas/admin_bar
이 필터를 사용하면 캔버스에서 WordPress 관리자 표시줄을 표시하거나 숨길 수 있습니다.
add_filter('blockstudio/settings/dev/canvas/admin_bar', function() {
return true;
});
WPML
blockstudio/wpml/config/label
wp bs wpml config이 작성하는 각 키의 레이블을 필터링합니다. 컨텍스트 배열에 대해서는 레이블 변경을 참조하세요.
add_filter('blockstudio/wpml/config/label', function($label, $context) {
return str_replace(' (optional)', '', $label);
}, 10, 2);
캔버스
blockstudio/canvas/inventory
이 필터는 선택 항목에 대해 캔버스가 보고하는 인벤토리를 조정합니다. 콜백은 인벤토리 DTO, 원래 선택 항목 및 호출 시 전달된 옵션을 받습니다.
add_filter('blockstudio/canvas/inventory', function(array $result, array $selection, array $options) {
return $result;
}, 10, 3);
blockstudio/canvas/documents
이 필터는 캔버스가 반환하는 렌더링된 문서를 조정하며, 인벤토리 필터와 동일한 세 가지 인수를 받습니다.
blockstudio/canvas/item_loaded
이 액션은 인벤토리 레코드가 로드될 때마다 한 번 실행되며, 인벤토리 유형, 표준 레코드 ID 및 정규화된 레코드를 받습니다.
blockstudio/canvas/source_compiled
이 액션은 캔버스용 소스 파일이 컴파일된 후 실행되며, 선택된 소스 경로와 표준 소스 레코드를 받습니다.
번들 UI
blockstudio/ui/directories
이 필터는 번들 UI 구성 요소를 검색하는 디렉터리를 조정합니다.
blockstudio/ui/inventory
이 필터는 공개 UI 제품군 인벤토리를 조정합니다.
blockstudio/ui/examples
이 필터는 UI 예제 레코드를 조정하며, 예제와 예제의 기반이 된 공개 UI 인벤토리를 받습니다.
토폴로지
blockstudio/blocks/topology_refreshed
이 액션은 블록 토폴로지가 다시 구성된 후 실행됩니다.
blockstudio/pages/topology_refreshed
이 액션은 페이지 토폴로지가 다시 구성된 후 실행됩니다.
blockstudio/pages/layout_error
이 액션은 페이지 레이아웃 렌더링이 실패했을 때 아무런 알림 없이 실패하는 대신 실행됩니다.
런타임
blockstudio/runtime/initialized
이 액션은 런타임이 설정을 확인한 후 실행됩니다.
blockstudio/runtime/changed
이 액션은 확인된 런타임 ID가 변경될 때 실행되며, 이 변경으로 캐시 네임스페이스와 정적 사전 렌더링 상태가 이동합니다.
blockstudio/performance/default_config
이 필터는 프로젝트 자체의 blockstudio.json 값이 적용되기 전에 성능 기본값을 조정합니다.
콘텐츠
blockstudio/content/orphan_action
이 필터는 더 이상 소스가 없는 레코드를 콘텐츠 동기화에서 어떻게 처리할지 결정합니다.
Bootstrap
blockstudio/url
이 필터는 Blockstudio 편집기 및 관리자 에셋에 사용되는 공개 URL을 변경합니다. Composer 통합은 Blockstudio의 자동 로드 파일을 불러오기 전에 이를 등록해야 합니다. 두 번째 인수는 실제 패키지 디렉터리입니다.
add_filter(
'blockstudio/url',
function(string $url, string $directory) {
return get_stylesheet_directory_uri() . '/vendor/blockstudio/blockstudio/';
},
10,
2
);
런타임 캐시
blockstudio/cache/dir
이 필터는 런타임, 편집기 에셋 또는 다른 캐시 범위가 추가되기 전에 확인된 캐시 기본 디렉터리를 받습니다.
add_filter('blockstudio/cache/dir', function(string $directory) {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
blockstudio/cache/context
이 필터는 캐시 ID에 직렬화 가능한 런타임 변형을 추가합니다. 같은 검색 소스에서 서로 다른 논리적 인벤토리를 선택할 수 있는 경우 사용하세요.
add_filter('blockstudio/cache/context', function($context, string $scope) {
return [
'preview' => get_query_var('preview_id'),
'site' => get_current_blog_id(),
];
}, 10, 2);
blockstudio/cache/site_key
이 필터는 자체 테넌트 경계가 있는 호스트의 네트워크/블로그 디렉터리 ID를 변경합니다. 반환된 값은 사용 전에 정제됩니다.
add_filter(
'blockstudio/cache/site_key',
function(string $key, int $networkId, int $blogId) {
return sprintf('tenant-%d-%d', $networkId, $blogId);
},
10,
3
);
blockstudio/runtime/identity
이 필터는 런타임 범위의 모든 객체에 영향을 주는 호스트 정보를 추가합니다. 항목별 소스 지문은 대신 해당 소유 API에서 명시적 종속 항목으로 전달해야 합니다.
add_filter(
'blockstudio/runtime/identity',
function(array $identity, string $scope) {
$identity['deployment'] = getenv('RELEASE_SHA') ?: 'local';
return $identity;
},
10,
2
);
blockstudio/cache/watch_debounce
파일 시스템을 다시 확인하지 않고 검증된 파일 감시 스냅샷을 재사용할 수 있는 시간을 초 단위로 필터링합니다. 기본값은 로컬 및 개발 환경에서 0이고 그 외 환경에서는 20입니다.
add_filter('blockstudio/cache/watch_debounce', function() {
return 30;
});
blockstudio/cache/build_wait_budget
동시 빌더가 런타임 캐시 또는 선택 항목이 채워진 새로 고침을 게시할 때까지 요청이 기다리는 시간을 밀리초 단위로 필터링합니다. 대기 시간이 지나면 요청은 성능 저하 상태로 전환됩니다. 구조 재빌드의 기본값은 5000이고 선택 항목 새로 고침의 기본값은 4000입니다.
add_filter('blockstudio/cache/build_wait_budget', function() {
return 2000;
});
blockstudio/cache/populate_debounce
콘텐츠, 용어, 사용자 또는 메타 쓰기 작업이 한꺼번에 발생했을 때 이를 하나의 선택 항목 새로 고침으로 통합하는 시간을 초 단위로 필터링합니다. 대기 기간 후 첫 쓰기는 즉시 새로 고침을 트리거하며, 한꺼번에 발생한 쓰기 중 마지막 쓰기는 대기 시간이 지나면 반영됩니다. 기본값은 30입니다. 모든 쓰기마다 새로 고치려면 0을 반환하세요.
add_filter('blockstudio/cache/populate_debounce', function() {
return 120;
});
blockstudio/cache/populate_ignored_meta_keys
값을 써도 채워진 선택 항목을 새로 고치지 않는 메타 키를 필터링합니다. 기본적으로 다음 키는 WordPress이 편집 및 로그인 기록을 위해 씁니다. _edit_lock은 게시물이 열려 있는 동안 편집기와 Heartbeat가 새로 고치고, _edit_last는 이미 새로 고침을 수행하는 게시물 저장 시 함께 기록하며, session_tokens은 로그인 및 로그아웃 시 기록합니다. 자주 변경되지만 선택 쿼리에는 영향을 주지 않는 키를 추가하세요.
add_filter('blockstudio/cache/populate_ignored_meta_keys', function(array $keys) {
$keys[] = '_my_view_counter';
return $keys;
});
blockstudio/cache/max_files_per_scope
각 런타임 캐시 범위에 보관되는 게시된 페이로드 수를 필터링합니다.
add_filter('blockstudio/cache/max_files_per_scope', function($maximum, $scope) {
return $scope === 'runtime' ? 50 : $maximum;
}, 10, 2);
blockstudio/cache/compress
캐시 페이로드에 일반 PHP 배열 대신 압축된 직렬화 데이터를 사용할지 필터링합니다. 기본적으로 크기가 1 MiB 이하인 페이로드만 일반 형식을 사용하며, 대상 파일을 캐시할 수 있는 활성 OPcache 공유 메모리가 있을 때만 적용됩니다. 다른 프로세스, 제외된 파일 및 더 큰 페이로드에는 압축이 사용됩니다.
add_filter('blockstudio/cache/compress', function($compress, $scope) {
return $scope === 'runtime' ? false : $compress;
}, 10, 2);
false을 반환하면 크기 제한도 무시됩니다. opcache.enable_cli 없이 WP-CLI이 파일을 준비해 OPcache가 활성화된 웹 작업자에서 사용하도록 할 때 유용할 수 있지만, OPcache가 없는 모든 리더는 생성된 배열을 파싱해야 합니다. 추가 메모리 비용을 감당할 수 있는 경우가 아니라면 공유 페이로드가 클 때는 압축을 유지하세요. 기본 보호 조치는 캐시 페이로드 형식을 참조하세요.
blockstudio/cache/protected_paths
캐시 경로 보존 정리에서는 해당 경로를 절대로 삭제하면 안 됩니다. Blockstudio은 설치된 조기 제공 맵이 참조하는 모든 파일을 넣어 해당 목록을 초기화합니다.
add_filter('blockstudio/cache/protected_paths', function(array $paths, string $scope, string $directory) {
if ('static-prerender' === $scope) {
$paths[] = $directory . '/pinned.html';
}
return $paths;
}, 10, 3);
blockstudio/cache/outcome
이 액션은 hit, build, miss-stale, stale-last-good 또는 write-failure와 같은 공유 캐시 범위 및 결과를 보고합니다.
add_action('blockstudio/cache/outcome', function(string $scope, string $reason) {
my_metrics()->increment("blockstudio.cache.{$scope}.{$reason}");
}, 10, 2);
blockstudio/static_prerender/request_bypass
이 필터는 서버 및 쿠키 입력과 함께 최종 익명 안전성 결정을 받습니다. true을 반환하면 정적 제공과 생성을 항상 건너뜁니다.
add_filter(
'blockstudio/static_prerender/request_bypass',
function(bool $bypass, array $server, array $cookies) {
return $bypass || isset($cookies['commerce_session']);
},
10,
3
);
blockstudio/static_prerender/public_urls
이 필터는 예약된 워밍업 및 명시적 그래프 도구에서 사용하는 전체 공개 URL 인벤토리를 제공하거나 조정합니다.
add_filter('blockstudio/static_prerender/public_urls', function(array $urls) {
$urls[] = home_url('/custom-route/');
return array_values(array_unique($urls));
});
필터가 반환하는 값은 최종 인벤토리가 아닙니다. 결과는 캐시 가능성 검사 과정을 거치며, 여기서 구성된 동적 경로와 기본적으로 제외되는 다음 항목이 제거됩니다. /wp-admin, /wp-json, /wp-login.php, /xmlrpc.php, /feed/를 포함하는 모든 경로, 그리고 사이트의 홈 경로 아래에 있는 검색 기본 경로의 검색 결과(기본값 /search/). 따라서 추가한 URL이 경고 없이 제외될 수 있습니다. 예상한 경로가 생성된 인벤토리에 없다면 필터가 실행되지 않았다고 단정하기 전에 해당 경로가 이 규칙에 걸리는지 확인하세요.
blockstudio/static_prerender/render_internal
이 필터는 선택적 프로세스 내 일괄 전송을 구현합니다. 정규화된 결과 배열을 반환하거나 값을 변경하지 않고 두면 렌더러가 구성된 HTTP 대체 방법을 사용합니다. 결과에는 html이 포함되며, 선택적으로 status, dependencies, virtualHashes, headers도 포함됩니다. performance.staticPrerender.replayHeaders에 지정된 헤더는 문서와 함께 저장됩니다.
add_filter(
'blockstudio/static_prerender/render_internal',
function($result, string $url, array $options) {
return my_static_renderer()->render($url, $options);
},
10,
3
);
blockstudio/static_prerender/cacheable_html
이 필터는 Blockstudio이 출력이 캐시 금지 표시가 없는 완전한 HTML 문서인지, 관찰된 응답 상태가 성공인지 확인한 후 최종 결정을 내립니다. 세 번째 인수는 관찰된 상태이며, 상태가 지정되지 않은 경우 null입니다.
add_filter('blockstudio/static_prerender/cacheable_html', function(bool $cacheable, string $html, ?int $status) {
return $cacheable && !str_contains($html, 'data-personalized');
}, 10, 3);
blockstudio/static_prerender/outcome
이 액션은 정적 사전 렌더링의 적중, 누락, 쓰기, 그래프 쓰기, 오래된 항목 및 실패 결과를 보고합니다.
add_action('blockstudio/static_prerender/outcome', function(string $reason) {
my_metrics()->increment("blockstudio.prerender.{$reason}");
});
blockstudio/tailwind/cache_max_files
컴파일된 Tailwind CSS 항목의 최대 개수를 필터링합니다. 기본값은 1000입니다.
add_filter('blockstudio/tailwind/cache_max_files', function() {
return 1500;
});
blockstudio/tailwind/cache_max_age
컴파일된 Tailwind CSS 항목의 최대 보관 기간을 초 단위로 필터링합니다. 기본값은 30일이며 최소값은 1시간입니다.
add_filter('blockstudio/tailwind/cache_max_age', function() {
return 14 * DAY_IN_SECONDS;
});
관리자
활성화
이 필터를 사용하면 도구 > Blockstudio 아래에 있는 Blockstudio 관리 페이지를 활성화하거나 비활성화할 수 있습니다.
add_filter('blockstudio/admin/enabled', function() {
return false;
});
에셋
editor/canvas/body_class
에셋 초기화가 활성화된 경우 이 필터는 블록 편집기 캔버스에 복사되는 정제된 프런트엔드 body 클래스를 조정합니다.
add_filter('blockstudio/editor/canvas/body_class', function(array $classes) {
return array_values(array_diff($classes, ['logged-in']));
});
활성화
이 필터를 사용하면 특정 에셋 유형의 처리 및 대기열 추가를 비활성화할 수 있습니다.
add_filter('blockstudio/assets/enable', function($enable, $type, $block) {
if ($type === 'css' && $block['name'] === 'my/block') {
return false;
}
return $enable;
}, 10, 3);
비활성화
이 필터를 사용하면 ID를 기준으로 특정 에셋을 비활성화할 수 있습니다. 반환된 배열의 ID와 일치하는 에셋은 프런트엔드에서 렌더링되지 않습니다.
add_filter('blockstudio/assets/disable', function($disabled) {
$disabled[] = 'my-block-style';
return $disabled;
});
process/scss/import_paths
이 필터를 사용하면 SCSS 컴파일러의 @import 문에 추가 경로를 추가할 수 있습니다.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_stylesheet_directory() . '/scss';
return $paths;
});
process/scss/prelude
이 필터를 사용하면 각 SCSS 파일을 컴파일하기 전에 공유 Sass 코드를 앞에 추가할 수 있습니다.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
process/css/content
이 필터를 사용하면 CSS 파일을 컴파일하기 전에 내용을 조정할 수 있습니다.
add_filter('blockstudio/assets/process/css/content', function($content, $block) {
return str_replace('old-class', 'new-class', $content);
}, 10, 2);
process/js/content
이 필터를 사용하면 JS 파일을 컴파일하기 전에 내용을 조정할 수 있습니다.
add_filter('blockstudio/assets/process/js/content', function($content, $block) {
return $content;
}, 10, 2);
버퍼
활성화
Blockstudio은 프런트엔드 응답을 버퍼링하여 본문 내부에서 렌더링된 블록 스타일 및 스크립트 태그를 head와 footer로 이동하고, Tailwind이 전체 문서를 검사할 수 있게 합니다. 버퍼링은 모든 프런트엔드 요청에서 문서 전체를 보관하고 검사한다는 뜻입니다. Blockstudio 블록 에셋을 렌더링하지 않고 Tailwind도 사용하지 않는 사이트는 둘 다 건너뛰도록 false을 반환할 수 있습니다.
add_filter('blockstudio/buffer/enabled', '__return_false');
관리자 화면과 사용자 정의 도구 미리보기에서는 버퍼링도 꺼져 있습니다. wp_enqueue_scripts 이상에서 bs_is_buffering()을 호출하면 현재 응답이 버퍼링되는지 확인할 수 있습니다. template_redirect에서 결정이 내려지기 전에는 false를 반환합니다.
출력
이 필터는 전송 전에 버퍼링된 전체 HTML 문서를 받습니다. Blockstudio 자체 에셋 이동은 우선순위 1000000에서 실행되고 Tailwind 컴파일은 999999에서 실행되므로, 이들보다 먼저 문서를 확인하려면 더 이른 우선순위로, 최종 출력을 확인하려면 더 늦은 우선순위로 실행하세요.
add_filter('blockstudio/buffer/output', function(string $html) {
return $html;
}, 2000000);
렌더링
종속 항목
이 필터는 Blockstudio이 블록을 렌더링할 때마다 선택된 템플릿 및 에셋 종속 항목을 보고합니다. 정적 내보내기 도구 및 기타 프로세스 내 종속 항목 수집기에 유용합니다.
add_filter(
'blockstudio/render/dependencies',
function($paths, $name, $block, $isEditor, $isPreview) {
my_dependency_graph()->add($name, $paths);
return $paths;
},
10,
5
);
전역
이 필터를 사용하면 페이지를 렌더링하기 전에 출력을 조정할 수 있습니다.
add_filter('blockstudio/render', function($content) {
return $content;
});
헤드
이 필터를 사용하면 <head> 태그가 렌더링되기 전에 출력을 조정할 수 있습니다. 응답을 Blockstudio이 버퍼링하는 경우에만 실행됩니다. bs_is_buffering()을 참조하세요.
add_filter('blockstudio/render/head', function($content) {
return $content . '<meta name="custom" content="value">';
});
푸터
이 필터를 사용하면 렌더링 전에 </body>의 출력을 조정할 수 있습니다.
add_filter('blockstudio/render/footer', function($content) {
return $content . '<script>console.log("loaded")</script>';
});
오류 처리
error/logged
오류가 기록된 후 실행되는 액션입니다. 이 액션을 사용하면 외부 로깅 서비스로 오류를 전송할 수 있습니다.
add_action('blockstudio/error/logged', function($message, $level, $context) {
if ($level === 'error') {
my_external_logger($message, $context);
}
}, 10, 3);
error/exception
예외가 처리된 후 실행되는 액션입니다.
add_action('blockstudio/error/exception', function($exception, $context) {
my_error_tracker($exception);
}, 10, 2);
데이터베이스
모든 데이터베이스 훅은 단일 $params 배열을 받습니다.
db/before_create
레코드가 생성되기 전에 실행되는 액션입니다.
add_action('blockstudio/db/before_create', function($params) {
// $params: block, schema, data, storage
});
db/after_create
레코드가 생성된 후 실행되는 액션입니다.
add_action('blockstudio/db/after_create', function($params) {
// $params: block, schema, record, storage
wp_mail($params['record']['email'], 'Welcome!', 'Thanks for subscribing.');
});
db/before_update
레코드가 업데이트되기 전에 실행되는 액션입니다.
add_action('blockstudio/db/before_update', function($params) {
// $params: block, schema, id, data, storage
});
db/after_update
레코드가 업데이트된 후 실행되는 액션입니다.
add_action('blockstudio/db/after_update', function($params) {
// $params: block, schema, id, record, storage
});
db/before_delete
레코드가 삭제되기 전에 실행되는 액션입니다.
add_action('blockstudio/db/before_delete', function($params) {
// $params: block, schema, id, storage
});
db/after_delete
레코드가 삭제된 후 실행되는 액션입니다.
add_action('blockstudio/db/after_delete', function($params) {
// $params: block, schema, id, storage
});
RPC
모든 RPC 훅은 단일 $params 배열을 받습니다.
rpc/before_call
RPC 함수가 호출되기 전에 실행되는 액션입니다.
add_action('blockstudio/rpc/before_call', function($params) {
// $params: block, function, params
});
rpc/after_call
RPC 함수가 호출된 후 실행되는 액션입니다.
add_action('blockstudio/rpc/after_call', function($params) {
// $params: block, function, params, result
});