Treci la conținut

Composer

Blockstudio este disponibil pe Packagist. Există mai multe modalități de instalare prin Composer, în funcție de configurația proiectului.

Ca plugin

Folosiți composer/installers pentru a instala Blockstudio direct în directorul wp-content/plugins/. Aceasta este abordarea standard pentru proiectele WordPress gestionate de Composer, precum Bedrock.

JSON
{
  "require": {
    "composer/installers": "^2.0",
    "blockstudio/blockstudio": "^7.0"
  },
  "extra": {
    "installer-paths": {
      "wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
    }
  }
}

Activați Blockstudio prin panoul de administrare WordPress sau prin WP-CLI:

Shell
wp plugin activate blockstudio

Autoloaderul Composer al proiectului trebuie încărcat de aplicația WordPress, astfel încât Composer să poată înregistra Blockstudio. În Bedrock, acest lucru este gestionat automat. În celelalte configurații, folosiți un plugin obligatoriu:

PHP
<?php
require_once dirname( __DIR__, 2 ) . '/vendor/autoload.php';

Când Blockstudio este inclus prin autoloaderul Composer înainte ca WordPress să înceapă încărcarea pluginurilor, bootstrapul Composer amână inițializarea până când mediul de încărcare a pluginurilor este disponibil. Astfel, Bedrock și alte configurații Composer la nivel de site pot include pachetul devreme, fără să inițializeze Blockstudio înainte ca API-urile pluginurilor WordPress să fie pregătite.

Ca plugin obligatoriu

Instalați Blockstudio în mu-plugins/ pentru a-l încărca automat, fără activare. Suprascrieți calea instalatorului pentru a viza directorul mu-plugins:

JSON
{
  "require": {
    "composer/installers": "^2.0",
    "blockstudio/blockstudio": "^7.0"
  },
  "extra": {
    "installer-paths": {
      "wp-content/mu-plugins/{$name}/": ["type:wordpress-plugin"]
    }
  }
}

WordPress încarcă automat doar fișierele PHP aflate în rădăcina mu-plugins/, nu și în subdirectoare. Adăugați un fișier de încărcare:

PHP
<?php
require_once WPMU_PLUGIN_DIR . '/blockstudio/blockstudio.php';

Nu este necesară activarea. Blockstudio se încarcă automat la fiecare cerere.

Inclus într-o temă

Instalați Blockstudio ca dependență în tema dvs. Astfel, totul rămâne autonom, fără să fie nevoie de un plugin separat.

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

Încărcați-l în fișierul functions.php al temei:

PHP
<?php
require_once __DIR__ . '/vendor/autoload.php';

Blockstudio se inițializează automat prin autoloaderul Composer atunci când este încărcat de WordPress. URL-urile resurselor indică directorul corect al temei. Blocurile definite în directorul blockstudio/ al temei funcționează exact ca în cazul instalării unui plugin. Acest lucru funcționează și atunci când directorul public al temei este o legătură simbolică: Blockstudio mapează calea fizică a pachetului prin URL temei active sau părinte, în loc să expună calea serverului.

Inclus într-un plugin

Instalați Blockstudio ca dependență în alt plugin. Se aplică același bootstrap al autoloaderului.

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

Încărcați-l în fișierul principal al pluginului:

PHP
<?php
/*
Plugin Name: My Plugin
*/
require_once __DIR__ . '/vendor/autoload.php';

URL-urile resurselor indică directorul vendor corect al pluginului.

Verificări pentru modurile de încărcare acceptate

Blockstudio verifică în permanență același pachet în patru poziții de runtime acceptate:

Mod Bootstrap
Plugin WordPress WordPress activează blockstudio.php
Plugin obligatoriu Un încărcător din directorul rădăcină necesită punctul de intrare al pachetului
Dependență Composer într-o temă Tema necesită autoloaderul Composer
Dependență Composer într-un plugin Pluginul gazdă necesită autoloaderul Composer

Fiecare mod inițializează WordPress cu același rezultat: o singură instanță Blockstudio, cu BLOCKSTUDIO_VERSION definit și fără o a doua abstracție gazdă dedesubt.

URL pentru pachet personalizat

Instalările ca plugin obișnuit, plugin obligatoriu, plugin grupat, temă activă, temă părinte și temă cu legătură simbolică sunt rezolvate automat. Pentru o implementare personalizată în care pachetul este expus printr-un alt URL public, definiți BLOCKSTUDIO_URL înainte ca Composer să încarce Blockstudio. Includeți bara oblică finală:

PHP
<?php
define(
    'BLOCKSTUDIO_URL',
    get_stylesheet_directory_uri() . '/packages/blockstudio/'
);

require_once __DIR__ . '/vendor/autoload.php';

În schimb, puteți înregistra blockstudio/url înainte de a încărca autoloaderul 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';

Filtrul primește URL rezolvat și directorul fizic al pachetului.

Dependențe

Dependențele runtime ale Blockstudio (TailwindPHP, ScssPhp, Minify) sunt incluse și au namespace în plugin. Singura dependență Composer instalată în directorul vendor/ este yahnis-elsts/plugin-update-checker, care gestionează intern rezolvarea conflictelor de versiune.

Cod
composer.json requires:
  php >= 8.2
  yahnis-elsts/plugin-update-checker ^5.6

Actualizări

Instalările Composer primesc actualizări prin Composer. Programul de actualizare GitHub integrat este dezactivat automat când Blockstudio este încărcat dintr-un director vendor/.