Migrando para o Bondry

Migre membros, grupos, fóruns, blog e assinaturas do WordPress, XenForo ou Invision Community com o módulo gratuito Migrator.

O Migrator é um módulo oficial e gratuito que copia um site existente para o Bondry. Ele lê WordPress (com ou sem ARMember e WooCommerce), XenForo 2 e Invision Community 4 e 5. Os membros mantêm as senhas, os artigos mantêm as imagens e todo endereço antigo responde com um redirecionamento permanente para a nova página.

O site antigo é apenas lido. O Migrator nunca grava no banco de origem nem nos arquivos dele, então o site antigo pode continuar no ar até você apontar o domínio para o Bondry.

Como obter o módulo#

1. Entre na sua conta em bondry.org e abra Downloads. O Migrator aparece em Módulos gratuitos. Não há licença nem checkout.
2. Baixe o instalador.
3. No painel de administração do Bondry, abra Modules, envie o zip e ative o módulo. O instalador confere o arquivo no registro do Bondry antes de extrair.

O Migrator não tem licença própria. Ele recebe atualizações pela sua licença do core, pelo painel de administração, enquanto a licença do core receber.

Antes de começar#

• Faça backup do Bondry primeiro. Use System > Backup e guarde o arquivo fora do servidor. A migração grava muitos dados, e um backup é o caminho mais rápido de volta a um estado limpo.
• Acesso ao banco do site antigo. Host, porta, nome do banco, usuário, senha e prefixo das tabelas. Um usuário só com SELECT basta, e é o que recomendamos. Se o banco antigo está em outro servidor que não aceita conexão remota, importe um dump num banco temporário no servidor do Bondry e aponte o Migrator para ele.
• Acesso aos arquivos antigos. Um caminho local no servidor do Bondry (por exemplo /home/antigo/public_html/wp-content/uploads) ou um endereço base HTTPS (por exemplo https://antigo.exemplo.com/wp-content/uploads). Os arquivos servem para avatares, imagens dentro dos posts e anexos.
• O agendador rodando. O Bondry processa a migração em lotes pelo schedule:run, a cada minuto. O botão Processar agora da tela de execução também roda um lote por vez, sem o agendador.

O assistente#

Abra Migrator no painel de administração. Toda execução passa pelos mesmos sete passos:

1. Fonte. Escolha WordPress, XenForo ou Invision Community. A tela resume o que aquela fonte traz e o que não traz.
2. Conexão. Preencha os dados do banco e o caminho ou endereço dos arquivos. Testar responde com a versão detectada e a contagem de membros; o teste de arquivos busca um arquivo conhecido.
3. Inventário. Contagens por entidade e o que vai ficar de fora.
4. Mapeamento. Grupos da fonte para grupos do Bondry (criar um novo com o nome da fonte ou escolher um existente), planos de assinatura para planos do Members Plus, e fóruns e categorias do blog (criados como vêm, por padrão, ou mapeados para existentes).
5. Opções. Mesclar membros pelo e-mail, baixar as imagens embutidas nos posts, usar Gravatar, manter as datas originais e escolher o tamanho do lote.
6. Execução. Uma barra de progresso por entidade com o lote atual, feitos, pulados e erros, mais Processar agora, Pausar, Continuar e um log com filtro por nível. Uma execução interrompida continua de onde parou e nunca cria um registro duas vezes.
7. Relatório. Contagens finais, o que ficou de fora e o motivo, os redirecionamentos gravados, quantos membros ainda têm senha em formato antigo, os próximos passos, Reverter e Exportar relatório.

A senha da conexão fica cifrada e nunca aparece na tela nem no log. Executar e reverter pedem a sua senha de novo.

WordPress, ARMember e WooCommerce#

1. Em Fonte, escolha WordPress.
2. Em Conexão, use os valores do wp-config.php do site antigo (DB_HOST, DB_NAME, DB_USER, DB_PASSWORD e $table_prefix, normalmente wp_). Para os arquivos, aponte para wp-content/uploads.
3. Em Inventário, confira membros, posts, comentários e mídia. Com ARMember ou WooCommerce Subscriptions instalados, os planos, assinaturas e pagamentos também entram na contagem.
4. Em Mapeamento, mapeie cada papel do WordPress para um grupo do Bondry, e cada plano do ARMember ou produto de assinatura do WooCommerce para um plano do Members Plus.
5. Em Opções, decida se as imagens dentro dos posts são baixadas para a biblioteca de mídia ou mantidas no endereço antigo, e se o Gravatar é usado para membros sem foto.
6. Execute, acompanhe o progresso e leia o relatório.

Os posts viram artigos do blog com categorias, tags, imagem destacada e comentários aninhados. Shortcodes e comentários de bloco são removidos; o conteúdo passa pelo mesmo sanitizador do editor. Rascunhos, agendados e privados mantêm o status.

XenForo 2#

1. Em Fonte, escolha XenForo.
2. Em Conexão, use os valores do src/config.php ($config['db']). O prefixo das tabelas é xf_. Para os arquivos, aponte para a raiz do XenForo: os avatares vêm de data/avatars e os anexos de internal_data/attachments.
3. Em Inventário, confira membros, nós, tópicos, posts, conversas e user upgrades.
4. Em Mapeamento, mapeie os grupos de usuários para grupos do Bondry e os user upgrades para planos do Members Plus. Os nós viram fóruns e categorias na mesma árvore.
5. Em Opções, escolha o tamanho do lote e se a mesclagem por e-mail fica ligada.
6. Execute e leia o relatório.

O BBCode é convertido em HTML. Enquetes, prefixos, tags, reações, seguidores e advertências vêm junto.

Invision Community 4 e 5#

1. Em Fonte, escolha Invision Community.
2. Em Conexão, use os valores do conf_global.php (sql_host, sql_database, sql_user, sql_pass e sql_tbl_prefix, muitas vezes vazio). Para os arquivos, aponte para a pasta uploads.
3. Em Inventário, confira membros, fóruns, tópicos, posts, mensagens, artigos do blog e, com o Commerce, assinaturas, compras e faturas.
4. Em Mapeamento, mapeie os grupos de membros (inclusive os secundários) para grupos do Bondry e os pacotes de assinatura do Commerce para planos do Members Plus. Cada blog do Invision vira uma categoria do blog.
5. Em Opções, escolha o tamanho do lote e se a mesclagem por e-mail fica ligada.
6. Execute e leia o relatório.

O que migra#

O que não migra#

• Produtos, pedidos de produtos e frete do WooCommerce (o Bondry não tem loja).
• Gallery, Downloads, Calendar, Clubs e Pages do Invision Community.
• Media Gallery e Resource Manager do XenForo.
• bbPress e BuddyPress do WordPress.
• Temas, plugins, configurações, e-mails e templates do site antigo.

Tudo o que fica de fora aparece no relatório final com a contagem e o motivo, para você saber o que sobrou antes de desligar o site antigo.

Senhas#

Ninguém precisa redefinir a senha. Hashes modernos (bcrypt, usado pelo XenForo 2 e pelo Invision Community 4 e 5) migram como estão. Formatos antigos do WordPress, do Invision Community 3 e do XenForo 1 são guardados como vieram e conferidos no primeiro login do membro; quando a senha confere, ela é re-hasheada na hora. O relatório mostra quantos membros ainda têm um formato antigo.

Se você desinstalar o Migrator antes de todos entrarem, essas senhas antigas deixam de conferir e o membro usa Esqueci minha senha.

Redirecionamentos#

Cada endereço antigo de tópico, post, categoria, perfil e artigo é gravado e responde com um redirecionamento permanente (301) para a nova página. Aponte o domínio antigo para o Bondry e os links dos buscadores, dos favoritos e de outros sites continuam funcionando. Os redirecionamentos valem enquanto o Migrator estiver ativo.

Assinaturas#

As assinaturas ativas entram com o plano e a data de término, mas sem renovação automática: o meio de pagamento continua no gateway antigo. Avise os assinantes antes do vencimento para que renovem no Bondry.

Revertendo uma migração#

Reverter, no relatório, remove o que a execução criou, usando o registro de cada item migrado. Ele pede a sua senha e uma confirmação. O conteúdo criado no Bondry depois da migração não é tocado. Para recomeçar de um estado limpo, restaurar o backup feito antes da execução é mais rápido.

Depois da migração#

1. Revise as permissões dos grupos: cada fonte tem um modelo diferente e só a matriz principal migra.
2. Reconstrua o índice de busca com php artisan search:rebuild.
3. Aponte o domínio para o Bondry.
4. Avise os assinantes sobre a renovação.