본문으로 건너뛰기

설정

Blockstudio에는 강력한 설정 API이 포함되어 있어 테마 폴더의 blockstudio.json 파일 및/또는 필터를 통해 옵션을 설정할 수 있습니다. 또한 권한이 있는 사용자는 관리자 영역에서 설정을 시각적으로 변경할 수 있습니다.

JSON을 통한 설정

테마 폴더에 blockstudio.json 파일이 있으면 현재 사이트의 기본 옵션을 설정하는 데 사용됩니다. 파일을 검증하고 IDE에서 자동 완성을 지원하는 JSON 스키마도 제공됩니다.

이 파일은 선택 사항입니다. 파일이 없으면 Blockstudio은 기본 제공 설정에 관리자 영역에 저장된 설정을 적용합니다. 파일의 추가, 변경, 삭제는 자동으로 감지되므로 캐시를 지우거나 수동으로 다시 불러올 필요가 없습니다.

사용 가능한 속성은 다음과 같습니다.

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "users": {
    "ids": [],
    "roles": []
  },
  "assets": {
    "enqueue": true,
    "reset": {
      "enabled": false,
      "fullWidth": []
    },
    "minify": {
      "css": false,
      "js": false
    },
    "process": {
      "scss": false
    }
  },
  "cache": {
    "enabled": true,
    "path": "blockstudio/cache"
  },
  "themeDefaults": {
    "titleTag": false,
    "suppressDirectoryUpdates": false
  },
  "performance": {
    "profile": "compat",
    "wordpress": {
      "headNoise": false,
      "embeds": false,
      "xmlrpc": false,
      "editor": false,
      "frontendAssets": false,
      "media": false,
      "heartbeat": false
    },
    "preload": {
      "links": "off"
    },
    "media": {
      "lazy": false,
      "skeleton": false,
      "metadata": false,
      "rootMargin": "300px"
    },
    "measurement": {
      "enabled": false,
      "queryMonitor": false,
      "headers": false,
      "timings": false
    }
  },
  "content": {
    "enabled": false,
    "id": "default",
    "path": "content",
    "includePageSyncManaged": false,
    "authors": "ignore",
    "postTypes": [],
    "meta": {
      "include": [],
      "exclude": ["_edit_lock", "_edit_last", "_wp_old_slug"],
      "references": {}
    },
    "taxonomies": [],
    "media": "manifest"
  },
  "editor": {
    "formatOnSave": false,
    "assets": [],
    "markup": false
  },
  "tailwind": {
    "enabled": false,
    "config": "",
    "output": "inline"
  },
  "blockTags": {
    "enabled": false,
    "allow": [],
    "deny": [],
    "prefixes": {}
  },
  "ui": {
    "enabled": false
  },
  "blockEditor": {
    "disableLoading": false,
    "enhance": false,
    "cssClasses": [],
    "cssVariables": [],
    "blocks": {
      "allow": [],
      "deny": [],
      "directory": true,
      "categories": {
        "allow": [],
        "deny": [],
        "rename": {},
        "order": []
      },
      "styles": {
        "deny": {}
      },
      "legacyWidgets": {
        "hide": []
      }
    },
    "patterns": {
      "core": true,
      "remote": true,
      "theme": true,
      "blockstudio": true,
      "categories": {
        "allow": [],
        "deny": [],
        "rename": {},
        "order": []
      }
    },
    "media": {
      "openverse": true,
      "imageSizes": {
        "allow": [],
        "deny": []
      }
    }
  },
  "dev": {
    "grab": {
      "enabled": false
    },
    "perf": false,
    "canvas": {
      "enabled": false,
      "adminBar": true
    }
  },
  "githooks": {
    "commit": false
  },
  "phpstan": {
    "preset": "base",
    "configuration": "",
    "roots": ["."],
    "excludePaths": [],
    "maxFiles": 10000
  },
  "ai": {
    "enableContextGeneration": false
  }
}

필터를 통한 설정

또는 blockstudio/settings/${setting} 필터를 사용해 PHP을 통해 옵션을 설정하면 유연성을 높일 수 있습니다.

