Migrar do WordPress

EmDash migra conteúdo do WordPress. Importe suas postagens, páginas, mídias e taxonomias através do painel de administração.

Antes de começar

Métodos de importação

EmDash suporta três métodos para importar conteúdo do WordPress:

O upload de arquivo WXR é recomendado para a maioria das migrações. Ele captura todo o conteúdo, incluindo rascunhos, campos personalizados e postagens privadas.

Importação de arquivo WXR

Conversão de conteúdo

Gutenberg para Portable Text

EmDash converte blocos Gutenberg em Portable Text, um formato de conteúdo estruturado.

Blocos desconhecidos são armazenados como htmlBlock com o HTML original e metadados do bloco. Você pode revisá-los e convertê-los manualmente ou criar componentes Portable Text personalizados para renderizá-los.

Conteúdo do editor clássico

HTML do editor clássico é convertido em blocos Portable Text. Estilos inline (<strong>, <em>, <a>) se tornam marcações em spans.

Mapeamento de status

Importação de taxonomia

Categorias e tags são importadas como taxonomias com hierarquia preservada:

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

Campos personalizados e ACF

Meta de postagens do WordPress e campos ACF são analisados durante a importação:

Redirecionamentos de URL

Após a importação, EmDash gera um mapa de redirecionamento:

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

Aplique esses redirecionamentos a:

• Regras de redirecionamento Cloudflare
• Configuração de redirecionamento da sua plataforma de hospedagem
• Opção redirects do Astro em astro.config.mjs

Referência de mapeamento de conceitos

Use esta tabela ao adaptar padrões do WordPress para EmDash:

Importação API (Avançado)

A importação do WordPress está disponível através do painel de administração e da REST API. Use o assistente de importação do painel de administração para a melhor experiência — ele fornece mapeamento de campos, resolução de conflitos e rastreamento de progresso.

Os endpoints da API de importação estão sob /_emdash/api/import/wordpress/ para acesso programático.

Solução de problemas

”Erro de análise XML”

O arquivo de exportação pode estar corrompido ou incompleto. Exporte novamente do WordPress.

Falhas no download de mídia

Algumas imagens podem estar atrás de autenticação ou terem sido movidas. A importação continua e as URLs com falha são registradas para tratamento manual.

Conflitos de tipo de campo

Se uma coleção existente tiver um campo com um tipo incompatível, o assistente de importação mostra o conflito. Ou:

• Renomeie o campo EmDash
• Altere o mapeamento de campo do WordPress
• Exclua e recrie a coleção

Exportações grandes

Para exportações acima de 100MB, considere:

1. Exportar tipos de postagem separadamente no WordPress
2. Importar cada arquivo sequencialmente
3. Usar a CLI com --resume para confiabilidade

Próximos passos

• Importação de conteúdo — Outras fontes e métodos de importação
• Portabilidade de plugins — Migrar funcionalidade de plugins do WordPress
• Trabalhando com conteúdo — Consultar e renderizar seu conteúdo importado