Siirry sisältöön

Composer

Blockstudio on saatavilla osoitteessa Packagist. Voit asentaa sen Composer-työkalulla usealla tavalla projektisi kokoonpanon mukaan.

Lisäosana

Asenna composer/installers suoraan hakemistoon wp-content/plugins/ työkalulla Blockstudio. Tämä on tavanomainen tapa Composer-hallituissa WordPress-projekteissa, kuten Bedrock.

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

Ota Blockstudio käyttöön WordPress-hallinnassa tai komennolla WP-CLI:

Shell
wp plugin activate blockstudio

Projektisi Composer-autoloaderin on oltava WordPress-sovelluksen lataama, jotta Composer voi rekisteröidä Blockstudio-toiminnon. Bedrock hoitaa tämän automaattisesti. Muissa kokoonpanoissa käytä pakollista lisäosaa:

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

Kun Blockstudio sisällytetään Composer-autoloaderin kautta ennen kuin WordPress on aloittanut lisäosien lataamisen, Composer-käynnistyskomponentti lykkää alustusta, kunnes lisäosien latausympäristö on käytettävissä. Näin Bedrock ja muut sivustotason Composer-kokoonpanot voivat sisällyttää paketin aikaisin käynnistämättä Blockstudio-toimintoa ennen kuin WordPress-lisäosien rajapinnat ovat valmiina.

Pakollisena lisäosana

Asenna Blockstudio hakemistoon mu-plugins/, jotta se latautuu automaattisesti ilman käyttöönottoa. Määritä asentimen polku osoittamaan mu-plugins-hakemistoon:

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

WordPress lataa automaattisesti vain hakemiston mu-plugins/ juuressa olevat PHP-tiedostot, ei alihakemistoja. Lisää lataustiedosto:

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

Käyttöönottoa ei tarvita. Blockstudio latautuu automaattisesti jokaisella pyynnöllä.

Teemaan sisällytettynä

Asenna Blockstudio riippuvuutena teemasi sisään. Näin kaikki pysyy yhdessä paketissa eikä erillistä lisäosaa tarvita.

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

Lataa se teemasi functions.php-tiedostossa:

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

Blockstudio käynnistyy automaattisesti Composer-autoloaderin kautta, kun WordPress lataa sen. Resurssien URL-osoitteet ohjautuvat oikeaan teemahakemistoon. Teemasi blockstudio/-kansiossa määritellyt lohkot toimivat samoin kuin lisäosa-asennuksessa. Tämä toimii myös silloin, kun julkinen teeman hakemisto on symbolinen linkki: Blockstudio muuntaa paketin fyysisen polun aktiivisen tai yläteeman URL-poluksi paljastamatta palvelimen polkua.

Lisäosaan sisällytettynä

Asenna Blockstudio riippuvuutena toisen lisäosan sisään. Sama automaattisen latauksen käynnistys toimii.

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

Lataa se lisäosasi päätiedostossa:

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

Resurssien URL-osoitteet ohjautuvat oikeaan lisäosan vendor-hakemistoon.

Tuetut lataustilan tarkistukset

Blockstudio tarkistaa jatkuvasti saman paketin neljässä tuetussa suoritusympäristön sijainnissa:

Tila Bootstrap
WordPress-lisäosa WordPress aktivoi kohteen blockstudio.php
Pakollinen lisäosa Juurilataaja vaatii paketin aloituspisteen
Composer-riippuvuus teemassa Teema vaatii kohteen Composer autoloaderin
Composer-riippuvuus lisäosassa Isäntälisäosa vaatii kohteen Composer autoloaderin

Kaikki tilat käynnistävät WordPress-toiminnon samalla tavalla: yksi Blockstudio-ilmentymä, BLOCKSTUDIO_VERSION määritettynä, eikä alla ole toista isäntäabstraktiota.

Mukautettu paketti URL

Tavallisen lisäosan, pakollisen lisäosan, lisäosaan sisällytetyn paketin, aktiivisen teeman, yläteeman ja symbolisella linkillä liitetyn teeman asennukset ratkaistaan automaattisesti. Jos mukautetussa käyttöönotossa paketti tuodaan saataville toisen julkisen URL-osoitteen kautta, määritä BLOCKSTUDIO_URL ennen kuin Composer lataa kohteen Blockstudio. Lisää loppuun vinoviiva:

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

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

Voit vaihtoehtoisesti rekisteröidä blockstudio/url-suodattimen ennen Composer- autoloaderin lataamista:

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

Suodatin saa syötteekseen selvitetyn URL-arvon ja paketin fyysisen hakemiston.

Riippuvuudet

Blockstudio-ajonaikaiset riippuvuudet (TailwindPHP, ScssPhp, Minify) sisältyvät lisäosaan nimiavaruuksineen. Ainoa Composer-riippuvuus, joka asennetaan vendor/-hakemistoosi, on yahnis-elsts/plugin-update-checker, joka ratkaisee versioristiriidat sisäisesti.

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

Päivitykset

Composer-asennukset saavat päivitykset Composer-palvelun kautta. Sisäänrakennettu GitHub-päivitystoiminto poistetaan automaattisesti käytöstä, kun Blockstudio ladataan vendor/-hakemistosta.