Composer
Blockstudio ir pieejams vietnē Packagist. Atkarībā no projekta iestatījumiem to var instalēt vairākos veidos, izmantojot Composer.
Kā spraudni
Izmantojiet composer/installers, lai instalētu Blockstudio tieši savā wp-content/plugins/ direktorijā. Tā ir standarta pieeja Composer pārvaldītiem WordPress projektiem, piemēram, Bedrock.
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
Aktivizējiet Blockstudio, izmantojot WordPress administrēšanas vidi vai WP-CLI:
wp plugin activate blockstudio
Projekta Composer automātiskās ielādes rīks ir jāielādē WordPress lietotnei, lai Composer varētu reģistrēt Blockstudio. Bedrock tas notiek automātiski. Citās vidēs izmantojiet obligāti ielādējamu spraudni:
<?php
require_once dirname( __DIR__, 2 ) . '/vendor/autoload.php';
Ja Blockstudio ir iekļauts, izmantojot Composer automātiskās ielādes rīku, pirms WordPress sāk ielādēt spraudņus, Composer sākumdaļa atliek inicializāciju, līdz ir pieejama spraudņu ielādes vide. Tādējādi Bedrock un citas vietnes līmeņa Composer konfigurācijas var iekļaut pakotni agri, nepalaižot Blockstudio, pirms ir gatavas WordPress spraudņu API.
Kā obligāti ielādējamu spraudni
Instalējiet Blockstudio mapē mu-plugins/, lai tas ielādētos automātiski bez aktivizēšanas. Norādiet instalētāja ceļu uz obligāti ielādējamo spraudņu direktoriju:
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/mu-plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
WordPress automātiski ielādē tikai PHP failus, kas atrodas mu-plugins/ saknē, nevis apakšdirektorijās. Pievienojiet ielādētāja failu:
<?php
require_once WPMU_PLUGIN_DIR . '/blockstudio/blockstudio.php';
Aktivizēšana nav nepieciešama. Blockstudio tiek automātiski ielādēts katrā pieprasījumā.
Iekļauts tēmā
Instalējiet Blockstudio kā atkarību savā tēmā. Tādējādi viss ir iekļauts vienā vietā un atsevišķs spraudnis nav nepieciešams.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Ielādējiet to savas tēmas functions.php:
<?php
require_once __DIR__ . '/vendor/autoload.php';
Blockstudio tiek automātiski inicializēts, izmantojot Composer automātiskās ielādes rīku,
kad to ielādē WordPress. Līdzekļu URL tiek novirzīti uz pareizo tēmas direktoriju. Bloki,
kas definēti tēmas mapē blockstudio/, darbojas tāpat kā spraudņa instalācijā. Tas darbojas arī tad, ja publiskā tēmas direktorija ir simboliskā saite:
Blockstudio sasaista pakotnes fizisko ceļu ar aktīvās vai vecāktēmas URL,
neatklājot servera ceļu.
Iekļauts spraudnī
Instalējiet Blockstudio kā atkarību citā spraudnī. Tiek izmantota tā pati automātiskās ielādes sākumdaļa.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Ielādējiet to spraudņa galvenajā failā:
<?php
/*
Plugin Name: My Plugin
*/
require_once __DIR__ . '/vendor/autoload.php';
Līdzekļu URL tiek novirzīti uz pareizo spraudņa piegādātāja direktoriju.
Atbalstīto ielādes režīmu pārbaudes
Blockstudio nepārtraukti pārbauda vienu un to pašu pakotni četrās atbalstītās izpildvides pozīcijās:
| Režīms | Bootstrap |
|---|---|
| WordPress spraudnis | WordPress aktivizē blockstudio.php |
| Obligāti ielādējams spraudnis | Saknes ielādētājs pieprasa pakotnes ieejas punktu |
| Composer atkarība tēmā | Tēma pieprasa Composer automātiskās ielādes rīku |
| Composer atkarība spraudnī | Resursdatora spraudnis pieprasa Composer automātiskās ielādes rīku |
Katrā režīmā WordPress tiek inicializēts ar vienādu rezultātu: viena Blockstudio instance ar definētu BLOCKSTUDIO_VERSION un bez otras resursdatora abstrakcijas pamatā.
Pielāgotā pakotne URL
Parasta spraudņa, obligāti ielādējama spraudņa, komplektēta spraudņa, aktīvās tēmas, vecāktēmas un tēmas ar simbolisko saiti instalācijas tiek atrisinātas automātiski. Pielāgotā izvietojumā, kur pakotne ir pieejama, izmantojot citu publisko URL, definējiet BLOCKSTUDIO_URL, pirms Composer ielādē Blockstudio. Iekļaujiet beigu slīpsvītru:
<?php
define(
'BLOCKSTUDIO_URL',
get_stylesheet_directory_uri() . '/packages/blockstudio/'
);
require_once __DIR__ . '/vendor/autoload.php';
Varat arī reģistrēt blockstudio/url, pirms ielādējat Composer automātiskās ielādes rīku:
<?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';
Filtrs saņem atrisināto URL un pakotnes fizisko direktoriju.
Atkarības
Blockstudio izpildlaika atkarības (TailwindPHP, ScssPhp, Minify) ir iekļautas un nosauktas ar spraudņa iekšējiem nosaukumiem. Vienīgā Composer atkarība, kas instalēta jūsu vendor/ direktorijā, ir yahnis-elsts/plugin-update-checker, kas iekšēji apstrādā versiju konfliktu novēršanu.
composer.json requires:
php >= 8.2
yahnis-elsts/plugin-update-checker ^5.6
Atjauninājumi
Composer instalācijas saņem atjauninājumus, izmantojot Composer. Iebūvētais GitHub atjauninātājs tiek automātiski atspējots, ja Blockstudio tiek ielādēts no direktorijas vendor/.