Liigu sisu juurde

Composer

Blockstudio on saadaval keskkonnas Packagist. Olenevalt projekti seadistusest saab selle installida Composer abil mitmel viisil.

Pluginana

Kasutage composer/installers-i, et installida Blockstudio otse kataloogi wp-content/plugins/. See on tavapärane viis Composer-i hallatavate WordPress projektide jaoks, näiteks Bedrock.

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

Aktiveerige Blockstudio keskkonna WordPress halduses või käsuga WP-CLI:

Shell
wp plugin activate blockstudio

Projekti Composer autoloader peab olema laaditud WordPress rakenduse poolt, et Composer saaks registreerida Blockstudio. Bedrock-is toimub see automaatselt. Muude seadistuste korral kasutage kohustuslikult laaditavat pluginat:

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

Kui Blockstudio kaasatakse Composer autoloaderi kaudu enne, kui WordPress alustab pluginate laadimist, lükkab Composer alglaadur lähtestamise edasi, kuni pluginate laadimiskeskkond on valmis. Nii saavad Bedrock ja muud saiditaseme Composer seadistused paketi varakult kaasata, käivitamata Blockstudio-i enne, kui WordPress pluginate API-d on valmis.

Kohustuslikult laaditava pluginana

Installige Blockstudio asukohta mu-plugins/, et see laaditaks automaatselt ilma aktiveerimiseta. Suunake installer ümber mu-pluginite kataloogi:

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

WordPress laadib automaatselt ainult PHP-failid kataloogi mu-plugins/ juurkaustast, mitte alamkataloogidest. Lisage laadurifail:

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

Aktiveerimine pole vajalik. Blockstudio laaditakse automaatselt igal päringul.

Teemasse komplekteerituna

Installige Blockstudio oma teema sõltuvusena. Nii on kõik ühes kohas ja eraldi pluginat pole vaja.

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

Laadige see teema failis functions.php:

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

Blockstudio käivitub automaatselt Composer autoloaderi kaudu, kui selle laadib WordPress. Varade URL-id suunatakse õigesse teemakataloogi. Teema kataloogis blockstudio/ määratletud plokid töötavad täpselt nagu plugina installi korral. See toimib ka siis, kui avalik teemakataloog on sümbollink: Blockstudio leiab paketi füüsilise asukoha aktiivse või ülemteema URL kaudu ega avalda serveri asukohta.

Pluginasse komplekteerituna

Installige Blockstudio teise plugina sõltuvusena. Kehtib sama autoloaderi alglaadimine.

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

Laadige see plugina põhifailis:

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

Varade URL-id suunatakse õigesse plugina vendor-kataloogi.

Toetatud laadimisrežiimide kontrollid

Blockstudio kontrollib pidevalt sama paketti neljas toetatud käituskeskkonna asukohas:

Režiim Bootstrap
WordPress plugin WordPress aktiveerib blockstudio.php
Kohustuslikult laaditav plugin Juure laadur nõuab paketi sisenemispunkti
Composer-sõltuvus teemas Teema nõuab Composer autoloaderit
Composer-sõltuvus pluginas Host-plugin nõuab Composer autoloaderit

Kõigis režiimides jõuab WordPress samasse olekusse: üks Blockstudio-i eksemplar, milles BLOCKSTUDIO_VERSION on määratletud, ilma teise host-abstraktsioonita selle all.

Kohandatud paketi URL

Tavalise plugina, kohustuslikult laaditava plugina, komplekteeritud plugina, aktiivse teema, ülemteema ja sümbollingitud teemaga installid lahendatakse automaatselt. Kohandatud juurutuse korral, kus pakett on saadaval teise avaliku URL kaudu, määratlege BLOCKSTUDIO_URL enne Composer laadimist Blockstudio. Lisage lõppu kaldkriips:

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

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

Teise võimalusena registreerige blockstudio/url enne Composer autoloaderi laadimist:

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 saab lahendatud URL väärtuse ja paketi füüsilise kataloogi.

Sõltuvused

Blockstudio käituskeskkonna sõltuvused (TailwindPHP, ScssPhp, Minify) on plugina sees komplekteeritud ja nimeruumiga eraldatud. Ainus Composer-sõltuvus, mis installitakse kataloogi vendor/, on yahnis-elsts/plugin-update-checker, mis lahendab versioonikonfliktid sisemiselt.

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

Uuendused

Composer-i installid saavad uuendusi teenuse Composer kaudu. Sisseehitatud GitHub-uuendaja lülitatakse automaatselt välja, kui Blockstudio laaditakse kataloogist vendor/.