Composer
Blockstudio está disponible en Packagist. Hay varias formas de instalarlo con Composer según la configuración de su proyecto.
Como plugin
Use composer/installers para instalar Blockstudio directamente en el directorio wp-content/plugins/. Es el método estándar para proyectos WordPress administrados por Composer, como Bedrock.
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
Active Blockstudio desde el panel de administración de WordPress o mediante WP-CLI:
wp plugin activate blockstudio
El cargador automático de Composer del proyecto debe cargarse desde la aplicación WordPress para que Composer pueda registrar Blockstudio. En Bedrock, esto se gestiona automáticamente. En otras configuraciones, use un plugin de uso obligatorio:
<?php
require_once dirname( __DIR__, 2 ) . '/vendor/autoload.php';
Cuando Blockstudio se incluye mediante el cargador automático de Composer antes de que WordPress empiece a cargar plugins, el proceso de inicialización de Composer retrasa el inicio hasta que el entorno de carga de plugins esté disponible. Así, Bedrock y otras configuraciones de Composer para el sitio pueden incluir el paquete pronto sin iniciar Blockstudio antes de que estén listas las API de plugins de WordPress.
Como plugin de uso obligatorio
Instale Blockstudio en mu-plugins/ para que se cargue automáticamente sin activarlo. Cambie la ruta del instalador para usar el directorio de plugins de uso obligatorio:
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/mu-plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
WordPress solo carga automáticamente los archivos PHP que están en la raíz de mu-plugins/, no los de subdirectorios. Añada un archivo de carga:
<?php
require_once WPMU_PLUGIN_DIR . '/blockstudio/blockstudio.php';
No hace falta activarlo. Blockstudio se carga automáticamente en cada solicitud.
Incluido en un tema
Instale Blockstudio como dependencia dentro de su tema. Así, todo queda integrado sin necesidad de un plugin independiente.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Cárguelo en functions.php de su tema:
<?php
require_once __DIR__ . '/vendor/autoload.php';
Blockstudio se inicia automáticamente mediante el cargador automático de Composer cuando lo carga WordPress. Las URL de los recursos apuntan al directorio correcto del tema. Los bloques definidos en la carpeta blockstudio/ del tema funcionan igual que con una instalación mediante plugin. También funciona si el directorio público del tema es un enlace simbólico:
Blockstudio asigna la ruta física del paquete a través del URL del tema activo o principal, en lugar de exponer la ruta del servidor.
Incluido en un plugin
Instale Blockstudio como dependencia dentro de otro plugin. Se aplica el mismo proceso de carga automática.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Cárguelo en el archivo principal del plugin:
<?php
/*
Plugin Name: My Plugin
*/
require_once __DIR__ . '/vendor/autoload.php';
Las URL de los recursos apuntan al directorio correcto de proveedores del plugin.
Comprobaciones de los modos de carga admitidos
Blockstudio verifica continuamente el mismo paquete en cuatro posiciones de ejecución admitidas:
| Modo | Bootstrap |
|---|---|
| Plugin WordPress | WordPress activa blockstudio.php |
| Plugin de uso obligatorio | Un cargador raíz requiere el punto de entrada del paquete |
| Dependencia de Composer en un tema | El tema requiere el cargador automático de Composer |
| Dependencia de Composer en un plugin | El plugin anfitrión requiere el cargador automático de Composer |
Todos los modos inician WordPress con el mismo resultado: una instancia de Blockstudio con BLOCKSTUDIO_VERSION definido y sin una segunda abstracción anfitriona subyacente.
URL de paquete personalizado
Las instalaciones como plugin normal, plugin de uso obligatorio, plugin integrado, tema activo, tema principal y tema con enlace simbólico se resuelven automáticamente. Para una implementación personalizada en la que se exponga el paquete a través de otro URL público, defina BLOCKSTUDIO_URL antes de que Composer cargue Blockstudio. Incluya la barra diagonal final:
<?php
define(
'BLOCKSTUDIO_URL',
get_stylesheet_directory_uri() . '/packages/blockstudio/'
);
require_once __DIR__ . '/vendor/autoload.php';
También puede registrar blockstudio/url antes de cargar el cargador automático de 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';
El filtro recibe el URL resuelto y el directorio físico del paquete.
Dependencias
Las dependencias de ejecución de Blockstudio (TailwindPHP, ScssPhp, Minify) se incluyen con el plugin y usan espacios de nombres internos. La única dependencia Composer instalada en el directorio vendor/ es yahnis-elsts/plugin-update-checker, que gestiona internamente la resolución de conflictos entre versiones.
composer.json requires:
php >= 8.2
yahnis-elsts/plugin-update-checker ^5.6
Actualizaciones
Las instalaciones de Composer reciben actualizaciones a través de Composer. El actualizador GitHub integrado se desactiva automáticamente cuando Blockstudio se carga desde un directorio vendor/.