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

الإعدادات

يتضمن Blockstudio واجهة إعدادات قوية API تتيح ضبط الخيارات عبر ملف blockstudio.json داخل مجلد القالب و/أو باستخدام المرشحات. بالإضافة إلى ذلك، يستطيع المستخدمون المصرح لهم تغيير الإعدادات مرئيًا من منطقة الإدارة.

عبر JSON

إذا وُجد ملف blockstudio.json داخل مجلد القالب، فسيُستخدم لضبط الخيارات الافتراضية للموقع الحالي. يتوفر مخطط JSON للتحقق من صحة الملف والمساعدة في الإكمال التلقائي عند استخدام بيئة تطوير متكاملة.

هذا الملف اختياري. عند عدم وجوده، يستخدم Blockstudio الإعدادات المحفوظة في منطقة الإدارة إلى جانب الإعدادات الافتراضية المدمجة. يجري اكتشاف إضافة الملف أو تغييره أو حذفه تلقائيًا، لذا لا حاجة إلى مسح ذاكرة التخزين المؤقت أو إعادة التحميل يدويًا.

الخصائص المتاحة:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "users": {
    "ids": [],
    "roles": []
  },
  "assets": {
    "enqueue": true,
    "reset": {
      "enabled": false,
      "fullWidth": []
    },
    "minify": {
      "css": false,
      "js": false
    },
    "process": {
      "scss": false
    }
  },
  "cache": {
    "enabled": true,
    "path": "blockstudio/cache"
  },
  "themeDefaults": {
    "titleTag": false,
    "suppressDirectoryUpdates": false
  },
  "performance": {
    "profile": "compat",
    "wordpress": {
      "headNoise": false,
      "embeds": false,
      "xmlrpc": false,
      "editor": false,
      "frontendAssets": false,
      "media": false,
      "heartbeat": false
    },
    "preload": {
      "links": "off"
    },
    "media": {
      "lazy": false,
      "skeleton": false,
      "metadata": false,
      "rootMargin": "300px"
    },
    "measurement": {
      "enabled": false,
      "queryMonitor": false,
      "headers": false,
      "timings": false
    }
  },
  "content": {
    "enabled": false,
    "id": "default",
    "path": "content",
    "includePageSyncManaged": false,
    "authors": "ignore",
    "postTypes": [],
    "meta": {
      "include": [],
      "exclude": ["_edit_lock", "_edit_last", "_wp_old_slug"],
      "references": {}
    },
    "taxonomies": [],
    "media": "manifest"
  },
  "editor": {
    "formatOnSave": false,
    "assets": [],
    "markup": false
  },
  "tailwind": {
    "enabled": false,
    "config": "",
    "output": "inline"
  },
  "blockTags": {
    "enabled": false,
    "allow": [],
    "deny": [],
    "prefixes": {}
  },
  "ui": {
    "enabled": false
  },
  "blockEditor": {
    "disableLoading": false,
    "enhance": false,
    "cssClasses": [],
    "cssVariables": [],
    "blocks": {
      "allow": [],
      "deny": [],
      "directory": true,
      "categories": {
        "allow": [],
        "deny": [],
        "rename": {},
        "order": []
      },
      "styles": {
        "deny": {}
      },
      "legacyWidgets": {
        "hide": []
      }
    },
    "patterns": {
      "core": true,
      "remote": true,
      "theme": true,
      "blockstudio": true,
      "categories": {
        "allow": [],
        "deny": [],
        "rename": {},
        "order": []
      }
    },
    "media": {
      "openverse": true,
      "imageSizes": {
        "allow": [],
        "deny": []
      }
    }
  },
  "dev": {
    "grab": {
      "enabled": false
    },
    "perf": false,
    "canvas": {
      "enabled": false,
      "adminBar": true
    }
  },
  "githooks": {
    "commit": false
  },
  "phpstan": {
    "preset": "base",
    "configuration": "",
    "roots": ["."],
    "excludePaths": [],
    "maxFiles": 10000
  },
  "ai": {
    "enableContextGeneration": false
  }
}

