Para que serve o Widget Importer & Exporter

Transferir widgets de um site WordPress para outro é uma tarefa que surge com regularidade. Mudar para um novo domínio, alterar o alojamento, clonar um projeto para desenvolvimento, implementar configurações padrão para clientes. O WordPress não tem ferramentas nativas para migração de widgets. Copiar definições manualmente é lento, aborrecido e propenso a erros: um widget de texto com HTML, blocos de navegação, subscrições, tudo isto se perde durante a transferência manual.

O Widget Importer & Exporter preenche esta lacuna. O plugin empacota todos os widgets ativos num único ficheiro JSON com a extensão .wie e implementa-os no site de destino com um tratamento inteligente de conflitos. Sem magia, apenas uma ferramenta funcional que não tenta ser um canivete suíço.

Desde o seu lançamento, o plugin acumulou mais de 200.000 instalações ativas e mantém uma classificação de 4,7 em 5, com 117 avaliações. O programador, Steven Gliebe do ChurchThemes.com, mantém-no atualizado: a última atualização saiu em maio de 2026 e a versão 1.6.1 está testada até ao WordPress 7.0.

💡 Visão geral rápida:

• Instalação. Instale o Widget Importer & Exporter a partir do diretório de plugins do WordPress.
• Exportação. No site de origem: Ferramentas → Widget Importer & Exporter → clique em "Export Widgets" e descarregue o ficheiro .wie.
• Importação. No site de destino: mesma secção → carregue o ficheiro .wie → clique em "Import Widgets".
• Resultado. Reveja a tabela: o plugin mostra quais os widgets que foram importados, quais foram ignorados e porquê.

Como funciona a exportação de widgets

A exportação no Widget Importer & Exporter é o mais simples possível. Vá a Ferramentas → Widget Importer & Exporter, clique no único botão "Export Widgets" e o navegador descarrega um ficheiro com a extensão .wie. No interior está uma estrutura JSON que contém todos os widgets ativos no site: os seus tipos, definições e atribuições a áreas (barra lateral, rodapé, cabeçalho).

O formato .wie é uma extensão proprietária do plugin, e esta é a decisão correta. Evita confusões com outras exportações JSON de widgets de plugins de terceiros. Tecnicamente, é JSON simples que pode abrir num editor de texto para ver a estrutura.

O que é exportado:

• todos os widgets ativos com as suas definições;
• a atribuição do widget a uma área específica do tema;
• a posição do widget dentro da área;
• todos os tipos de widgets, tanto os padrão (texto, pesquisa, categorias) como os adicionados por outros plugins.

Como funciona a importação de widgets

A importação é a operação inversa. No site de destino onde o Widget Importer & Exporter já está instalado, vá às mesmas Ferramentas → Widget Importer & Exporter, carregue o ficheiro .wie através do formulário e clique em "Import Widgets". O plugin analisa o JSON, faz corresponder as áreas de widgets do site de origem às áreas do tema atual e coloca os widgets em conformidade.

O resultado é exibido como uma tabela organizada. Cada área e cada widget recebem a sua própria linha com um estado. Vê imediatamente se um widget foi importado ou ignorado e, se foi ignorado, por que razão.

A tabela de resultados é um dos pontos fortes do plugin. Em vez de esperar cegamente que «provavelmente tudo foi transferido», obtém um relatório transparente. Isto é especialmente valioso ao migrar sites grandes com dezenas de widgets em áreas diferentes: rodapé, barra lateral do blogue, barra lateral da loja, cabeçalho.

Tratamento inteligente: o que o plugin faz nos bastidores

O aspeto mais valioso do Widget Importer & Exporter não é a transferência de dados em si, mas a lógica para lidar com incompatibilidades. Durante a importação, o plugin executa três verificações para cada widget.

Primeira verificação: existência da área. Se no site de origem um widget estava na barra lateral "Loja", mas o tema de destino não tem essa barra lateral, o widget não se perde. É marcado como "Inativo" e vai para a secção de widgets inativos no painel de administração. Pode arrastá-lo manualmente para uma área adequada.

Segunda verificação: duplicados. Se a área de destino já tiver exatamente o mesmo widget com as mesmas definições, o plugin não o duplica. A importação ignora a instância existente e prossegue. Sem clones e sem barras laterais desorganizadas.

Terceira verificação: widgets não suportados. Por vezes, um widget foi adicionado por um plugin que não está presente no site de destino. O Widget Importer & Exporter não tenta criar um bloco quebrado; simplesmente ignora esse widget e reporta-o na tabela de resultados.

Um cenário à parte envolve ficheiros .wie de programadores de temas. Muitos temas, especialmente os premium, são fornecidos com um conjunto pronto de widgets de demonstração. O Widget Importer & Exporter é a forma padrão para os autores de temas distribuírem esses exemplos. Os utilizadores obtêm uma cópia exata dos widgets do site de demonstração com um único clique.

Hooks e filtros para programadores

Apesar da sua simplicidade exterior, o plugin oferece espaço para personalização através de três hooks. Todos eles estão documentados no repositório no GitHub.

