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

مصادر الاكتشاف المنطقية

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

يواصل Blockstudio تحليل الكتل والصفحات والمجموعات والأنماط والحقول والقوالب وأجزاء القوالب وتسجيلها. ويحدد المصدر فقط الملفات المنطقية المرئية ومكان قراءة كل ملف مرئي.

مصادر قوائم الجرد

استخدم المرشح blockstudio/discovery/sources لاستبدال كائنات Filesystem_Discovery_Source الافتراضية:

PHP
use Blockstudio\Inventory_Discovery_Source;

add_filter(
    'blockstudio/discovery/sources',
    function (array $sources, string $context, array $paths): array {
        if ('blocks' !== $context) {
            return $sources;
        }

        return [
            new Inventory_Discovery_Source(
                'preview:feature-card',
                '/runtime-preview/feature-card/blockstudio',
                [
                    'card/block.json' => [
                        'path' => '/theme/blockstudio/card/block.json',
                        'provenance' => [
                            'layer' => 'parent',
                            'inherited' => true,
                        ],
                    ],
                    'card/index.php' => [
                        'path' => '/runtime-preview/feature-card/blockstudio/card/index.php',
                        'provenance' => [
                            'layer' => 'preview',
                        ],
                    ],
                ],
                'parent-and-preview-fingerprint',
                ['/theme/blockstudio', '/runtime-preview/feature-card/blockstudio']
            ),
        ];
    },
    10,
    3
);

السياقات المتاحة هي:

  • blocks
  • fields
  • pages
  • patterns
  • site-templates
  • site-template-parts

قائمة الجرد هي الشجرة النهائية المرئية. ادمج الطبقات قبل إرجاعها:

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

يُسهّل Inventory_Discovery_Source إنشاء قوائم الجرد المدعومة بالمصفوفات. ويمكن لعمليات التكامل تنفيذ الواجهة Discovery_Source عندما تُحل الإدخالات عند الطلب أو تأتي من نظام تخزين آخر.

حل الملفات الشقيقة

قد تُحل الملفات المنطقية الشقيقة إلى جذور فعلية مختلفة. يمكن لـblock.json أصل استخدام index.php تراكبية، كما يمكن لصفحة تراكبية أن ترث pages.json الأصل أو المحمّل أو التخطيط. يحل Blockstudio هذه العلاقات حسب المسار المنطقي قبل قراءة الملفات الفعلية المحددة.

تحتفظ مسارات المحمّل الواقعة خارج مجموعة بالحد الأمني الحالي لـblockstudio/pages/allow_external_loader_path.

الهوية والإبطال

يوفر كل مصدر ما يلي:

  • معرّف مصدر ثابت لبيئة التشغيل المحددة.
  • بصمة تتغير بتغير قائمة الجرد المرئية.
  • مدخلات مراقبة فعلية لإعادة التحميل الفوري والتحقق من ذاكرة التخزين المؤقت.
  • مصدرًا وبيانات وصفية لكل إدخال.

يضمّن Blockstudio معرّفات المصادر وبصماتها في هويات ذاكرة التخزين المؤقت لبيئة التشغيل وبيان الصفحة وقالب محرر الموقع وCanvas وTailwind.

استخدم blockstudio/cache/context عندما يمكن لاختيار المصدر نفسه أن يُعرض ضمن متغيرات متعددة لبيئة التشغيل:

PHP
add_filter(
    'blockstudio/cache/context',
    fn ($context, string $scope) => [
        'preview' => 'feature-card',
        'site' => get_current_blog_id(),
    ],
    10,
    2
);

يجب أن تكون قيمة السياق قابلة للتسلسل وثابتة للطلبات المتكافئة. يحتفظ Tailwind بآخر CSS صالح في نطاق خاص بالسياق، كي لا تتلقى إحدى المعاينات قيمة CSS احتياطية تخص معاينة أخرى.

الأصول المُنشأة

ضع علامة على الإدخالات الموروثة أو المخصصة للقراءة فقط باستخدام inherited: true أو readOnly: true أو writable: false في المصدر أو البيانات الوصفية. عندئذ يكتب Blockstudio الأصول المترجمة في نطاق generated خاص بالسياق ضمن جذر ذاكرة التخزين المؤقت Blockstudio المُعدّ، بدلًا من وضعها بجوار المصدر الأصل. وبذلك تشترك الأصول المُنشأة ومخرجات Tailwind ومستندات العرض والعروض المسبقة الثابتة في حد المضيف نفسه القابل للكتابة.

يغطي مرشحان توجيه وقت التشغيل المخصص:

PHP
add_filter(
    'blockstudio/generated_output/path',
    function (string $path, string $source, string $scope, array $metadata) {
        return $path;
    },
    10,
    4
);

add_filter(
    'blockstudio/files/url',
    function (string $url, string $path, string $scope) {
        return $url;
    },
    10,
    3
);

استخدم المرشح URL عندما تكون الملفات المحددة خارج wp-content أو تُقدّم عبر نقطة نهاية لوقت التشغيل.