Composer
Blockstudio pasiekiamas per Packagist. Priklausomai nuo projekto sąrankos, jį galima įdiegti keliais būdais per Composer.
Kaip papildinį
Naudokite composer/installers, kad įdiegtumėte Blockstudio tiesiai į savo wp-content/plugins/ katalogą. Tai įprastas būdas Composer valdomiems WordPress projektams, pavyzdžiui, Bedrock.
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
Aktyvinkite Blockstudio per WordPress administravimo aplinką arba naudodami WP-CLI:
wp plugin activate blockstudio
Jūsų projekto Composer automatinio įkėlimo programa turi būti įkelta WordPress programos, kad Composer galėtų užregistruoti Blockstudio. Bedrock tai atliekama automatiškai. Kitose sąrankose naudokite privalomąjį papildinį:
<?php
require_once dirname( __DIR__, 2 ) . '/vendor/autoload.php';
Kai Blockstudio įtraukiamas per Composer automatinio įkėlimo programą prieš WordPress pradedant įkelti papildinius, Composer paleidimo kodas atideda inicijavimą, kol bus paruošta papildinių įkėlimo aplinka. Taip Bedrock ir kitos svetainės lygmens Composer sąrankos gali įtraukti paketą anksčiau, nepaleisdamos Blockstudio, kol neparuoštos WordPress papildinių API.
Kaip privalomąjį papildinį
Įdiekite Blockstudio į mu-plugins/, kad jis būtų įkeliamas automatiškai ir jo nereikėtų aktyvinti. Pakeiskite diegimo programos kelią, kad jis nurodytų mu-plugins katalogą:
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/mu-plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
WordPress automatiškai įkelia tik PHP failus, esančius mu-plugins/ šakniniame kataloge, bet ne poaplankiuose. Sukurkite įkėlimo failą:
<?php
require_once WPMU_PLUGIN_DIR . '/blockstudio/blockstudio.php';
Aktyvinti nereikia. Blockstudio automatiškai įkeliamas su kiekviena užklausa.
Įtrauktas į temą
Įdiekite Blockstudio kaip priklausomybę savo temoje. Taip viskas lieka vienoje vietoje ir nereikia atskiro papildinio.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Įkelkite jį temoje esančiame functions.php:
<?php
require_once __DIR__ . '/vendor/autoload.php';
Blockstudio automatiškai paleidžiamas per Composer automatinio įkėlimo programą, kai jį įkelia WordPress. Išteklių URL nurodo tinkamą temos katalogą. Jūsų temos blockstudio/ aplanke apibrėžti blokai veikia taip pat kaip ir įdiegus papildinį. Tai veikia ir tada, kai viešas temos katalogas yra simbolinė nuoroda: Blockstudio susieja fizinį paketo kelią su aktyviosios arba pagrindinės temos URL, todėl serverio kelias neatskleidžiamas.
Įtrauktas į papildinį
Įdiekite Blockstudio kaip priklausomybę kitame papildinyje. Taikomas tas pats automatinio įkėlimo paleidimo kodas.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Įkelkite jį pagrindiniame papildinio faile:
<?php
/*
Plugin Name: My Plugin
*/
require_once __DIR__ . '/vendor/autoload.php';
Išteklių URL nurodo tinkamą papildinio tiekėjo katalogą.
Palaikomų įkėlimo režimų patikros
Blockstudio nuolat tikrina tą patį paketą keturiose palaikomose vykdymo aplinkose:
| Režimas | Bootstrap |
|---|---|
| WordPress papildinys | WordPress aktyvina blockstudio.php |
| Privalomasis papildinys | Šakniniame kataloge esantis įkėlimo failas reikalauja paketo įvesties taško |
| Composer priklausomybė temoje | Tema reikalauja Composer automatinio įkėlimo programos |
| Composer priklausomybė papildinyje | Pagrindinis papildinys reikalauja Composer automatinio įkėlimo programos |
Visais režimais WordPress paleidžiamas taip pat: sukuriamas vienas Blockstudio egzempliorius,
apibrėžiamas BLOCKSTUDIO_VERSION ir nenaudojama jokia papildoma pagrindinė abstrakcija.
Pasirinktinio paketo URL
Įprastas papildinys, privalomasis papildinys, įtrauktas papildinys, aktyvioji tema, pagrindinė tema ir
įdiegimai su simboline temos nuoroda nustatomi automatiškai. Jei pasirinktiniame diegime paketas pateikiamas per kitą viešą URL, apibrėžkite BLOCKSTUDIO_URL prieš Composer įkeliant Blockstudio. Pabaigoje pridėkite pasvirąjį brūkšnį:
<?php
define(
'BLOCKSTUDIO_URL',
get_stylesheet_directory_uri() . '/packages/blockstudio/'
);
require_once __DIR__ . '/vendor/autoload.php';
Taip pat galite užregistruoti blockstudio/url prieš įkeldami Composer automatinio įkėlimo programą:
<?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';
Filtras gauna nustatytą URL ir fizinį paketo katalogą.
Priklausomybės
Blockstudio vykdymo aplinkos priklausomybės (TailwindPHP, ScssPhp, Minify) įtrauktos į papildinį ir naudoja vardų sritis. Vienintelė Composer priklausomybė, įdiegiama į jūsų vendor/ katalogą, yra yahnis-elsts/plugin-update-checker; ji viduje išsprendžia versijų konfliktus.
composer.json requires:
php >= 8.2
yahnis-elsts/plugin-update-checker ^5.6
Atnaujinimai
Composer diegimo aplinkos naujinimus gauna per Composer. Įtaisytasis GitHub naujinimo įrankis automatiškai išjungiamas, kai Blockstudio įkeliamas iš vendor/ katalogo.