Preskočiť na obsah

Composer

Blockstudio je dostupný na Packagist. V závislosti od nastavenia projektu ho možno nainštalovať niekoľkými spôsobmi cez Composer.

Ako doplnok

Pomocou composer/installers nainštalujete Blockstudio priamo do adresára wp-content/plugins/. Ide o štandardný postup pri projektoch WordPress spravovaných cez Composer, ako je Bedrock.

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

Aktivujte Blockstudio cez administráciu WordPress alebo pomocou WP-CLI:

Shell
wp plugin activate blockstudio

Autoloader projektu Composer musí načítať aplikácia WordPress, aby Composer mohol zaregistrovať Blockstudio. V prostredí Bedrock sa to zabezpečuje automaticky. V ostatných nastaveniach použite povinný doplnok:

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

Keď sa Blockstudio načíta cez autoloader Composer ešte predtým, než WordPress začne načítavať doplnky, zavádzací kód Composer odloží inicializáciu, kým nebude dostupné prostredie na načítanie doplnkov. Vďaka tomu môžu Bedrock a ďalšie nastavenia Composer na úrovni webu zahrnúť balík včas bez spustenia Blockstudio skôr, než budú pripravené rozhrania API doplnkov WordPress.

Ako povinný doplnok

Nainštalujte Blockstudio do mu-plugins/, aby sa načítal automaticky bez aktivácie. Prepíšte cestu inštalátora tak, aby smerovala do adresára mu-plugins:

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

WordPress automaticky načítava iba súbory PHP v koreňovom adresári mu-plugins/, nie v podadresároch. Pridajte zavádzací súbor:

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

Aktivácia nie je potrebná. Blockstudio sa automaticky načítava pri každej požiadavke.

Zabalený v téme

Nainštalujte Blockstudio ako závislosť vo svojej téme. Všetko tak zostane samostatné bez potreby osobitného doplnku.

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

Načítajte ho v súbore functions.php svojej témy:

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

Blockstudio sa automaticky inicializuje cez autoloader Composer, keď ho načíta WordPress. Adresy URL zdrojov sa správne odvodia od adresára témy. Bloky definované v priečinku blockstudio/ vašej témy fungujú rovnako ako pri inštalácii doplnku. Funguje to aj vtedy, keď je verejný adresár témy symbolickým odkazom: Blockstudio priradí fyzickú cestu balíka k adresáru URL aktívnej alebo nadradenej témy namiesto odhalenia cesty na serveri.

Zabalený v doplnku

Nainštalujte Blockstudio ako závislosť v inom doplnku. Použije sa rovnaký zavádzací kód pre autoload.

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

Načítajte ho v hlavnom súbore doplnku:

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

Adresy URL zdrojov sa správne odvodia od adresára dodávateľa doplnku.

Kontroly podporovaných režimov načítania

Blockstudio priebežne overuje ten istý balík v štyroch podporovaných pozíciách behu:

Režim Bootstrap
Doplnok WordPress WordPress aktivuje blockstudio.php
Povinný doplnok Koreňový zavádzač vyžaduje vstupný bod balíka
Závislosť Composer v téme Téma vyžaduje autoloader Composer
Závislosť Composer v doplnku Hostiteľský doplnok vyžaduje autoloader Composer

Každý režim spustí WordPress s rovnakým výsledkom: jedna inštancia Blockstudio s definovaným BLOCKSTUDIO_VERSION a bez ďalšej abstrakcie hostiteľa na nižšej úrovni.

Vlastný balík URL

Bežná inštalácia doplnku, povinného doplnku, zabaleného doplnku, aktívnej témy, nadradenej témy aj témy so symbolickým odkazom sa rozpozná automaticky. Pri vlastnom nasadení, kde je balík sprístupnený cez iný verejný súbor URL, definujte BLOCKSTUDIO_URL pred načítaním Composer Blockstudio. Nezabudnite na koncovú lomku:

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

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

Namiesto toho môžete zaregistrovať blockstudio/url pred načítaním autoloadera 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';

Filter dostane vyriešenú cestu URL a fyzický adresár balíka.

Závislosti

Závislosti prostredia Blockstudio (TailwindPHP, ScssPhp, Minify) sú zabalené a majú vlastné menné priestory v doplnku. Jediná závislosť Composer nainštalovaná do vášho adresára vendor/ je yahnis-elsts/plugin-update-checker, ktorá interne rieši konflikty verzií.

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

Aktualizácie

Inštalácie Composer dostávajú aktualizácie cez Composer. Vstavaný aktualizátor GitHub sa automaticky vypne, keď sa Blockstudio načíta z adresára vendor/.