Composer
A Blockstudio elérhető itt: Packagist. A projekt beállításaitól függően többféleképpen telepíthető a Composer segítségével.
Bővítményként
A composer/installers segítségével közvetlenül telepítheti a Blockstudio elemet a wp-content/plugins/ könyvtárába. Ez a szokásos megoldás a Composer által kezelt, például Bedrock típusú WordPress projektekhez.
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
Aktiválja a Blockstudio elemet a WordPress adminisztrációs felületén vagy a WP-CLI segítségével:
wp plugin activate blockstudio
A projekt Composer automatikus betöltőjét a WordPress alkalmazásnak kell betöltenie, hogy a Composer regisztrálhassa a Blockstudio elemet. Bedrock esetén ez automatikusan történik. Más környezetben használjon kötelezően betöltődő bővítményt:
<?php
require_once dirname( __DIR__, 2 ) . '/vendor/autoload.php';
Ha a Blockstudio a Composer automatikus betöltőjén keresztül, a WordPress által megkezdett bővítménybetöltés előtt kerül be, a Composer indítófolyamata elhalasztja az inicializálást, amíg a bővítménybetöltési környezet elérhetővé nem válik. Így a Bedrock és más, a webhely szintjén működő Composer beállítások korán betölthetik a csomagot anélkül, hogy a Blockstudio eleme inicializálódna, mielőtt a WordPress bővítmény API-jai elkészülnének.
Kötelezően betöltődő bővítményként
Telepítse a Blockstudio elemet a mu-plugins/ könyvtárba, hogy aktiválás nélkül automatikusan betöltődjön. A könyvtár célzásához írja felül a mu-plugins telepítési útvonalát:
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/mu-plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
A WordPress csak a mu-plugins/ gyökérkönyvtárában lévő PHP fájlokat tölti be automatikusan, az alkönyvtárakban lévőket nem. Adjon hozzá betöltőfájlt:
<?php
require_once WPMU_PLUGIN_DIR . '/blockstudio/blockstudio.php';
Nincs szükség aktiválásra. A Blockstudio minden kérésnél automatikusan betöltődik.
Témába csomagolva
Telepítse a Blockstudio elemet függőségként a témán belül. Így minden egy helyen marad, külön bővítmény nélkül.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Töltse be a téma functions.php fájljában:
<?php
require_once __DIR__ . '/vendor/autoload.php';
A Blockstudio automatikusan elindul a Composer automatikus betöltőjén keresztül, amikor a WordPress betölti.
Az eszközök URL-jei a megfelelő téma könyvtárára mutatnak. A téma blockstudio/ mappájában
meghatározott blokkok ugyanúgy működnek, mint bővítményként telepítve. Ez akkor is működik, ha a nyilvános témakönyvtár szimbolikus hivatkozás:
Blockstudio a csomag fizikai útvonalát az aktív vagy szülőtémához tartozó URL útvonalon keresztül oldja fel, így nem teszi láthatóvá a szerver útvonalát.
Bővítménybe csomagolva
Telepítse a Blockstudio elemet függőségként egy másik bővítményen belül. Ugyanez az automatikus betöltési folyamat érvényes.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Töltse be a bővítmény főfájljában:
<?php
/*
Plugin Name: My Plugin
*/
require_once __DIR__ . '/vendor/autoload.php';
Az eszközök URL-jei a megfelelő bővítmény vendor könyvtárára mutatnak.
A támogatott betöltési módok ellenőrzése
A Blockstudio folyamatosan ellenőrzi ugyanazt a csomagot a négy támogatott futtatókörnyezeti helyzetben:
| Mód | Bootstrap |
|---|---|
| WordPress bővítmény | A WordPress aktiválja a blockstudio.php elemet |
| Kötelezően betöltődő bővítmény | A gyökérkönyvtárban lévő betöltő behívja a csomag belépési pontját |
| Composer függőségként egy témában | A téma betölti a Composer automatikus betöltőjét |
| Composer függőségként egy bővítményben | A befogadó bővítmény betölti a Composer automatikus betöltőjét |
Minden mód ugyanazt az eredményt hozza a WordPress betöltésekor: egyetlen Blockstudio példány, amelyben a BLOCKSTUDIO_VERSION definiálva van, és nincs alatta második befogadó absztrakció.
Egyéni csomag URL
A normál bővítményként, kötelezően betöltődő bővítményként, másik bővítménybe csomagolva, aktív témába vagy szülőtémába csomagolva, illetve szimbolikus hivatkozáson keresztül telepített példányok útvonala automatikusan feloldódik. Egyéni telepítésnél, amikor a csomag egy másik nyilvános URL útvonalon érhető el, határozza meg a BLOCKSTUDIO_URL értékét, mielőtt a Composer betölti a Blockstudio elemet. A záró perjelet is adja meg:
<?php
define(
'BLOCKSTUDIO_URL',
get_stylesheet_directory_uri() . '/packages/blockstudio/'
);
require_once __DIR__ . '/vendor/autoload.php';
A Composer automatikus betöltőjének betöltése előtt is regisztrálhatja a blockstudio/url elemet:
<?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';
A szűrő a feloldott URL értéket és a csomag fizikai könyvtárát kapja meg.
Függőségek
A Blockstudio futásidejű függőségei (TailwindPHP, ScssPhp, Minify) a bővítménybe csomagolva, saját névtér alatt szerepelnek. Az egyetlen telepített Composer függőség a vendor/ könyvtárba a yahnis-elsts/plugin-update-checker, amely belsőleg kezeli a verzióütközések feloldását.
composer.json requires:
php >= 8.2
yahnis-elsts/plugin-update-checker ^5.6
Frissítések
A Composer telepítései a Composer szolgáltatáson keresztül kapnak frissítéseket. A beépített GitHub frissítő automatikusan letiltódik, ha a Blockstudio elemet egy vendor/ könyvtárból töltik be.