مخططات وووكامرس (WooCommerce Blueprints)
تساعدك مخططات وووكامرس (WooCommerce Blueprints) على تبسيط إعداد إدارة واختبار إعدادات متجرك. تتيح لك المخططات استيراد وتصدير إعدادات متجرك، وإضافات WordPress.org المحددة، وقوالب WordPress.org المحددة.
- توفير الوقت عبر إعادة استخدام إعدادات المتاجر المُبرمج مسبقاً.
- ضمان الاتساق عبر الفرق والبيئات المختلفة.
- اختبار الميزات أو الإعدادات الجديدة بأمان وبكفاءة.
ما هي المخططات (Blueprints)؟
المخطط (Blueprint) هو ملف إعداد قابل للنقل يلتقط إعدادات متجر وووكامرس الخاص بك. يمكن أن يتضمن إعدادات وووكامرس، والإضافات المحددة من WordPress.org، والقوالب المحددة من WordPress.org. هذا يجعل من السهل إعادة إنشاء بيئة المتجر، أو مشاركة الإعدادات مع زملائك، أو تشغيل متاجر جديدة بسرعة باستخدام الإعداد المفضل لديك.
تستخدم المخططات تنسيق مخططات ملعب ووردبريس (WordPress Playground blueprint format)، مما يجعلها قابلة للنقل ومتوافقة مع مجموعة واسعة من أدوات ووردبريس.
تفعيل ميزة المخطط
تكون ميزة المخطط مفعلة افتراضياً في إصدارات وووكامرس الحالية. لا يزال بإمكانك تغيير هذا الإعداد ضمن وووكامرس > الإعدادات > متقدم > الميزات (WooCommerce > Settings > Advanced > Features):
- ابحث عن المخطط (تجريبي - Blueprint beta).
- قم بتفعيل الميزة أو إيقاف تشغيلها.
- اختر حفظ التغييرات (Save changes).
تفعيل ميزة المخططات
عند التفعيل، يظهر خيار المخطط (تجريبي - Blueprint beta) ضمن المسار وووكامرس > الإعدادات > متقدم > المخطط (تجريبي).
تصدير مخطط (Exporting a Blueprint)
يحفظ تصدير المخطط إعدادات متجرك الحالية في ملف .json يمكنك استيراده إلى موقع وووكامرس آخر.
- انتقل إلى وووكامرس > الإعدادات > متقدم > المخطط (تجريبي).
- قم بالتمرير إلى قسم التصدير (Export).
- اختر الإعدادات والإضافات والقوالب المراد تضمينها.
- اختر تصدير (Export) لإنشاء وتنزيل ملف المخطط.
تصدير المخططات
إعدادات وووكامرس (WooCommerce settings)
يمكنك تحديد إعدادات وووكامرس التالية لتصديرها:
- عام (General)
- المنتجات (Products)
- الضرائب (Tax)
- الشحن (Shipping)
- المدفوعات (Payments)
- البريد الإلكتروني (Emails)
- الحسابات والخصوصية (Accounts & Privacy)
- التكاملات (Integrations)
- رؤية الموقع (Site Visibility)
- متقدم (Advanced)
تم تضمين إعدادات بوابة الدفع في أداة التصدير الحالية لوووكامرس.
يتم تصدير معظم خيارات وووكامرس من خلال واجهة برمجة تطبيقات الإعدادات (Settings API). ويتم تصدير بعض البيانات مباشرة من جداول قاعدة البيانات كخطوات SQL، بما في ذلك معدلات وفئات الضرائب، وفئات ومناطق ومواقع وأطقم ومعدلات الشحن. تظل أدلة التنزيل المعتمدة ومفاتيح REST API التي تم إنشاؤها بواسطة الكود القديم أمثلة على البيانات غير المضمنة.
الإضافات والقوالب (Plugins and themes)
يمكنك تحديد الإضافات والقوالب المدعومة النشطة أو غير النشطة والمتوفرة من WordPress.org. يتم تثبيت وتفعيل الإضافات المحددة أثناء الاستيراد. يتم تثبيت القوالب المحددة، ولكن يتم تفعيل القالب الذي كان نشطاً في المتجر المصدر فقط.
لا تعتبر الإضافات والقوالب التجارية أو الخاصة العشوائية قابلة للنقل من خلال هذه الآلية. كما لا تقوم المخططات عادةً بتصدير إعدادات الإضافات العشوائية، لذا قم بمراجعة وتكوين إعدادات الإضافات بشكل منفصل بعد الاستيراد.
استيراد مخطط (Importing a Blueprint)
يُطبق استيراد المخطط خطواته على موقع وووكامرس جديد أو موجود. قم بمراجعة الملف وتأكد من أنه يأتي من مصدر موثوق قبل استيراده.
- انتقل إلى وووكامرس > الإعدادات > متقدم > المخطط (تجريبي).
- قم بالتمرير إلى قسم الاستيراد (Import).
- قم بتحميل ملف المخطط.
- اختر استيراد (Import) لبدء عملية الاستيراد.
استيراد المخططات
يقوم الاستيراد بتشغيل خطوات المخطط بشكل متسلسل. يتحقق وووكامرس من مخطط وصلاحيات كل خطوة مباشرة قبل تطبيقها. يمكن أن تنجح خطوة سابقة قبل الوصول إلى خطوة لاحقة غير صالحة أو فاشلة، ولا يتم رفض الخصائص غير المتوقعة موحداً. راجع رسائل الاستيراد بعد انتهاء العملية.
قيود الاستيراد (Import restrictions)
يتم تعطيل عمليات الاستيراد من خلال شاشة إعدادات وووكامرس وواجهة REST API الإدارية افتراضياً عندما يكون الموقع مباشراً (live). قم بتفعيل وضع "قريباً (Coming Soon)" قبل الاستيراد، أو قم بتعريف ALLOW_BLUEPRINT_IMPORT_IN_LIVE_MODE كقيمة true في ملف wp-config.php للسماح بهذه الاستيرادات على موقع مباشر.
لا تتطلب عمليات استيراد WP-CLI وضع "قريباً". قم بمراجعة الملف قبل تشغيل الاستيراد.
المزايا (Benefits)
- تطبيق تكوين ابتدائي بسرعة عبر المتاجر الجديدة باستخدام مجموعة قوالب وإضافات مشتركة.
- إعادة استخدام الإعدادات والإضافات والقوالب المحددة من WordPress.org عبر بيئات التطوير أو الاختبار (staging).
- اختبار إضافات وووكامرس في بيئات مختلفة وتكوينات متجر باستخدام مجموعة من ملفات المخطط.
- نسخ تكوين المتجر عند الإطلاق في سوق جديد أو اختبار ميزة أو إضافة جديدة.
الأمان (Security)
قم باستيراد المخططات من المصادر الموثوقة فقط. راجع الملف قبل تأكيد الاستيراد. يتم تشغيل خطوات المخطط باستخدام صلاحيات المسؤول الذي يقوم بالاستيراد ويمكنها تغيير بيانات الموقع.
التحقق من الخطوات والصلاحيات (Step validation and permissions)
يتحقق وووكامرس من كل خطوة قبل معالجتها ويتحقق من الصلاحيات المطلوبة لهذه الخطوة. تحدث عمليات التحقق من الصحة والصلاحيات عند وصول المحمل إلى كل خطوة؛ وهي لا تضمن التحقق من صحة الملف بأكمله قبل إجراء أي تغييرات.
قيود الخيارات (Option restrictions)
تتخطى خطوة setSiteOptions قائمة بالخيارات المقيدة لووردبريس، بما في ذلك عناوين URL للموقع، والإضافات النشطة، وإعدادات القوالب، وإعدادات تسجيل المستخدم، والخيارات المتعلقة بالأدوار. ينطبق هذا القيد على خطوة setSiteOptions فقط. وهو لا يمنع عالمياً خطوة runSql من تغيير تلك الخيارات.
فحوصات تنفيذ SQL (SQL execution checks)
يمكن أن تحتوي المخططات على خطوات runSql. يطبق وووكامرس فحوصات الدفاع في العمق (defense-in-depth) قبل تنفيذ هذه الخطوات، بما في ذلك الفحوصات لأنواع الاستعلامات المسموح بها، والتعليقات المشبوهة، وأنماط حقن SQL المعروفة، وجداول المستخدمين المحمية، والخيارات المتعلقة بالصلاحيات.
هذه فحوصات تعتمد على أنماط النصوص، وليست بيئة محاكاة SQL (sandbox) أو حدود أمان صارمة. فهي لا تجعل المخطط غير الموثوق به آمناً. قم بمراجعة كل مخطط قبل استيراده.
تسجيل التدقيق (Audit logging)
يتم تسجيل عمليات استيراد وتصدير المخطط ضمن المسار وووكامرس > الحالة > السجلات (WooCommerce > Status > Logs). ابحث عن wc-blueprint في عمود المصدر (Source).
