Към съдържанието

Composer

Blockstudio е наличен в Packagist. Има няколко начина да го инсталирате чрез Composer в зависимост от конфигурацията на проекта ви.

Като плъгин

Използвайте composer/installers, за да инсталирате Blockstudio директно в директорията wp-content/plugins/. Това е стандартният подход за проекти WordPress, управлявани чрез Composer, като Bedrock.

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

Активирайте Blockstudio през администрацията на WordPress или чрез WP-CLI:

Обвивка
wp plugin activate blockstudio

Автозареждащият механизъм на Composer в проекта ви трябва да бъде зареден от приложението WordPress, за да може Composer да регистрира Blockstudio. В Bedrock това се обработва автоматично. В други конфигурации използвайте задължителен плъгин:

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

Когато Blockstudio е включен чрез автозареждащия механизъм на Composer преди WordPress да е започнал да зарежда плъгини, началната настройка на Composer отлага инициализацията, докато средата за зареждане на плъгини стане налична. Така Bedrock и други конфигурации на Composer за ниво сайт могат да включат пакета рано, без да стартират Blockstudio, преди API на плъгините на WordPress да са готови.

Като задължителен плъгин

Инсталирайте Blockstudio в mu-plugins/, за да се зарежда автоматично без активиране. Задайте различен път на инсталатора, така че да сочи към директорията mu-plugins:

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

WordPress зарежда автоматично само файловете PHP в основната директория на mu-plugins/, а не в поддиректории. Добавете файл за зареждане:

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

Не е необходимо активиране. Blockstudio се зарежда автоматично при всяка заявка.

Включване в тема

Инсталирайте Blockstudio като зависимост в темата си. Така всичко остава в един пакет, без да е необходим отделен плъгин.

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

Заредете го във файла functions.php на темата си:

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

Blockstudio се зарежда автоматично чрез автозареждащия механизъм на Composer, когато е зареден от WordPress. URL адресите на ресурсите сочат към правилната директория на темата. Блоковете, дефинирани в папката blockstudio/ на темата ви, работят точно както при инсталиране като плъгин. Това работи и когато публичната директория на темата е символна връзка: Blockstudio свързва физическия път на пакета с URL на активната или родителската тема, вместо да разкрива пътя на сървъра.

Включване в плъгин

Инсталирайте Blockstudio като зависимост в друг плъгин. Прилага се същата начална настройка за автозареждане.

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

Заредете го в основния файл на плъгина си:

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

URL адресите на ресурсите сочат към правилната директория на доставчика на плъгина.

Проверки на поддържаните режими на зареждане

Blockstudio непрекъснато проверява един и същ пакет в четири поддържани позиции по време на изпълнение:

Режим Bootstrap
плъгин WordPress WordPress активира blockstudio.php
Задължителен плъгин Зареждащ файл в основната директория изисква входната точка на пакета
Зависимост Composer в тема Темата изисква автозареждащия механизъм на Composer
Зависимост Composer в плъгин Хостващият плъгин изисква автозареждащия механизъм на Composer

Всеки режим стартира WordPress с един и същ резултат: един екземпляр на Blockstudio с дефиниран BLOCKSTUDIO_VERSION и без допълнителна абстракция на хоста.

Персонализиран пакет URL

Инсталациите като обикновен плъгин, задължителен плъгин, включен плъгин, активна тема, родителска тема и тема чрез символна връзка се разрешават автоматично. При персонализирано внедряване, където пакетът се предоставя чрез друг публичен URL, задайте BLOCKSTUDIO_URL, преди Composer да зареди Blockstudio. Включете наклонената черта в края:

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

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

Вместо това можете да регистрирате blockstudio/url, преди да заредите автозареждащия механизъм на 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';

Филтърът получава разрешения URL и физическата директория на пакета.

Зависимости

Зависимостите за изпълнение на Blockstudio (TailwindPHP, ScssPhp, Minify) са включени в плъгина с отделни пространства от имена. Единствената зависимост Composer, инсталирана в директорията vendor/, е yahnis-elsts/plugin-update-checker, която вътрешно разрешава конфликти между версиите.

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

Обновявания

Инсталациите на Composer получават обновявания чрез Composer. Вграденият инструмент за обновяване на GitHub се деактивира автоматично, когато Blockstudio е зареден от директория vendor/.