Composer
Blockstudio je dostupný na Packagist. V závislosti na nastavení projektu ho můžete nainstalovat několika způsoby pomocí Composer.
Jako plugin
Pomocí composer/installers nainstalujte Blockstudio přímo do adresáře wp-content/plugins/. Jde o standardní postup pro projekty WordPress spravované pomocí Composer, například Bedrock.
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
Aktivujte Blockstudio v administraci WordPress nebo pomocí WP-CLI:
wp plugin activate blockstudio
Autoloader projektu Composer musí aplikace WordPress načíst, aby mohl Composer registrovat Blockstudio. V prostředí Bedrock se to děje automaticky. V ostatních prostředích použijte povinný plugin:
<?php
require_once dirname( __DIR__, 2 ) . '/vendor/autoload.php';
Pokud je Blockstudio načten přes autoloader Composer ještě před zahájením načítání pluginů WordPress, zaváděcí část Composer odloží inicializaci, dokud nebude dostupné prostředí pro načítání pluginů. Díky tomu mohou nastavení na úrovni webu jako Bedrock a další Composer zahrnout balíček včas, aniž by spustila Blockstudio před zpřístupněním rozhraní API pluginů WordPress.
Jako povinný plugin
Nainstalujte Blockstudio do mu-plugins/, aby se načítal automaticky bez aktivace. Přepište cestu instalátoru tak, aby ukazovala do adresáře 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čítá pouze soubory PHP v kořenovém adresáři mu-plugins/, nikoli v podadresářích. Přidejte zaváděcí soubor:
<?php
require_once WPMU_PLUGIN_DIR . '/blockstudio/blockstudio.php';
Aktivace není potřeba. Blockstudio se automaticky načte při každém požadavku.
Přibalený v šabloně
Nainstalujte Blockstudio jako závislost uvnitř šablony. Vše tak zůstane pohromadě a nebude potřeba samostatný plugin.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Načtěte jej v souboru functions.php své šablony:
<?php
require_once __DIR__ . '/vendor/autoload.php';
Blockstudio se automaticky zavede prostřednictvím autoloaderu Composer, když jej načte WordPress. URL aktiv se správně odvodí z adresáře šablony. Bloky definované ve složce blockstudio/ vaší šablony fungují stejně jako při instalaci pluginu. Funguje to také v případě, že je veřejný adresář šablony symbolickým odkazem: Blockstudio namapuje fyzickou cestu balíčku přes URL aktivní nebo nadřazené šablony, takže se nezveřejní cesta na serveru.
Přibalený v pluginu
Nainstalujte Blockstudio jako závislost uvnitř jiného pluginu. Použije se stejný zaváděcí postup přes autoloader.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Načtěte jej v hlavním souboru pluginu:
<?php
/*
Plugin Name: My Plugin
*/
require_once __DIR__ . '/vendor/autoload.php';
URL aktiv se správně odvodí z adresáře vendor daného pluginu.
Testy podporovaných režimů načítání
Blockstudio průběžně ověřuje stejný balíček ve čtyřech podporovaných pozicích běhového prostředí:
| Režim | Bootstrap |
|---|---|
| Plugin WordPress | WordPress aktivuje blockstudio.php |
| Povinný plugin | Kořenový zaváděcí soubor vyžaduje vstupní bod balíčku |
| Závislost Composer v šabloně | Šablona vyžaduje autoloader Composer |
| Závislost Composer v pluginu | Hostitelský plugin vyžaduje autoloader Composer |
Ve všech režimech se WordPress spustí se stejným výsledkem: jedna instance Blockstudio s definovaným BLOCKSTUDIO_VERSION a bez další abstrakce hostitele na nižší úrovni.
Vlastní balíček URL
Instalace jako běžný nebo povinný plugin, přibalený plugin, aktivní či nadřazená šablona i instalace v šabloně se symbolickým odkazem se vyřeší automaticky. Pokud vlastní nasazení zpřístupňuje balíček prostřednictvím jiného veřejného URL, definujte BLOCKSTUDIO_URL před načtením Blockstudio pomocí Composer. Nezapomeňte na koncové lomítko:
<?php
define(
'BLOCKSTUDIO_URL',
get_stylesheet_directory_uri() . '/packages/blockstudio/'
);
require_once __DIR__ . '/vendor/autoload.php';
blockstudio/url můžete zaregistrovat také před načtením autoloaderu 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 obdrží vyřešené URL a fyzický adresář balíčku.
Závislosti
Závislosti Blockstudio za běhu (TailwindPHP, ScssPhp, Minify) jsou přibalené a jejich názvy jsou v rámci pluginu oddělené. Jedinou závislostí Composer instalovanou do vašeho adresáře vendor/ je yahnis-elsts/plugin-update-checker, která interně řeší konflikty verzí.
composer.json requires:
php >= 8.2
yahnis-elsts/plugin-update-checker ^5.6
Aktualizace
Instalace Composer dostávají aktualizace prostřednictvím Composer. Vestavěný aktualizátor GitHub se automaticky vypne, když je Blockstudio načten z adresáře vendor/.