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 до завантаження Blockstudio у Composer. Додайте завершальну косу риску:
<?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/.