Composer
Blockstudio je na voljo na Packagist. Glede na nastavitev projekta ga lahko prek Composer namestite na več načinov.
Kot vtičnik
Uporabite composer/installers za neposredno namestitev Blockstudio v imenik wp-content/plugins/. To je običajni način za projekte WordPress, ki jih upravlja Composer, kot je Bedrock.
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
Aktivirajte Blockstudio prek skrbniškega vmesnika WordPress ali z ukazom WP-CLI:
wp plugin activate blockstudio
Avtonalagalnik Composer vašega projekta mora naložiti aplikacija WordPress, da lahko Composer registrira Blockstudio. V Bedrock se to izvede samodejno. V drugih nastavitvah uporabite obvezni vtičnik:
<?php
require_once dirname( __DIR__, 2 ) . '/vendor/autoload.php';
Ko je Blockstudio vključen prek avtonalagalnika Composer, preden začne WordPress nalagati vtičnike, zagonski postopek Composer odloži inicializacijo, dokler ni na voljo okolje za nalaganje vtičnikov. Tako lahko Bedrock in druge nastavitve Composer na ravni mesta vključijo paket zgodaj, ne da bi zagnale Blockstudio, preden so pripravljeni API-ji vtičnikov WordPress.
Kot obvezni vtičnik
Namestite Blockstudio v mu-plugins/, da se samodejno naloži brez aktivacije. Prepišite pot namestitvenega programa, da ciljate na imenik mu-plugins:
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/mu-plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
WordPress samodejno naloži samo datoteke PHP v korenu mu-plugins/, ne pa tudi v podimenikih. Dodajte nalagalno datoteko:
<?php
require_once WPMU_PLUGIN_DIR . '/blockstudio/blockstudio.php';
Aktivacija ni potrebna. Blockstudio se samodejno naloži ob vsaki zahtevi.
Vključen v temo
Namestite Blockstudio kot odvisnost v svoji temi. Tako vse ostane na enem mestu, brez potrebe po ločenem vtičniku.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Naložite ga v functions.php svoje teme:
<?php
require_once __DIR__ . '/vendor/autoload.php';
Blockstudio se samodejno zažene prek avtonalagalnika Composer, ko ga naloži WordPress. URL-ji sredstev kažejo na pravi imenik teme. Bloki, določeni v mapi blockstudio/ vaše teme, delujejo enako kot pri namestitvi vtičnika. To deluje tudi, kadar je javni imenik teme simbolna povezava: Blockstudio preslika fizično pot paketa prek URL aktivne ali nadrejene teme namesto razkritja poti strežnika.
Vključen v vtičnik
Namestite Blockstudio kot odvisnost v drug vtičnik. Velja enak zagonski postopek z avtonalagalnikom.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Naložite ga v glavni datoteki vtičnika:
<?php
/*
Plugin Name: My Plugin
*/
require_once __DIR__ . '/vendor/autoload.php';
URL-ji sredstev kažejo na pravi imenik ponudnikov vtičnika.
Preverjanja podprtih načinov nalaganja
Blockstudio neprekinjeno preverja isti paket na štirih podprtih mestih izvajanja:
| Način | Bootstrap |
|---|---|
| Vtičnik WordPress | WordPress aktivira blockstudio.php |
| Obvezni vtičnik | Korenski nalagalnik zahteva vstopno točko paketa |
| Odvisnost Composer v temi | Tema zahteva avtonalagalnik Composer |
| Odvisnost Composer v vtičniku | Gostiteljski vtičnik zahteva avtonalagalnik Composer |
Vsak način zažene WordPress z enakim rezultatom: en primerek Blockstudio z definicijo BLOCKSTUDIO_VERSION in brez dodatne abstrakcije gostitelja.
URL paketa po meri
Namestitve kot običajni vtičnik, obvezni vtičnik, vključeni vtičnik, aktivna tema, nadrejena tema in tema s simbolno povezavo se razrešijo samodejno. Pri namestitvi po meri, kjer je paket izpostavljen prek drugega javnega URL, določite BLOCKSTUDIO_URL, preden Composer naloži Blockstudio. Vključite zaključno poševnico:
<?php
define(
'BLOCKSTUDIO_URL',
get_stylesheet_directory_uri() . '/packages/blockstudio/'
);
require_once __DIR__ . '/vendor/autoload.php';
Lahko pa registrirate blockstudio/url, preden naložite avtonalagalnik 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';
Filter prejme razrešeni URL in fizični imenik paketa.
Odvisnosti
Izvajalne odvisnosti za Blockstudio (TailwindPHP, ScssPhp, Minify) so vključene in uporabljajo lastna imenska prostora v vtičniku. Edina odvisnost Composer, nameščena v vaš imenik vendor/, je yahnis-elsts/plugin-update-checker, ki interno obravnava razreševanje sporov med različicami.
composer.json requires:
php >= 8.2
yahnis-elsts/plugin-update-checker ^5.6
Posodobitve
Namestitve Composer prejemajo posodobitve prek Composer. Vgrajeni posodabljalnik GitHub je samodejno onemogočen, ko je Blockstudio naložen iz imenika vendor/.