PHP
add_filter('blockstudio/settings/assets/enqueue', '__return_false');
add_filter('blockstudio/settings/editor/formatOnSave', '__return_true');
add_filter('blockstudio/settings/ui/enabled', '__return_true');
add_filter('blockstudio/settings/block_editor/patterns/remote', '__return_false');

blockstudio/settings/${setting} 필터로 설정한 옵션은 blockstudio.json 파일로 설정한 옵션보다 우선합니다. 두 방법을 함께 사용할 수 있습니다.

런타임 값에는 blockstudio/performance/${setting} 필터와 마지막 blockstudio/performance/config 필터 하나도 포함됩니다. 마지막 필터는 유효한 설정 객체를 반환해야 합니다.

설정 소스의 적용 순서

각 소스를 불러와 우선순위가 낮은 것부터 병합합니다.

  1. 기본 제공 기본값
  2. 관리자 UI을 통해 저장한 설정(blockstudio_settings 옵션)
  3. 테마의 blockstudio.json
  4. blockstudio/settings/* 필터

blockstudio.json은 선언한 키만 재정의합니다. 이전에는 저장된 설정 전체를 대체했기 때문에 파일이 나타나는 순간 관련 없는 관리자 저장 값이 적용되지 않았지만, 이제는 저장된 설정 위에 적용됩니다. 반대로 파일에 해당 키를 선언하거나 저장된 값을 제거할 때까지 관리자 UI을 통해 저장된 오래된 값이 계속 적용됩니다. 설정이 파일의 내용과 다르게 작동하면 wp bs settings 또는 Settings::get_raw()으로 저장된 계층을 확인하세요. 두 명령은 현재 활성화된 JSON 또는 옵션 소스가 명시적으로 선언한 값만 반환합니다.

PHP에서 설정 읽기

Blockstudio\Settings은 활성 소스를 불러오고 잘못된 JSON을 보고하며 blockstudio.json이 변경되면 자동으로 다시 불러옵니다.

PHP
use Blockstudio\Settings;

$enabled = Settings::get_bool('performance/media/lazy');
$margin = Settings::get_string('performance/media/rootMargin', '300px');
$roles = Settings::get_array('users/roles');
$ttl = Settings::get_int('performance/staticPrerender/ttl', 86400);

foreach (Settings::errors() as $error) {
    error_log($error);
}

통합에서 활성 JSON 또는 옵션 소스에 명시적으로 선언된 값만 필요한 경우 Settings::get_raw()를 사용하세요. Settings::fingerprint()는 결정론적인 유효 설정 식별자를 반환합니다. 장시간 실행되는 프로세스에서는 Settings::reload()를 명시적으로 호출해 파일 변경 사항을 즉시 읽을 수 있습니다. 일반적인 액세스에서는 요청 또는 장시간 실행되는 PHP 프로세스 내에서 파일을 초당 최대 한 번 확인하며, 크기가 같은 파일 수정도 감지합니다. 설정된 경로를 바꾸면 다음번 읽기부터 적용됩니다. 활성 JSON 파일이 없으면 저장된 데이터베이스 설정은 이 시간 창으로 지연되지 않습니다.

확정된 성능 프로필은 Blockstudio\Runtime_Settings::current()을 통해 사용할 수 있습니다. 슬래시 또는 점 경로를 지원합니다.

PHP
use Blockstudio\Runtime_Settings;

$runtime = Runtime_Settings::current();

if ($runtime->enabled('measurement/queryMonitor')) {
    $hash = $runtime->hash();
}

사용 가능한 설정

users

옵션 유형 기본값 설명
ids 배열 [] 편집기 접근 권한이 있는 사용자 ID
roles 배열 [] 편집기 접근 권한이 있는 사용자 역할

assets

옵션 유형 기본값 설명
enqueue 부울 true 블록 에셋 자동 대기열 등록
reset.enabled 부울 false 코어 블록 스타일 제거 및 편집기 유틸리티 초기화 적용
reset.fullWidth 배열 [] 전체 너비 편집기 레이아웃을 사용하는 게시물 유형
minify.css 부울 false CSS 출력 최소화
minify.js 부울 false JS 출력 최소화
process.scss 부울 false SCSS 파일 처리
output 문자열 source 컴파일된 에셋을 기록할 위치: source 또는 cache
inlineLimit 정수 0 페이지마다 인라인으로 출력할 외부 블록 CSS의 바이트 수

output의 기본값은 source이며, 각 블록 옆에 _dist 디렉터리를 만듭니다. cache으로 설정하면 컴파일된 자산을 Blockstudio 캐시 디렉터리에 기록하므로 블록 소스 트리를 깔끔하게 유지하고 변경 불가 체크아웃에서 배포할 수 있습니다. 소스 Blockstudio는 이 설정과 관계없이 캐시에 기록하도록 이미 경로가 변경되어 있습니다.

inlineLimit가 0에서 꺼져 있으므로 모든 외부 스타일시트에 <link> 태그가 유지됩니다. 대신 바이트 수를 설정하면 해당 페이지의 외부 블록 스타일시트 중 가장 작은 것부터 인라인으로 출력하며, 전체 크기가 설정한 수를 넘지 않는 경우에만 적용됩니다. 40000은 WordPress 코어가 같은 규칙에 사용하는 한도입니다. 자세한 내용은 작은 스타일시트 인라인 처리를 참조하세요.

reset.enabled이 활성화되면 Blockstudio은 정제된 프런트엔드 body_class 값도 편집기 캔버스에 복사합니다. blockstudio/editor/canvas/body_class을 사용해 편집기 전용 클래스 목록을 조정하세요.

cache

옵션 유형 기본값 설명
enabled 불리언 true Blockstudio 파일 기반 캐시 활성화
path 문자열 "blockstudio/cache" WP_CONTENT_DIR 기준 상대 경로 또는 절대 경로인 캐시 경로
namespaceGrace 정수 86400 폐기된 캐시 네임스페이스를 정리 전까지 보관하는 시간(초)

기본적으로 캐시 파일은 업로드 디렉터리 외부인 wp-content/blockstudio/cache에 기록됩니다. 상대 path 경로는 WP_CONTENT_DIR 기준으로 확인하며, 절대 경로는 그대로 사용합니다. 이를 통해 전용 쓰기 가능 캐시 볼륨을 제공하는 호스트를 지원합니다.

활성화하면 Blockstudio은 빌드 페이로드, 사전 빌드된 블록 등록 데이터, 확인된 편집기 자산, Tailwind CSS, 렌더 문서, 아일랜드 조각, 정적 사전 렌더링, 그래프 인덱스, 대기열, 진단 정보를 이 단일 루트에 저장합니다. 각 객체는 네트워크, 사이트, 전체 런타임 식별자, 범위별로 격리됩니다. 런타임 식별자에는 Blockstudio, 설정, WordPress, PHP, 활성 테마, 활성 플러그인, 논리적 검색 소스, 호스트 컨텍스트, 소유 작업에서 제공하는 명시적 종속성 해시가 포함됩니다.

콘텐츠, 용어, 사용자 및 메타데이터가 변경되면 채워진 필드 선택 항목이 무효화되지만, 블록 구조 탐색이나 컴파일된 에셋은 무효화되지 않습니다. 선택 항목은 고정된 빌드 경로 잠금 아래에서 별도로 새로고침됩니다. 번역 동기화나 가져오기처럼 쓰기가 연속해서 발생하면 하나로 묶입니다. 조용한 기간 이후 첫 쓰기는 즉시 새로고침하고, 연속 쓰기의 마지막 변경 사항은 blockstudio/cache/populate_debounce에 따라 30초가 지나면 한 번 반영됩니다. 게시물 편집 잠금처럼 WordPress에서 기록하는 장부용 메타데이터는 변경 사항으로 간주하지 않습니다. blockstudio/cache/populate_ignored_meta_keys를 사용하면 이 목록을 확장할 수 있습니다. 편집기는 항상 실시간 옵션을 조회하므로, 이 시간 간격은 렌더링 시 읽는 캐시된 선택 항목에만 영향을 줍니다. 소스 파일과 빌드 설정은 여전히 일반적인 방식으로 구조 캐시를 무효화합니다. 선택 항목을 덮어써도 콘텐츠가 변경될 때마다 캐시 디렉터리를 다시 검색하지 않습니다. 주기적인 정리 작업으로 고아 임시 파일은 계속 삭제됩니다. 언어별 런타임 ID는 서로 격리됩니다. 다국어 사이트에 캐시 네임스페이스 디렉터리가 여러 개 있다는 사실만으로 캐시 미스가 발생했다고 볼 수는 없습니다.

SQLite 블록의 db 데이터 디렉터리 안에서 발생한 저널 활동은 캐시된 블록 메타데이터를 폐기하지 않습니다. db.php, 감시 중인 소스 파일 또는 데이터 디렉터리의 소스 파일 및 하위 디렉터리 구조가 변경되면 캐시는 여전히 무효화됩니다.

동시 런타임 재빌드에서는 하나의 빌더가 선출됩니다. 다른 요청은 최대 5초 동안 기다린 뒤 소스 파일과 필요한 컴파일 자산이 여전히 있으면 마지막으로 정상 생성된 블록 메타데이터를 재사용합니다. 안전한 페이로드가 없는 콜드 요청은 다른 빌드를 시작하는 대신 Retry-After이 포함된 HTTP 503을 반환합니다. blockstudio/cache/build_wait_budget 필터는 구조 재빌드와 선택 항목 새로 고침 모두의 대기 시간을 밀리초 단위로 조정합니다. 자문 파일 잠금이 없는 호스트는 보호 없이 선택 항목을 새로 고치고 게시하므로 다음 요청은 캐시를 적중합니다.

이전 버전에서 남은 유휴 키별 .build.lock 파일은 WP-Cron이 이 사이트의 모든 캐시 네임스페이스에서 수거합니다. 업그레이드 5분 후 시작하여 10초 예산 안에 분당 최대 10,000개의 잠금을 제거합니다. wp bs cache status는 남은 수를 보고하고 wp bs cache cleanup은 대기 항목을 즉시 처리하며, wp bs cache clear는 런타임 캐시를 비웁니다. cron이 실행되지 않아 예약된 배치가 10분 넘게 지연되면, 요청이 한 시간에 한 번 제한된 수의 잠금을 정리하여 처리가 멈추지 않도록 합니다. 최근에 사용했거나 점유 중인 잠금은 그대로 두며 새 고정 경로 잠금은 수거하지 않습니다. 대기 항목 처리가 끝나면 같은 배치에서 namespaceGrace이 지난 폐기 캐시 네임스페이스도 사이트별로 최대 한 시간에 한 번 수거하며 이를 위한 일일 주기를 유지합니다. 유예 기간은 네임스페이스가 폐기된 것을 처음 발견한 정리 작업부터 계산하며, 가장 최근 파일 시점부터 계산하지 않습니다. 어떤 범위에서든 아직 현재 사용 중인 네임스페이스는 수거하지 않습니다. 내부 캐시 정리는 WordPress 첨부 파일 삭제 필터를 실행하지 않습니다. WP-Cron이 비활성화된 호스트는 평소 예약된 cron 작업자를 계속 실행해야 합니다. 대기 항목을 비우려고 활성 잠금 파일을 무차별적으로 삭제하지 마세요.

blockstudio/settings/cache/path 설정 필터는 구성된 값을 변경합니다. 배포별 경로를 확인하려면 blockstudio/cache/dir을 사용해 확인된 기본 디렉터리를 필터링하세요.

PHP
add_filter('blockstudio/cache/dir', function (string $directory): string {
    return WP_CONTENT_DIR . '/cache/blockstudio';
});

테넌트 식별자가 WordPress 네트워크/블로그 ID와 다른 호스트는 blockstudio/cache/site_key을 필터링할 수 있습니다. 결과는 정제되어 디렉터리 세그먼트로만 사용됩니다. 런타임 객체 식별자를 변경해야 하는 직렬화 가능한 변형에는 blockstudio/cache/context가 적합합니다.

themeDefaults

옵션 유형 기본값 설명
titleTag 불리언 false WordPress 제목 태그 테마 지원 활성화
suppressDirectoryUpdates 불리언 false 디렉터리 업데이트 결과에서 활성 하위 테마와 상위 테마 제거

패턴은 기존 Blockstudio\Patterns API을 계속 사용합니다. 이 기본값은 대체 페이지 또는 패턴 파사드를 도입하지 않습니다.

performance

compat 프로필은 일반 WordPress 동작을 변경하지 않습니다. speed와 strict은 동일한 선택적 프런트엔드 기본값을 활성화하며, 각 하위 설정은 해당 프로필 값을 재정의할 수 있습니다.

선택적 설정은 등록을 제어합니다. 선택적 기능이 false이면 Blockstudio은 해당 기능의 프런트엔드, 관리자, 편집기, REST 또는 예약 콜백을 연결하지 않습니다. Early Serve 또는 예약 워밍을 사용한 뒤 비활성화하면 해당 기능이 소유한 정리 작업이 한 번 수행되며, 이후 요청은 아무 작업도 하지 않습니다.

옵션 유형 호환 기본값 속도/엄격 기본값 설명
profile 문자열 "compat" 해당 없음 compat, speed 또는 strict
wordpress.headNoise 불리언 false true 일반적인 head 검색 및 이모지 출력을 제거합니다
wordpress.embeds 불리언 false true oEmbed 검색 및 호스트 스크립트를 제거합니다
wordpress.xmlrpc 불리언 false true XML-RPC 및 핑백을 비활성화합니다
wordpress.editor 불리언 false true 원격 편집기 검색 기능을 비활성화합니다
wordpress.frontendAssets 불리언 false true 일반적인 코어 프런트엔드 에셋을 제거합니다
wordpress.media 불리언 false true 이미지 출력 기본값을 적용합니다
wordpress.heartbeat 불리언 false true 편집기 밖에서 Heartbeat를 제한합니다
preload.links 문자열 "off" "intent" 사용자 의도에 따라 동일 출처 문서를 프리페치합니다
media.lazy 불리언 false true Blockstudio의 이미지 로더를 사용합니다
media.skeleton 불리언 false true 기본 제공 로딩 스켈레톤을 표시합니다
media.metadata 불리언 false true assets/media.json 사용을 선언합니다
media.rootMargin 문자열 "300px" "300px" 지연 로더의 교차 영역 여백
measurement.enabled 불리언 false false 런타임 측정 API를 활성화합니다
measurement.queryMonitor 불리언 false false 50ms 이상 걸리는 쿼리를 포함합니다
measurement.headers 불리언 false false 프로필 및 구성 해시 헤더를 전송합니다
measurement.timings 불리언 false false 경과 런타임 헤더를 전송합니다
staticPrerender.enabled 불리언 false false 익명 사용자에게 안전한 HTML 캐싱을 활성화합니다
staticPrerender.ttl 정수 86400 86400 캐시된 문서의 최대 수명(초)
staticPrerender.invalidate 문자열 "signature" "signature" signature 또는 증분 graph ID를 사용합니다
staticPrerender.earlyServe 불리언 false false WordPress가 시작되기 전에 안전한 캐시 적중 응답을 제공합니다
staticPrerender.serveLoggedIn 불리언 false false 사용자는 캐시 적중 결과를 사용할 수 있지만 생성할 수는 없습니다
staticPrerender.dynamicPaths 배열 [] [] 동적 상태를 유지해야 하는 경로 접두사
staticPrerender.replayHeaders 배열 ["Link"] ["Link"] 캐시 적중 시 저장 및 전송할 응답 헤더
staticPrerender.warm.enabled 불리언 false false 영구 예약 워밍 큐를 활성화합니다
staticPrerender.warm.interval 정수 3600 3600 워밍 간격(초)
staticPrerender.warm.concurrency 정수 2 2 한 번의 워밍 작업에서 처리할 최대 작업 수
staticPrerender.warm.transport 문자열 "http" "http" http 또는 호스트가 제공하는 internal 렌더러를 사용합니다

명시적으로 활성화하지 않으면 정적 사전 렌더링은 비활성화된 상태로 유지됩니다. 마스터 스위치가 꺼져 있으면 사전 렌더링 요청 훅이 등록되지 않으며, 비활성화된 earlyServe 및 warm.enabled 스위치는 관리자 또는 cron 훅을 등록하지 않습니다. 서명 모드는 일반 요청에서 비용이 적은 활성화된 식별 방식을 사용합니다. 그래프 모드는 명시적 빌드를 위한 것으로, 페이지별 소스 종속성을 기록하므로 한 페이지가 변경되어도 관련 없는 문서는 무효화되지 않습니다. 워밍, 배포, 조기 제공 및 안전 세부 정보는 정적 사전 렌더링을 참조하세요.

측정값은 프로그래밍 방식으로 사용할 수 있습니다:

PHP
use Blockstudio\Performance_Measurement;

$snapshot = Performance_Measurement::snapshot();

헤더가 활성화되면 Blockstudio는 X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config 및 선택적으로 X-Blockstudio-Performance-Time을 전송합니다. blockstudio/performance/measurement_enabled 작업은 확인된 런타임 설정을 받습니다.

media 옵션은 bs_media_image(), assets/media.json 매니페스트 및 프런트엔드 지연 로더를 제어합니다. 헬퍼, 매니페스트 빌더 및 로더 동작은 미디어를 참조하세요.

content

옵션 유형 기본값 설명
enabled boolean false Content Sync 구성을 활성화합니다
id string "default" 동기화된 엔터티에 저장되는 콘텐츠 세트 네임스페이스
path string "content" 테마 기준 콘텐츠 파일 디렉터리
includePageSyncManaged boolean false 본문을 소유하지 않고 Page Sync가 관리하는 게시물을 포함합니다
authors string "ignore" 작성자 처리 방식(ignore 또는 기존 사용자 login)
postTypes array [] 허용 목록에 포함할 게시물 유형
meta.include array [] 동기화할 메타 키의 Glob 패턴
meta.exclude array ["_edit_lock", "_edit_last", "_wp_old_slug"] 제외할 메타 키의 Glob 패턴
meta.references object {} 선언된 메타 참조를 ID와 UID 간에 다시 씁니다
taxonomies array [] 용어와 관계에 사용할 허용 목록의 등록 분류
media string "manifest" 첨부 파일 참조 동작(manifest 또는 none)

Content Sync는 wp bs content를 통해 관리하며, 허용 목록에 포함된 게시물, postmeta 및 선언된 참조를 이식 가능한 파일로 내보냅니다. 워크플로우와 파일 형식은 Content Sync를 참조하세요.

editor

옵션 유형 기본값 설명
formatOnSave boolean false 저장할 때 block.json 형식을 지정합니다
assets array [] 편집기에서 불러올 추가 에셋
markup boolean false 마크업 편집을 활성화합니다

tailwind

옵션 유형 기본값 설명
enabled boolean false Tailwind CSS 컴파일을 활성화합니다
config string "" Tailwind v4 CSS 우선 구성

컴파일 동작과 CSS 우선 구성 형식은 Tailwind CSS를 참조하세요.

blockTags

옵션 유형 기본값 설명
enabled boolean false 게시물 콘텐츠 및 위젯 영역에서 페이지 수준 bs: 태그 렌더링을 활성화합니다
allow array [] 블록 이름 패턴 허용 목록입니다. fnmatch() 와일드카드를 지원합니다
deny array [] 블록 이름 패턴 차단 목록입니다. allow보다 우선합니다
prefixes object {} 약어의 네임스페이스 접두사입니다. 각 값은 네임스페이스 또는 순서가 있는 배열입니다

템플릿 수준 태그 렌더링은 항상 활성화되어 있으며, 이 옵션은 페이지 수준 대체를 제어합니다. 태그 구문과 확인 규칙은 렌더링을 참조하세요.

ui

옵션 유형 기본값 설명
enabled boolean false 번들로 제공되는 bsui/* UI 구성 요소와 app/* 데모 앱을 등록합니다

blockEditor

옵션 유형 기본값 설명
disableLoading boolean false 편집기에서 블록 로딩을 비활성화합니다
enhance boolean false Blockstudio 편집기의 마우스 오버 및 선택 기능을 활성화합니다
cssClasses array [] 클래스 필드 자동 완성에 사용할 CSS 클래스를 추출할 스타일시트 URL
cssVariables array [] 코드 필드 자동 완성에 사용할 CSS 변수를 추출할 스타일시트 URL

blockEditor.blocks

프로젝트 전체의 블록 삽입기 정책에는 blockEditor.blocks를 사용하세요. allow 및 deny는 core/* 같은 와일드카드 패턴을 포함한 블록 이름을 받습니다.

JSON
{
  "blockEditor": {
    "blocks": {
      "allow": ["core/*", "my-theme/*"],
      "deny": ["core/embed", "core/freeform"],
      "directory": false,
      "categories": {
        "rename": {
          "text": "Writing",
          "design": "Layout"
        },
        "order": ["my-theme", "text", "media"]
      },
      "legacyWidgets": {
        "hide": ["archives", "calendar"]
      }
    }
  }
}

blocks.styles.deny는 WordPress의 PHP 블록 스타일 레지스트리를 통해 등록된 스타일을 등록 해제합니다:

JSON
{
  "blockEditor": {
    "blocks": {
      "styles": {
        "deny": {
          "my-theme/card": ["outline"],
          "my-theme/media": ["framed"]
        }
      }
    }
  }
}

blockEditor.patterns

전역 패턴 소스를 비활성화하고 패턴 범주를 필터링하려면 blockEditor.patterns를 사용하세요.

JSON
{
  "blockEditor": {
    "patterns": {
      "core": false,
      "remote": false,
      "theme": true,
      "blockstudio": true,
      "categories": {
        "deny": ["gallery"],
        "rename": {
          "featured": "Featured Layouts"
        },
        "order": ["featured", "buttons"]
      }
    }
  }
}

blockEditor.media

전역 미디어 삽입기 정책에는 blockEditor.media를 사용하세요.

JSON
{
  "blockEditor": {
    "media": {
      "openverse": false,
      "imageSizes": {
        "allow": ["thumbnail", "large"],
        "deny": ["medium_large"]
      }
    }
  }
}

dev

옵션 유형 기본값 설명
grab.enabled boolean false 프런트엔드 요소 선택기를 활성화합니다
perf boolean false 모든 페이지 로드에서 성능 프로파일러를 활성화합니다
canvas.enabled boolean false 캔버스를 활성화합니다
canvas.adminBar boolean true 캔버스를 볼 때 WordPress 관리자 표시줄을 표시합니다

githooks

옵션 유형 기본값 설명
commit boolean false blockstudio-githooks sync 실행 시 분석 전용 커밋 전 훅을 생성합니다

생성된 훅의 실행 내용과 동기화 유지 방식은 관리형 커밋 훅을 참조하세요.

phpstan

옵션 유형 기본값 설명
preset string "base" 명령줄에서 프리셋을 선택하지 않을 때 사용할 분석 프리셋: base, theme, extreme-theme 또는 wordpress-render
configuration string "" 프리셋과 함께 포함할 프로젝트 PHPStan 구성으로, blockstudio.json에서 확인합니다
roots array ["."] 표준 명령이 분석하는 테마 루트
excludePaths array [] 구성된 각 루트 기준의 추가 스캐너 제외 항목
maxFiles integer 10000 테마 스캐너가 검사할 최대 파일 수
blockTags object {} 블록 태그 규칙에 사용할 요소 매핑, 태그 별칭 및 scanPhp

이 설정은 표준 blockstudio-phpstan 명령을 제어합니다. 프리셋, 계층 및 도입 방법은 PHPStan을 참조하세요.

ai

옵션 유형 기본값 설명
enableContextGeneration boolean false LLM 도구를 위해 블록, 설정, 스키마 및 문서를 통합한 컨텍스트 파일을 생성합니다

문서 색인과 생성된 전체 텍스트는 AI 통합을 참조하세요.

UI 구성 요소

Blockstudio 7.3에서 도입된 번들 헤드리스 UI 구성 요소를 활성화하고 조합하세요.