O hook wie_before_import é acionado após o carregamento do ficheiro, mas antes do processamento dos dados. Neste ponto, pode: verificar a estrutura JSON, registar a operação, adicionar validação extra específica para o seu projeto.

O hook wie_after_import é executado depois de os dados terem sido importados e os widgets estarem no lugar. Isto é conveniente para: limpar a cache, enviar uma notificação ao administrador, acionar a regeneração de CSS se usar widgets com estilos dinâmicos.

O filtro wie_import_data dá acesso ao array de dados antes da importação. Pode remover certos widgets, substituir definições, adaptar caminhos de ficheiros multimédia para um novo domínio. Isto é útil para implementações automatizadas quando a importação não acontece manualmente através do painel de administração, mas sim através de scripts.

Hooks adicionais são aceites via pull request no GitHub. O programador está aberto a sugestões, o repositório está ativo e as questões são tratadas.

Limitações e quando o plugin não é suficiente

O Widget Importer & Exporter resolve uma tarefa e resolve-a bem. Mas é importante compreender os seus limites.

O plugin transfere apenas definições de widgets, não o conteúdo das publicações, não os ficheiros multimédia, não as definições do tema e não as opções do personalizador. Não é adequado para a migração completa de um site e não se posiciona como uma ferramenta de migração total. É uma ferramenta restrita e focada para uma única operação.

Os widgets guardados através de blocos Gutenberg (no modo "blocos como widgets") são transferidos corretamente; isto é confirmado por avaliações de utilizadores de 2023. Mas se um site mudou totalmente para um tema FSE (Full Site Editing), onde as barras laterais são substituídas por modelos de blocos, os widgets tradicionais podem não existir como conceito, e o plugin simplesmente não tem nada para exportar.

Além disso, o ficheiro .wie está vinculado à estrutura de áreas de um tema específico. Se os sites de origem e de destino usarem temas radicalmente diferentes, com conjuntos diferentes de barras laterais, alguns widgets acabarão como "Inativos". Isto não é um bug, mas um comportamento esperado, embora deva estar preparado para isso.

Vídeo: importação e exportação de widgets na prática

Veja uma demonstração passo a passo: instalar o Widget Importer & Exporter, exportar widgets de um site de teste e importá-los para uma instalação limpa do WordPress, com uma análise da tabela de resultados.

⁉️🤔 Perguntas frequentes

O ficheiro .wie é apenas JSON?

Sim. O .wie é um ficheiro JSON simples com uma extensão proprietária, introduzida para evitar confusões com ficheiros de exportação de outros plugins de widgets. Abre em qualquer editor de texto.

O que acontece se o site de destino já tiver o mesmo widget na mesma área?

O plugin não cria duplicados. Um widget idêntico a um já existente é ignorado; na tabela de resultados, será marcado como "Already exists" e permanecerá como uma única instância.

É possível importar widgets entre temas com conjuntos diferentes de barras laterais?

Sim, e este é um cenário padrão. Se uma área de widgets do tema de origem estiver ausente no tema de destino, o widget é marcado como "Inativo" e vai para a secção correspondente do painel de administração. Arrasta-o manualmente para uma área adequada.

O plugin é necessário em ambos os sites para a migração?

No site de origem, para criar o ficheiro de exportação .wie. No site de destino, para importar esse ficheiro. A instalação demora menos de um minuto: pesquisa padrão no diretório de plugins do WordPress → ativação.

O plugin transfere widgets adicionados por outros plugins?

Sim, se o mesmo plugin de origem do widget estiver instalado no site de destino. Se o plugin não estiver lá, o widget será ignorado durante a importação e verá isso na tabela de resultados. Sem blocos quebrados ou erros.

O Widget Importer & Exporter é gratuito?

Totalmente. O plugin é distribuído através do diretório oficial do WordPress sob uma licença aberta. Sem versões Pro, subscrições ou funcionalidades premium. O código-fonte está no repositório do GitHub.

Vale a pena instalar o Widget Importer & Exporter em 2026

Após seis anos de existência e duzentas mil instalações ativas, a resposta é clara: se precisa de transferir widgets entre sites WordPress ou fazer uma cópia de segurança das definições de widgets, esta é a ferramenta certa. É gratuita, leve, não tenta ser "tudo-em-um" e faz exatamente o que promete.

Para programadores que implementam regularmente configurações padrão, o ficheiro .wie torna-se um modelo: configure os widgets uma vez num site de desenvolvimento, exporte-os e reutilize-os em cada novo projeto. A poupança é substancial.

Se a tarefa for mais ampla (migração completa do site com conteúdo, ficheiros multimédia e definições do tema), procure o All-in-One WP Migration, o Duplicator ou o WP Migrate. O Widget Importer & Exporter não substitui estas ferramentas, mas complementa-as: após uma migração completa, pode trazer separadamente as definições de widgets se o plugin de migração principal não as tiver tratado.

🔗 Widget Importer & Exporter no WordPress.org🔗 Código-fonte no GitHub