Lewati ke konten

Composer

Blockstudio tersedia di Packagist. Ada beberapa cara untuk memasangnya melalui Composer, bergantung pada konfigurasi proyek Anda.

Sebagai Plugin

Gunakan composer/installers untuk memasang Blockstudio langsung ke direktori wp-content/plugins/ Anda. Ini adalah pendekatan standar untuk proyek WordPress yang dikelola oleh Composer, seperti Bedrock.

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

Aktifkan Blockstudio melalui admin WordPress atau WP-CLI:

Shell
wp plugin activate blockstudio

Autoloader Composer proyek Anda harus dimuat oleh aplikasi WordPress agar Composer dapat mendaftarkan Blockstudio. Di Bedrock, ini ditangani secara otomatis. Untuk penyiapan lain, gunakan plugin yang wajib dimuat:

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

Jika Blockstudio disertakan melalui autoloader milik Composer sebelum WordPress mulai memuat plugin, bootstrap Composer menunda inisialisasi hingga lingkungan pemuatan plugin tersedia. Ini memungkinkan Bedrock dan penyiapan Composer tingkat situs lainnya menyertakan paket lebih awal tanpa mem-boot Blockstudio sebelum API plugin WordPress siap.

Sebagai Plugin Wajib Muat

Pasang Blockstudio ke mu-plugins/ agar dimuat secara otomatis tanpa aktivasi. Ganti jalur penginstal untuk menargetkan direktori mu-plugins:

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

WordPress hanya memuat otomatis file PHP yang berada di root mu-plugins/, bukan subdirektori. Tambahkan file pemuat:

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

Aktivasi tidak diperlukan. Blockstudio dimuat otomatis pada setiap permintaan.

Disertakan dalam Tema

Pasang Blockstudio sebagai dependensi di dalam tema Anda. Dengan begitu, semuanya mandiri tanpa memerlukan plugin terpisah.

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

Muat di functions.php tema Anda:

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

Blockstudio melakukan bootstrap secara otomatis melalui autoloader Composer saat dimuat oleh WordPress. URL aset mengarah ke direktori tema yang benar. Blok yang didefinisikan dalam folder blockstudio/ tema Anda berfungsi sama seperti pada instalasi plugin. Ini juga berlaku jika direktori tema publik berupa symlink: Blockstudio memetakan jalur fisik paket melalui URL tema aktif atau induk alih-alih menampilkan jalur server.

Disertakan dalam Plugin

Pasang Blockstudio sebagai dependensi di dalam plugin lain. Bootstrap autoload yang sama berlaku.

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

Muat di file utama plugin Anda:

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

URL aset mengarah ke direktori vendor plugin yang benar.

Pemeriksaan mode pemuatan yang didukung

Blockstudio terus memverifikasi paket yang sama dalam empat posisi runtime yang didukung:

Mode Bootstrap
Plugin WordPress WordPress mengaktifkan blockstudio.php
Plugin wajib muat Pemuat root mewajibkan entry point paket
Dependensi Composer dalam tema Tema mewajibkan autoloader milik Composer
Dependensi Composer dalam plugin Plugin host mewajibkan autoloader milik Composer

Setiap mode mem-boot WordPress dengan hasil yang sama: satu instans Blockstudio dengan BLOCKSTUDIO_VERSION terdefinisi, tanpa abstraksi host kedua di bawahnya.

URL Paket Kustom

Instalasi plugin biasa, plugin wajib muat, plugin yang disertakan, tema aktif, tema induk, dan tema bersymlink dikenali secara otomatis. Untuk deployment kustom ketika paket diakses melalui URL publik lainnya, definisikan BLOCKSTUDIO_URL sebelum Composer memuat Blockstudio. Sertakan garis miring di akhir:

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

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

Anda juga dapat mendaftarkan blockstudio/url sebelum memuat autoloader Composer:

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 menerima URL yang telah ditentukan dan direktori fisik paket.

Dependensi

Dependensi runtime Blockstudio (TailwindPHP, ScssPhp, Minify) disertakan dan diberi namespace di dalam plugin. Satu-satunya dependensi Composer yang dipasang di direktori vendor/ Anda adalah yahnis-elsts/plugin-update-checker, yang menangani resolusi konflik versi secara internal.

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

Pembaruan

Instalasi Composer menerima pembaruan melalui Composer. Pemutakhir GitHub bawaan otomatis dinonaktifkan saat Blockstudio dimuat dari direktori vendor/.