Composer
Blockstudio è disponibile su Packagist. A seconda della configurazione del progetto, è possibile installarlo tramite Composer in diversi modi.
Come plugin
Usa composer/installers per installare Blockstudio direttamente nella directory wp-content/plugins/. È l’approccio standard per i progetti WordPress gestiti da Composer, come Bedrock.
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
Attiva Blockstudio dall’area di amministrazione di WordPress o tramite WP-CLI:
wp plugin activate blockstudio
L’autoloader Composer del progetto deve essere caricato dall’app WordPress affinché Composer possa registrare Blockstudio. In Bedrock questo avviene automaticamente. Nelle altre configurazioni, usa un plugin obbligatorio:
<?php
require_once dirname( __DIR__, 2 ) . '/vendor/autoload.php';
Quando Blockstudio viene incluso tramite l’autoloader di Composer prima che WordPress inizi a caricare i plugin, il bootstrap di Composer rimanda l’inizializzazione finché l’ambiente di caricamento dei plugin non è disponibile. Ciò consente a Bedrock e ad altre configurazioni Composer a livello di sito di includere il pacchetto in anticipo senza avviare Blockstudio prima che le API dei plugin di WordPress siano pronte.
Come plugin obbligatorio
Installa Blockstudio in mu-plugins/ per caricarlo automaticamente senza attivazione. Modifica il percorso dell’installer per usare la directory mu-plugins:
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/mu-plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
WordPress carica automaticamente solo i file PHP nella directory radice di mu-plugins/, non nelle sottodirectory. Aggiungi un file loader:
<?php
require_once WPMU_PLUGIN_DIR . '/blockstudio/blockstudio.php';
Non serve attivarlo. Blockstudio viene caricato automaticamente a ogni richiesta.
Incluso in un tema
Installa Blockstudio come dipendenza all’interno del tema. Tutto rimane così autonomo e non è necessario un plugin separato.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Caricalo nel file functions.php del tema:
<?php
require_once __DIR__ . '/vendor/autoload.php';
Blockstudio esegue automaticamente il bootstrap tramite l’autoloader di Composer quando viene caricato da WordPress. Gli URL delle risorse puntano alla directory corretta del tema. I blocchi definiti nella directory blockstudio/ del tema funzionano esattamente come con un’installazione tramite plugin. Funziona anche quando la directory pubblica del tema è un symlink: Blockstudio ricava il percorso fisico del pacchetto tramite URL del tema attivo o genitore, invece di esporre il percorso del server.
Incluso in un plugin
Installa Blockstudio come dipendenza all’interno di un altro plugin. Si applica lo stesso bootstrap dell’autoload.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Caricalo nel file principale del plugin:
<?php
/*
Plugin Name: My Plugin
*/
require_once __DIR__ . '/vendor/autoload.php';
Gli URL delle risorse puntano alla directory vendor corretta del plugin.
Verifiche delle modalità di caricamento supportate
Blockstudio verifica continuamente lo stesso pacchetto in quattro posizioni runtime supportate:
| Modalità | Bootstrap |
|---|---|
| Plugin WordPress | WordPress attiva blockstudio.php |
| Plugin obbligatorio | Un loader nella directory radice richiede il punto d’ingresso del pacchetto |
| Dipendenza Composer in un tema | Il tema richiede l’autoloader di Composer |
| Dipendenza Composer in un plugin | Il plugin host richiede l’autoloader di Composer |
Tutte le modalità avviano WordPress ottenendo lo stesso risultato: una sola istanza Blockstudio con BLOCKSTUDIO_VERSION definito e nessuna seconda astrazione host sottostante.
URL del pacchetto personalizzato
Le installazioni come plugin normale, plugin obbligatorio, plugin incluso, tema attivo, tema genitore e tema con symlink vengono risolte automaticamente. Per una distribuzione personalizzata in cui il pacchetto è esposto tramite un altro URL pubblico, definisci BLOCKSTUDIO_URL prima che Composer carichi Blockstudio. Includi la barra finale:
<?php
define(
'BLOCKSTUDIO_URL',
get_stylesheet_directory_uri() . '/packages/blockstudio/'
);
require_once __DIR__ . '/vendor/autoload.php';
Puoi invece registrare blockstudio/url prima di caricare l’autoloader Composer:
<?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';
Il filtro riceve il URL risolto e la directory fisica del pacchetto.
Dipendenze
Le dipendenze runtime di Blockstudio (TailwindPHP, ScssPhp, Minify) sono incluse e hanno namespace interni al plugin. L’unica dipendenza Composer installata nella directory vendor/ è yahnis-elsts/plugin-update-checker, che gestisce internamente la risoluzione dei conflitti di versione.
composer.json requires:
php >= 8.2
yahnis-elsts/plugin-update-checker ^5.6
Aggiornamenti
Le installazioni di Composer ricevono gli aggiornamenti tramite Composer. L’aggiornatore GitHub integrato viene disattivato automaticamente quando Blockstudio viene caricato da una directory vendor/.