Cara Migrasi dari WordPress ke EmDash CMS

EmDash punya wizard import WordPress bawaan — ini bukan migrasi copy-paste manual. Ia membaca file ekspor WordPress standar, mengonversi block Gutenberg ke format konten terstruktur EmDash, dan mempertahankan hierarki taksonomi, custom field, dan media-mu. Ini menelusuri proses persisnya.
Daftar Isi
- Sebelum Kamu Mulai
- Memilih Metode Import
- Langkah-demi-Langkah: Import File WXR
- Apa yang Terjadi pada Kontenmu Secara Struktural
- Block Gutenberg Jadi Portable Text
- Konten Classic Editor
- Pemetaan Status
- Hierarki Taksonomi Dipertahankan
- Custom Field dan ACF
- Menangani Redirect URL
- Troubleshooting
- "XML parsing error"
- Kegagalan unduh media
- Konflik tipe field
- Ekspor besar (lebih dari 100MB)
- Pertanyaan yang Sering Diajukan
- Apakah plugin WordPress-ku dan fungsionalitasnya akan terbawa?
- Apakah import aman dijalankan lebih dari sekali?
- Apakah saya perlu mematikan situs WordPress-ku selama migrasi?
- Bagaimana kalau ada konten yang tidak terkonversi dengan bersih?
- Kesimpulan
Sebelum Kamu Mulai
- Ekspor kontenmu: di WordPress, buka Tools → Export dan unduh file ekspor lengkap (.xml).
- Backup situsmu dan jaga WordPress tetap berjalan sampai kamu memverifikasi migrasinya berhasil.
Memilih Metode Import
EmDash mendukung tiga metode import, dan buat sebagian besar migrasi, upload file WXR adalah yang tepat — ia menangkap segalanya, termasuk draft dan post privat, tanpa autentikasi dibutuhkan:
- Upload file WXR — terbaik buat migrasi lengkap; mencakup draft; tanpa auth dibutuhkan.
- OAuth WordPress.com — terbaik secara khusus buat situs yang di-hosting WordPress.com; mencakup draft; butuh OAuth.
- Probe REST API — terbaik buat mengecek konten sebelum ekspor; cuma konten yang dipublikasikan; auth opsional.
Langkah-demi-Langkah: Import File WXR
- Ekspor dari WordPress. Di admin WordPress-mu, buka Tools → Export → All content → Download Export File.
- Buka wizard Import. Di EmDash, buka Admin → Settings → Import → WordPress.
- Unggah file ekspormu. Drag and drop file .xml-mu atau klik buat browse — ia di-parsing langsung di browser-mu.
- Tinjau konten yang terdeteksi. Wizard menunjukkan persis apa yang ditemukannya:
Found in export:
├── Posts: 127 → posts [New collection]
├── Pages: 12 → pages [Add fields]
└── Media: 89 attachments- Konfigurasikan pemetaan. Toggle post type mana yang akan diimpor — EmDash otomatis membuat collection baru buat post type yang belum dipetakan, menambahkan field yang hilang ke collection yang sudah ada, dan memperingatkan soal konflik tipe field sebelum kamu lanjut.
- Jalankan import. Klik Import Content dan lihat progress saat setiap item diproses.
- Impor media (opsional). Setelah konten diimpor, pilih apakah akan mengunduh file media — EmDash mengunduh dari URL WordPress-mu, men-deduplikasi berdasarkan content hash, dan menulis ulang URL di kontenmu secara otomatis.
Menjalankan ulang import aman. Item dicocokkan berdasarkan ID WordPress, jadi kamu tidak akan membuat duplikat.
Apa yang Terjadi pada Kontenmu Secara Struktural
Block Gutenberg Jadi Portable Text
EmDash mengonversi block Gutenberg ke Portable Text, format konten terstruktur, mempertahankan mark inline, level heading, referensi gambar, tipe list, kutipan quote, atribut bahasa code, dan URL embed. Block yang tidak dikenali EmDash dipertahankan sebagai HTML mentah buat tinjauan manual alih-alih diam-diam dibuang.
Konten Classic Editor
Kalau situsmu masih punya post Classic Editor (pra-Gutenberg), HTML itu juga dikonversi jadi block Portable Text, dengan style inline seperti bold, italic, dan link jadi mark di span teks yang sesuai.
Pemetaan Status
Status WordPress terpetakan langsung ke status setara EmDash:
- publish → published
- draft → draft
- pending → pending
- private → private
- future → scheduled
- trash → archived
Hierarki Taksonomi Dipertahankan
Kategori WordPress yang hierarkis diimpor dengan struktur parent-child-nya utuh, dan tag flat diimpor sebagai term taksonomi flat — tidak ada yang diratakan atau direstrukturisasi selama perpindahan.
Custom Field dan ACF
Selama fase analisis, EmDash mendeteksi custom field dan menyimpulkan tipe field EmDash yang tepat dari nilai sesungguhnya — string numerik jadi `number`, `"1"`/`"0"`/`"true"`/`"false"` jadi `boolean`, tanggal ISO jadi `date`, dan ID WordPress seperti `_thumbnail_id` jadi field `reference`. Field plugin SEO (Yoast, dll) terpetakan ke objek `seo` khusus secara otomatis. Field internal WordPress berawalan `_edit_` atau `_wp_` disembunyikan secara default alih-alih memenuhi schema barumu.
Field repeater ACF dan flexible content diimpor sebagai JSON mentah — kamu akan ingin membuat field Portable Text atau array yang cocok di EmDash sesudahnya buat memberi data itu struktur yang tepat alih-alih membiarkannya sebagai JSON opak.
Menangani Redirect URL
Setelah import, EmDash menghasilkan peta redirect supaya URL WordPress lama tetap bekerja:
{
"redirects": [
{ "from": "/?p=123", "to": "/posts/hello-world" },
{ "from": "/2024/01/hello-world/", "to": "/posts/hello-world" },
{ "from": "/category/news/", "to": "/categories/news" }
],
"feeds": [
{ "from": "/feed/", "to": "/rss.xml" },
{ "from": "/feed/atom/", "to": "/atom.xml" }
]
}Terapkan ini ke aturan redirect Cloudflare, konfigurasi redirect platform hosting-mu, atau opsi `redirects` milik Astro sendiri di `astro.config.mjs` — melewati langkah ini adalah penyebab tunggal paling umum penurunan ranking SEO nyata setelah migrasi CMS, jadi jangan perlakukan sebagai opsional.
Troubleshooting
"XML parsing error"
File ekspormu mungkin rusak atau tidak lengkap — ekspor ulang dari WordPress dan coba lagi.
Kegagalan unduh media
Beberapa gambar mungkin di balik autentikasi atau sudah dipindahkan. Import terus berlanjut terlepas itu, dan URL yang gagal dicatat buat penanganan manual sesudahnya.
Konflik tipe field
Kalau collection EmDash yang sudah ada punya field dengan tipe yang tidak kompatibel, wizard menandai konfliknya secara langsung — ganti nama field EmDash, ubah pemetaan field WordPress, atau hapus dan buat ulang collection-nya.
Ekspor besar (lebih dari 100MB)
- Ekspor post type secara terpisah di WordPress alih-alih satu file raksasa.
- Impor setiap file secara berurutan alih-alih sekaligus.
- Pakai CLI EmDash dengan `--resume` buat keandalan di migrasi yang sangat besar.
Pertanyaan yang Sering Diajukan
Apakah plugin WordPress-ku dan fungsionalitasnya akan terbawa?
Konten dan data dari field plugin umumnya diimpor sebagai custom field, tapi perilaku plugin itu sendiri tidak berpindah otomatis. Sistem plugin EmDash terinspirasi WordPress secara khusus buat memberi fungsionalitas kustom jalur porting yang jelas, tapi itu langkah terpisah dari import konten.
Apakah import aman dijalankan lebih dari sekali?
Ya — item dicocokkan berdasarkan ID WordPress aslinya, jadi menjalankan ulang import setelah memperbaiki konflik field tidak akan membuat konten duplikat.
Apakah saya perlu mematikan situs WordPress-ku selama migrasi?
Tidak — import membaca dari file ekspor (atau probe lewat API), jadi situs WordPress-mu bisa tetap live dan melayani pengunjung sepanjang seluruh proses migrasi dan verifikasi.
Bagaimana kalau ada konten yang tidak terkonversi dengan bersih?
Block yang tidak dikenali EmDash dipertahankan sebagai HTML mentah alih-alih hilang, jadi kamu bisa meninjau dan mengonversinya secara manual, atau membangun komponen Portable Text kustom buat me-render tipe block HTML spesifik itu ke depannya.
Kesimpulan
Import WordPress EmDash adalah jalur migrasi sesungguhnya dan terbimbing — bukan proyek entry-ulang manual — menangani post, halaman, media, taksonomi, custom field, dan redirect lewat satu wizard. Langkah paling penting yang dilewatkan sebagian besar tim adalah menerapkan peta redirect yang dihasilkan; lakukan itu sebelum mengalihkan DNS. Lihat panduan setup EmDash 10-menit kami kalau kamu belum membuat proyek EmDash-mu.








Komentar