Atualizar o Joomla 1.5: migrar o conteúdo para uma versão atual do Joomla

O Joomla 1.5 não pode ser atualizado para uma versão moderna com o botão de atualizar, nem a partir do Softaculous: entre ambas muda tanto que a única forma é migrar o conteúdo para uma instalação nova. Antes migrava-se para o Joomla 2.5 com o componente jUpgrade, mas a 2.5 também está há anos sem suporte. Hoje pode saltar diretamente da 1.5 para a versão atual do Joomla.

O processo consiste em montar uma instalação nova do Joomla em paralelo, numa subpasta, copiar para ela o conteúdo da 1.5 e, quando estiver tudo pronto, convertê-la no site principal. O site antigo continua a funcionar até ao último passo.

1. Preparar o terreno

1. Faça uma cópia de segurança completa do site atual (ficheiros e base de dados) com o assistente de cópias de segurança do cPanel.
2. Anote os dados de ligação da base de dados do Joomla 1.5. Estão no ficheiro configuration.php do site: $host, $user, $password, $db e $dbprefix (normalmente jos_).

2. Instalar o Joomla novo em paralelo

Instale a última versão do Joomla a partir do Softaculous no mesmo domínio, numa subpasta, por exemplo nueva. O Softaculous criará a sua própria base de dados, pelo que não mexe na do site antigo.

No fim, terá o site novo em tudominio.com/nueva e a sua administração em tudominio.com/nueva/administrator.

3. Migrar o conteúdo com o SP Upgrade

O SP Upgrade é um componente pago que migra diretamente do Joomla 1.5 para as versões 4, 5 e 6. Instala-se no Joomla novo, e não no antigo.

1. Descarregue o SP Upgrade a partir da sua ficha no diretório de extensões do Joomla.
2. Na administração do Joomla novo, entre em Sistema > Instalar > Extensões e carregue o ficheiro zip.
3. Abra Componentes > SP Upgrade e, nas suas opções de ligação, introduza os dados da base de dados do Joomla 1.5 que anotou no passo 1. Como host, use localhost.
4. Inicie a transferência e aguarde que termine. Com muito conteúdo, pode demorar algum tempo.

O SP Upgrade copia o conteúdo do núcleo do Joomla: utilizadores, artigos com as suas secções e categorias, contactos, ligações, feeds de notícias, banners, menus e módulos. As imagens da pasta images tem de as copiar você: a partir do gestor de ficheiros do cPanel, copie o conteúdo de public_html/images para public_html/nueva/images.

4. Rever o site novo

É aqui que começa o verdadeiro trabalho. Reveja o site novo a partir de tudominio.com/nueva:

• Componentes e módulos de terceiros: os do Joomla 1.5 não funcionam nas versões atuais. Procure a sua versão atual ou uma alternativa no diretório de extensões, instale-a e volte a configurá-la.
• Modelo: o da 1.5 também não serve. Escolha um modelo atual e adapte-o ao seu design.
• Menus e ligações: verifique se todos os itens de menu levam à sua página e se as ligações dentro dos artigos funcionam.
• Utilizadores: entre com uma conta migrada para verificar se o acesso funciona.

Quanto menos componentes e personalizações tiver o site antigo, menos trabalho haverá neste passo.

5. Converter o site novo no principal

Quando o site novo estiver pronto:

1. Faça outra cópia de segurança.
2. Mova os ficheiros do Joomla 1.5 de public_html para uma pasta fora do site, por exemplo /home/usuario/joomla15, para o caso de precisar de recuperar algo. Não mova a pasta nueva.
3. Mova todo o conteúdo de public_html/nueva para public_html, incluindo o ficheiro oculto .htaccess.
4. Edite public_html/configuration.php e altere os caminhos que terminam em /nueva: $log_path e $tmp_path devem ficar como /home/usuario/public_html/administrator/logs e /home/usuario/public_html/tmp. Se $live_site tiver um endereço, deixe-o vazio ou coloque https://tudominio.com.
5. Abra tudominio.com e a administração em tudominio.com/administrator e verifique se tudo funciona.

Se os endereços de algumas páginas mudarem, crie redirecionamentos dos antigos para os novos em Componentes > Redirecionamentos do Joomla para não perder as visitas que chegam a partir da Google.

Quando tudo funcionar, pode apagar a pasta joomla15 e a base de dados antiga.