Ga naar de inhoud

Composer

Blockstudio is beschikbaar op Packagist. Afhankelijk van de projectconfiguratie zijn er verschillende manieren om het via Composer te installeren.

Als plugin

Gebruik composer/installers om Blockstudio rechtstreeks in de map wp-content/plugins/ te installeren. Dit is de standaardaanpak voor door Composer beheerde WordPress-projecten zoals Bedrock.

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

Activeer Blockstudio via het WordPress-beheer of WP-CLI:

Shell
wp plugin activate blockstudio

De Composer-autoloader van je project moet door de WordPress-app worden geladen, zodat Composer Blockstudio kan registreren. In Bedrock gebeurt dit automatisch. Gebruik in andere opstellingen een must-use-plugin:

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

Wanneer Blockstudio via de autoloader van Composer wordt opgenomen voordat WordPress plugins begint te laden, stelt de bootstrap van Composer de initialisatie uit totdat de omgeving voor het laden van plugins beschikbaar is. Hierdoor kunnen Bedrock en andere Composer-opstellingen op siteniveau het pakket vroeg opnemen zonder Blockstudio te starten voordat de plugin-API’s van WordPress gereed zijn.

Als must-use-plugin

Installeer Blockstudio in mu-plugins/ zodat het automatisch wordt geladen zonder activering. Overschrijf het installatiepad om de map mu-plugins als doel te gebruiken:

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

WordPress laadt automatisch alleen PHP-bestanden in de hoofdmap van mu-plugins/, niet in submappen. Voeg een loaderbestand toe:

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

Activering is niet nodig. Blockstudio wordt automatisch bij elk verzoek geladen.

Opgenomen in een thema

Installeer Blockstudio als afhankelijkheid in je thema. Zo blijft alles zelfstandig zonder dat je een aparte plugin nodig hebt.

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

Laad het in functions.php van je thema:

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

Blockstudio start automatisch op via de autoloader van Composer wanneer het wordt geladen door WordPress. Asset-URL’s verwijzen naar de juiste themamap. Blokken gedefinieerd in de map blockstudio/ van je thema werken precies zoals bij een plugininstallatie. Dit werkt ook wanneer de openbare themamap een symlink is: Blockstudio koppelt het fysieke pad van het pakket via de actieve of bovenliggende themamap URL, in plaats van het serverpad zichtbaar te maken.

Opgenomen in een plugin

Installeer Blockstudio als afhankelijkheid in een andere plugin. Dezelfde bootstrap voor autoloading is van toepassing.

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

Laad het in het hoofdbestand van je plugin:

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

Asset-URL’s verwijzen naar de juiste vendormap van de plugin.

Controles van ondersteunde laadmodi

Blockstudio controleert voortdurend hetzelfde pakket op vier ondersteunde runtimeposities:

Modus Bootstrap
WordPress-plugin WordPress activeert blockstudio.php
Must-use-plugin Een loader in de hoofdmap vereist het pakketentrypoint
Afhankelijkheid Composer in een thema Het thema vereist de autoloader van Composer
Afhankelijkheid Composer in een plugin De hostplugin vereist de autoloader van Composer

Elke modus start WordPress op met hetzelfde resultaat: één instantie van Blockstudio met BLOCKSTUDIO_VERSION gedefinieerd, zonder een tweede abstractielaag van de host eronder.

Aangepast pakket URL

Installaties als normale plugin, must-use-plugin, gebundelde plugin, actief thema, bovenliggend thema en symlink-thema worden automatisch herkend. Definieer voor een aangepaste implementatie waarbij het pakket via een andere openbare URL beschikbaar is BLOCKSTUDIO_URL voordat Composer Blockstudio laadt. Neem de afsluitende slash op:

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

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

Je kunt ook blockstudio/url registreren voordat je de autoloader van Composer laadt:

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

Het filter ontvangt de opgeloste URL en de fysieke pakketmap.

Afhankelijkheden

De runtime-afhankelijkheden van Blockstudio (TailwindPHP, ScssPhp, Minify) zijn gebundeld en hebben een eigen namespace in de plugin. De enige afhankelijkheid van Composer die in je map vendor/ wordt geïnstalleerd, is yahnis-elsts/plugin-update-checker. Die regelt intern het oplossen van versieconflicten.

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

Updates

Installaties van Composer ontvangen updates via Composer. De ingebouwde updater van GitHub wordt automatisch uitgeschakeld wanneer Blockstudio vanuit een map vendor/ wordt geladen.