Composer
Blockstudio ist auf Packagist verfügbar. Je nach Projekt-Setup gibt es mehrere Möglichkeiten, es mit Composer zu installieren.
Als Plugin
Verwende composer/installers, um Blockstudio direkt in deinem Verzeichnis wp-content/plugins/ zu installieren. Das ist die übliche Vorgehensweise bei Composer-verwalteten WordPress-Projekten wie Bedrock.
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
Aktiviere Blockstudio über die WordPress-Administration oder WP-CLI:
wp plugin activate blockstudio
Der Composer-Autoloader deines Projekts muss von der WordPress-App geladen werden, damit Composer Blockstudio registrieren kann. In Bedrock geschieht das automatisch. Bei anderen Setups verwendest du ein Must-Use-Plugin:
<?php
require_once dirname( __DIR__, 2 ) . '/vendor/autoload.php';
Wenn Blockstudio über den Composer-Autoloader eingebunden wird, bevor WordPress mit dem Laden von Plugins begonnen hat, verschiebt der Composer-Bootstrap die Initialisierung, bis die Plugin-Ladeumgebung verfügbar ist. So können Bedrock und andere Composer-Setups auf Website-Ebene das Paket früh einbinden, ohne Blockstudio zu starten, bevor die Plugin-APIs von WordPress bereit sind.
Als Must-Use-Plugin
Installiere Blockstudio in mu-plugins/, damit es automatisch und ohne Aktivierung geladen wird. Überschreibe den Installationspfad, um das Verzeichnis für Must-Use-Plugins als Ziel festzulegen:
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/mu-plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
WordPress lädt automatisch nur PHP-Dateien im Stammverzeichnis von mu-plugins/, keine Dateien in Unterverzeichnissen. Füge eine Loader-Datei hinzu:
<?php
require_once WPMU_PLUGIN_DIR . '/blockstudio/blockstudio.php';
Keine Aktivierung nötig. Blockstudio wird bei jeder Anfrage automatisch geladen.
In einem Theme gebündelt
Installiere Blockstudio als Abhängigkeit in deinem Theme. So bleibt alles eigenständig, ohne dass ein separates Plugin erforderlich ist.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Binde es in der functions.php deines Themes ein:
<?php
require_once __DIR__ . '/vendor/autoload.php';
Blockstudio wird automatisch über den Composer-Autoloader initialisiert, wenn es von WordPress geladen wird. Asset-URLs verweisen auf das richtige Theme-Verzeichnis. Blöcke im Ordner blockstudio/ deines Themes funktionieren genauso wie bei einer Plugin-Installation. Das funktioniert auch, wenn das öffentliche Theme-Verzeichnis ein Symlink ist: Blockstudio bildet den physischen Pfad des Pakets über URL des aktiven oder übergeordneten Themes ab, statt den Serverpfad offenzulegen.
In einem Plugin gebündelt
Installiere Blockstudio als Abhängigkeit in einem anderen Plugin. Derselbe Autoload-Bootstrap kommt zum Einsatz.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Binde es in der Hauptdatei deines Plugins ein:
<?php
/*
Plugin Name: My Plugin
*/
require_once __DIR__ . '/vendor/autoload.php';
Asset-URLs verweisen auf das richtige Vendor-Verzeichnis des Plugins.
Prüfungen der unterstützten Lademodi
Blockstudio überprüft fortlaufend dasselbe Paket in vier unterstützten Laufzeitumgebungen:
| Modus | Bootstrap |
|---|---|
| WordPress-Plugin | WordPress aktiviert blockstudio.php |
| Must-Use-Plugin | Ein Loader im Stammverzeichnis bindet den Paketeinstiegspunkt ein |
| Composer-Abhängigkeit in einem Theme | Das Theme lädt den Composer-Autoloader |
| Composer-Abhängigkeit in einem Plugin | Das Host-Plugin lädt den Composer-Autoloader |
Jeder Modus startet WordPress mit demselben Ergebnis: einer Blockstudio-Instanz mit definierter BLOCKSTUDIO_VERSION und ohne eine zusätzliche Host-Abstraktion darunter.
Benutzerdefiniertes Paket-URL
Installationen als normales Plugin, Must-Use-Plugin, gebündeltes Plugin, aktives Theme, übergeordnetes Theme und Theme mit Symlink werden automatisch erkannt. Bei einem benutzerdefinierten Deployment, in dem das Paket über ein anderes öffentliches URL bereitgestellt wird, definiere BLOCKSTUDIO_URL, bevor Composer Blockstudio lädt. Den abschließenden Schrägstrich beibehalten:
<?php
define(
'BLOCKSTUDIO_URL',
get_stylesheet_directory_uri() . '/packages/blockstudio/'
);
require_once __DIR__ . '/vendor/autoload.php';
Du kannst stattdessen blockstudio/url registrieren, bevor du den Composer-Autoloader lädst:
<?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';
Der Filter erhält das aufgelöste URL und das physische Paketverzeichnis.
Abhängigkeiten
Die Laufzeitabhängigkeiten von Blockstudio (TailwindPHP, ScssPhp, Minify) sind im Plugin gebündelt und in Namespaces isoliert. Die einzige Composer-Abhängigkeit, die in deinem Verzeichnis vendor/ installiert wird, ist yahnis-elsts/plugin-update-checker; sie löst Versionskonflikte intern auf.
composer.json requires:
php >= 8.2
yahnis-elsts/plugin-update-checker ^5.6
Updates
Composer-Installationen erhalten Updates über Composer. Der integrierte GitHub-Updater wird automatisch deaktiviert, wenn Blockstudio aus einem Verzeichnis vendor/ geladen wird.