Composer
Blockstudio е наличен в Packagist. Има няколко начина да го инсталирате чрез Composer в зависимост от конфигурацията на проекта ви.
Като плъгин
Използвайте composer/installers, за да инсталирате Blockstudio директно в директорията wp-content/plugins/. Това е стандартният подход за проекти WordPress, управлявани чрез Composer, като Bedrock.
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
Активирайте Blockstudio през администрацията на WordPress или чрез WP-CLI:
wp plugin activate blockstudio
Автозареждащият механизъм на Composer в проекта ви трябва да бъде зареден от приложението WordPress, за да може Composer да регистрира Blockstudio. В Bedrock това се обработва автоматично. В други конфигурации използвайте задължителен плъгин:
<?php
require_once dirname( __DIR__, 2 ) . '/vendor/autoload.php';
Когато Blockstudio е включен чрез автозареждащия механизъм на Composer преди WordPress да е започнал да зарежда плъгини, началната настройка на Composer отлага инициализацията, докато средата за зареждане на плъгини стане налична. Така Bedrock и други конфигурации на Composer за ниво сайт могат да включат пакета рано, без да стартират Blockstudio, преди API на плъгините на WordPress да са готови.
Като задължителен плъгин
Инсталирайте 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 зарежда автоматично само файловете PHP в основната директория на mu-plugins/, а не в поддиректории. Добавете файл за зареждане:
<?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';
Blockstudio се зарежда автоматично чрез автозареждащия механизъм на Composer, когато е зареден от WordPress. URL адресите на ресурсите сочат към правилната директория на темата. Блоковете, дефинирани в папката blockstudio/ на темата ви, работят точно както при инсталиране като плъгин. Това работи и когато публичната директория на темата е символна връзка: Blockstudio свързва физическия път на пакета с URL на активната или родителската тема, вместо да разкрива пътя на сървъра.
Включване в плъгин
Инсталирайте Blockstudio като зависимост в друг плъгин. Прилага се същата начална настройка за автозареждане.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Заредете го в основния файл на плъгина си:
<?php
/*
Plugin Name: My Plugin
*/
require_once __DIR__ . '/vendor/autoload.php';
URL адресите на ресурсите сочат към правилната директория на доставчика на плъгина.
Проверки на поддържаните режими на зареждане
Blockstudio непрекъснато проверява един и същ пакет в четири поддържани позиции по време на изпълнение:
| Режим | Bootstrap |
|---|---|
| плъгин WordPress | WordPress активира blockstudio.php |
| Задължителен плъгин | Зареждащ файл в основната директория изисква входната точка на пакета |
| Зависимост Composer в тема | Темата изисква автозареждащия механизъм на Composer |
| Зависимост Composer в плъгин | Хостващият плъгин изисква автозареждащия механизъм на Composer |
Всеки режим стартира WordPress с един и същ резултат: един екземпляр на Blockstudio с дефиниран BLOCKSTUDIO_VERSION и без допълнителна абстракция на хоста.
Персонализиран пакет URL
Инсталациите като обикновен плъгин, задължителен плъгин, включен плъгин, активна тема, родителска тема и тема чрез символна връзка се разрешават автоматично. При персонализирано внедряване, където пакетът се предоставя чрез друг публичен URL, задайте BLOCKSTUDIO_URL, преди Composer да зареди Blockstudio. Включете наклонената черта в края:
<?php
define(
'BLOCKSTUDIO_URL',
get_stylesheet_directory_uri() . '/packages/blockstudio/'
);
require_once __DIR__ . '/vendor/autoload.php';
Вместо това можете да регистрирате blockstudio/url, преди да заредите автозареждащия механизъм на Composer:
<?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) са включени в плъгина с отделни пространства от имена. Единствената зависимост Composer, инсталирана в директорията vendor/, е yahnis-elsts/plugin-update-checker, която вътрешно разрешава конфликти между версиите.
composer.json requires:
php >= 8.2
yahnis-elsts/plugin-update-checker ^5.6
Обновявания
Инсталациите на Composer получават обновявания чрез Composer. Вграденият инструмент за обновяване на GitHub се деактивира автоматично, когато Blockstudio е зареден от директория vendor/.