Composer
Blockstudio는 Packagist에서 사용할 수 있습니다. 프로젝트 설정에 따라 Composer를 통해 여러 방법으로 설치할 수 있습니다.
플러그인으로 설치
composer/installers를 사용해 wp-content/plugins/ 디렉터리에 Blockstudio를 직접 설치하세요. 이는 Composer로 관리되는 WordPress 프로젝트(예: Bedrock)의 표준 방식입니다.
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
WordPress 관리자 또는 WP-CLI에서 Blockstudio를 활성화하세요:
wp plugin activate blockstudio
프로젝트의 Composer 자동 로더는 WordPress 앱에서 로드해야 Composer가 Blockstudio을 등록할 수 있습니다. Bedrock에서는 이 과정이 자동으로 처리됩니다. 다른 설정에서는 필수 플러그인을 사용하세요:
<?php
require_once dirname( __DIR__, 2 ) . '/vendor/autoload.php';
WordPress가 플러그인 로드를 시작하기 전에 Composer의 자동 로더를 통해 Blockstudio가 포함되면, Composer 부트스트랩은 플러그인 로딩 환경이 준비될 때까지 초기화를 미룹니다. 이를 통해 Bedrock 및 기타 사이트 수준의 Composer 설정에서 패키지를 일찍 포함해도 WordPress 플러그인 API가 준비되기 전에 Blockstudio를 부팅하지 않습니다.
필수 플러그인으로 설치
활성화 없이 자동으로 로드되도록 Blockstudio를 mu-plugins/에 설치하세요. 설치 경로를 재정의해 mu-plugins 디렉터리를 대상으로 지정합니다:
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/mu-plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
WordPress는 mu-plugins/의 루트에 있는 PHP 파일만 자동 로드하며 하위 디렉터리는 로드하지 않습니다. 로더 파일을 추가하세요:
<?php
require_once WPMU_PLUGIN_DIR . '/blockstudio/blockstudio.php';
활성화할 필요가 없습니다. Blockstudio는 모든 요청에서 자동으로 로드됩니다.
테마에 포함
별도의 플러그인 없이 모든 것을 자체적으로 구성하려면 테마 내부에 종속 항목으로 Blockstudio를 설치하세요.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
테마의 functions.php에서 로드하세요:
<?php
require_once __DIR__ . '/vendor/autoload.php';
WordPress가 로드하면 Blockstudio는 Composer의 자동 로더를 통해 자동으로 부팅됩니다. 에셋 URL은 올바른 테마 디렉터리로 확인됩니다. 테마의 blockstudio/ 폴더에 정의된 블록은 플러그인 설치와 똑같이 작동합니다. 공개 테마 디렉터리가 심볼릭 링크인 경우에도 작동합니다. Blockstudio는 서버 경로를 노출하는 대신 활성 테마 또는 상위 테마의 URL를 통해 패키지의 실제 경로를 매핑합니다.
플러그인에 포함
다른 플러그인 내부에 종속 항목으로 Blockstudio를 설치하세요. 같은 자동 로더 부트스트랩이 적용됩니다.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
플러그인의 기본 파일에서 로드하세요:
<?php
/*
Plugin Name: My Plugin
*/
require_once __DIR__ . '/vendor/autoload.php';
에셋 URL은 올바른 플러그인 vendor 디렉터리로 확인됩니다.
지원되는 로드 모드 확인
Blockstudio는 지원되는 네 가지 런타임 위치에서 동일한 패키지를 지속적으로 확인합니다:
| 모드 | Bootstrap |
|---|---|
| WordPress 플러그인 | WordPress가 blockstudio.php를 활성화 |
| 필수 플러그인 | 루트 로더가 패키지 진입점을 필요로 함 |
| 테마의 Composer 종속 항목 | 테마가 Composer의 자동 로더를 필요로 함 |
| 플러그인의 Composer 종속 항목 | 호스트 플러그인이 Composer의 자동 로더를 필요로 함 |
모든 모드에서 WordPress는 동일한 결과로 부팅됩니다. Blockstudio 인스턴스 하나와 정의된 BLOCKSTUDIO_VERSION가 있으며, 그 아래에 두 번째 호스트 추상화 계층은 없습니다.
사용자 정의 패키지 URL
일반 플러그인, 필수 플러그인, 번들 플러그인, 활성 테마, 상위 테마 및 심볼릭 링크 테마 설치는 자동으로 확인됩니다. 패키지가 다른 공개 URL을 통해 노출되는 사용자 정의 배포의 경우, Composer가 Blockstudio를 로드하기 전에 BLOCKSTUDIO_URL을 정의하세요. 끝에 슬래시를 포함해야 합니다:
<?php
define(
'BLOCKSTUDIO_URL',
get_stylesheet_directory_uri() . '/packages/blockstudio/'
);
require_once __DIR__ . '/vendor/autoload.php';
Composer 자동 로더를 로드하기 전에 blockstudio/url을 등록하는 방법도 있습니다:
<?php
add_filter(
'blockstudio/url',
function (string $url, string $directory): string {
return get_stylesheet_directory_uri() . '/vendor/blockstudio/blockstudio/';
},
10,
2
);
require_once __DIR__ . '/vendor/autoload.php';
필터에는 확인된 URL과 실제 패키지 디렉터리가 전달됩니다.
종속 항목
Blockstudio의 런타임 종속 항목(TailwindPHP, ScssPhp, Minify)은 플러그인 내부에 번들로 포함되고 네임스페이스가 지정됩니다. vendor/ 디렉터리에 설치되는 유일한 Composer 종속 항목은 버전 충돌 해결을 내부적으로 처리하는 yahnis-elsts/plugin-update-checker입니다.
composer.json requires:
php >= 8.2
yahnis-elsts/plugin-update-checker ^5.6
업데이트
Composer 설치는 Composer를 통해 업데이트를 받습니다. Blockstudio가 vendor/ 디렉터리에서 로드되면 기본 제공 GitHub 업데이트 프로그램은 자동으로 비활성화됩니다.