Vai al contenuto

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.

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

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

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

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

Caricalo nel file functions.php del tema:

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

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

Caricalo nel file principale del plugin:

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

Codice
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/.