Saltar al contenido

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.

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

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

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

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

Cárguelo en functions.php de su tema:

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

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

Cárguelo en el archivo principal del plugin:

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

Código
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/.