خطوات ترحيل WordPress.org المستضاف ذاتياً إلى VeloCMS

يوفّر لك WordPress المستضاف ذاتياً مسارَين للترحيل: تصدير WXR بصيغة XML (المماثل لـ WordPress.com الموثّق في دليل تشغيله)، أو تفريغ مباشر لـ MySQL يستطيع CLI الترحيل تحليله بسرعة أكبر للمواقع الكبيرة. بالنسبة للمدونات التي تتجاوز 500 منشور، يُعدّ مسار MySQL أسرع بكثير لأنه يتجاوز حدّ الإخراج في لوحة تحكم WordPress التي تخضع لمهلة PHP البالغة 30 ثانية.

الخيار أ — تصدير WP-CLI (الموصى به لمعظم المواقع)

إذا كان WP-CLI مثبّتاً على خادمك، فشغّل الأمر wp export --dir=/tmp/wp-export --post_type=post --post_status=publish لإنشاء ملف WXR. هذا الأسلوب أسرع من تصدير واجهة الإدارة للمواقع الكبيرة، إذ يعمل WP-CLI دون التقيّد بمهلة PHP البالغة 30 ثانية التي تُقيّد عمليات التصدير من لوحة الإدارة. انقل ملف .xml إلى جهازك المحلي ثم اتّبع خطوات استيراد WXR في دليل WordPress.com ابتداءً من الخطوة الثانية.

الخيار ب — التفريغ المباشر لـ MySQL

mysqldump -u username -p database_name \
  wp_posts wp_postmeta wp_terms wp_term_relationships wp_term_taxonomy \
  > wp-dump.sql

# Then convert:
velocms-migrate mysql-to-json --input wp-dump.sql --output posts.json

نقل صور wp-uploads

على خلاف WordPress.com (حيث تُستضاف الصور على خوادم WordPress)، يخزّن WordPress المستضاف ذاتياً الصور في مجلد wp-content/uploads/ على خادمك. شغّل الأمر tar -czf uploads.tar.gz wp-content/uploads/ ثم نزّل الأرشيف. يقرأ أمر upload-media في CLI الترحيل هذا الأرشيف ويعيد رفع الصور إلى حاوية VeloCMS R2 الخاصة بك، مع تحديث روابط الصور في المنشورات المستوردة تلقائياً.

استراتيجية إعادة توجيه الروابط الدائمة للاستضافة الذاتية

يعتمد WordPress المستضاف ذاتياً عادةً على أحد أنماط الروابط الدائمة الثلاثة: /?p=123 (رقمي)، أو /YYYY/MM/DD/slug (مستند إلى التاريخ)، أو /slug (مباشر). يحتفظ مستورد VeloCMS بروابط المنشورات كما هي، لذا فإن إعادة التوجيه من /slug إلى /blog/slug أمر سلس (يكفي إضافة البادئة /blog/). أما الروابط المستندة إلى التاريخ فتتطلب قاعدة إعادة توجيه بالتعبيرات النمطية. يُنشئ CLI الترحيل قواعد إعادة الكتابة لـ Nginx وقواعد إعادة توجيه regex في Cloudflare لكلا النمطين — راجع مجلد redirects/ في مجلد الإخراج.