L'application est mise à jour par l'administrateur dans l'onglet Paramètres → Mises à jour. Les mises à jour sont téléchargées depuis le serveur de l'éditeur. Les nouvelles versions s'installent en un clic (auto-installateur, généralement sans FTP). Le FTP sert à déposer les fichiers lors de la première installation du programme ; pour une mise à jour, l'assistance technique est utile lorsque le serveur ne permet pas à l'application d'écraser ses propres fichiers. Si le paquet téléchargé ne dispose pas d'auto-installateur, l'application affichera les instructions de dépôt par FTP.

Le téléchargement des mises à jour nécessite une licence active (la même qui débloque l'enregistrement dans l'application). Le serveur du fournisseur ne met la liste des versions à disposition que pour une clé associée au domaine de cette installation. Lorsque le droit aux mises à jour enregistré dans la clé expire, le bouton de la nouvelle version passe à l'état Bloqué, et la raison est visible sous le numéro de version ainsi qu'au survol du bouton.

Avec une licence avec mises à jour jusqu'à une date donnée, c'est la date de publication de la version qui compte (visible pour chaque version de la liste) : la licence couvre les versions publiées avant la fin du droit, pas les plus récentes. Le programme continue de fonctionner - vous ne pourrez simplement pas télécharger les nouvelles versions tant que vous n'aurez pas renouvelé le droit (nouvelle clé auprès du fournisseur, voir le chapitre sur la licence). Il est préférable d'installer la dernière mise à jour de la période couverte avant la fin de celle-ci : le serveur du fournisseur ne propose généralement que la dernière version disponible, et pourrait donc ne plus afficher d'ancienne version après cette date.

Vérification automatique et notification

L'application vérifie elle-même la disponibilité des mises à jour - plus besoin d'aller à chaque fois dans les paramètres :

  • après connexion (à l'entrée dans l'application),
  • périodiquement, tant que l'application reste ouverte,
  • au retour sur l'onglet du navigateur (si un certain temps s'est écoulé depuis la dernière vérification).

Lorsqu'une nouvelle version sort, l'administrateur voit s'afficher une courte notification (« Mise à jour disponible - la version X.Y.Z est prête à être installée ») avec un bouton Afficher qui ouvre directement Paramètres → Mises à jour. La notification s'affiche une seule fois par version (elle ne réapparaît pas à chaque connexion) - vous en recevrez une nouvelle à la prochaine version.

Si la nouvelle version ne peut pas être installée (par exemple parce que le droit aux mises à jour a expiré), la notification l'indique clairement : « La version X.Y.Z est disponible, mais ne peut pas être installée : … » avec la raison. Lorsque les mises à jour sont indisponibles à cause de la clé de licence (absence de clé, clé non reconnue, révoquée, associée à un autre domaine ou inconnue du serveur), l'administrateur reçoit un seul avertissement Mises à jour indisponibles accompagné de l'explication - le suivant n'apparaîtra que lorsque le problème aura disparu puis réapparu.

Indicateur de nouvelle version

Indépendamment de la notification, lorsqu'une version plus récente est disponible, l'administrateur voit un point rouge sur l'icône de la roue dentée (⚙) dans le menu supérieur, puis, une fois les paramètres ouverts, le même point à côté de l'onglet Mises à jour. Le point disparaît automatiquement une fois la dernière version installée. Cet indicateur (et la notification) ne sont visibles que par les administrateurs.

Vérifier les versions disponibles

  1. Cliquez sur l'icône de la roue dentée (⚙) → onglet Mises à jour.

Version développeur. Si l'application tourne en mode développeur (code directement issu du dépôt), la vérification des mises à jour est désactivée : pas de point rouge ni de notification, et l'onglet indique clairement que vous travaillez sur une version développeur.

  1. Cliquez sur Vérifier les mises à jour. Vous verrez :
    • Version installée - version active sur le serveur,
    • Version du code - version des fichiers de l'application,
    • Versions disponibles - liste des versions plus récentes avec la liste des modifications (changelog) de chacune.

Les versions s'installent dans l'ordre - seul le bouton de la version suivante est actif. Les versions suivantes se débloquent après l'installation de la précédente.

Task Manager : onglet Mises à jour avec la liste des versions et un bouton d'installation.
Onglet Mises à jour : version sur le serveur, nouvelles versions disponibles et liste des changements.

Téléchargement du paquet

  1. Sur la version disponible la plus proche, cliquez sur Télécharger.
  2. Un avertissement de sauvegarde s'affiche - avant la mise à jour, effectuez une sauvegarde de la base de données ainsi que du dossier des pièces jointes (uploads/). Confirmez pour continuer.
  3. Le serveur télécharge le paquet et vérifie sa somme de contrôle (SHA-256). Ensuite, selon le type de paquet :
    • Paquet avec auto-installateur - le bouton Installer apparaît (description ci-dessous). Vous n'avez rien à déposer par FTP.
    • Paquet à déposer manuellement - le navigateur enregistre le fichier .zip sur votre disque (vous pourrez le retélécharger si besoin avec le bouton Enregistrer le paquet (.zip)) et affiche les instructions FTP.

Installation en un clic (auto-installateur)

Pour les versions prenant en charge l'auto-installation, vous n'avez pas besoin de FTP :

  1. Une fois le téléchargement terminé, cliquez sur Installer.
  2. Une barre de progression (« Installation en cours… ») apparaît et indique les étapes : migration de la base de données → copie des fichiers → finalisation.
  3. Une fois terminé, le bouton devient Actualiser l'application - cliquez dessus pour charger la nouvelle version (vous pouvez aussi actualiser la page avec Ctrl/Cmd + Shift + R).

