الترحيل من WordPress.com إلى VeloCMS (دليل شامل)
لا تتيح WordPress.com الوصول المباشر إلى قاعدة البيانات، لكن ملف XML الذي تُصدِّره يحتوي على كل ما تحتاجه. يغطي هذا الدليل الترحيل الكامل — المقالات والصور والتعليقات وإعادة التوجيه — دون أي فقدان للبيانات.
يستغرق الترحيل من WordPress.com إلى VeloCMS نحو ساعتين لمدونة تضم 100 مقالة. تعتمد العملية على أداة التصدير WXR XML المدمجة في WordPress، وسكريبت تحويل يُحوِّل WXR إلى صيغة الاستيراد الخاصة بـ VeloCMS، وإعداد إعادة توجيه 301 في Cloudflare للحفاظ على SEO. لا شيء يتطلب الوصول إلى قاعدة البيانات — يجري الترحيل بالكامل عبر أداة تصدير WordPress.com ونقطة استيراد VeloCMS.
الخطوة 1 — تصدير محتوى WordPress.com
في لوحة تحكم WordPress.com، انتقل إلى الأدوات ثم التصدير. اختر 'كل المحتوى' وانقر على تنزيل ملف التصدير. تُولِّد WordPress ملف .xml (بتنسيق WXR) يحتوي على كل مقالة وصفحة وتعليق وعلامة وتصنيف وعنوان URL للصور. احتفظ بهذا الملف — فهو المصدر الحقيقي لعملية ترحيلك بأكملها.
تصدير WordPress.com يتضمن عناوين URL للصور تشير إلى i0.wp.com أو yoursite.wordpress.com. يُنزِّل سكريبت الاستيراد كل صورة تلقائيًا ويُعيد رفعها إلى مجموعة Cloudflare R2 الخاصة بموقعك على VeloCMS — بشرط أن يكون موقع WordPress.com لا يزال يعمل أثناء عملية الاستيراد.
الخطوة 2 — تحويل WXR إلى صيغة استيراد VeloCMS
ثبِّت أداة سطر أوامر VeloCMS للترحيل بصفة عامة باستخدام npm i -g @velocms/migrate. ثم نفِّذ velocms-migrate wxr-to-json --input export.xml --output posts.json. يُحلِّل المحوِّل كل مقالة، ويُزيل رموز WordPress القصيرة، ويُحوِّل HTML المضمَّن إلى بنية AST خاصة بـ VeloCMS، ويُخرج مصفوفة JSON من كائنات المقالات جاهزة لنقطة الاستيراد. راجع المخرجات بحثًا عن أي رموز قصيرة أشار إليها المحوِّل بوصفها غير مدعومة — ستحتاج إلى تحريرها يدويًا بعد الاستيراد.
الخطوة 3 — الاستيراد إلى VeloCMS
في قسم الاستيراد من أدوات الإدارة، ارفع ملف posts.json. يُعالج المستورد المقالات على دفعات من 10، ويعرض شريطًا لتتبع التقدم وسجلًا لأي مقالات صادفت أخطاء. تصل المقالات المستوردة بنجاح كمسودات — راجعها وانشرها وفق جدولك الزمني.
الخطوة 4 — إعداد إعادة توجيه 301
إذا كانت مدونتك القديمة على WordPress.com في yourname.wordpress.com ومدونتك الجديدة على VeloCMS في yourname.velocms.org (أو نطاق مخصص)، فأنت بحاجة إلى إعادة توجيه 301 لكل URL قديم. لا تتيح WordPress.com إعداد إعادة التوجيه على مستوى الخادم، لكن يمكنك استخدام قواعد الصفحات أو قواعد إعادة التوجيه في Cloudflare لاعتراض الطلبات الواردة إلى العناوين القديمة وتحويلها. تُولِّد أداة سطر أوامر الترحيل ملف redirects.json — ارفعه إلى ميزة إعادة التوجيه الجماعية في Cloudflare لإعداد جميع عمليات إعادة التوجيه دفعةً واحدة.
الخطوة 5 — التحقق والتنظيف
بعد الاستيراد، نفِّذ velocms-migrate verify --site yoursite.velocms.org --source export.xml لمقارنة أعداد المقالات، والتحقق من الصور المكسورة، والتأكد من أن إعادة التوجيه تُعيد 301. تطبع أمر التحقق جدولًا بأي تناقضات. أصلحها قبل الإعلان عن الترحيل علنًا. بمجرد التحقق، حدِّث رسالتك الإخبارية الإلكترونية وملفات التواصل الاجتماعي وأي روابط خارجية تتحكم بها لتشير إلى العناوين الجديدة.