Przejdź do treści

Composer

Blockstudio jest dostępny w Packagist. Istnieje kilka sposobów instalacji przez Composer, zależnie od konfiguracji projektu.

Jako wtyczka

Użyj composer/installers, aby zainstalować Blockstudio bezpośrednio w katalogu wp-content/plugins/. To standardowe podejście w projektach WordPress zarządzanych przez Composer, takich jak Bedrock.

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

Aktywuj Blockstudio w panelu administracyjnym WordPress lub przez WP-CLI:

Powłoka
wp plugin activate blockstudio

Autoloader Composer projektu musi zostać załadowany przez aplikację WordPress, aby Composer mógł zarejestrować Blockstudio. W Bedrock odbywa się to automatycznie. W pozostałych konfiguracjach użyj wtyczki must-use:

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

Gdy Blockstudio zostaje dołączony przez autoloader Composer, zanim WordPress rozpocznie ładowanie wtyczek, bootstrap Composer opóźnia inicjalizację do chwili, gdy środowisko ładowania wtyczek będzie dostępne. Dzięki temu Bedrock i inne konfiguracje Composer na poziomie witryny mogą dołączyć pakiet wcześniej, nie uruchamiając Blockstudio przed przygotowaniem API wtyczek WordPress.

Jako wtyczka must-use

Zainstaluj Blockstudio w mu-plugins/, aby ładował się automatycznie bez aktywacji. Zmień ścieżkę instalatora, aby wskazywała katalog mu-plugins:

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

WordPress automatycznie ładuje tylko pliki PHP znajdujące się w katalogu głównym mu-plugins/, a nie w podkatalogach. Dodaj plik ładujący:

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

Aktywacja nie jest potrzebna. Blockstudio ładuje się automatycznie przy każdym żądaniu.

W pakiecie motywu

Zainstaluj Blockstudio jako zależność w motywie. Wszystko pozostanie w jednym pakiecie, bez potrzeby instalowania osobnej wtyczki.

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

Załaduj go w pliku functions.php motywu:

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

Blockstudio uruchamia się automatycznie przez autoloader Composer, gdy zostanie załadowany przez WordPress. Adresy URL zasobów wskazują właściwy katalog motywu. Bloki zdefiniowane w katalogu blockstudio/ motywu działają tak samo jak przy instalacji wtyczki. Działa to również wtedy, gdy publiczny katalog motywu jest dowiązaniem symbolicznym: Blockstudio mapuje fizyczną ścieżkę pakietu za pośrednictwem URL aktywnego motywu lub motywu nadrzędnego, zamiast ujawniać ścieżkę serwera.

W pakiecie wtyczki

Zainstaluj Blockstudio jako zależność innej wtyczki. Obowiązuje ten sam mechanizm bootstrapu autoloadera.

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

Załaduj go w głównym pliku wtyczki:

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

Adresy URL zasobów wskazują właściwy katalog vendor wtyczki.

Testy obsługiwanych trybów ładowania

Blockstudio stale weryfikuje ten sam pakiet w czterech obsługiwanych pozycjach środowiska uruchomieniowego:

Tryb Bootstrap
Wtyczka WordPress WordPress aktywuje blockstudio.php
Wtyczka must-use Główny plik ładujący wymaga punktu wejścia pakietu
Zależność Composer w motywie Motyw wymaga autoloadera Composer
Zależność Composer we wtyczce Wtyczka hosta wymaga autoloadera Composer

Każdy tryb uruchamia WordPress z tym samym rezultatem: jedna instancja Blockstudio z zdefiniowanym BLOCKSTUDIO_VERSION, bez dodatkowej abstrakcji hosta pod spodem.

Pakiet niestandardowy URL

Instalacje jako zwykła wtyczka, wtyczka must-use, pakiet wtyczki, aktywny motyw, motyw nadrzędny i motyw z dowiązaniem symbolicznym są obsługiwane automatycznie. W przypadku niestandardowego wdrożenia, w którym pakiet jest udostępniany przez inny publiczny URL, zdefiniuj BLOCKSTUDIO_URL, zanim Composer załaduje Blockstudio. Uwzględnij końcowy ukośnik:

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

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

Możesz też zarejestrować blockstudio/url przed załadowaniem 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';

Filtr otrzymuje rozwiązaną wartość URL oraz fizyczny katalog pakietu.

Zależności

Zależności środowiska uruchomieniowego Blockstudio (TailwindPHP, ScssPhp, Minify) są dołączone do wtyczki z własnymi przestrzeniami nazw. Jedyną zależnością Composer instalowaną w katalogu vendor/ jest yahnis-elsts/plugin-update-checker, który wewnętrznie obsługuje rozwiązywanie konfliktów wersji.

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

Aktualizacje

Instalacje Composer otrzymują aktualizacje przez Composer. Wbudowany aktualizator GitHub jest automatycznie wyłączany, gdy Blockstudio jest ładowany z katalogu vendor/.