A aplicação é atualizada pelo administrador no separador Definições → Atualizações. As atualizações são obtidas a partir do servidor do fabricante. A maioria das versões instala-se com um clique (instalador automático, sem FTP); alguns pacotes carregam-se manualmente por FTP - a aplicação indica sempre qual o caminho a seguir para cada versão.

As atualizações exigem uma licença válida (a mesma que desbloqueia a gravação na aplicação). Sem ela, a lista de versões não é transferida.

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

A aplicação verifica sozinha 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 a cada entrada) - para a próxima versão receberá uma nova.

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 após a instalação da versão mais recente. O indicador (e a notificação) só são visíveis para 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 em funcionamento no servidor,
    • Versão do código - a versão dos ficheiros da aplicação,
    • Versões disponíveis - a lista de versões mais recentes, com a Lista de alterações (changelog) de cada uma.

As versões instalam-se por ordem - só o botão da versão seguinte está ativo. As seguintes ficam disponíveis depois de instalar a anterior.

Transferência do pacote

  1. Na versão disponível mais próxima, clique em Transferir.
  2. Aparecerá um aviso sobre a 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 instalador automático - aparece o botão Instalar (descrito 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 transferi-lo novamente 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 instalação automática (a maioria das atualizações) não precisa de FTP:

  1. Depois de transferir, clique em Instalar.
  2. Aparecerá uma barra de progresso («A instalar…») a mostrar as etapas: migrações da base de dados → cópia de ficheiros → finalização.
  3. No final, o botão passa a 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 sozinho eventuais migrações da base de dados. Ainda assim, vale a pena ter uma cópia de segurança (aviso na transferência).

Nota: a barra de progresso só é totalmente «em direto» a partir do momento em que a versão instalada já inclui este mecanismo. Ao instalar 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.
  • «Tem a versão mais recente» - não existe nenhuma versão mais recente do que a instalada.
  • A versão não mudou depois do carregamento - certifique-se de que os ficheiros foram para a pasta correta e atualize a página ignorando a memória de cache (Ctrl/Cmd + Shift + R).