عبر المرشحات

يمكنك بدلًا من ذلك استخدام مرشح blockstudio/settings/${setting} لضبط الخيارات عبر PHP بمزيد من المرونة.

PHP
add_filter('blockstudio/settings/assets/enqueue', '__return_false');
add_filter('blockstudio/settings/editor/formatOnSave', '__return_true');
add_filter('blockstudio/settings/ui/enabled', '__return_true');
add_filter('blockstudio/settings/block_editor/patterns/remote', '__return_false');

تتجاوز الخيارات المضبوطة عبر مرشح blockstudio/settings/${setting} الخيارات المضبوطة عبر ملف blockstudio.json. ويمكن استخدام الطريقتين معًا.

تتيح قيم وقت التشغيل أيضًا مرشحات blockstudio/performance/${setting} ومرشح blockstudio/performance/config نهائيًا واحدًا. يجب أن يعيد الأخير كائن إعدادات صالحًا.

كيفية تراكب المصادر

يُحمّل كل مصدر وتُدمج محتوياته، بدءًا من الأقل أولوية:

  1. الإعدادات الافتراضية المدمجة
  2. الإعدادات المحفوظة عبر UI الإدارة (الخيار blockstudio_settings)
  3. blockstudio.json في القالب
  4. مرشحات blockstudio/settings/*

لا يتجاوز blockstudio.json إلا المفاتيح التي يحددها. كان يستبدل الإعدادات المحفوظة بالكامل، ما يعني أن قيمة محفوظة في الإدارة وغير مرتبطة به تتوقف عن التطبيق بمجرد ظهور الملف؛ أما الآن فيُضاف فوقها. والجانب الآخر هو أن القيمة القديمة المحفوظة عبر UI الإدارة تظل مطبقة حتى يحدد الملف ذلك المفتاح أو تُزال القيمة المحفوظة. إذا تصرف إعداد على نحو يخالف ما يحدده الملف، فتحقق من الطبقة المحفوظة باستخدام wp bs settings أو Settings::get_raw()، الذي يعيد فقط ما حدده المصدر النشط JSON أو مصدر الخيارات صراحةً.

قراءة الإعدادات من PHP

يحمّل Blockstudio\Settings المصدر النشط، ويبلّغ عن JSON غير الصالح، ويعيد التحميل تلقائيًا عند تغيّر blockstudio.json:

PHP
use Blockstudio\Settings;

$enabled = Settings::get_bool('performance/media/lazy');
$margin = Settings::get_string('performance/media/rootMargin', '300px');
$roles = Settings::get_array('users/roles');
$ttl = Settings::get_int('performance/staticPrerender/ttl', 86400);

foreach (Settings::errors() as $error) {
    error_log($error);
}

استخدم Settings::get_raw() عندما يحتاج التكامل إلى القيم المعلنة صراحةً في مصدر JSON النشط أو مصدر الخيارات فقط. يعيد Settings::fingerprint() معرّفًا حتميًا للإعدادات الفعلية. يمكن للعمليات طويلة الأمد استدعاء Settings::reload() صراحةً لقراءة تغييرات الملف فورًا. وفي الوصول العادي، يُفحص الملف مرة واحدة في الثانية كحد أقصى ضمن الطلب أو العملية طويلة الأمد PHP، بما في ذلك التعديلات التي لا تغيّر الحجم. يسري تغيير المسار المُعدّ عند القراءة التالية. وعندما لا يكون ملف JSON نشطًا، لا تتأخر إعدادات قاعدة البيانات المحفوظة بسبب هذه المهلة.

يتوفر ملف تعريف الأداء بعد حله عبر Blockstudio\Runtime_Settings::current(). وهو يدعم مسارات مفصولة بشرطة مائلة أو بنقطة:

PHP
use Blockstudio\Runtime_Settings;

$runtime = Runtime_Settings::current();

if ($runtime->enabled('measurement/queryMonitor')) {
    $hash = $runtime->hash();
}

الإعدادات المتاحة

users

الخيار النوع الافتراضي الوصف
ids مصفوفة [] معرّفات المستخدمين الذين لديهم صلاحية التحرير
roles مصفوفة [] أدوار المستخدمين التي لديها صلاحية التحرير

assets

الخيار النوع الافتراضي الوصف
enqueue boolean true إضافة أصول الكتل تلقائيًا إلى قائمة الانتظار
reset.enabled boolean false إزالة أنماط الكتل الأساسية وتطبيق إعادة ضبط أدوات المحرر
reset.fullWidth array [] أنواع المنشورات التي تستخدم تخطيط المحرر بعرض كامل
minify.css boolean false تصغير مخرجات CSS
minify.js boolean false تصغير مخرجات JS
process.scss boolean false معالجة ملفات SCSS
output string source مكان كتابة الأصول المجمّعة: source أو cache
inlineLimit integer 0 عدد بايتات أصول كتل CSS الخارجية التي تُطبع ضمن الصفحة

تكون القيمة الافتراضية لـoutput هي source، التي تنشئ مجلد _dist بجوار كل كتلة. اضبطها على cache لكتابة الأصول المجمّعة في مجلد ذاكرة التخزين المؤقت Blockstudio بدلًا من ذلك، بحيث تظل شجرة مصدر الكتلة نظيفة وقابلة للنشر من نسخة مستودع غير قابلة للتغيير. تُوجّه المصادر Blockstudio إلى ذاكرة التخزين المؤقت على أي حال، ولا يمكنها الكتابة فيها بصرف النظر عن هذا الإعداد.

تكون inlineLimit معطّلة عند 0، لذا يحتفظ كل ملف أنماط خارجي بوسم <link> الخاص به. عيّنها إلى عدد من البايتات لطباعة أصغر ملفات أنماط الكتل الخارجية للصفحة ضمن الصفحة بدلًا من ذلك، ما دام مجموعها لا يتجاوز ذلك العدد. 40000 هو الحد الذي يستخدمه قلب WordPress للقاعدة نفسها. راجع تضمين أوراق الأنماط الصغيرة.

عند تفعيل reset.enabled، ينسخ Blockstudio أيضًا قيم body_class الأمامية بعد تنقيحها إلى لوحة المحرر. استخدم blockstudio/editor/canvas/body_class لضبط قائمة الفئات المخصصة للمحرر فقط.

cache

الخيار النوع الافتراضي الوصف
enabled منطقي true تفعيل ذاكرات التخزين المؤقت المدعومة بالملفات Blockstudio
path سلسلة نصية "blockstudio/cache" مسار ذاكرة التخزين المؤقت، نسبةً إلى WP_CONTENT_DIR أو مسار مطلق
namespaceGrace عدد صحيح 86400 عدد الثواني التي تبقى فيها مساحة أسماء ذاكرة مؤقتة متقاعدة قبل جمعها

تُكتب ملفات ذاكرة التخزين المؤقت افتراضيًا في wp-content/blockstudio/cache خارج مجلد التحميلات. يُحل المسار النسبي path انطلاقًا من WP_CONTENT_DIR، أما المسار المطلق فيُستخدم كما هو. ويدعم ذلك المضيفين الذين يوفرون وحدة تخزين مؤقتة مخصصة قابلة للكتابة.

عند تفعيلها، يستخدم Blockstudio هذا الجذر الواحد لحمولات البناء، وبيانات تسجيل الكتل المعدّة مسبقًا، وأصول المحرر المحلولة، وTailwind CSS، ومستندات العرض، وأجزاء الجزر، وعمليات العرض المسبق الثابتة، وفهارس الرسوم البيانية، وقوائم الانتظار، والتشخيصات. يُعزل كل كائن بحسب الشبكة والموقع وهوية وقت التشغيل الكاملة والنطاق. وتشمل هويات وقت التشغيل Blockstudio، والإعدادات، وWordPress، وPHP، والقالب النشط، والإضافات النشطة، ومصادر الاكتشاف المنطقية، وسياق المضيف، وتجزئات التبعيات الصريحة التي توفرها العملية المالكة.

تؤدي تغييرات المحتوى والمصطلحات والمستخدمين والبيانات الوصفية إلى إبطال خيارات الحقول المعبأة، لا إلى اكتشاف الكتل البنيوي أو الأصول المجمّعة. تُحدَّث الخيارات بشكل منفصل ضمن قفل ثابت لمسار البناء. تُدمج دفعة من عمليات الكتابة، مثل مزامنة الترجمة أو الاستيراد: تُحدَّث الخيارات فورًا عند أول كتابة بعد فترة هدوء، ثم تنعكس آخر كتابة في الدفعة مرة واحدة بعد مرور ثلاثين ثانية، ويمكن ضبط هذه المدة عبر blockstudio/cache/populate_debounce. لا تُحتسب البيانات الوصفية التي WordPress تكتبها لأغراض تنظيمية، مثل قفل تحرير المقالة، كتغيير؛ وتضيف blockstudio/cache/populate_ignored_meta_keys عناصر أخرى إلى هذه القائمة. يستعلم المحرر دائمًا عن الخيارات الحالية، لذا تؤثر هذه المدة فقط في الخيارات المخزنة مؤقتًا التي تُقرأ وقت العرض. وتظل ملفات المصدر وإعدادات البناء تُبطل ذاكرة التخزين المؤقت البنيوية بالطريقة المعتادة. لا تؤدي الكتابة فوق الخيارات إلى إعادة فحص دليل ذاكرة التخزين المؤقت عند كل تغيير للمحتوى؛ إذ يواصل التنظيف الدوري إزالة الملفات المؤقتة اليتيمة. تظل هويات وقت التشغيل الخاصة بكل لغة معزولة؛ ووجود أدلة متعددة لمساحات أسماء ذاكرة التخزين المؤقت في موقع متعدد اللغات لا يُعد بحد ذاته دليلًا على عدم إصابة ذاكرة التخزين المؤقت.

لا يؤدي نشاط سجل SQLite داخل دليل بيانات db الكتلة إلى التخلص من بيانات الكتلة الوصفية المخزنة مؤقتًا. تظل التغييرات في db.php أو ملفات المصدر الخاضعة للمراقبة أو بنية ملفات المصدر والأدلة الفرعية لدليل البيانات تُبطل ذاكرة التخزين المؤقت.

لا ينتخب سوى باني واحد لإعادة بناء وقت التشغيل بالتزامن. وتنتظر الطلبات الأخرى مدة تصل إلى خمس ثوانٍ، ثم تعيد استخدام بيانات آخر كتلة سليمة إذا كانت ملفات المصدر والأصول المجمّعة المطلوبة لا تزال موجودة. أما الطلب البارد الذي لا يتوفر له محتوى آمن فيعيد HTTP 503 مع Retry-After بدلًا من بدء عملية بناء أخرى. يضبط المرشح blockstudio/cache/build_wait_budget مدة الانتظار بالمللي ثانية لكل من إعادة البناء البنيوي وتحديث الخيارات. ويحدّث المضيف الذي لا يدعم أقفال الملفات الاستشارية الخيارات دون حماية، وينشرها مع ذلك، كي تصل إصابة إلى الطلب التالي.

يجمع WP-Cron ملفات .build.lock القديمة الخاصة بالمفاتيح بعد خمولها، والتي تركتها الإصدارات السابقة، عبر مساحات أسماء ذاكرة التخزين المؤقت لهذا الموقع. ويبدأ ذلك بعد خمس دقائق من الترقية، ويزيل ما يصل إلى 10,000 قفل في الدقيقة ضمن مهلة عشر ثوانٍ. يعرض wp bs cache status العدد المتبقي، ويعالج wp bs cache cleanup التراكم فورًا، ويمسح wp bs cache clear ذاكرة تخزين وقت التشغيل المؤقتة. إذا تأخرت دفعة مجدولة أكثر من عشر دقائق بسبب عدم تشغيل cron، تفحص الطلبات عددًا محدودًا من الأقفال مرة كل ساعة كيلا يتوقف الإفراغ. وتُترك الأقفال الحديثة أو الممسوكة دون مساس، ولا تُجمع الأقفال الجديدة ذات المسارات الثابتة مطلقًا. بعد إفراغ التراكم، تجمع الدفعة نفسها مساحات أسماء ذاكرة التخزين المؤقت المتروكة بعد انقضاء namespaceGrace، بمعدل مرة واحدة في الساعة كحد أقصى لكل موقع، وتُبقي على مهمة يومية لذلك. تُحتسب فترة السماح من أول فحص يكتشف تقاعد مساحة الأسماء، لا من أحدث ملف فيها؛ ولا تُجمع أبدًا مساحة أسماء تظل مستخدمة لأي من نطاقاتها. لا يستدعي تنظيف ذاكرة التخزين المؤقت الداخلية مرشحات حذف المرفقات WordPress. ينبغي للمضيفين الذين عطّلوا WP-Cron مواصلة تشغيل عامل cron المجدول المعتاد؛ ولا تحذف ملفات الأقفال النشطة عشوائيًا لإفراغ التراكم.

يغيّر مرشح إعداد blockstudio/settings/cache/path القيمة المضبوطة. ولحل المسار الخاص ببيئة النشر، يرشّح blockstudio/cache/dir المجلد الأساسي المحلول:

PHP
add_filter('blockstudio/cache/dir', function (string $directory): string {
    return WP_CONTENT_DIR . '/cache/blockstudio';
});

يمكن للمضيفين الذين تختلف هوية المستأجر لديهم عن معرّفات الشبكة/المدونة WordPress ترشيح blockstudio/cache/site_key. تُنقّح النتيجة وتُستخدم كجزء من مسار مجلد فقط. ويظل blockstudio/cache/context الموضع المناسب لمتغير وقت تشغيل قابل للتسلسل يجب أن يغيّر هويات الكائنات.

themeDefaults

الخيار النوع الافتراضي الوصف
titleTag منطقي false تفعيل دعم وسم العنوان في القالب WordPress
suppressDirectoryUpdates منطقي false استبعاد القوالب الفرعية والأصلية النشطة من نتائج تحديث المجلدات

تواصل الأنماط استخدام Blockstudio\Patterns API الحالي؛ ولا تضيف هذه الإعدادات الافتراضية واجهات بديلة للصفحات أو الأنماط.

performance

يُبقي ملف تعريف compat سلوك WordPress العام دون تغيير. ويتيح كل من speed وstrict الإعدادات الافتراضية الأمامية الاختيارية نفسها؛ ويمكن لكل إعداد فرعي تجاوز قيمة ملف التعريف.

إعدادات التفعيل الاختياري هي بوابات تسجيل. عندما تكون ميزة اختيارية false، لا يربط Blockstudio عمليات رد الواجهة الأمامية أو الإدارة أو المحرر أو REST أو المهام المجدولة الخاصة بهذه الميزة. يؤدي تعطيل التقديم المبكر أو الإحماء المجدول بعد استخدامه إلى تنظيف الموارد التي يملكها مرة واحدة؛ وتظل الطلبات اللاحقة خاملة.

الخيار النوع القيمة الافتراضية للتوافق القيمة الافتراضية للسرعة/التشدد الوصف
profile سلسلة "compat" غير منطبق compat أو speed أو strict
wordpress.headNoise قيمة منطقية false true إزالة اكتشاف الترويسة العام وإخراج الرموز التعبيرية
wordpress.embeds قيمة منطقية false true إزالة اكتشاف oEmbed وبرامج المضيف النصية
wordpress.xmlrpc قيمة منطقية false true تعطيل XML-RPC وردود الإشعار
wordpress.editor قيمة منطقية false true تعطيل واجهات اكتشاف المحرر عن بُعد
wordpress.frontendAssets قيمة منطقية false true إزالة أصول الواجهة الأمامية العامة في النواة
wordpress.media قيمة منطقية false true تطبيق الإعدادات الافتراضية لإخراج الصور
wordpress.heartbeat قيمة منطقية false true الحد من معدل Heartbeat خارج المحررات
preload.links سلسلة "off" "intent" استباق تحميل المستندات من المصدر نفسه بعد تفاعل المستخدم
media.lazy قيمة منطقية false true استخدام محمّل الصور الخاص بـ Blockstudio
media.skeleton قيمة منطقية false true إظهار الهيكل العظمي المدمج للتحميل
media.metadata قيمة منطقية false true التصريح باستخدام assets/media.json
media.rootMargin سلسلة "300px" "300px" هامش التقاطع للمحمّل الكسول
measurement.enabled قيمة منطقية false false تفعيل واجهات قياس وقت التشغيل
measurement.queryMonitor قيمة منطقية false false تضمين الاستعلامات التي تستغرق 50ms على الأقل
measurement.headers قيمة منطقية false false إرسال ترويسات ملف التعريف وتجزئة الإعدادات
measurement.timings قيمة منطقية false false إرسال ترويسة وقت التشغيل المنقضي
staticPrerender.enabled قيمة منطقية false false تفعيل التخزين المؤقت الآمن المجهول لـ HTML
staticPrerender.ttl عدد صحيح 86400 86400 الحد الأقصى لعمر المستند المخزّن مؤقتًا بالثواني
staticPrerender.invalidate سلسلة "signature" "signature" استخدام هوية signature أو الهوية التزايدية لـ graph
staticPrerender.earlyServe قيمة منطقية false false تقديم النتائج الآمنة قبل بدء WordPress
staticPrerender.serveLoggedIn قيمة منطقية false false السماح للمستخدمين باستهلاك النتائج المخزّنة مؤقتًا، دون إنشائها
staticPrerender.dynamicPaths مصفوفة [] [] بادئات المسارات التي يجب أن تظل ديناميكية
staticPrerender.replayHeaders مصفوفة ["Link"] ["Link"] ترويسات الاستجابة المخزّنة مع النتائج والمُرسلة عند إصابتها في ذاكرة التخزين المؤقت
staticPrerender.warm.enabled قيمة منطقية false false تفعيل قائمة الانتظار المجدولة الدائمة للإحماء
staticPrerender.warm.interval عدد صحيح 3600 3600 الفاصل الزمني للإحماء بالثواني
staticPrerender.warm.concurrency عدد صحيح 2 2 الحد الأقصى للمهام التي تعالجها دورة إحماء واحدة
staticPrerender.warm.transport سلسلة "http" "http" استخدام http أو عارض يوفّره المضيف وهو internal

يظل العرض المسبق الثابت معطّلًا ما لم يُفعّل صراحةً. لا يسجّل المفتاح الرئيسي المعطّل أي خطافات لطلبات العرض المسبق، كما أن مفتاحَي earlyServe وwarm.enabled المعطّلين لا يسجّلان أي خطافات للإدارة أو cron. يستخدم وضع التوقيع هوية مفعّلة منخفضة التكلفة في الطلبات العادية. أما وضع الرسم البياني فهو مخصص للإنشاءات الصريحة: إذ يسجّل تبعيات المصدر لكل صفحة، بحيث لا يؤدي تغيير صفحة واحدة إلى إبطال مستندات غير مرتبطة بها. راجع العرض المسبق الثابت لمعرفة تفاصيل الإحماء والنشر والتقديم المبكر والسلامة.

تتوفر القياسات برمجيًا:

PHP
use Blockstudio\Performance_Measurement;

$snapshot = Performance_Measurement::snapshot();

عند تفعيل الترويسات، يرسل Blockstudio ‏X-Blockstudio-Performance-Profile وX-Blockstudio-Performance-Config، واختياريًا X-Blockstudio-Performance-Time. ويتلقى الإجراء blockstudio/performance/measurement_enabled إعدادات وقت التشغيل التي تم حلّها.

تتحكم خيارات media في bs_media_image() وبيان assets/media.json ومُحمّل الواجهة الأمامية الكسول. راجع الوسائط لمعرفة تفاصيل المساعد ومنشئ البيان وسلوك المُحمّل.

content

الخيار النوع الافتراضي الوصف
enabled منطقي false تفعيل إعداد مزامنة المحتوى
id سلسلة "default" نطاق مجموعة المحتوى المخزن في الكيانات المتزامنة
path سلسلة "content" مجلد ملفات المحتوى بالنسبة إلى القالب
includePageSyncManaged منطقي false تضمين المنشورات التي تديرها مزامنة الصفحات دون امتلاك محتواها
authors سلسلة "ignore" معالجة المؤلف (ignore أو login لمستخدم موجود)
postTypes مصفوفة [] أنواع المنشورات المسموح بها
meta.include مصفوفة [] أنماط glob لمفاتيح البيانات الوصفية المراد مزامنتها
meta.exclude مصفوفة ["_edit_lock", "_edit_last", "_wp_old_slug"] أنماط glob لمفاتيح البيانات الوصفية المستثناة
meta.references كائن {} مراجع البيانات الوصفية المعلنة التي يُعاد تحويلها بين المعرّفات ومعرّفات UID
taxonomies مصفوفة [] التصنيفات المسجلة المسموح بها للمصطلحات والعلاقات
media سلسلة "manifest" سلوك مراجع المرفقات (manifest أو none)

تُدار مزامنة المحتوى عبر wp bs content، وتُصدّر المنشورات المسموح بها والبيانات الوصفية للمنشورات والمراجع المعلنة إلى ملفات قابلة للنقل. راجع مزامنة المحتوى لمعرفة سير العمل وتنسيق الملفات.

editor

الخيار النوع الافتراضي الوصف
formatOnSave منطقي false تنسيق block.json عند الحفظ
assets مصفوفة [] أصول إضافية لتحميلها في المحرر
markup منطقي false تفعيل تحرير الترميز

tailwind

الخيار النوع الافتراضي الوصف
enabled منطقي false تفعيل تجميع Tailwind CSS
config سلسلة "" إعداد يبدأ بـ CSS لـ Tailwind v4

راجع Tailwind CSS لمعرفة سلوك التجميع وتنسيق الإعداد الذي يبدأ بـ CSS.

blockTags

الخيار النوع الافتراضي الوصف
enabled منطقي false تفعيل عرض وسوم bs: على مستوى الصفحة ضمن محتوى المنشورات ومناطق الأدوات
allow مصفوفة [] قائمة سماح لأنماط أسماء الكتل؛ تدعم أحرف البدل fnmatch()
deny مصفوفة [] قائمة حظر لأنماط أسماء الكتل؛ لها الأولوية على allow
prefixes كائن {} بادئة لتحديد نطاق الأسماء المختصرة؛ كل قيمة نطاق اسم أو مصفوفة مرتبة

يكون عرض الوسوم على مستوى القالب مفعّلًا دائمًا؛ وتتحكم هذه الخيارات في الاستبدال على مستوى الصفحة. راجع العرض لمعرفة صياغة الوسوم وقواعد حلّها.

ui

الخيار النوع الافتراضي الوصف
enabled منطقي false تسجيل مكونات bsui/* UI المضمّنة وتطبيقات العرض التوضيحي app/*

blockEditor

الخيار النوع الافتراضي الوصف
disableLoading منطقي false تعطيل تحميل الكتل في المحرر
enhance منطقي false تفعيل إمكانات التحويم والتحديد في محرر Blockstudio
cssClasses مصفوفة [] عناوين URL لأوراق الأنماط لاستخراج أصناف CSS منها للاقتراح التلقائي في حقل الأصناف
cssVariables مصفوفة [] عناوين URL لأوراق الأنماط لاستخراج متغيرات CSS منها للاقتراح التلقائي في حقل الأكواد

blockEditor.blocks

استخدم blockEditor.blocks لتحديد سياسة إدراج الكتل على مستوى المشروع. يقبل allow وdeny أسماء الكتل وأنماط أحرف البدل مثل core/*.

JSON
{
  "blockEditor": {
    "blocks": {
      "allow": ["core/*", "my-theme/*"],
      "deny": ["core/embed", "core/freeform"],
      "directory": false,
      "categories": {
        "rename": {
          "text": "Writing",
          "design": "Layout"
        },
        "order": ["my-theme", "text", "media"]
      },
      "legacyWidgets": {
        "hide": ["archives", "calendar"]
      }
    }
  }
}

يلغي blocks.styles.deny تسجيل الأنماط المسجلة عبر سجل أنماط الكتل WordPress’ الخاص بـ PHP:

JSON
{
  "blockEditor": {
    "blocks": {
      "styles": {
        "deny": {
          "my-theme/card": ["outline"],
          "my-theme/media": ["framed"]
        }
      }
    }
  }
}

blockEditor.patterns

استخدم blockEditor.patterns لتعطيل مصادر الأنماط العامة وتصفية فئات الأنماط.

JSON
{
  "blockEditor": {
    "patterns": {
      "core": false,
      "remote": false,
      "theme": true,
      "blockstudio": true,
      "categories": {
        "deny": ["gallery"],
        "rename": {
          "featured": "Featured Layouts"
        },
        "order": ["featured", "buttons"]
      }
    }
  }
}

blockEditor.media

استخدم blockEditor.media لتحديد سياسة أداة إدراج الوسائط العامة.

JSON
{
  "blockEditor": {
    "media": {
      "openverse": false,
      "imageSizes": {
        "allow": ["thumbnail", "large"],
        "deny": ["medium_large"]
      }
    }
  }
}

dev

الخيار النوع الافتراضي الوصف
grab.enabled منطقي false تفعيل أداة التقاط العناصر في الواجهة الأمامية
perf منطقي false تفعيل محلّل الأداء عند تحميل كل صفحة
canvas.enabled منطقي false تفعيل اللوحة
canvas.adminBar منطقي true إظهار شريط إدارة WordPress عند عرض اللوحة

githooks

الخيار النوع الافتراضي الوصف
commit منطقي false إنشاء خطاف ما قبل الالتزام للتحليل فقط عند تشغيل blockstudio-githooks sync

راجع خطاف الالتزام المُدار لمعرفة ما ينفذه الخطاف المُنشأ وكيفية إبقائه متزامنًا.

phpstan

الخيار النوع الافتراضي الوصف
preset نص "base" إعداد التحليل المسبق عند عدم تحديد أحد في سطر الأوامر: base أو theme أو extreme-theme أو wordpress-render
configuration نص "" إعداد PHPStan المشروع المُضمّن إلى جانب الإعداد المسبق، ويُحدّد من blockstudio.json
roots مصفوفة ["."] جذور السمات التي يحللها الأمر المعتمد
excludePaths مصفوفة [] استثناءات إضافية للماسح نسبةً إلى كل جذر مُعدّ
maxFiles عدد صحيح 10000 الحد الأقصى لعدد الملفات التي يفحصها ماسح السمات
blockTags كائن {} تعيينات العناصر، والأسماء البديلة للوسوم، وscanPhp لقاعدة وسم الكتلة

تتحكم هذه الإعدادات في الأمر الأساسي blockstudio-phpstan. راجع PHPStan لمعرفة الإعدادات المسبقة والطبقات وكيفية التبني.

ai

الخيار النوع الافتراضي الوصف
enableContextGeneration منطقي false إنشاء ملف سياق موحّد للكتل والإعدادات والمخططات والوثائق لاستخدامه مع أدوات LLM

راجع تكامل AI لفهرس الوثائق والنص المُنشأ كاملًا.

مكونات UI

فعّل مكونات UI المضمّنة عديمة الواجهة وركّبها، وقد قُدّمت في Blockstudio 7.3.