مزامنة المحتوى
صُمم Blockstudio حول سير عمل يضع الملفات أولًا: إذ يمكن أن تكون الكتل والحقول والقوالب والأصول والأنماط والصفحات المستندة إلى الملفات كلها ضمن مشروعك. وتوسّع مزامنة المحتوى هذا النموذج ليشمل محتوى قاعدة بيانات WordPress محددًا، للفرق التي تريد أيضًا حفظ المنشورات والمصطلحات والعلاقات والبيانات الوصفية المعلنة في git.
إنه سير عمل WP-CLI، وليس نسخًا مباشرًا لقاعدة البيانات. عند السحب، تُسقط مزامنة المحتوى المنشورات وبيانات المنشورات الوصفية والمصطلحات وبيانات المصطلحات الوصفية والعلاقات بين المنشورات والمصطلحات المدرجة في قائمة السماح إلى ملفات قابلة للنقل في نسقك. وعند الدفع، تطبّق تلك الملفات على بيئة أخرى، باستخدام معرّفات UID ثابتة، ولا تعيد كتابة إلا المراجع التي تحددها صراحةً.
ملاحظة
تعمل مزامنة المحتوى عند الطلب. ولا تعمل مع كل طلب إداري. تُرجع الأوامر صفًا يفيد بالتخطي إلى أن يصبح
content.enabledtrue.
متى تستخدم مزامنة المحتوى
استخدم مزامنة المحتوى لمجموعات المحتوى المهمة لإدارة الإصدارات ومراجعتها ونقلها بين البيئات:
- المحتوى المنظم مثل أعضاء الفريق والمواقع ودراسات الحالة والمنتجات ومدخلات التوثيق أو صفحات الحملات
- التصنيفات والعلاقات المرتبطة بمجموعات المحتوى هذه
- البيانات الوصفية المسموح بها التي يمكن حفظها بأمان وتحتاج إلى مراجع ثابتة
- مجموعات المحتوى الصغيرة إلى المتوسطة، حيث تظل مراجعة الملفات في git عملية
كقاعدة عامة، تناسب مزامنة المحتوى عشرات الصفوف أو مئاتها، ويمكنها التعامل مع بضعة آلاف إذا كانت البيانات منظمة وقليلة التغيّر ومقسمة إلى أنواع منشورات محددة. وهي غير مخصصة لنسخ قاعدة بيانات إنتاج كاملة، أو المحتوى التحريري كثير الزيارات، أو السجلات أو الطلبات أو التحليلات أو عمليات إرسال النماذج أو الجلسات أو غيرها من البيانات كبيرة الحجم أو كثيرة التغيّر. إذا أصبحت الملفات الناتجة مزعجة عند مراجعتها، أو استغرقت عمليات الدفع وقتًا طويلًا لفهمها، أو تغيرت معظم الصفوف خارج سير عمل النشر، فاستخدم بدلًا من ذلك نسخة احتياطية لقاعدة البيانات أو أداة ترحيل أو استيراد وتصدير.
لا تُنسخ الملفات الثنائية للوسائط. يمكن تسجيل مراجع المرفقات في بيان والتحقق منها، لكن يجب أن تكون الملفات نفسها موجودة في البيئة المستهدفة.
الإعداد
فعّل مزامنة المحتوى في blockstudio.json:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"content": {
"enabled": true,
"id": "default",
"path": "content",
"includePageSyncManaged": false,
"authors": "ignore",
"postTypes": ["team_member"],
"meta": {
"include": ["_my_*"],
"exclude": ["_edit_lock", "_edit_last", "_wp_old_slug"],
"references": {
"_thumbnail_id": { "kind": "attachment" },
"_related_posts": { "kind": "post", "path": "*" },
"_hero": { "kind": "attachment", "path": "image.id" }
}
},
"taxonomies": [],
"media": "manifest"
}
}
postTypes قائمة سماح. إذا كانت فارغة، فلن تمس مزامنة المحتوى المنشورات. وtaxonomies قائمة سماح بالتصنيفات المسجلة مسبقًا، التي ينبغي مزامنة مصطلحاتها وعلاقاتها بالمنشورات. أما Blockstudio فلا يسجل تعريفات التصنيفات من ملفات مزامنة المحتوى. وتُدرج بيانات المنشورات والمصطلحات الوصفية المسموح بها عبر meta.include؛ وتكون الغلبة دائمًا لـmeta.exclude.
تحذير
تعامل مع
meta.includeعلى أنه حدّ لما يمكن إيداعه. يُفترض أن تحفظ ملفات المزامنة في git، لذا لا تُدرج مفاتيح تحتوي على أسرار أو رموز وصول أو بيانات اعتماد أو معلومات تعريف شخصية. ويصدرwp bs content statusصفوفًا تحذيرية عندما يبدو أن مفتاح بيانات وصفية مسموحًا به حساس.
تُخزّن content.id في الكيانات المتزامنة بوصفها _blockstudio_content_set. وتُقيّد عمليات التنظيف وفحوصات الملكية بهذه القيمة، كي لا تتمكن مجموعة محتوى من حذف محتوى مجموعة أخرى.
تُستثنى المنشورات التي تديرها مزامنة الصفحات افتراضيًا. إذا فُعّل includePageSyncManaged، يمكن لمزامنة المحتوى مزامنة بياناتها الوصفية المضبوطة، لكن تظل مزامنة الصفحات مسؤولة عن post_content الخاصة بها.
تحتوي هذه الإسقاطات على "bodyOwner": "page-sync". يعرض السحب عملية الكتابة JSON على أنها بيانات وصفية فقط، ويضيف صف متن skipped بدلاً من إظهار المنشور كما لو كان متنه فارغاً. ولا يكتب أو يحذف ملف .html شقيقاً. تُحفظ نسخة المراجعة الموجودة ويتجاهلها الدفع. وتُدرج رسائل الملكية نفسها في مخرجات التشغيل التجريبي.
في بيئة أخرى، شغّل Page Sync أولًا. يجب أن يشير الإسقاط الذي يتضمن bodyOwner: "page-sync" إلى منشور موجود يديره Page Sync؛ ويرفض push إنشاء بديل فارغ أو تطبيق نسخة المراجعة الخاصة بذلك المتن. يظل دعم الإسقاطات من الإصدارات الأقدم التي لا تتضمن العلامة متاحًا.
يُتجاهل المؤلفون افتراضيًا لأن المستخدمين لا تتم مزامنتهم. اضبط authors: "login" لتخزين اسم دخول المؤلف في ملفات المنشورات وحلّه إلى مستخدم موجود عند الدفع. ويؤدي غياب المستخدم إلى خطأ في الفحص المسبق؛ ولا تنشئ مزامنة المحتوى مستخدمين.
الأوامر
wp bs content pull [--post-type=<type>] [--taxonomy=<taxonomy>] [--dry-run]
wp bs content push [--dry-run] [--prune] [--yes]
wp bs content status
يلتقط pull محتوى قاعدة البيانات في ملفات. ويعيّن _blockstudio_content_uid للمنشورات الواقعة ضمن النطاق التي لا تملكه بعد، ويبلغ عن الملفات القديمة التي لم يعد مصدرها في قاعدة البيانات موجودًا. ولا تُحذف الملفات القديمة عند السحب.
يطبّق push الملفات على قاعدة البيانات الحالية. ويتحقق من الخطة قبل الكتابة، ويمنع التنفيذ عند وجود مراجع معلنة لم تُحل أو تعارضات في الروابط الثابتة أو كيانات مقفلة أو أنواع منشورات مفقودة.
يقارن status الملفات بقاعدة البيانات، ويبلغ عن كل كيان بوصفه unchanged أو would-update أو missing-db أو conflict أو locked أو orphaned. كما يحذر من مفاتيح البيانات الوصفية المسموح بها التي تبدو كأنها أسرار قبل إيداع تلك القيم، ومن المعرّفات الرقمية داخل أجسام ترميز الكتل، لأن مزامنة المحتوى لا تعيد كتابة المعرّفات في ملفات .html.
استخدم --dry-run لفحص عملية سحب أو دفع دون كتابة. واستخدم push --prune --yes لإزالة كيانات قاعدة البيانات التي تملكها مجموعة المحتوى ولم تعد موجودة في الملفات.
ضمان السلامة عند الإخفاق
يحلل push خطة المصدر كاملة ويتحقق منها قبل الكتابة أو
التنظيف. وتمنع مرحلة ما قبل التنفيذ أي حالات فشل ناجمة عن JSON مشوهة أو مراجع معلنة لم تُحل أو ملكية غير صالحة أو غير ذلك.
ويظل التنظيف مقتصرًا على أنواع المنشورات والتصنيفات وcontent.id التي جرى ضبطها.
يكتب pull كل ملف مُسقط قبل تسجيل الكيان على أنه تمت مزامنته. ويُعاد إخفاق الكتابة في نظام الملفات كصف خطأ، ولا يحدّث حالة المزامنة المخزنة لذلك الكيان.
تتبع معالجة المرفقات content.media. مع "manifest"، يجب أن تكون معرّفات UID للمرفقات المشار إليها موجودة في البيئة المستهدفة. ومع "none"، تُحذف مراجع المرفقات المعلنة عمدًا من الناتج القابل للنقل، بدلًا من الاحتفاظ بمعرّفات خاصة بالبيئة.
الملفات
تكتب مزامنة المحتوى الملفات ضمن content.path المضبوط:
content/
posts/
team_member/
jane.9b1c0e6e.json
jane.9b1c0e6e.html
terms/
category/
leadership.5e900000.json
media/
manifest.json
تخزن ملفات .json الخاصة بالمنشورات الهوية وحقول المنشور وعلاقات المصطلحات والبيانات الوصفية المعلنة وترميز البيانات الوصفية. ويخزن ملف .html المجاور post_content على هيئة ترميز كتل خام، ويُحذف إذا كان المحتوى فارغًا. أما ملفات .json الخاصة بالمصطلحات فتخزن الهوية والتصنيف والرابط الثابت والاسم والوصف ومعرّف UID للعنصر الأب والبيانات الوصفية المعلنة للمصطلح وترميز البيانات الوصفية.
الحالة الأخرى التي لا يوجد فيها ملف .html هي متن مملوك لـ Page Sync، ويُحدَّد بواسطة bodyOwner أعلاه. أما في المنشورات العادية التي يصبح متنها فارغًا، فيحذف pull ملف المتن القديم ويذكره في صف مستقل للمتن deleted.
{
"uid": "9b1c0e6e-0000-4000-9000-000000000000",
"type": "team_member",
"status": "publish",
"slug": "jane",
"title": "Jane",
"parent": null,
"menuOrder": 0,
"terms": {
"category": ["5e900000-0000-4000-9000-000000000000"]
},
"meta": {
"_my_subtitle": "Creative Director",
"_thumbnail_id": "a1b2c3d4-0000-4000-9000-000000000000"
},
"metaEncoding": {
"_my_subtitle": "scalar",
"_thumbnail_id": "scalar"
}
}
حالة المزامنة المخزنة هي:
| مفتاح البيانات الوصفية | الغرض |
|---|---|
_blockstudio_content_uid |
هوية المحتوى القابلة للنقل |
_blockstudio_content_set |
مساحة أسماء مجموعة المحتوى من content.id |
_blockstudio_content_source |
مسار الملف نسبةً إلى النسق |
_blockstudio_content_fingerprint |
بصمة آخر مزامنة للملف/قاعدة البيانات |
_blockstudio_content_locked |
قيمة صادقة تمنع الدفع من الكتابة فوق الكيان |
المراجع
لا تخمّن مزامنة المحتوى مطلقًا أن عددًا صحيحًا هو معرّف. ولا تُعاد كتابة المراجع إلا عند ضبطها في meta.references.
{
"meta": {
"references": {
"_related_posts": { "kind": "post", "path": "*" },
"_topic": { "kind": "term" },
"_hero": { "kind": "attachment", "path": "image.id" }
}
}
}
عند السحب، تتحول المعرّفات المحلية في تلك المسارات إلى معرّفات UID قابلة للنقل. وعند الدفع، تُحل معرّفات UID مرة أخرى إلى معرّفات محلية في قاعدة البيانات الحالية.
تُعدّ العناصر الأب للمنشورات والمصطلحات، والعلاقات بين المنشورات والمصطلحات، مراجع هيكلية تديرها مزامنة المحتوى وتُخزن تلقائيًا بصيغة معرّفات UID. وتُكتب التصنيفات المضبوطة في ملفات المنشورات حتى عندما تكون فارغة؛ إذ تمسح المصفوفة الفارغة علاقات ذلك التصنيف عند الدفع.
يجري التحقق من مراجع المرفقات دون استيرادها. مع media: "manifest"، تُدرج المرفقات المشار إليها في content/media/manifest.json؛ ويتطلب الدفع وجود معرّف UID للمرفق المشار إليه محليًا. ومع media: "none"، تُحذف مراجع المرفقات المعلنة من الملفات القابلة للنقل. ولأن المفتاح المحذوف لا يُطبّق عند الدفع، يحتفظ المنشور الموجود في البيئة المستهدفة ببيانات المرفقات الوصفية الحالية.
سير عمل قابلية النقل
- سجّل نوع المنشور المستهدف في كل بيئة.
- اضبط
content.postTypesوmeta.includeوأي مراجع معلنة. - شغّل
wp bs content pullفي البيئة المصدر. - أودع الملفات المُنشأة.
- شغّل
wp bs content pushفي البيئة المستهدفة. - شغّل
wp bs content statusللتحقق من تطابق قاعدة البيانات مع الملفات.
الملفات هي مصدر الحقيقة لـpush. وتُلتقط قاعدة البيانات مجددًا في الملفات باستخدام pull.
النطاق
تدعم مزامنة المحتوى ما يلي:
- المنشورات من أنواع المنشورات المدرجة في قائمة السماح
- بيانات المنشورات الوصفية المدرجة في قائمة السماح
- المصطلحات من التصنيفات المسجلة والمدرجة في قائمة السماح
- بيانات المصطلحات الوصفية المدرجة في قائمة السماح
- العلاقات بين المنشورات والمصطلحات
- مراجع
postوattachmentوtermالمعلنة - معرّفات UID قابلة للنقل للمنشورات والمصطلحات وملكية مجموعات المحتوى
- الاستثناء الافتراضي لمزامنة الصفحات
- بيان المرفقات والتحقق المسبق منها
- معالجة
pullوpushوstatusو--dry-runو--pruneوالكيانات المقفلة
لا يدعم النظام التقاط تعريفات التصنيفات أو نسخ الملفات الثنائية للوسائط أو إعادة كتابة معرّفات ترميز الكتل.