본문으로 건너뛰기

속성 필터링

Blockstudio은 블록 속성을 필터링하는 두 가지 메서드를 제공합니다.

속성 정의

blockstudio/blocks/attributes은 각 필드 정의를 필터링하고, Blockstudio은 블록을 빌드하고 등록합니다. 이를 사용해 편집기 컨트롤, 기본값, 조건, 옵션, 렌더링 중 값을 검증하는 데 사용되는 정의를 조정할 수 있습니다.

PHP
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이 템플릿에 저장된 값을 가져올 때도 유효합니다.

PHP
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는 필드 하나의 확인된 값을 블록 템플릿에 전달하기 직전에 필터링합니다. 모든 필드에 한 번씩 실행되므로 콜백은 값, 필드 키, 블록 데이터를 받습니다.

PHP
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의 블록 이름만 받습니다. 이 헬퍼는 렌더링 횟수 카운터나 렌더링 전용 메타데이터를 생성하지 않습니다.