Composer
Blockstudio jest dostępny w Packagist. Istnieje kilka sposobów instalacji przez Composer, zależnie od konfiguracji projektu.
Jako wtyczka
Użyj composer/installers, aby zainstalować Blockstudio bezpośrednio w katalogu wp-content/plugins/. To standardowe podejście w projektach WordPress zarządzanych przez Composer, takich jak Bedrock.
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
Aktywuj Blockstudio w panelu administracyjnym WordPress lub przez WP-CLI:
wp plugin activate blockstudio
Autoloader Composer projektu musi zostać załadowany przez aplikację WordPress, aby Composer mógł zarejestrować Blockstudio. W Bedrock odbywa się to automatycznie. W pozostałych konfiguracjach użyj wtyczki must-use:
<?php
require_once dirname( __DIR__, 2 ) . '/vendor/autoload.php';
Gdy Blockstudio zostaje dołączony przez autoloader Composer, zanim WordPress rozpocznie ładowanie wtyczek, bootstrap Composer opóźnia inicjalizację do chwili, gdy środowisko ładowania wtyczek będzie dostępne. Dzięki temu Bedrock i inne konfiguracje Composer na poziomie witryny mogą dołączyć pakiet wcześniej, nie uruchamiając Blockstudio przed przygotowaniem API wtyczek WordPress.
Jako wtyczka must-use
Zainstaluj Blockstudio w mu-plugins/, aby ładował się automatycznie bez aktywacji. Zmień ścieżkę instalatora, aby wskazywała katalog mu-plugins:
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/mu-plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
WordPress automatycznie ładuje tylko pliki PHP znajdujące się w katalogu głównym mu-plugins/, a nie w podkatalogach. Dodaj plik ładujący:
<?php
require_once WPMU_PLUGIN_DIR . '/blockstudio/blockstudio.php';
Aktywacja nie jest potrzebna. Blockstudio ładuje się automatycznie przy każdym żądaniu.
W pakiecie motywu
Zainstaluj Blockstudio jako zależność w motywie. Wszystko pozostanie w jednym pakiecie, bez potrzeby instalowania osobnej wtyczki.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Załaduj go w pliku functions.php motywu:
<?php
require_once __DIR__ . '/vendor/autoload.php';
Blockstudio uruchamia się automatycznie przez autoloader Composer, gdy zostanie
załadowany przez WordPress. Adresy URL zasobów wskazują właściwy katalog motywu. Bloki
zdefiniowane w katalogu blockstudio/ motywu działają tak samo jak przy instalacji
wtyczki. Działa to również wtedy, gdy publiczny katalog motywu jest dowiązaniem symbolicznym:
Blockstudio mapuje fizyczną ścieżkę pakietu za pośrednictwem URL aktywnego motywu
lub motywu nadrzędnego, zamiast ujawniać ścieżkę serwera.
W pakiecie wtyczki
Zainstaluj Blockstudio jako zależność innej wtyczki. Obowiązuje ten sam mechanizm bootstrapu autoloadera.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Załaduj go w głównym pliku wtyczki:
<?php
/*
Plugin Name: My Plugin
*/
require_once __DIR__ . '/vendor/autoload.php';
Adresy URL zasobów wskazują właściwy katalog vendor wtyczki.
Testy obsługiwanych trybów ładowania
Blockstudio stale weryfikuje ten sam pakiet w czterech obsługiwanych pozycjach środowiska uruchomieniowego:
| Tryb | Bootstrap |
|---|---|
| Wtyczka WordPress | WordPress aktywuje blockstudio.php |
| Wtyczka must-use | Główny plik ładujący wymaga punktu wejścia pakietu |
| Zależność Composer w motywie | Motyw wymaga autoloadera Composer |
| Zależność Composer we wtyczce | Wtyczka hosta wymaga autoloadera Composer |
Każdy tryb uruchamia WordPress z tym samym rezultatem: jedna instancja Blockstudio z
zdefiniowanym BLOCKSTUDIO_VERSION, bez dodatkowej abstrakcji hosta pod spodem.
Pakiet niestandardowy URL
Instalacje jako zwykła wtyczka, wtyczka must-use, pakiet wtyczki, aktywny motyw, motyw nadrzędny i motyw z dowiązaniem symbolicznym są obsługiwane automatycznie. W przypadku niestandardowego wdrożenia,
w którym pakiet jest udostępniany przez inny publiczny URL, zdefiniuj BLOCKSTUDIO_URL,
zanim Composer załaduje Blockstudio. Uwzględnij końcowy ukośnik:
<?php
define(
'BLOCKSTUDIO_URL',
get_stylesheet_directory_uri() . '/packages/blockstudio/'
);
require_once __DIR__ . '/vendor/autoload.php';
Możesz też zarejestrować blockstudio/url przed załadowaniem autoloadera 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';
Filtr otrzymuje rozwiązaną wartość URL oraz fizyczny katalog pakietu.
Zależności
Zależności środowiska uruchomieniowego Blockstudio (TailwindPHP, ScssPhp, Minify) są dołączone do wtyczki z własnymi przestrzeniami nazw. Jedyną zależnością Composer instalowaną w katalogu vendor/ jest yahnis-elsts/plugin-update-checker, który wewnętrznie obsługuje rozwiązywanie konfliktów wersji.
composer.json requires:
php >= 8.2
yahnis-elsts/plugin-update-checker ^5.6
Aktualizacje
Instalacje Composer otrzymują aktualizacje przez Composer. Wbudowany aktualizator GitHub jest automatycznie wyłączany, gdy Blockstudio jest ładowany z katalogu vendor/.