Migrare da WordPress

EmDash migra i contenuti da WordPress. Importa i tuoi post, pagine, media e tassonomie tramite il pannello di amministrazione.

Prima di iniziare

Metodi di importazione

EmDash supporta tre metodi per importare contenuti WordPress:

Il caricamento del file WXR è consigliato per la maggior parte delle migrazioni. Cattura tutti i contenuti, inclusi bozze, campi personalizzati e post privati.

Importazione file WXR

Conversione dei contenuti

Gutenberg a Portable Text

EmDash converte i blocchi Gutenberg in Portable Text, un formato di contenuto strutturato.

I blocchi sconosciuti vengono memorizzati come htmlBlock con l’HTML originale e i metadati del blocco. Puoi rivederli e convertirli manualmente o creare componenti Portable Text personalizzati per renderizzarli.

Contenuto dell’editor classico

L’HTML dell’editor classico viene convertito in blocchi Portable Text. Gli stili inline (<strong>, <em>, <a>) diventano marcature su span.

Mappatura degli stati

Importazione tassonomie

Categorie e tag vengono importati come tassonomie con gerarchia preservata:

WordPress:                    EmDash:
├── Categories (hierarchical) ├── taxonomies table
│   ├── News                  │   ├── category/news
│   │   ├── Local             │   ├── category/local (parent: news)
│   │   └── World             │   ├── category/world (parent: news)
│   └── Sports                │   └── category/sports
└── Tags (flat)               └── content_taxonomies junction
    ├── featured                  ├── tag/featured
    └── breaking                  └── tag/breaking

Campi personalizzati e ACF

I meta dei post WordPress e i campi ACF vengono analizzati durante l’importazione:

Reindirizzamenti URL

Dopo l’importazione, EmDash genera una mappa di reindirizzamento:

{
	"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" }
	]
}

Applica questi reindirizzamenti a:

• Regole di reindirizzamento Cloudflare
• La configurazione di reindirizzamento della tua piattaforma di hosting
• L’opzione redirects di Astro in astro.config.mjs

Riferimento mappatura concetti

Usa questa tabella quando adatti i pattern di WordPress a EmDash:

Importazione API (Avanzato)

L’importazione WordPress è disponibile tramite il pannello di amministrazione e l’API REST. Usa la procedura guidata di importazione del pannello di amministrazione per la migliore esperienza — fornisce mappatura dei campi, risoluzione dei conflitti e tracciamento del progresso.

Gli endpoint dell’API di importazione si trovano sotto /_emdash/api/import/wordpress/ per l’accesso programmatico.

Risoluzione dei problemi

”Errore di analisi XML”

Il file di esportazione potrebbe essere corrotto o incompleto. Riesporta da WordPress.

Errori di download dei media

Alcune immagini potrebbero essere dietro autenticazione o essere state spostate. L’importazione continua e gli URL falliti vengono registrati per la gestione manuale.

Conflitti di tipo di campo

Se una collezione esistente ha un campo con un tipo incompatibile, la procedura guidata di importazione mostra il conflitto. O:

• Rinomina il campo EmDash
• Cambia la mappatura del campo WordPress
• Elimina e ricrea la collezione

Esportazioni grandi

Per esportazioni superiori a 100MB, considera:

1. Esportare i tipi di post separatamente in WordPress
2. Importare ogni file in sequenza
3. Usare la CLI con --resume per affidabilità

Passaggi successivi

• Importazione contenuti — Altre fonti e metodi di importazione
• Porting plugin — Migrare le funzionalità dei plugin WordPress
• Lavorare con i contenuti — Interrogare e renderizzare i tuoi contenuti importati