A aplicação é atualizada pelo administrador no separador Definições → Atualizações. As atualizações são descarregadas do servidor do fabricante. As novas versões instalam-se com um clique (auto-instalador, normalmente sem FTP). Por FTP carregam-se os ficheiros na primeira instalação do programa; na atualização, o apoio técnico é útil quando o servidor não permite à aplicação substituir os seus próprios ficheiros. Caso o pacote descarregado não tenha auto-instalador, a aplicação mostra instruções para carregar por FTP.

Obter a atualização requer uma licença ativa (a mesma que desbloqueia a gravação na aplicação). O servidor do fabricante disponibiliza a lista de versões apenas para a chave associada ao domínio desta instalação. Quando termina o direito a atualizações registado na chave, o botão da nova versão fica com o estado Bloqueado, e o motivo é visível por baixo do número da versão e ao passar o cursor sobre o botão.

Numa licença com atualizações até uma data, conta a data de publicação da versão (visível junto de cada versão na lista): a licença abrange as versões publicadas até ao fim do direito, não as mais recentes. O programa continua a funcionar - simplesmente não irá obter as versões mais recentes enquanto não renovar o direito (nova chave do fornecedor, ver capítulo sobre a licença). O melhor é instalar a última atualização do período de validade antes de este terminar: o servidor do fabricante costuma disponibilizar apenas a versão mais recente, pelo que, depois dessa data, pode já não mostrar a mais antiga.

Verificação automática e notificação

A aplicação verifica automaticamente a disponibilidade de atualizações - já não é preciso entrar nas definições de cada vez:

  • ao iniciar sessão (ao entrar na aplicação),
  • periodicamente, enquanto a aplicação permanece aberta,
  • ao regressar ao separador do navegador (se tiver passado algum tempo desde a última verificação).

Quando surge uma nova versão, o administrador vê uma breve notificação («Atualização disponível - a versão X.Y.Z está pronta a instalar») com um botão Mostrar que abre de imediato Definições → Atualizações. A notificação aparece uma vez por versão (não incomoda em cada acesso) - sobre a próxima versão receberá uma nova.

Se não for possível instalar a nova versão (por exemplo, o direito a atualizações terminou), a notificação diz isso diretamente: "A versão X.Y.Z está disponível, mas não é possível instalá-la: …" juntamente com o motivo. Quando as atualizações estão indisponíveis devido à chave de licença (sem chave, chave não reconhecida, revogada, associada a outro domínio ou desconhecida do servidor), o administrador recebe um único aviso Atualizações indisponíveis com a explicação - o seguinte só surge quando o problema desaparecer e voltar a ocorrer.

Indicador de nova versão

Independentemente da notificação, quando está disponível uma versão mais recente, o administrador vê um ponto vermelho no ícone da roda dentada (⚙) no menu superior e, ao abrir as definições, o mesmo ponto junto ao separador Atualizações. O ponto desaparece automaticamente depois de instalada a versão mais recente. O indicador (e a notificação) são visíveis apenas para os administradores.

Verificar as versões disponíveis

  1. Clique no ícone da roda dentada (⚙) → separador Atualizações.

Versão de programação. Se a aplicação funcionar em modo de programação (código diretamente do repositório), a verificação de atualizações está desativada: não há ponto vermelho nem notificações, e o separador indica claramente que está a trabalhar numa versão de programação.

  1. Clique em Verificar atualizações. Verá:
    • Versão instalada - a versão que está a funcionar no servidor,
    • Versão do código - a versão dos ficheiros da aplicação,
    • Versões disponíveis - lista das versões mais recentes com a Lista de alterações (changelog) de cada uma.

As versões instalam-se uma a uma - apenas o botão da próxima versão está ativo. As seguintes ficam disponíveis depois de carregar a anterior.

Task Manager: separador Atualizações com lista de versões e botão de instalação.
Separador Atualizações: versão no servidor, novas versões e lista de alterações.

Transferência do pacote

  1. Na versão disponível mais próxima, clique em Transferir.
  2. Aparecerá um aviso sobre cópia de segurança - antes de atualizar, faça uma cópia de segurança da base de dados e da pasta de anexos (uploads/). Confirme para continuar.
  3. O servidor transfere o pacote e verifica a sua soma de verificação (SHA‑256). A partir daqui, depende do tipo de pacote:
    • Pacote com auto-instalador - aparecerá o botão Instalar (descrição abaixo). Não precisa de carregar nada por FTP.
    • Pacote para carregamento manual - o navegador guarda o ficheiro .zip no seu disco (se precisar, pode voltar a descarregá-lo com o botão Guardar pacote (.zip)) e mostra as instruções de FTP.

Instalação com um clique (instalador automático)

Para as versões que suportam a auto-instalação não precisa de FTP:

  1. Depois de transferir, clique em Instalar.
  2. Aparecerá uma barra de progresso («A instalar…») que mostra as etapas: migrações da base de dados → cópia de ficheiros → finalização.
  3. No final, o botão muda para Atualizar aplicação - clique nele para carregar a nova versão (também pode atualizar a página com Ctrl/Cmd + Shift + R).

