Zum Inhalt springen

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.

JSON
{
  "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:

Shell
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
<?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:

JSON
{
  "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
<?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.

JSON
{
  "require": {
    "blockstudio/blockstudio": "^7.0"
  }
}

Binde es in der functions.php deines Themes ein:

PHP
<?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.

JSON
{
  "require": {
    "blockstudio/blockstudio": "^7.0"
  }
}

Binde es in der Hauptdatei deines Plugins ein:

PHP
<?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
<?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
<?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.

Code
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.