Primeiros passos
Export/Import Media foi criado para operações seguras com mídias no WordPress: migrações simples na versão gratuita e fluxos avançados reutilizáveis no Pro.
Configuração inicial
- Instale o plugin gratuito em Plugins > Adicionar novo.
- Abra Mídia > Export/Import para exportar ou importar mídias.
- Instale e ative o Pro quando precisar atualizar mídias existentes, executar trabalhos em segundo plano, usar rollback, conversão, fluxos salvos ou automações.
Comece com um pequeno teste de exportação/importação para confirmar a estrutura do CSV antes de executar trabalhos maiores.
Exportar para CSV
Gerar um CSV da sua biblioteca é a melhor forma de auditar metadados SEO atuais ou preparar um arquivo de migração.
Opções de filtro
- Intervalo de datas: exporte apenas arquivos enviados recentemente.
- Tipo de mídia: filtre para exportar apenas imagens, PDFs ou vídeos.
- Contexto do anexo: escolha entre todas as mídias ou apenas aquelas anexadas a posts específicos.
O arquivo gerado inclui colunas como ID, título, texto alternativo e URL direta do recurso.
Importar de CSV
Este é o método principal para adicionar novos recursos ao seu site ou movê-los de um ambiente de staging.
Segurança primeiro: pré-visualização
Quando você envia um CSV, o plugin não começa imediatamente. Ele analisa o arquivo e mostra uma pré-visualização visual. Isso permite verificar se a coluna de texto alternativo corresponde ao campo interno correto.
Processamento em lotes
O WordPress pode ser lento ao processar imagens. Por isso, a importação é dividida em blocos pequenos. Se o processo for interrompido, você pode continuar de onde parou.
Modo de importação local
Uma importação normal pede que o WordPress baixe um arquivo a partir de uma URL. Mas, se você tem milhares de arquivos, baixá-los um por um não é eficiente.
O modo de importação local serve quando você já moveu os arquivos para o servidor via FTP, SSH ou painel de hospedagem. O plugin pula o download e registra os arquivos no banco de dados.
Respeitar caminhos relativos
O WordPress geralmente organiza mídias por ano e mês, por exemplo uploads/2024/05/img.jpg.
Se você está migrando um site antigo, as imagens podem estar em pastas como uploads/2019/.... Uma importação comum poderia movê-las para a pasta do mês atual e quebrar links antigos.
Ao ativar Honor Relative Path, o plugin respeita a estrutura original definida no CSV para preservar melhor a organização do site e o SEO.
Atualizar mídias existentes (Pro)
O Pro permite atualizar mídias que já estão na biblioteca sem reenviar todos os arquivos.
Caso de uso típico
Você exporta a biblioteca, melhora textos alternativos e títulos em uma planilha e depois reimporta usando um fluxo de atualização. O plugin encontra o anexo existente e atualiza apenas os campos de metadados selecionados.
Comportamento mais seguro por padrão
Use atualizações por campos selecionados para que células vazias do CSV não apaguem valores existentes por acidente, a menos que você escolha intencionalmente um fluxo destrutivo.
Fontes CSV remotas (Pro)
Fluxos de importação salvos podem usar uma URL CSV remota, como um link público de exportação de uma planilha, ou um caminho CSV no servidor para casos avançados.
Isso é útil quando o mesmo arquivo é atualizado periodicamente e você quer que o WordPress o processe por meio de um fluxo repetível, sem enviar o CSV manualmente toda vez.
Processamento em segundo plano (Pro)
A fila em segundo plano do Pro foi pensada para execuções grandes que não deveriam depender de uma aba aberta do navegador.
Você pode iniciar um fluxo, deixar o servidor processar o trabalho e depois conferir o resultado no Histórico, com resumos e logs baixáveis.
Estratégias de correspondência (Pro)
Ao atualizar mídias existentes, o plugin precisa identificar o anexo correto. Dependendo do CSV e do cenário de migração, você pode fazer correspondência por:
- ID do anexo: a opção mais precisa quando os IDs pertencem ao mesmo site.
- URL de origem: útil quando a URL original está disponível.
- Nome do arquivo: útil quando os IDs mudaram durante uma migração.
Use a estratégia mais específica disponível para reduzir atualizações acidentais.
History & Automations (Pro)
Pro History gives you summaries, downloadable logs, restore-point information, conversion counts, rollback information, and export artifact re-downloads when available.
Optional automations are for repeatable scheduled workflows. Manual imports and exports can still be used normally without configuring automations.
Rollback e pontos de restauração (Pro)
Quando o Pro executa importações reais compatíveis com uma licença ativa, ele pode criar pontos de restauração antes de aplicar as alterações.
As ações de rollback ficam disponíveis no Histórico Pro para alterações compatíveis, como novos anexos, atualizações de metadados, substituição de arquivos e importações convertidas.
Conversão de imagens (Pro)
O Pro pode converter importações JPG/JPEG e PNG compatíveis para WebP ou AVIF quando o WordPress e o editor de imagens do servidor suportam o formato escolhido.
Fallback seguro
Se o servidor não puder gravar o formato selecionado, os arquivos não compatíveis são ignorados com segurança ou importados normalmente conforme as configurações do fluxo.
Solução de problemas
O processo parou no meio
Na versão gratuita, verifique se a aba do navegador continua aberta e se o computador não entrou em suspensão. Para trabalhos grandes, use fluxos salvos Pro e processamento em segundo plano.
Meu CSV não é reconhecido
Verifique se o CSV tem cabeçalhos e pelo menos uma linha de dados. Confira também o separador e a codificação, especialmente se ele foi exportado de uma planilha.
Não vejo a opção de rollback
O rollback aparece apenas para importações Pro compatíveis criadas com uma versão que salva pontos de restauração. Ele não pode restaurar retroativamente importações antigas executadas antes da existência desses restore points.
A conversão de imagens não está disponível
WebP e AVIF dependem do suporte do WordPress e do editor de imagens do servidor. Se o formato não estiver disponível na hospedagem, a opção pode aparecer desativada ou ser ignorada com segurança.
