속성 필터링
Blockstudio은 블록 속성을 필터링하는 두 가지 메서드를 제공합니다.
속성 정의
blockstudio/blocks/attributes은 각 필드 정의를 필터링하고, Blockstudio은 블록을 빌드하고 등록합니다. 이를 사용해 편집기 컨트롤, 기본값, 조건, 옵션, 렌더링 중 값을 검증하는 데 사용되는 정의를 조정할 수 있습니다.
add_filter('blockstudio/blocks/attributes', function($attribute, $block) {
if (
($block['name'] ?? '') === 'my-theme/code-block' &&
($attribute['id'] ?? '') === 'lineNumbers'
) {
$attribute['default'] = true;
$attribute['conditions'] = [
[
[
'id' => 'language',
'operator' => '==',
'value' => 'css'
]
]
];
}
return $attribute;
}, 10, 2);
위 코드는 lineNumbers의 기본값을 true로 설정하고, language가 css로 설정되지 않으면 필드를 숨깁니다.
콜백은 호출될 때마다 중첩된 그룹 및 반복 필드를 포함해 필드 정의 하나를 받습니다. 블록을 등록할 때 실행되며, 프런트엔드 렌더링마다 실행되지는 않습니다.
필터링된 옵션 정의는 렌더링 속성 맵에도 사용됩니다. 예를 들어 select, radio 또는 checkbox 필드에 추가한 옵션은 편집기에서 사용할 수 있으며, Blockstudio이 템플릿에 저장된 값을 가져올 때도 유효합니다.
add_filter('blockstudio/blocks/attributes', function($attribute, $block) {
if (
($block['name'] ?? '') === 'bsui/button' &&
($attribute['id'] ?? '') === 'variant'
) {
$attribute['options'][] = [
'label' => 'Brand',
'value' => 'brand',
];
}
return $attribute;
}, 10, 2);
렌더링된 값
blockstudio/blocks/attributes/render는 필드 하나의 확인된 값을 블록 템플릿에 전달하기 직전에 필터링합니다. 모든 필드에 한 번씩 실행되므로 콜백은 값, 필드 키, 블록 데이터를 받습니다.
add_filter('blockstudio/blocks/attributes/render', function($value, $key, $block) {
if (($block['name'] ?? '') === 'my-theme/code-block' && 'lineNumbers' === $key) {
return true;
}
return $value;
}, 10, 3);
위 예제는 lineNumbers에 대해 편집기에 저장된 값을 모두 재정의합니다.
콜백은 세 개의 인수를 받도록 등록해야 합니다(add_filter의 마지막 인수). 그렇지 않으면 WordPress는 값만 전달합니다.
$value: 템플릿이$a[$key]로 받는 형태의 필드 확인 값입니다. 템플릿에 전달할 값을 반환합니다.$key:$a에서 사용되는 필드 키입니다. 반복 필드 행 안에서는 해당 행 내 필드의 ID입니다.$block: 템플릿이$block또는$b로 받는 블록 데이터 배열이며,id,name,postId,postType,index,indexTotal,context및 아일랜드 플래그를 포함합니다. 확장 프로그램을 Blockstudio 블록이 아닌 블록에 적용하면$block에는blockstudio항목(attributes및disabled)만 포함되며name는 없습니다.
이 필터는 Blockstudio 필드가 아닌 속성(예: className 및 anchor)과 파일 필드의 동반 항목인 <id>__size에도 실행되므로, 값을 변경하기 전에 $key를 비교하세요. 반환값은 $key의 값만 대체하며, 필터로 $a에 새 키를 추가할 수는 없습니다.
필드 구성을 변경할 때는 정의 필터를 사용하고, 요청에 대한 템플릿 값을 계산하거나 재정의할 때는 렌더 필터를 사용하세요.
렌더링하지 않고 bs_block_values()를 통해 값을 읽으면, 이 필터는 $block의 블록 이름만 받습니다.
이 헬퍼는 렌더링 횟수 카운터나 렌더링 전용 메타데이터를 생성하지 않습니다.