Composer
Blockstudio finns på Packagist. Det finns flera sätt att installera via Composer, beroende på projektets upplägg.
Som tillägg
Använd composer/installers för att installera Blockstudio direkt i katalogen wp-content/plugins/. Det är standardmetoden för Composer-hanterade WordPress-projekt som Bedrock.
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
Aktivera Blockstudio via adminpanelen WordPress eller WP-CLI:
wp plugin activate blockstudio
Projektets autoladdare Composer måste läsas in av appen WordPress så att Composer kan registrera Blockstudio. I Bedrock hanteras detta automatiskt. I andra upplägg använder du ett MU-tillägg:
<?php
require_once dirname( __DIR__, 2 ) . '/vendor/autoload.php';
När Blockstudio inkluderas via autoladdaren för Composer innan WordPress har börjat läsa in tillägg, skjuter startstrapsrutinen Composer upp initieringen tills miljön för inläsning av tillägg är tillgänglig. Då kan Bedrock och andra inställningar på webbplatsnivå för Composer inkludera paketet tidigt utan att starta Blockstudio innan tilläggens API:er i WordPress är redo.
Som MU-tillägg
Installera Blockstudio i mu-plugins/ så att det läses in automatiskt utan aktivering. Ange en annan installationssökväg för att använda MU-tilläggskatalogen:
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/mu-plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
WordPress läser bara in PHP-filer automatiskt i roten av mu-plugins/, inte i underkataloger. Lägg till en laddarfil:
<?php
require_once WPMU_PLUGIN_DIR . '/blockstudio/blockstudio.php';
Ingen aktivering krävs. Blockstudio läses in automatiskt vid varje förfrågan.
Inbäddat i ett tema
Installera Blockstudio som ett beroende i temat. Då hålls allt samlat utan att ett separat tillägg behövs.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Läs in det i temats functions.php:
<?php
require_once __DIR__ . '/vendor/autoload.php';
Blockstudio startas automatiskt via autoladdaren för Composer när det
läses in av WordPress. Resurs-URL:er pekar på rätt temakatalog. Block
som definieras i temats blockstudio/-mapp fungerar precis som vid en installation som
tillägg. Detta fungerar även när den offentliga temakatalogen är en symbolisk länk:
Blockstudio mappar paketets fysiska sökväg via det aktiva temat eller överordnade temats
URL i stället för att exponera serversökvägen.
Inbäddat i ett tillägg
Installera Blockstudio som ett beroende i ett annat tillägg. Samma autoladdning vid start gäller.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Läs in det i tilläggets huvudfil:
<?php
/*
Plugin Name: My Plugin
*/
require_once __DIR__ . '/vendor/autoload.php';
Resurs-URL:er pekar på rätt tilläggsleverantörskatalog.
Kontroller av laddningslägen som stöds
Blockstudio verifierar kontinuerligt samma paket i fyra stödda körningsmiljöer:
| Läge | Bootstrap |
|---|---|
| Tillägg WordPress | WordPress aktiverar blockstudio.php |
| MU-tillägg | En laddarfil i roten kräver paketets startpunkt |
| Composer-beroende i ett tema | Temat kräver autoladdaren för Composer |
| Composer-beroende i ett tillägg | Värdtillägget kräver autoladdaren för Composer |
Alla lägen startar WordPress med samma resultat: en Blockstudio-instans med
BLOCKSTUDIO_VERSION definierat och utan något andra värdabstraktionslager under den.
Anpassat paket-URL
Installationer som vanliga tillägg, MU-tillägg, inbäddade tillägg, aktiva teman, överordnade teman och symboliskt länkade teman hanteras automatiskt. För en anpassad distribution där paketet exponeras via ett annat offentligt URL, definiera BLOCKSTUDIO_URL
innan Composer läser in Blockstudio. Ta med det avslutande snedstrecket:
<?php
define(
'BLOCKSTUDIO_URL',
get_stylesheet_directory_uri() . '/packages/blockstudio/'
);
require_once __DIR__ . '/vendor/autoload.php';
Du kan i stället registrera blockstudio/url innan autoladdaren för Composer läses in:
<?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';
Filtret får det lösta URL och den fysiska paketkatalogen.
Beroenden
Blockstudios körningsberoenden (TailwindPHP, ScssPhp, Minify) är paketerade och namnrymdsseparerade i tillägget. Det enda installerade beroendet för Composer i katalogen vendor/ är yahnis-elsts/plugin-update-checker, som hanterar versionskonflikter internt.
composer.json requires:
php >= 8.2
yahnis-elsts/plugin-update-checker ^5.6
Uppdateringar
Composer-installationer får uppdateringar via Composer. Den inbyggda uppdateraren för GitHub inaktiveras automatiskt när Blockstudio läses in från en katalog vendor/.