O instalador não toca nos seus dados - ignora includes/config.php, uploads/, storage/ e logs/, e executa automaticamente eventuais migrações da base de dados. Ainda assim, vale a pena ter uma cópia de segurança (aviso no momento do download).

Atenção: a barra de progresso só funciona totalmente «em tempo real» a partir do momento em que a versão instalada já inclui este mecanismo. Durante a instalação a partir de uma versão mais antiga, a barra pode avançar aos saltos.

Instalação por FTP (pacotes sem instalador automático)

Quando o pacote não suporta instalação automática, a aplicação mostra as instruções para o carregamento manual:

  1. Faça uma cópia de segurança da base de dados e da pasta uploads/ (se ainda não o fez).
  2. Descompacte o ficheiro .zip transferido.
  3. Ligue-se ao alojamento por FTP e carregue o conteúdo do pacote para a pasta da aplicação, substituindo os ficheiros existentes.
  4. NÃO substitua (mantenha os seus):
    • includes/config.php - configuração e segredos,
    • uploads/ - anexos e avatares,
    • storage/ - dados de trabalho,
    • logs/ - registos.
  5. Atualize a aplicação no navegador (Ctrl/Cmd + Shift + R) e clique novamente em Verificar atualizações para confirmar o novo número de versão.

Se a versão introduzir alterações na base de dados, as instruções dessa versão (changelog / nota de versão) indicam passos adicionais. Em caso de dúvida, restaure primeiro a cópia de segurança e contacte o fornecedor.

Perguntas mais frequentes

  • "Não foi possível ligar ao servidor de atualizações" - verifique a ligação à internet e se a licença é válida. A lista de versões só é disponibilizada a instalações com uma chave válida. A descrição técnica do erro de ligação (por exemplo, "Could not resolve host…") é adicionada pelo programa entre parênteses depois da palavra "detalhes" - será útil para o suporte técnico do alojamento.
  • "Tem a versão mais recente" - não existe nenhuma edição mais recente do que a instalada. Esta mensagem só aparece quando o servidor reconheceu a chave - em caso de problema com a chave, verá uma das mensagens abaixo.
  • "Esta instalação não tem chave de licença…" - introduza a chave em Definições → Avançado → Licença; sem ela, a aplicação nem sequer pergunta ao servidor sobre versões.
  • "O servidor de atualizações não reconhece a chave de licença…" - a assinatura da chave não corresponde à do servidor do fabricante (chave danificada ou de outra origem). Introduza a chave recebida do fornecedor ou contacte-o.
  • "A chave de licença desta instalação não existe na base de dados do servidor de atualizações…" - a chave é válida, mas o servidor do fabricante não a conhece. O fornecedor tem de a registar ou emitir uma nova.
  • "A chave de licença… foi revogada…" - o fornecedor revogou esta chave (geralmente depois de emitir uma nova). Introduza a nova chave.
  • "A chave de licença está associada a outro domínio…" - a chave foi emitida para um endereço diferente daquele em que o programa está a funcionar. Peça ao fornecedor uma chave para este domínio.
  • "A versão X.Y.Z está disponível, mas não pode ser instalada: o seu direito a atualizações terminou em DD.MM.AAAA…" - a versão foi publicada depois do fim do direito a atualizações. O programa continua a funcionar; para a instalar, renove o direito (nova chave junto do fornecedor). Nesse caso, a lista normalmente já não mostra a versão mais antiga do período de direito - o servidor do fabricante disponibiliza apenas a versão mais recente.
  • "No servidor falta a extensão PHP "zip"…" - sem esta extensão a aplicação não consegue descompactar o pacote. Ative-a no painel de alojamento (definições PHP → extensões) e tente novamente. A aplicação verifica isto antes de transferir o pacote.
  • A versão não mudou depois do carregamento - certifique-se de que os ficheiros foram colocados na pasta correta e atualize a página ignorando a cache (Ctrl/Cmd + Shift + R).
  • Mensagem sobre permissões de escrita (por exemplo, "Não foi possível substituir o ficheiro … (permissões de escrita?)") - o servidor não permite à aplicação gravar os seus ficheiros. Corrija as permissões da pasta da aplicação no painel de alojamento ou por FTP e repita a atualização. As migrações já executadas não serão repetidas.
  • "O servidor da aplicação devolveu uma resposta inesperada (HTTP …)" - o programa no seu servidor terminou com erro antes de conseguir responder (ao verificar ou transferir a atualização). A causa fica registada no log de erros do PHP no alojamento - envie-o à equipa de suporte.
  • Botão "Bloqueado" - o motivo aparece por baixo do número da versão (e ao passar o cursor sobre o botão): é preciso instalar primeiro uma versão anterior, a licença já não cobre esta atualização (por exemplo, o direito a atualizações terminou) ou a versão não tem uma assinatura válida do fabricante.