Pereiti prie turinio

Composer

Blockstudio pasiekiamas per Packagist. Priklausomai nuo projekto sąrankos, jį galima įdiegti keliais būdais per Composer.

Kaip papildinį

Naudokite composer/installers, kad įdiegtumėte Blockstudio tiesiai į savo wp-content/plugins/ katalogą. Tai įprastas būdas Composer valdomiems WordPress projektams, pavyzdžiui, Bedrock.

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

Aktyvinkite Blockstudio per WordPress administravimo aplinką arba naudodami WP-CLI:

Shell
wp plugin activate blockstudio

Jūsų projekto Composer automatinio įkėlimo programa turi būti įkelta WordPress programos, kad Composer galėtų užregistruoti Blockstudio. Bedrock tai atliekama automatiškai. Kitose sąrankose naudokite privalomąjį papildinį:

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

Kai Blockstudio įtraukiamas per Composer automatinio įkėlimo programą prieš WordPress pradedant įkelti papildinius, Composer paleidimo kodas atideda inicijavimą, kol bus paruošta papildinių įkėlimo aplinka. Taip Bedrock ir kitos svetainės lygmens Composer sąrankos gali įtraukti paketą anksčiau, nepaleisdamos Blockstudio, kol neparuoštos WordPress papildinių API.

Kaip privalomąjį papildinį

Įdiekite Blockstudio į mu-plugins/, kad jis būtų įkeliamas automatiškai ir jo nereikėtų aktyvinti. Pakeiskite diegimo programos kelią, kad jis nurodytų mu-plugins katalogą:

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

WordPress automatiškai įkelia tik PHP failus, esančius mu-plugins/ šakniniame kataloge, bet ne poaplankiuose. Sukurkite įkėlimo failą:

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

Aktyvinti nereikia. Blockstudio automatiškai įkeliamas su kiekviena užklausa.

Įtrauktas į temą

Įdiekite Blockstudio kaip priklausomybę savo temoje. Taip viskas lieka vienoje vietoje ir nereikia atskiro papildinio.

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

Įkelkite jį temoje esančiame functions.php:

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

Blockstudio automatiškai paleidžiamas per Composer automatinio įkėlimo programą, kai jį įkelia WordPress. Išteklių URL nurodo tinkamą temos katalogą. Jūsų temos blockstudio/ aplanke apibrėžti blokai veikia taip pat kaip ir įdiegus papildinį. Tai veikia ir tada, kai viešas temos katalogas yra simbolinė nuoroda: Blockstudio susieja fizinį paketo kelią su aktyviosios arba pagrindinės temos URL, todėl serverio kelias neatskleidžiamas.

Įtrauktas į papildinį

Įdiekite Blockstudio kaip priklausomybę kitame papildinyje. Taikomas tas pats automatinio įkėlimo paleidimo kodas.

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

Įkelkite jį pagrindiniame papildinio faile:

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

Išteklių URL nurodo tinkamą papildinio tiekėjo katalogą.

Palaikomų įkėlimo režimų patikros

Blockstudio nuolat tikrina tą patį paketą keturiose palaikomose vykdymo aplinkose:

Režimas Bootstrap
WordPress papildinys WordPress aktyvina blockstudio.php
Privalomasis papildinys Šakniniame kataloge esantis įkėlimo failas reikalauja paketo įvesties taško
Composer priklausomybė temoje Tema reikalauja Composer automatinio įkėlimo programos
Composer priklausomybė papildinyje Pagrindinis papildinys reikalauja Composer automatinio įkėlimo programos

Visais režimais WordPress paleidžiamas taip pat: sukuriamas vienas Blockstudio egzempliorius, apibrėžiamas BLOCKSTUDIO_VERSION ir nenaudojama jokia papildoma pagrindinė abstrakcija.

Pasirinktinio paketo URL

Įprastas papildinys, privalomasis papildinys, įtrauktas papildinys, aktyvioji tema, pagrindinė tema ir įdiegimai su simboline temos nuoroda nustatomi automatiškai. Jei pasirinktiniame diegime paketas pateikiamas per kitą viešą URL, apibrėžkite BLOCKSTUDIO_URL prieš Composer įkeliant Blockstudio. Pabaigoje pridėkite pasvirąjį brūkšnį:

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

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

Taip pat galite užregistruoti blockstudio/url prieš įkeldami Composer automatinio įkėlimo programą:

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';

Filtras gauna nustatytą URL ir fizinį paketo katalogą.

Priklausomybės

Blockstudio vykdymo aplinkos priklausomybės (TailwindPHP, ScssPhp, Minify) įtrauktos į papildinį ir naudoja vardų sritis. Vienintelė Composer priklausomybė, įdiegiama į jūsų vendor/ katalogą, yra yahnis-elsts/plugin-update-checker; ji viduje išsprendžia versijų konfliktus.

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

Atnaujinimai

Composer diegimo aplinkos naujinimus gauna per Composer. Įtaisytasis GitHub naujinimo įrankis automatiškai išjungiamas, kai Blockstudio įkeliamas iš vendor/ katalogo.