Hoppa till innehåll

Composer

Blockstudio finns på Packagist. Det finns flera sätt att installera via Composer, beroende på projektets upplägg.

Som tillägg

Använd composer/installers för att installera Blockstudio direkt i katalogen wp-content/plugins/. Det är standardmetoden för Composer-hanterade WordPress-projekt som Bedrock.

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

Aktivera Blockstudio via adminpanelen WordPress eller WP-CLI:

Shell
wp plugin activate blockstudio

Projektets autoladdare Composer måste läsas in av appen WordPress så att Composer kan registrera Blockstudio. I Bedrock hanteras detta automatiskt. I andra upplägg använder du ett MU-tillägg:

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

När Blockstudio inkluderas via autoladdaren för Composer innan WordPress har börjat läsa in tillägg, skjuter startstrapsrutinen Composer upp initieringen tills miljön för inläsning av tillägg är tillgänglig. Då kan Bedrock och andra inställningar på webbplatsnivå för Composer inkludera paketet tidigt utan att starta Blockstudio innan tilläggens API:er i WordPress är redo.

Som MU-tillägg

Installera Blockstudio i mu-plugins/ så att det läses in automatiskt utan aktivering. Ange en annan installationssökväg för att använda MU-tilläggskatalogen:

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

WordPress läser bara in PHP-filer automatiskt i roten av mu-plugins/, inte i underkataloger. Lägg till en laddarfil:

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

Ingen aktivering krävs. Blockstudio läses in automatiskt vid varje förfrågan.

Inbäddat i ett tema

Installera Blockstudio som ett beroende i temat. Då hålls allt samlat utan att ett separat tillägg behövs.

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

Läs in det i temats functions.php:

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

Blockstudio startas automatiskt via autoladdaren för Composer när det läses in av WordPress. Resurs-URL:er pekar på rätt temakatalog. Block som definieras i temats blockstudio/-mapp fungerar precis som vid en installation som tillägg. Detta fungerar även när den offentliga temakatalogen är en symbolisk länk: Blockstudio mappar paketets fysiska sökväg via det aktiva temat eller överordnade temats URL i stället för att exponera serversökvägen.

Inbäddat i ett tillägg

Installera Blockstudio som ett beroende i ett annat tillägg. Samma autoladdning vid start gäller.

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

Läs in det i tilläggets huvudfil:

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

Resurs-URL:er pekar på rätt tilläggsleverantörskatalog.

Kontroller av laddningslägen som stöds

Blockstudio verifierar kontinuerligt samma paket i fyra stödda körningsmiljöer:

Läge Bootstrap
Tillägg WordPress WordPress aktiverar blockstudio.php
MU-tillägg En laddarfil i roten kräver paketets startpunkt
Composer-beroende i ett tema Temat kräver autoladdaren för Composer
Composer-beroende i ett tillägg Värdtillägget kräver autoladdaren för Composer

Alla lägen startar WordPress med samma resultat: en Blockstudio-instans med BLOCKSTUDIO_VERSION definierat och utan något andra värdabstraktionslager under den.

Anpassat paket-URL

Installationer som vanliga tillägg, MU-tillägg, inbäddade tillägg, aktiva teman, överordnade teman och symboliskt länkade teman hanteras automatiskt. För en anpassad distribution där paketet exponeras via ett annat offentligt URL, definiera BLOCKSTUDIO_URL innan Composer läser in Blockstudio. Ta med det avslutande snedstrecket:

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

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

Du kan i stället registrera blockstudio/url innan autoladdaren för Composer läses in:

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

Filtret får det lösta URL och den fysiska paketkatalogen.

Beroenden

Blockstudios körningsberoenden (TailwindPHP, ScssPhp, Minify) är paketerade och namnrymdsseparerade i tillägget. Det enda installerade beroendet för Composer i katalogen vendor/ är yahnis-elsts/plugin-update-checker, som hanterar versionskonflikter internt.

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

Uppdateringar

Composer-installationer får uppdateringar via Composer. Den inbyggda uppdateraren för GitHub inaktiveras automatiskt när Blockstudio läses in från en katalog vendor/.