Composer
Blockstudio este disponibil pe Packagist. Există mai multe modalități de instalare prin Composer, în funcție de configurația proiectului.
Ca plugin
Folosiți composer/installers pentru a instala Blockstudio direct în directorul wp-content/plugins/. Aceasta este abordarea standard pentru proiectele WordPress gestionate de Composer, precum Bedrock.
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
Activați Blockstudio prin panoul de administrare WordPress sau prin WP-CLI:
wp plugin activate blockstudio
Autoloaderul Composer al proiectului trebuie încărcat de aplicația WordPress, astfel încât Composer să poată înregistra Blockstudio. În Bedrock, acest lucru este gestionat automat. În celelalte configurații, folosiți un plugin obligatoriu:
<?php
require_once dirname( __DIR__, 2 ) . '/vendor/autoload.php';
Când Blockstudio este inclus prin autoloaderul Composer înainte ca WordPress să înceapă încărcarea pluginurilor, bootstrapul Composer amână inițializarea până când mediul de încărcare a pluginurilor este disponibil. Astfel, Bedrock și alte configurații Composer la nivel de site pot include pachetul devreme, fără să inițializeze Blockstudio înainte ca API-urile pluginurilor WordPress să fie pregătite.
Ca plugin obligatoriu
Instalați Blockstudio în mu-plugins/ pentru a-l încărca automat, fără activare. Suprascrieți calea instalatorului pentru a viza directorul mu-plugins:
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/mu-plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
WordPress încarcă automat doar fișierele PHP aflate în rădăcina mu-plugins/, nu și în subdirectoare. Adăugați un fișier de încărcare:
<?php
require_once WPMU_PLUGIN_DIR . '/blockstudio/blockstudio.php';
Nu este necesară activarea. Blockstudio se încarcă automat la fiecare cerere.
Inclus într-o temă
Instalați Blockstudio ca dependență în tema dvs. Astfel, totul rămâne autonom, fără să fie nevoie de un plugin separat.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Încărcați-l în fișierul functions.php al temei:
<?php
require_once __DIR__ . '/vendor/autoload.php';
Blockstudio se inițializează automat prin autoloaderul Composer atunci când este
încărcat de WordPress. URL-urile resurselor indică directorul corect al temei. Blocurile
definite în directorul blockstudio/ al temei funcționează exact ca în cazul instalării unui plugin. Acest lucru funcționează și atunci când directorul public al temei este o legătură simbolică:
Blockstudio mapează calea fizică a pachetului prin URL temei active sau părinte,
în loc să expună calea serverului.
Inclus într-un plugin
Instalați Blockstudio ca dependență în alt plugin. Se aplică același bootstrap al autoloaderului.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Încărcați-l în fișierul principal al pluginului:
<?php
/*
Plugin Name: My Plugin
*/
require_once __DIR__ . '/vendor/autoload.php';
URL-urile resurselor indică directorul vendor corect al pluginului.
Verificări pentru modurile de încărcare acceptate
Blockstudio verifică în permanență același pachet în patru poziții de runtime acceptate:
| Mod | Bootstrap |
|---|---|
| Plugin WordPress | WordPress activează blockstudio.php |
| Plugin obligatoriu | Un încărcător din directorul rădăcină necesită punctul de intrare al pachetului |
| Dependență Composer într-o temă | Tema necesită autoloaderul Composer |
| Dependență Composer într-un plugin | Pluginul gazdă necesită autoloaderul Composer |
Fiecare mod inițializează WordPress cu același rezultat: o singură instanță Blockstudio, cu
BLOCKSTUDIO_VERSION definit și fără o a doua abstracție gazdă dedesubt.
URL pentru pachet personalizat
Instalările ca plugin obișnuit, plugin obligatoriu, plugin grupat, temă activă, temă părinte și temă
cu legătură simbolică sunt rezolvate automat. Pentru o implementare personalizată în care
pachetul este expus printr-un alt URL public, definiți BLOCKSTUDIO_URL
înainte ca Composer să încarce Blockstudio. Includeți bara oblică finală:
<?php
define(
'BLOCKSTUDIO_URL',
get_stylesheet_directory_uri() . '/packages/blockstudio/'
);
require_once __DIR__ . '/vendor/autoload.php';
În schimb, puteți înregistra blockstudio/url înainte de a încărca autoloaderul 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';
Filtrul primește URL rezolvat și directorul fizic al pachetului.
Dependențe
Dependențele runtime ale Blockstudio (TailwindPHP, ScssPhp, Minify) sunt incluse și au namespace în plugin. Singura dependență Composer instalată în directorul vendor/ este yahnis-elsts/plugin-update-checker, care gestionează intern rezolvarea conflictelor de versiune.
composer.json requires:
php >= 8.2
yahnis-elsts/plugin-update-checker ^5.6
Actualizări
Instalările Composer primesc actualizări prin Composer. Programul de actualizare GitHub integrat este dezactivat automat când Blockstudio este încărcat dintr-un director vendor/.