Ugrás a tartalomhoz

Composer

A Blockstudio elérhető itt: Packagist. A projekt beállításaitól függően többféleképpen telepíthető a Composer segítségével.

Bővítményként

A composer/installers segítségével közvetlenül telepítheti a Blockstudio elemet a wp-content/plugins/ könyvtárába. Ez a szokásos megoldás a Composer által kezelt, például Bedrock típusú WordPress projektekhez.

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

Aktiválja a Blockstudio elemet a WordPress adminisztrációs felületén vagy a WP-CLI segítségével:

Shell
wp plugin activate blockstudio

A projekt Composer automatikus betöltőjét a WordPress alkalmazásnak kell betöltenie, hogy a Composer regisztrálhassa a Blockstudio elemet. Bedrock esetén ez automatikusan történik. Más környezetben használjon kötelezően betöltődő bővítményt:

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

Ha a Blockstudio a Composer automatikus betöltőjén keresztül, a WordPress által megkezdett bővítménybetöltés előtt kerül be, a Composer indítófolyamata elhalasztja az inicializálást, amíg a bővítménybetöltési környezet elérhetővé nem válik. Így a Bedrock és más, a webhely szintjén működő Composer beállítások korán betölthetik a csomagot anélkül, hogy a Blockstudio eleme inicializálódna, mielőtt a WordPress bővítmény API-jai elkészülnének.

Kötelezően betöltődő bővítményként

Telepítse a Blockstudio elemet a mu-plugins/ könyvtárba, hogy aktiválás nélkül automatikusan betöltődjön. A könyvtár célzásához írja felül a mu-plugins telepítési útvonalát:

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

A WordPress csak a mu-plugins/ gyökérkönyvtárában lévő PHP fájlokat tölti be automatikusan, az alkönyvtárakban lévőket nem. Adjon hozzá betöltőfájlt:

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

Nincs szükség aktiválásra. A Blockstudio minden kérésnél automatikusan betöltődik.

Témába csomagolva

Telepítse a Blockstudio elemet függőségként a témán belül. Így minden egy helyen marad, külön bővítmény nélkül.

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

Töltse be a téma functions.php fájljában:

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

A Blockstudio automatikusan elindul a Composer automatikus betöltőjén keresztül, amikor a WordPress betölti. Az eszközök URL-jei a megfelelő téma könyvtárára mutatnak. A téma blockstudio/ mappájában meghatározott blokkok ugyanúgy működnek, mint bővítményként telepítve. Ez akkor is működik, ha a nyilvános témakönyvtár szimbolikus hivatkozás: Blockstudio a csomag fizikai útvonalát az aktív vagy szülőtémához tartozó URL útvonalon keresztül oldja fel, így nem teszi láthatóvá a szerver útvonalát.

Bővítménybe csomagolva

Telepítse a Blockstudio elemet függőségként egy másik bővítményen belül. Ugyanez az automatikus betöltési folyamat érvényes.

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

Töltse be a bővítmény főfájljában:

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

Az eszközök URL-jei a megfelelő bővítmény vendor könyvtárára mutatnak.

A támogatott betöltési módok ellenőrzése

A Blockstudio folyamatosan ellenőrzi ugyanazt a csomagot a négy támogatott futtatókörnyezeti helyzetben:

Mód Bootstrap
WordPress bővítmény A WordPress aktiválja a blockstudio.php elemet
Kötelezően betöltődő bővítmény A gyökérkönyvtárban lévő betöltő behívja a csomag belépési pontját
Composer függőségként egy témában A téma betölti a Composer automatikus betöltőjét
Composer függőségként egy bővítményben A befogadó bővítmény betölti a Composer automatikus betöltőjét

Minden mód ugyanazt az eredményt hozza a WordPress betöltésekor: egyetlen Blockstudio példány, amelyben a BLOCKSTUDIO_VERSION definiálva van, és nincs alatta második befogadó absztrakció.

Egyéni csomag URL

A normál bővítményként, kötelezően betöltődő bővítményként, másik bővítménybe csomagolva, aktív témába vagy szülőtémába csomagolva, illetve szimbolikus hivatkozáson keresztül telepített példányok útvonala automatikusan feloldódik. Egyéni telepítésnél, amikor a csomag egy másik nyilvános URL útvonalon érhető el, határozza meg a BLOCKSTUDIO_URL értékét, mielőtt a Composer betölti a Blockstudio elemet. A záró perjelet is adja meg:

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

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

A Composer automatikus betöltőjének betöltése előtt is regisztrálhatja a blockstudio/url elemet:

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

A szűrő a feloldott URL értéket és a csomag fizikai könyvtárát kapja meg.

Függőségek

A Blockstudio futásidejű függőségei (TailwindPHP, ScssPhp, Minify) a bővítménybe csomagolva, saját névtér alatt szerepelnek. Az egyetlen telepített Composer függőség a vendor/ könyvtárba a yahnis-elsts/plugin-update-checker, amely belsőleg kezeli a verzióütközések feloldását.

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

Frissítések

A Composer telepítései a Composer szolgáltatáson keresztül kapnak frissítéseket. A beépített GitHub frissítő automatikusan letiltódik, ha a Blockstudio elemet egy vendor/ könyvtárból töltik be.