انتقل إلى المحتوى

Composer

يتوفر Blockstudio على Packagist. توجد عدة طرق لتثبيته عبر Composer، بحسب إعداد مشروعك.

كإضافة

استخدم composer/installers لتثبيت Blockstudio مباشرةً في مجلد wp-content/plugins/. وهذه هي الطريقة المعتادة لمشاريع WordPress المُدارة عبر Composer، مثل Bedrock.

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

فعّل Blockstudio من لوحة إدارة WordPress أو عبر WP-CLI:

سطر الأوامر
wp plugin activate blockstudio

يجب أن يحمّل تطبيق WordPress أداة التحميل التلقائي لـ Composer الخاصة بمشروعك، كي يتمكن Composer من تسجيل Blockstudio. يتولى Bedrock ذلك تلقائيًا. أما في الإعدادات الأخرى، فاستخدم إضافة إلزامية التحميل:

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

عندما يُضمّن Blockstudio عبر أداة التحميل التلقائي لـ Composer قبل بدء WordPress تحميل الإضافات، يؤجل التمهيد عبر Composer عملية التهيئة إلى حين توفر بيئة تحميل الإضافات. يتيح ذلك لـ Bedrock وإعدادات Composer الأخرى على مستوى الموقع تضمين الحزمة مبكرًا دون تهيئة Blockstudio قبل جاهزية واجهات برمجة التطبيقات الخاصة بإضافات WordPress.

كإضافة إلزامية التحميل

ثبّت Blockstudio في mu-plugins/ ليُحمّل تلقائيًا دون تفعيل. غيّر مسار أداة التثبيت ليستهدف مجلد الإضافات الإلزامية التحميل:

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

لا يحمّل WordPress تلقائيًا سوى ملفات PHP الموجودة في جذر mu-plugins/، وليس في المجلدات الفرعية. أضف ملفًا للتحميل:

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

لا حاجة إلى التفعيل. يحمّل Blockstudio تلقائيًا مع كل طلب.

تضمينها في قالب

ثبّت Blockstudio كتبعية داخل قالبك. يتيح ذلك أن يكون كل شيء مستقلًا دون الحاجة إلى إضافة منفصلة.

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

حمّله في functions.php الخاص بقالبك:

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

يُهيّئ Blockstudio نفسه تلقائيًا عبر أداة التحميل التلقائي لـ Composer عند تحميله بواسطة WordPress. تُحل روابط الأصول إلى دليل القالب الصحيح. وتعمل الكتل المعرّفة في مجلد blockstudio/ الخاص بقالبك كما لو ثُبّتت كإضافة. ويعمل ذلك أيضًا عندما يكون دليل القالب العام رابطًا رمزيًا: إذ يربط Blockstudio المسار الفعلي للحزمة بـURL للقالب النشط أو القالب الأصل بدلًا من كشف مسار الخادم.

تضمينها في إضافة

ثبّت Blockstudio كتبعية داخل إضافة أخرى. وتنطبق آلية التمهيد نفسها عبر أداة التحميل التلقائي.

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

حمّله في الملف الرئيسي لإضافتك:

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

تُحل روابط الأصول إلى دليل vendor الصحيح للإضافة.

فحوص أوضاع التحميل المدعومة

يتحقق Blockstudio باستمرار من الحزمة نفسها في أربعة مواضع تشغيل مدعومة:

الوضع Bootstrap
إضافة WordPress يفعّل WordPress blockstudio.php
إضافة إلزامية الاستخدام يحمّل مُحمّل الجذر نقطة دخول الحزمة
اعتماد Composer في قالب يستدعي القالب مُحمّل Composer
اعتماد Composer في إضافة تستدعي الإضافة المضيفة مُحمّل Composer

تُهيّئ كل الأوضاع WordPress إلى النتيجة نفسها: مثيل واحد من Blockstudio مع تعريف BLOCKSTUDIO_VERSION، ومن دون طبقة تجريد مضيفة ثانية تحته.

حزمة مخصصة URL

تُحل تلقائيًا مسارات التثبيت كإضافة عادية أو إلزامية التحميل أو مجمعة، وكذلك في القالب النشط أو الأصل أو المرتبط برابط رمزي. عند نشر مخصص يُتاح فيه الوصول إلى الحزمة عبر URL عام آخر، عرّف BLOCKSTUDIO_URL قبل أن يحمّل Composer Blockstudio. أدرج الشرطة المائلة الأخيرة:

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

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

يمكنك أيضًا تسجيل blockstudio/url قبل تحميل أداة التحميل التلقائي لـ 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';

يتلقى المرشح URL الذي جرى حله ودليل الحزمة الفعلي.

التبعيات

تُضمّن تبعيات تشغيل Blockstudio (TailwindPHP وScssPhp وMinify) وتُدرج ضمن مساحة أسماء الإضافة. تبعية Composer الوحيدة التي تُثبّت في مجلد vendor/ هي yahnis-elsts/plugin-update-checker، وهي تتولى حل تعارض الإصدارات داخليًا.

الكود
composer.json requires:
  php >= 8.2
  yahnis-elsts/plugin-update-checker ^5.6

التحديثات

تتلقى التثبيتات عبر Composer تحديثاتها من خلال Composer. يُعطّل محدّث GitHub المدمج تلقائيًا عندما يُحمّل Blockstudio من دليل vendor/.