Guia de migração WordPress para EmDash

Publicado em 2026-04-01 por EmDash CMS Team

Sair do WordPress para o EmDash é mais fácil quando você trata a migração primeiro como projeto de conteúdo e schema, e não como exercício de recriar o tema. Faça o conteúdo atravessar, verifique mídia e estrutura, e só depois trate renderização personalizada e paridade de design quando o modelo de dados estiver estável.

Antes de começar

Antes de rodar qualquer importação, certifique-se de saber que tipo de site WordPress está movendo.

Revise primeiro estas áreas:

• posts e páginas padrão
• anexos de mídia
• custom post types
• campos personalizados e metadados editoriais
• blocos Gutenberg ou conteúdo pesado em shortcodes

Isso importa porque um site de publicação simples costuma importar limpo, enquanto um site WordPress que depende muito de blocos personalizados, campos gerados por plugins ou renderização especial no frontend precisará de uma segunda passagem de implementação após a importação.

Opções de importação

Há duas formas sensatas de trazer conteúdo WordPress para o EmDash.

Exportação WXR

Use uma exportação WXR quando quiser um fluxo de migração baseado em arquivo.

Costuma ser a opção melhor quando:

• você quer um artefato de exportação portátil
• várias pessoas precisam revisar ou arquivar a exportação de origem
• você quer um limite mais claro entre dados de origem e validação no destino

Fluxo típico:

1. Abra o admin do WordPress.
2. Exporte o conteúdo do site como arquivo WXR.
3. Inicie a importação no EmDash usando essa exportação.
4. Revise as entradas e a mídia importadas.

Plugin EmDash Exporter

Use o plugin EmDash Exporter quando quiser um caminho direto de transferência a partir de uma instância WordPress em produção.

Fluxo típico:

1. Instale o plugin no site WordPress.
2. Configure o endpoint seguro de exportação que ele fornece.
3. Proteja o acesso com uma Application Password do WordPress.
4. Execute a importação para o EmDash a partir dessa fonte protegida.

Essa é a opção melhor quando o site de origem ainda é gerenciado ativamente e você quer um pull mais direto, em vez de passar arquivos de exportação adiante e para trás.

Caminho recomendado

Para a maioria das equipes, a sequência mais segura é:

1. Prepare o site EmDash que receberá o conteúdo.
2. Escolha um método de importação e execute uma primeira passagem de migração.
3. Verifique se entradas e mídia chegaram corretamente.
4. Crie tipos de conteúdo EmDash adequados para tudo que não deva permanecer conteúdo editorial genérico.
5. Reconstrua renderização personalizada só depois que a estrutura importada for confiável.

Essa ordem mantém o trabalho de maior risco para depois de os dados estarem visíveis e revisáveis no EmDash.

Validação após a importação

Não julgue a migração pelo fato de a importação terminar. Julgue pelo conteúdo importado ser utilizável.

A primeira passagem de validação deve verificar:

• posts e páginas existem no volume esperado
• mídia anexada foi trazida para a biblioteca de mídia do EmDash
• títulos, corpo e metadados de publicação parecem razoáveis
• relações editoriais ainda fazem sentido após a importação

Nesta fase, resista à vontade de corrigir detalhes visuais primeiro. Se o modelo de conteúdo ainda estiver errado, o trabalho de design vira retrabalho caro.

Conteúdo personalizado

Sites WordPress frequentemente ultrapassam o modelo padrão de Post e Page. Se o seu usa custom post types, trate-os como decisão de schema na migração, não como questão de formatação.

No EmDash, a abordagem melhor é criar tipos de conteúdo nativos para conteúdo que merece estrutura própria. Isso costuma significar revisar:

• qual conteúdo deve permanecer entradas editoriais padrão
• qual deve virar coleções EmDash separadas
• quais campos devem ser modelados explicitamente em vez de ficarem implícitos no corpo

É aqui que a qualidade da migração normalmente sobe ou desce. Uma importação WordPress pode ter sucesso tecnicamente e ainda assim produzir uma implementação EmDash fraca se cada forma de conteúdo for achatada em entradas genéricas.

Blocos e renderização sob medida

Blocos personalizados devem ser tratados de propósito. Se o site antigo depende de blocos Gutenberg sob medida, layouts por shortcode ou renderização específica de plugins, espere trabalho complementar.

Uma abordagem sensata é:

• importar o conteúdo subjacente primeiro
• identificar padrões de renderização que precisam sobreviver à mudança
• reconstruir essas partes com ferramentas e componentes nativos do EmDash

Se precisar recriar comportamento de bloco sob medida, o EmDash Block Kit Agent Skill é o ponto de partida relevante.

Checklist prático

Use como checklist de trabalho de migração:

• auditar posts, páginas, mídia e custom post types no WordPress
• decidir se WXR ou o plugin EmDash Exporter é o melhor caminho de importação
• preparar o site EmDash de destino
• executar a primeira importação
• verificar transferência de mídia e integridade das entradas
• criar tipos de conteúdo EmDash nativos onde for necessário
• identificar renderização personalizada que precisa de segunda implementação
• revisar estrutura de conteúdo antes de buscar paridade visual

O que ainda exige planejamento

Mesmo com um caminho de importação limpo, parte do trabalho de migração fica fora do importador em si:

• redirecionamentos
• verificações de paridade de SEO
• limpeza de campos
• paridade de renderização personalizada
• sequenciamento de rollback e lançamento

A importação coloca conteúdo no EmDash. Não elimina a necessidade de revisão editorial, decisões de schema e disciplina de lançamento.