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.
{
"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:
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
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:
{
"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
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.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Muat di functions.php tema Anda:
<?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.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Muat di file utama plugin Anda:
<?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
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
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.
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/.