İçeriğe geç

Composer

Blockstudio, Packagist üzerinde kullanılabilir. Proje kurulumunuza bağlı olarak Composer aracılığıyla yüklemenin birkaç yolu vardır.

Eklenti Olarak

composer/installers uygulamasını doğrudan wp-content/plugins/ dizininize yüklemek için Blockstudio kullanın. Bu, Bedrock gibi Composer tarafından yönetilen WordPress projeleri için standart yaklaşımdır.

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

Blockstudio uygulamasını WordPress yönetici panelinden veya WP-CLI aracılığıyla etkinleştirin:

Kabuk
wp plugin activate blockstudio

Composer otomatik yükleyicisi, WordPress uygulaması tarafından yüklenmelidir; böylece Composer, Blockstudio kaydını yapabilir. Bedrock içinde bu işlem otomatik olarak yapılır. Diğer kurulumlarda zorunlu eklenti kullanın:

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

Blockstudio, WordPress eklentileri yüklemeye başlamadan önce Composer otomatik yükleyicisi aracılığıyla eklenirse Composer başlangıç kodu, eklentilerin yüklenebileceği ortam hazır olana kadar başlatmayı erteler. Böylece Bedrock ve diğer site düzeyindeki Composer kurulumları, WordPress eklenti API’leri hazır olmadan Blockstudio başlatmaksızın paketi erkenden ekleyebilir.

Zorunlu Eklenti Olarak

Blockstudio uygulamasını, etkinleştirme gerektirmeden otomatik yüklenmesi için mu-plugins/ içine yükleyin. mu-plugins dizinini hedeflemek için yükleyici yolunu değiştirin:

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

WordPress, mu-plugins/ kökündeki PHP dosyalarını otomatik yükler; alt dizinlerdekileri yüklemez. Bir yükleyici dosyası ekleyin:

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

Etkinleştirme gerekmez. Blockstudio her istekte otomatik olarak yüklenir.

Tema İçinde Paketlenmiş

Her şeyi tek başına yeterli tutmak ve ayrı bir eklenti gerektirmemek için Blockstudio uygulamasını temanıza bağımlılık olarak yükleyin.

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

Temanızın functions.php dosyasına yükleyin:

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

Blockstudio, WordPress tarafından yüklendiğinde Composer otomatik yükleyicisi aracılığıyla otomatik olarak başlatılır. Varlık URL’leri doğru tema dizinine çözülür. Temanızın blockstudio/ klasöründe tanımlanan bloklar, eklenti kurulumu ile tamamen aynı şekilde çalışır. Bu, herkese açık tema dizininin sembolik bağlantı olduğu durumlarda da geçerlidir: Blockstudio, sunucu yolunu açığa çıkarmak yerine paketin fiziksel yolunu etkin veya üst tema URL üzerinden eşler.

Eklenti İçinde Paketlenmiş

Blockstudio uygulamasını başka bir eklentinin içine bağımlılık olarak yükleyin. Aynı otomatik yükleme başlangıç kodu burada da geçerlidir.

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

Eklentinizin ana dosyasına yükleyin:

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

Varlık URL’leri doğru eklenti satıcı dizinine çözülür.

Desteklenen yükleme modu denetimleri

Blockstudio aynı paketi desteklenen dört çalışma zamanı konumunda sürekli olarak doğrular:

Mod Bootstrap
WordPress eklentisi WordPress, blockstudio.php uygulamasını etkinleştirir
Zorunlu eklenti Kök yükleyici, paket giriş noktasını gerektirir
Temada Composer bağımlılığı Tema, Composer otomatik yükleyicisini gerektirir
Eklentide Composer bağımlılığı Ana eklenti, Composer otomatik yükleyicisini gerektirir

Her mod, WordPress uygulamasını aynı sonuca ulaştırır: tanımlı BLOCKSTUDIO_VERSION ile tek bir Blockstudio örneği ve altında ikinci bir ana bilgisayar soyutlaması yoktur.

Özel Paket URL

Normal eklenti, zorunlu eklenti, paketlenmiş eklenti, etkin tema, üst tema ve sembolik bağlantılı tema kurulumları otomatik olarak çözümlenir. Paketin başka bir herkese açık URL üzerinden sunulduğu özel bir dağıtımda, Composer Blockstudio yüklemeden önce BLOCKSTUDIO_URL tanımlayın. Sondaki eğik çizgiyi ekleyin:

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

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

Bunun yerine Composer otomatik yükleyicisini yüklemeden önce blockstudio/url kaydını yapabilirsiniz:

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

Filtre, çözümlenmiş URL değerini ve paketin fiziksel dizinini alır.

Bağımlılıklar

Blockstudio çalışma zamanı bağımlılıkları (TailwindPHP, ScssPhp, Minify) eklenti içine paketlenmiş ve ad alanına alınmıştır. vendor/ dizininize yüklenen tek Composer bağımlılığı, sürüm çakışmalarının çözümünü kendi içinde yöneten yahnis-elsts/plugin-update-checker uygulamasıdır.

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

Güncellemeler

Composer kurulumları güncellemeleri Composer aracılığıyla alır. Blockstudio, vendor/ dizininden yüklendiğinde yerleşik GitHub güncelleyicisi otomatik olarak devre dışı bırakılır.