الترحيل·7 min read·

تصدير Ghost واستيراده إلى VeloCMS

يحتوي تصدير JSON من Ghost على كل شيء — المنشورات والأعضاء والمستويات والصور. يحوّل CLI الترحيل في VeloCMS تنسيق Ghost إلى AST الكتل الخاص بـ VeloCMS بأمر واحد.

يُصدّر Ghost جميع محتوياتك في ملف JSON واحد عبر Settings ثم Labs ثم Export your content. يحتوي هذا الملف على المنشورات والصفحات والوسوم والأعضاء وإشارات الصور — وهو كل ما يحتاجه CLI الترحيل في VeloCMS لإجراء ترحيل كامل. في معظم مدونات Ghost، تستغرق عملية الترحيل أقل من 30 دقيقة.

الخطوة 1 — التصدير من Ghost

في لوحة إدارة Ghost، انتقل إلى Settings ثم Labs وانقر على Export your content. سيُنزّل Ghost ملفاً باسم ghost-export-YYYY-MM-DD.json. إذا كانت صور مدوّنتك مستضافة على شبكة توصيل محتوى Ghost Pro (ghost.io)، فسيتضمّن الملف المُصدَّر روابط الصور الكاملة، وسيتولّى CLI الترحيل تنزيلها وإعادة رفعها إلى حاوية VeloCMS R2 الخاصة بك. أما بالنسبة لـ Ghost المستضاف ذاتياً، فتوجد الصور في /content/images/ — صدّر هذا المجلد بشكل منفصل باستخدام أسلوب أرشيف tar الموضّح في دليل WordPress المستضاف ذاتياً.

الخطوة 2 — التحويل والاستيراد

شغّل الأمر velocms-migrate ghost-to-json --input ghost-export.json --output posts.json. يستخدم Ghost تنسيق Mobiledoc لمحتوى المنشورات (وهو تنسيق JSON قديم يشبه AST الكتل في VeloCMS لكنه يعتمد أنواعاً مختلفة من العقد). يتعامل المحوّل مع جميع أنواع بطاقات Mobiledoc القياسية: image وmarkdown وhtml وembed وcode وhr. أما بطاقات Ghost المخصصة فتُحوَّل إلى كتل HTML خام مع تعليق تحذيري — راجعها يدوياً بعد الاستيراد.

يُعيَّن نظام مستويات الأعضاء في Ghost على مستويات العضوية في VeloCMS. يُستورد الأعضاء المجانيون بوصفهم blog_members في المستوى المجاني. أما الأعضاء المكمّلون والمدفوعون في Ghost فيُستوردون ضمن أقرب مستوى متاح في VeloCMS (مستوى Pro افتراضياً). يمكنك إعادة تعيين المستويات بالجملة من Admin ثم Members بعد الاستيراد.

الخطوة 3 — ترحيل الأعضاء

يُصدّر Ghost عناوين البريد الإلكتروني للأعضاء وحالة الاشتراك وتواريخ التسجيل. بعد استيراد المنشورات، انتقل إلى Admin ثم Members ثم Import CSV وارفع ملف CSV للأعضاء من مجلد الإخراج. يُرسل VeloCMS لكل عضو مستورد رسالة إعادة موافقة (مطلوبة بموجب اللائحة الأوروبية لحماية البيانات GDPR عند تغيير وحدة التحكم في البيانات). يُنقل الأعضاء الذين ينقرون رابط التأكيد إلى العضوية النشطة في VeloCMS، بينما يُعزل من لا يستجيبون لمدة 30 يوماً ثم يُحذفون تلقائياً.

قائمة التحقق بعد الترحيل

تحقّق من إعادة تكوين تكاملات Ghost المخصصة (Mailchimp وZapier والتحليلات) في VeloCMS. ستكون روابط بوابة الأعضاء في Ghost الموجودة في محتواك معطّلة — يُشير إليها CLI الترحيل في تقرير مفصّل، وستحتاج إلى استبدالها بعنوان URL الخاص بـ VeloCMS وهو /member/login. شغّل خطوة التحقق لاكتشاف الروابط المعطّلة قبل الإطلاق. راجع أيضاً مقالة «قائمة التحقق من الترحيل إلى VeloCMS قبل الإطلاق» للحصول على مراجعة شاملة.