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

الأنماط

الأنماط قوالب مستندة إلى الملفات ومسجلة كأنماط كتل WordPress. تظهر في أداة إدراج الكتل ويمكن للمستخدمين وضعها في أي مكان.

على خلاف الصفحات، تُسجّل الأنماط في الذاكرة ولا تنشئ سجلات في قاعدة البيانات.

pattern.json

يحتاج كل مجلد نمط إلى ملف إعداد pattern.json:

JSON
{
  "name": "hero-section",
  "title": "Hero Section",
  "description": "A hero section with heading and CTA",
  "categories": ["featured", "header"],
  "keywords": ["hero", "banner", "cta"]
}

الخصائص

الخاصية النوع الافتراضي الوصف
name string مطلوب معرّف فريد (تسبقه blockstudio/)
title string مطلوب عنوان العرض في أداة إدراج الكتل
description string "" الوصف المعروض في أداة الإدراج
categories string[] [] فئات الأنماط (e.g، featured، header، footer)
keywords string[] [] كلمات البحث المفتاحية لأداة الإدراج
viewportWidth number – عرض المعاينة بالبكسل
blockTypes string[] [] أنواع الكتل المرتبطة
postTypes string[] [] تقييدها بأنواع منشورات محددة
inserter boolean true ما إذا كان سيُعرض في أداة الإدراج

مثال

pattern.json:

JSON
{
  "name": "hero-with-cta",
  "title": "Hero with CTA",
  "description": "A full-width hero section with heading and call-to-action buttons",
  "categories": ["featured", "header"],
  "keywords": ["hero", "banner", "cta", "landing"],
  "viewportWidth": 1200
}

index.php:

HTML
<block name="core/cover" url="https://example.com/hero-bg.jpg" dimRatio="60">
  <h1>Build Something Amazing</h1>
  <p>Create beautiful websites with the power of blocks.</p>
  <block name="core/buttons">
    <block name="core/button" url="/get-started">Get Started</block>
    <block name="core/button" url="/learn-more" className="is-style-outline">Learn More</block>
  </block>
</block>

المسارات المخصصة

افتراضيًا، يفحص Blockstudio get_template_directory() . '/patterns'. أضف مسارات أخرى باستخدام المرشح:

PHP
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
    $paths[] = get_stylesheet_directory() . '/custom-patterns';
    $paths[] = MY_PLUGIN_PATH . '/patterns';
    return $paths;
} );

يمكن لتكاملات وقت التشغيل التي تجمع الملفات من عدة جذور استبدال فحص نظام الملفات بـمصدر اكتشاف منطقي. يُحدّد موضع بيانات الأنماط والقوالب المصدرية في المخزون المنطقي النهائي الظاهر.

PHP API

PHP
// Get all registered patterns
$patterns = Blockstudio\Patterns::patterns();

// Get a specific pattern
$pattern = Blockstudio\Patterns::get_pattern('hero-section');

// Get registered paths
$paths = Blockstudio\Patterns::get_registered_paths();

مقارنة بالصفحات

الجانب الصفحات الأنماط
التخزين تُزامن مع قاعدة البيانات كمنشورات تُسجّل في الذاكرة
الإعداد page.json pattern.json
المزامنة صريحة، باستخدام wp bs pages sync لا حاجة إلى المزامنة
قفل القالب نعم لا
حالة الاستخدام محتوى صفحات محدد مسبقًا قوالب كتل قابلة لإعادة الاستخدام