Composer
Blockstudio je dostupný na Packagist. V závislosti od nastavenia projektu ho možno nainštalovať niekoľkými spôsobmi cez Composer.
Ako doplnok
Pomocou composer/installers nainštalujete Blockstudio priamo do adresára wp-content/plugins/. Ide o štandardný postup pri projektoch WordPress spravovaných cez Composer, ako je Bedrock.
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
Aktivujte Blockstudio cez administráciu WordPress alebo pomocou WP-CLI:
wp plugin activate blockstudio
Autoloader projektu Composer musí načítať aplikácia WordPress, aby Composer mohol zaregistrovať Blockstudio. V prostredí Bedrock sa to zabezpečuje automaticky. V ostatných nastaveniach použite povinný doplnok:
<?php
require_once dirname( __DIR__, 2 ) . '/vendor/autoload.php';
Keď sa Blockstudio načíta cez autoloader Composer ešte predtým, než WordPress začne načítavať doplnky, zavádzací kód Composer odloží inicializáciu, kým nebude dostupné prostredie na načítanie doplnkov. Vďaka tomu môžu Bedrock a ďalšie nastavenia Composer na úrovni webu zahrnúť balík včas bez spustenia Blockstudio skôr, než budú pripravené rozhrania API doplnkov WordPress.
Ako povinný doplnok
Nainštalujte Blockstudio do mu-plugins/, aby sa načítal automaticky bez aktivácie. Prepíšte cestu inštalátora tak, aby smerovala do adresára mu-plugins:
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/mu-plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
WordPress automaticky načítava iba súbory PHP v koreňovom adresári mu-plugins/, nie v podadresároch. Pridajte zavádzací súbor:
<?php
require_once WPMU_PLUGIN_DIR . '/blockstudio/blockstudio.php';
Aktivácia nie je potrebná. Blockstudio sa automaticky načítava pri každej požiadavke.
Zabalený v téme
Nainštalujte Blockstudio ako závislosť vo svojej téme. Všetko tak zostane samostatné bez potreby osobitného doplnku.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Načítajte ho v súbore functions.php svojej témy:
<?php
require_once __DIR__ . '/vendor/autoload.php';
Blockstudio sa automaticky inicializuje cez autoloader Composer, keď ho načíta WordPress. Adresy URL zdrojov sa správne odvodia od adresára témy. Bloky definované v priečinku blockstudio/ vašej témy fungujú rovnako ako pri inštalácii doplnku. Funguje to aj vtedy, keď je verejný adresár témy symbolickým odkazom: Blockstudio priradí fyzickú cestu balíka k adresáru URL aktívnej alebo nadradenej témy namiesto odhalenia cesty na serveri.
Zabalený v doplnku
Nainštalujte Blockstudio ako závislosť v inom doplnku. Použije sa rovnaký zavádzací kód pre autoload.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Načítajte ho v hlavnom súbore doplnku:
<?php
/*
Plugin Name: My Plugin
*/
require_once __DIR__ . '/vendor/autoload.php';
Adresy URL zdrojov sa správne odvodia od adresára dodávateľa doplnku.
Kontroly podporovaných režimov načítania
Blockstudio priebežne overuje ten istý balík v štyroch podporovaných pozíciách behu:
| Režim | Bootstrap |
|---|---|
| Doplnok WordPress | WordPress aktivuje blockstudio.php |
| Povinný doplnok | Koreňový zavádzač vyžaduje vstupný bod balíka |
| Závislosť Composer v téme | Téma vyžaduje autoloader Composer |
| Závislosť Composer v doplnku | Hostiteľský doplnok vyžaduje autoloader Composer |
Každý režim spustí WordPress s rovnakým výsledkom: jedna inštancia Blockstudio s definovaným BLOCKSTUDIO_VERSION a bez ďalšej abstrakcie hostiteľa na nižšej úrovni.
Vlastný balík URL
Bežná inštalácia doplnku, povinného doplnku, zabaleného doplnku, aktívnej témy,
nadradenej témy aj témy so symbolickým odkazom sa rozpozná automaticky. Pri
vlastnom nasadení, kde je balík sprístupnený cez iný verejný súbor URL, definujte BLOCKSTUDIO_URL
pred načítaním Composer Blockstudio. Nezabudnite na koncovú lomku:
<?php
define(
'BLOCKSTUDIO_URL',
get_stylesheet_directory_uri() . '/packages/blockstudio/'
);
require_once __DIR__ . '/vendor/autoload.php';
Namiesto toho môžete zaregistrovať blockstudio/url pred načítaním 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';
Filter dostane vyriešenú cestu URL a fyzický adresár balíka.
Závislosti
Závislosti prostredia Blockstudio (TailwindPHP, ScssPhp, Minify) sú zabalené a majú vlastné menné priestory v doplnku. Jediná závislosť Composer nainštalovaná do vášho adresára vendor/ je yahnis-elsts/plugin-update-checker, ktorá interne rieši konflikty verzií.
composer.json requires:
php >= 8.2
yahnis-elsts/plugin-update-checker ^5.6
Aktualizácie
Inštalácie Composer dostávajú aktualizácie cez Composer. Vstavaný aktualizátor GitHub sa automaticky vypne, keď sa Blockstudio načíta z adresára vendor/.