البدء
سيساعدك هذا الدليل على إعداد Blockstudio وإنشاء أول كتلة مخصصة لك.
التثبيت
عبر Composer (موصى به)
composer require blockstudio/blockstudio
يمكن تثبيت Blockstudio كإضافة عبر composer/installers أو تضمينه مباشرةً داخل قالب. راجع وثائق Composer للاطلاع على جميع طرق التثبيت.
تتلقى عمليات التثبيت عبر Composer التحديثات من خلال Composer. ويتوقف محدّث GitHub المدمج تلقائيًا.
التثبيت اليدوي
ارفع ملف zip إلى مجلد الإضافات WordPress وفعّل الإضافة. تتلقى عمليات التثبيت اليدوي إشعارات التحديث التلقائية في لوحة تحكم WordPress عبر محدّث GitHub المدمج.
تضمّن طريقتا التثبيت نسخًا خاصة من مكتبات Markdown وYAML والتحديث واعتمادياتها. ولا تستخدمان الإصدارات التي يوفرها مكون إضافي أو قالب آخر ولا تستبدلانها. ثبّت اعتماد Composer الخاص بك إذا كان تطبيقك يستخدم إحدى تلك المكتبات مباشرةً؛ فالنسخ المضمّنة في Blockstudio داخلية وليست PHP API عامة.
التحقق من التحديثات باستخدام المصادقة
تتحقق عمليات التثبيت اليدوية من GitHub دون مصادقة افتراضيًا. وقد تستنفد عدة مواقع تتشارك IP صادرًا واحدًا حصة API المجهولة في GitHub، وتتلقى استجابات HTTP 403 عند التحقق من وجود تحديثات. من 7.7.4، أعدّ GitHub رمز وصول شخصيًا في wp-config.php قبل تحميل WordPress:
define('BLOCKSTUDIO_GITHUB_TOKEN', 'your-github-token');
لا يحتاج الرمز إلا إلى الوصول إلى معلومات المستودع العامة. لا تمنحه أذونات الكتابة. احتفظ به في إعدادات الخادم، خارج نظام التحكم بالإصدارات وخارج blockstudio.json وسمات الكتل وشيفرة الواجهة الأمامية. يمرر المُحدِّث الرمز إلى عميل GitHub المضمّن لإجراء عمليات التحقق الموثّقة وتنزيل الإصدارات. ولا يُرسل الرمز إلى طلبات مستودعات غير ذات صلة أو إلى مضيفات تنزيل أخرى.
لإدارة الأسرار عبر البيئة، يمكن لمكوّن MU إضافي توفير الرمز أو تجاوزه:
<?php
add_filter('blockstudio/updater/token', function ($token) {
return getenv('BLOCKSTUDIO_GITHUB_TOKEN') ?: $token;
});
يُشغَّل المرشح عندما يهيئ Blockstudio المُحدِّث الخاص به، قبل تحميل القالب. سجّله في مكوّن MU إضافي بدلاً من functions.php. يؤدي إرجاع سلسلة فارغة إلى تعطيل المصادقة حتى عند تعريف الثابت. وتُبقي القيم الفارغة أو غير النصية عمليات التحقق دون مصادقة. الرموز اختيارية؛ ومن دونها، يظل سلوك التحديث الحالي كما هو. وتستمر عمليات التثبيت Composer في استخدام Composer للتحديثات ولا تهيئ هذا المُحدِّث.
إنشاء كتلتك الأولى
1. إنشاء مجلد للكتلة
أنشئ مجلدًا جديدًا في قالبك:
my-theme/
blockstudio/
my-first-block/
block.json
index.php
2. تحديد مخطط الكتلة
أنشئ block.json باستخدام إعدادات الكتلة:
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "my-theme/my-first-block",
"title": "My First Block",
"category": "common",
"icon": "star-filled",
"blockstudio": {
"attributes": [
{
"id": "heading",
"type": "text",
"label": "Heading",
"default": "Hello World"
},
{
"id": "content",
"type": "textarea",
"label": "Content"
}
]
}
}
3. إنشاء القالب
أنشئ index.php لعرض المحتوى:
<div class="my-first-block">
<h2><?php echo $a['heading']; ?></h2>
<p><?php echo $a['content']; ?></p>
</div>
استخدام قوالب Twig
يدعم Blockstudio قوالب Twig مباشرةً. ما عليك سوى استخدام index.twig بدلًا من ذلك:
<div class="my-first-block">
<h2>{{ a.heading }}</h2>
<p>{{ a.content }}</p>
</div>
إضافة الأنماط
أنشئ ملف style.css في المجلد نفسه:
.my-first-block {
padding: 2rem;
background: #f5f5f5;
}
سيضيف Blockstudio ورقة الأنماط هذه تلقائيًا عند استخدام الكتلة.
الترجمات
تحمّل عناصر التحكم في المحرر ونظرة عامة الإدارة في Blockstudio ترجمات JavaScript لمجال النص blockstudio عبر WordPress. ثبّت حزمة لغة مطابقة أو أنشئ ملفات ترجمة البرامج النصية JSON باستخدام أداة الترجمة في wp-content/languages/plugins/. تبقى السلاسل التي لا تتوفر لها ترجمة باللغة الإنجليزية. يترجم هذا واجهة Blockstudio نفسها، وليس المحتوى أو تسميات الحقول التي تحددها في كتلِك.
الخطوات التالية
أصبحت كتلتك جاهزة للاستخدام في محرر WordPress. تابع استكشاف الوثائق للتعرّف على:
- أنواع الحقول – جميع أنواع الحقول المتاحة
- المكوّنات – InnerBlocks وRichText والمزيد
- تكامل Tailwind – استخدام Tailwind CSS
- الخطافات – توسيع الوظائف باستخدام المرشحات والإجراءات
انتقل من كتلة واحدة إلى مكتبة متكاملة: رموز التصميم، ونمط الأقسام، والحقول المتكررة، والصور، وتركيب الصفحات.