Preskoči na vsebino

Composer

Blockstudio je na voljo na Packagist. Glede na nastavitev projekta ga lahko prek Composer namestite na več načinov.

Kot vtičnik

Uporabite composer/installers za neposredno namestitev Blockstudio v imenik wp-content/plugins/. To je običajni način za projekte WordPress, ki jih upravlja Composer, kot je Bedrock.

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

Aktivirajte Blockstudio prek skrbniškega vmesnika WordPress ali z ukazom WP-CLI:

Lupina
wp plugin activate blockstudio

Avtonalagalnik Composer vašega projekta mora naložiti aplikacija WordPress, da lahko Composer registrira Blockstudio. V Bedrock se to izvede samodejno. V drugih nastavitvah uporabite obvezni vtičnik:

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

Ko je Blockstudio vključen prek avtonalagalnika Composer, preden začne WordPress nalagati vtičnike, zagonski postopek Composer odloži inicializacijo, dokler ni na voljo okolje za nalaganje vtičnikov. Tako lahko Bedrock in druge nastavitve Composer na ravni mesta vključijo paket zgodaj, ne da bi zagnale Blockstudio, preden so pripravljeni API-ji vtičnikov WordPress.

Kot obvezni vtičnik

Namestite Blockstudio v mu-plugins/, da se samodejno naloži brez aktivacije. Prepišite pot namestitvenega programa, da ciljate na imenik mu-plugins:

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

WordPress samodejno naloži samo datoteke PHP v korenu mu-plugins/, ne pa tudi v podimenikih. Dodajte nalagalno datoteko:

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

Aktivacija ni potrebna. Blockstudio se samodejno naloži ob vsaki zahtevi.

Vključen v temo

Namestite Blockstudio kot odvisnost v svoji temi. Tako vse ostane na enem mestu, brez potrebe po ločenem vtičniku.

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

Naložite ga v functions.php svoje teme:

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

Blockstudio se samodejno zažene prek avtonalagalnika Composer, ko ga naloži WordPress. URL-ji sredstev kažejo na pravi imenik teme. Bloki, določeni v mapi blockstudio/ vaše teme, delujejo enako kot pri namestitvi vtičnika. To deluje tudi, kadar je javni imenik teme simbolna povezava: Blockstudio preslika fizično pot paketa prek URL aktivne ali nadrejene teme namesto razkritja poti strežnika.

Vključen v vtičnik

Namestite Blockstudio kot odvisnost v drug vtičnik. Velja enak zagonski postopek z avtonalagalnikom.

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

Naložite ga v glavni datoteki vtičnika:

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

URL-ji sredstev kažejo na pravi imenik ponudnikov vtičnika.

Preverjanja podprtih načinov nalaganja

Blockstudio neprekinjeno preverja isti paket na štirih podprtih mestih izvajanja:

Način Bootstrap
Vtičnik WordPress WordPress aktivira blockstudio.php
Obvezni vtičnik Korenski nalagalnik zahteva vstopno točko paketa
Odvisnost Composer v temi Tema zahteva avtonalagalnik Composer
Odvisnost Composer v vtičniku Gostiteljski vtičnik zahteva avtonalagalnik Composer

Vsak način zažene WordPress z enakim rezultatom: en primerek Blockstudio z definicijo BLOCKSTUDIO_VERSION in brez dodatne abstrakcije gostitelja.

URL paketa po meri

Namestitve kot običajni vtičnik, obvezni vtičnik, vključeni vtičnik, aktivna tema, nadrejena tema in tema s simbolno povezavo se razrešijo samodejno. Pri namestitvi po meri, kjer je paket izpostavljen prek drugega javnega URL, določite BLOCKSTUDIO_URL, preden Composer naloži Blockstudio. Vključite zaključno poševnico:

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

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

Lahko pa registrirate blockstudio/url, preden naložite avtonalagalnik 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 prejme razrešeni URL in fizični imenik paketa.

Odvisnosti

Izvajalne odvisnosti za Blockstudio (TailwindPHP, ScssPhp, Minify) so vključene in uporabljajo lastna imenska prostora v vtičniku. Edina odvisnost Composer, nameščena v vaš imenik vendor/, je yahnis-elsts/plugin-update-checker, ki interno obravnava razreševanje sporov med različicami.

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

Posodobitve

Namestitve Composer prejemajo posodobitve prek Composer. Vgrajeni posodabljalnik GitHub je samodejno onemogočen, ko je Blockstudio naložen iz imenika vendor/.