L'installateur ne touche pas à vos données - il ignore includes/config.php, uploads/, storage/ et logs/, et effectue lui-même les éventuelles migrations de base de données. Il reste néanmoins conseillé de disposer d'une sauvegarde (avertissement affiché lors du téléchargement).

Remarque : la barre de progression n’est entièrement « en temps réel » qu’à partir du moment où la version installée inclut déjà ce mécanisme. Lors d’une installation depuis une version plus ancienne, la progression peut s’afficher par à-coups.

Installation par FTP (paquets sans auto-installateur)

Quand le paquet ne prend pas en charge l'auto-installation, l'application affiche les instructions de dépôt manuel :

  1. Effectuez une sauvegarde de la base de données et du dossier uploads/ (si ce n'est pas déjà fait).
  2. Décompressez le fichier .zip téléchargé.
  3. Connectez-vous à l'hébergement par FTP et déposez le contenu du paquet dans le répertoire de l'application, en écrasant les fichiers existants.
  4. NE PAS écraser (conservez les vôtres) :
    • includes/config.php - configuration et secrets,
    • uploads/ - pièces jointes et avatars,
    • storage/ - données de travail,
    • logs/ - journaux.
  5. Actualisez l'application dans le navigateur (Ctrl/Cmd + Maj + R) et cliquez à nouveau sur Vérifier les mises à jour pour confirmer le nouveau numéro de version.

Si la version introduit des changements dans la base de données, les instructions de cette version (changelog / note de version) indiqueront les étapes supplémentaires. En cas de doute, restaurez d'abord la sauvegarde et contactez le fournisseur.

Questions fréquentes

  • « Impossible de se connecter au serveur de mises à jour » - vérifiez votre connexion internet ainsi que la validité de la licence. La liste des versions n'est accessible qu'aux installations disposant d'une clé valide. La description technique de l'erreur de connexion (par exemple « Could not resolve host… ») est ajoutée par le programme entre parenthèses après le mot « détails » - utile pour le support technique de l'hébergeur.
  • « Vous avez la dernière version » - il n'existe pas de version plus récente que celle installée. Ce message n'apparaît que lorsque le serveur a reconnu la clé - en cas de problème de clé, vous verrez l'un des messages ci-dessous.
  • « Cette installation n'a pas de clé de licence… » - saisissez la clé dans Paramètres → Avancé → Licence ; sans elle, l'application ne demande même pas les versions au serveur.
  • « Le serveur de mises à jour ne reconnaît pas la clé de licence… » - la signature de la clé ne correspond pas à celle du serveur du fournisseur (clé endommagée ou provenant d'une autre source). Saisissez la clé reçue du fournisseur ou contactez-le.
  • « La clé de licence de cette installation n'est pas dans la base du serveur de mises à jour… » - la clé est valide, mais le serveur du fournisseur ne la connaît pas. Le fournisseur doit l'enregistrer ou en délivrer une nouvelle.
  • « La clé de licence… a été révoquée… » - le fournisseur a révoqué cette clé (généralement après en avoir délivré une nouvelle). Saisissez la nouvelle clé.
  • « La clé de licence est associée à un autre domaine… » - la clé a été délivrée pour une autre adresse que celle sur laquelle fonctionne le programme. Demandez au fournisseur une clé pour ce domaine.
  • « La version X.Y.Z est disponible, mais elle ne peut pas être installée : votre droit aux mises à jour s’est terminé le JJ.MM.AAAA… » - cette version a été publiée après la fin de votre droit aux mises à jour. Le programme continue de fonctionner ; pour l’installer, renouvelez votre droit (nouvelle clé fournie par le prestataire). La liste n’affiche alors généralement plus la version plus ancienne correspondant à la période couverte - le serveur de l’éditeur ne propose que la dernière version publiée.
  • « Il manque l'extension PHP « zip » sur le serveur… » - sans cette extension, l'application ne peut pas décompresser le paquet. Activez-la dans le panneau d'hébergement (paramètres PHP → extensions) et réessayez. L'application vérifie cela avant le téléchargement du paquet.
  • La version n'a pas changé après le dépôt des fichiers - vérifiez que les fichiers ont bien été placés dans le bon répertoire et actualisez la page en ignorant le cache (Ctrl/Cmd + Shift + R).
  • Message concernant les droits d'écriture (par ex. « Impossible d'écraser le fichier … (droits d'écriture ?) ») - le serveur ne permet pas à l'application d'enregistrer ses fichiers. Corrigez les permissions du répertoire de l'application dans le panneau d'hébergement ou via FTP, puis relancez la mise à jour. Les migrations déjà effectuées ne seront pas répétées.
  • « Le serveur de l’application a renvoyé une réponse inattendue (HTTP …) » - le programme installé sur votre serveur s’est arrêté en erreur avant d’avoir pu répondre (lors de la vérification ou du téléchargement des mises à jour). La cause est enregistrée dans le journal d’erreurs PHP de l’hébergement - transmettez-le au support technique.
  • Bouton « Bloqué » - la raison apparaît sous le numéro de version (et au survol du bouton avec le curseur) : il faut d’abord installer une version précédente, la licence ne couvre plus cette mise à jour (par exemple, le droit aux mises à jour a expiré), ou la version ne porte pas de signature valide de l’éditeur.