Atualizado em: 17/08/2012
Uma dúvida ou mesmo dilema de muitos usuários do OpenCart é sobre a atualização para a última versão. Pensando nisso escrevi este pequeno guia com passos básicos para que você faça a atualização.
Neste guia pretendo tecnicamente expor um processo mais rápido e mais seguro para a atualização do OpenCart.
Observação: Se for possível, faça o teste de atualização em um ambiente local (sua máquina por exemplo) com uma cópia de sua loja atual, pois assim você não correrá o risco de sua loja parar por problemas inesperados e terá tempo para resolver os problemas que forem diagnosticados para poder executar uma atualização segura em sua loja oficial.
Importante: O processo aqui descrito de atualização foi testado na atualização das versões 1.5.1.3, 1.5.2.1 e 1.5.3.1 para a versão 1.5.4, e espero que seja útil para todos que estão pensando em migrar sua loja para a última versão, o que recomendo.
Antes de executar qualquer passo, por favor, leia todas as instruções com atenção.
1º Passo: Preparação.
- Faça o backup de todos os arquivos e pastas de sua loja via FTP ou CPanel e guarde-os em um lugar seguro.
- Faça o backup completo de seu banco de dados via o PHPMyAdmin e guarde-o em um lugar seguro.
Os passos acima são necessários, pois caso algo der errado você terá como recuperar o estado original de seu loja.
- Certifique-se que todas as suas atuais extensões e temas são compatíveis com a versão para a qual você vai atualizar, se alguma extensão ou tema não for, as chances são grandes de que a extensão ou tema não funcione ou mesmo passe a apresentar algum erro depois da atualização, neste caso verifique também se já não há atualizações disponíveis compatíveis com a versão do OpenCart que você vai utilizar após a atualização, caso não haja atualizações, desinstale as extensões e temas e tente reinstalá-los após o processo de atualização, lembrando que isso deve ser feito primeiro em ambiente de teste, ou seja, em uma copia de sua atual loja.
Observação: Gostaria de chamar a atenção para o fato dos temas da versão 1.5.1.3 não funcionarem bem com a versão 1.5.4, pelo fato das diferenças que existem entre elas no carrinho de compras e funções javascript.
Importante: Se você fez alterações no código nativo do OpenCart, como relatórios novos ou mesmos modificações diretamente nos arquivos PHP ou CSS da administração, muito provavelmente estas vão se perder e terão que ser refeitas, reinstaladas ou readaptadas, por isso os backups feitos anteriormente são de extrema importância e sempre leve em consideração a utilização do vQmod em suas modificações.
2º Passo: Faça o backup dos arquivos de configuração.
É necessário fazer o backup de dois arquivos que são extremamente necessários para a sua atualização ser bem sucedida, são eles:
config.php
admin/config.php
Faça uma cópia de ambos para o seu computador, mantendo a estrutura atual de pastas citada acima para não sobrescrevê-los, pois eles tem nomes iguais.
Importante: É nestes arquivos que estão as configurações para conexão com seu banco de dados e caminho para pastas do OpenCart.
3º Passo: Faça o upload dos arquivos da última versão.
- Faça o download da versão 1.5.4 do OpenCart:
http://www.opencart.com/index.php?route=download/download
- Descompacte o arquivo completo da versão atualizada do OpenCart que você baixou anteriormente e faça o upload deles para sua loja sobrescrevendo os antigos arquivos pelos novos, e acrescentando os novos arquivos e pastas da nova versão, você pode fazer este processo utilizando o ftp, ou enviando o arquivo zipado e o descompactando, caso você utilize o Gerenciador de Arquivos do CPanel de sua hospedagem.
Não recomendo deletar os arquivos da antiga versão, nos testes que fiz não teve nenhum problema em somente sobrescrevê-los com os arquivos da nova versão, pois se deletar a versão antiga da sua loja você vai ter que fazer novamente o upload de suas extensões e ainda perderá as imagens dos produtos e outras imagens que ficam localizadas na pasta image no diretório raiz de instalação do OpenCart.
Observação: Não sobrescreva os arquivos da pasta install (caso ela ainda esteja lá), delete esta pasta e todo o seu conteúdo e faça o upload da nova pasta install da versão atualizada.
4º Passo: Faça o upload dos arquivos de configurações.
Depois do upload dos novos arquivos, agora é a vez de devolver os arquivos de configuração que você fez o backup no 2º passo; como você fez o upload de todos os novos arquivos já vai existir esses arquivos no diretório de sua loja, neste caso, sobrescreva-os pelos config.php que você fez backup anteriormente, respeitando a estrutura de pastas.
Observação: Uma comparação na estrutura destes arquivos entre os antigos e novos config.php também ajuda caso você tenha dúvidas.
5º Passo: Atualize o seu banco de dados.
Chegou a hora de atualizar sua atual base de dados, e para isso vamos utilizar um serviço que vem junto com o pacote OpenCart que é a atualização de banco automática. Para utilizá-lo acesse o link:
http://www.sualoja.com.br/install/
Você verá a tela de upgrade, localize o botão upgrade e aguarde pela conclusão da atualização do seu banco de dados.
Observação: Após o processo de upgrade, delete a pasta install do diretório do OpenCart, pois ela não terá mais utilidade e o sistema ficará avisando que ela ainda está lá, caso você não a deletar.
6º Passo: Confirmando a configuração de sua loja e reinstalando extensões e temas.
- Vá no menu Sistema->Configurações: Preencha todos os campos necessários e verifique se tudo está conforme o esperado e sempre clique no botão Salvar, assim as novas configurações serão carregadas e você não terá problemas no funcionamento das configurações de sua versão atualizada.
- Vá no menu Sistema->Usuários->Grupo de Usuários: Edite cada grupo e refaça as permissões caso necessário, pois novos recursos precisam de novas permissões.
Importante: Se você desinstalou alguma extensão ou tema por dúvidas de compatibilidade, chegou a hora de instalar novamente e verificar se tudo ocorreu como o esperado, se não ocorreu, você pode tentar fazer os ajustes ou solicitar ajuda dos colegas da comunidade no fórum ou mesmo solicitar suporte do vendedor caso seja uma extensão ou tema pago.
7º Passo: Atualizando o pacote de linguagem.
Por último, baixe o pacote de linguagem compatível com sua nova versão e envie os arquivos de linguagem sobrescrevendo os antigos arquivos pelos novos, isso porque de uma versão para outra mudam ou entram novos textos e/ou palavras, e como você já havia instalado o pacote de linguagem anteriormente, basta que você os sobrescreva para que fiquem atualizados.
Pronto! Sua loja já está atualizada.
Considerações:
Informo que as versões 1.4.x não migram neste processo para as versões 1.5.x, esta migração ainda está em fase beta e em todos os testes que fiz sempre ocorreram muitos problemas.
Dúvidas:
Caso ainda tenha dúvidas, poste no fórum da comunidade.
