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

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

يحتوي تصدير JSON من Ghost على منشوراتك وأعضائك ومستوياتك. يتولّى معالج الاستيراد في «لوحة التحكم ← الاستيراد ← Ghost» الترحيل بالكامل.

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

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

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

الخطوة 2: الاستيراد إلى VeloCMS

سجّل الدخول إلى لوحة تحكم VeloCMS، وانتقل إلى «لوحة التحكم ← الاستيراد ← Ghost»، وارفع ملف ghost-export.json مباشرةً (حتى 100 ميغابايت). يربط VeloCMS حقول منشورات Ghost بنموذج المنشورات لديه: العنوان والـ slug ونص HTML وتاريخ النشر (published_at) والوسوم كلها تنتقل بسلاسة. يستخدم Ghost تنسيق Mobiledoc داخليًا لمحتوى المنشورات؛ وأنواع البطاقات القياسية (image وmarkdown وhtml وembed وcode وdivider) تتحول تلقائيًا. أما بطاقات Ghost المخصصة أو التنسيق الخاص بالقالب فقد تحتاج إلى تنظيف يدوي بعد الاستيراد، فراجع أولًا بضعة منشورات ذات تخطيطات غير معتادة.

صفحات Ghost لا تُستورد، المنشورات فقط. ويحصل كل منشور منشور على إعادة توجيه 301 من عنوانه القديم /post-slug/ إلى /blog/post-slug، وتعرض شاشة النتيجة العناصر المتخطاة وعدد قواعد إعادة التوجيه.

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

في لوحة Ghost انتقل إلى Members ثم Export members. ستحصل على ملف CSV بأعمدة مثل email وname وsubscribed_at وstripe_customer_id وlabels وcomplimentary_plan. في لوحة VeloCMS انتقل إلى «لوحة التحكم ← الأعضاء ← استيراد CSV». يتوقع المستورد الأعمدة email وname وsubscribed_at كحد أدنى. وإن كان لديك أعضاء مدفوعون فاربط أولًا حساب Stripe نفسه الذي استخدمته في Ghost («لوحة التحكم ← الإعدادات ← العضوية ← اشتراكات القرّاء»، بمفاتيح Stripe الخاصة بك)، كي يبحث VeloCMS عن المشتركين النشطين بالبريد الإلكتروني ويستعيد حالة الدفع تلقائيًا أثناء الاستيراد.

إذا ألغى عضو اشتراكه في Ghost فإن اشتراكه في Stripe غير نشط. يستورده VeloCMS عضوًا مجانيًا في كل الأحوال: لا يمكنك استعادة اشتراك ملغى، وعليه أن يشترك من جديد بسعرك الجديد في VeloCMS.

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

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