Table des matières

Mise à jour

Attention, en cas de mise à jour de la version 1.2.7 à la version 2.x, consulter : Mise à jour de Dotclear 1.2 vers 2

Préparatifs

Commencez toujours par faire une sauvegarde de la copie actuelle du programme. Ça ne coute rien et peut faire gagner un temps fou en cas de problème.

Vous devez conserver impérativement :

Mise à jour automatique

NEW Lorsqu'une nouvelle version de Dotclear est disponible, un message sur votre tableau de bord vous signalera l'existence de celle-ci et vous proposera d'effectuer la mise à jour de Dotclear. Suivez simplement la procédure et le programme se chargera lui-même d'effectuer les vérifications nécessaires puis mettra à jour les fichiers nécessaires. Vous serez ensuite invités à vous déconnecter pour finaliser la mise à jour. Vous n'aurez rien de plus à faire à part éventuellement vous assurer que vos plugins fonctionnent correctement.

Important :

Le processus de mise à jour automatique effectue une vérification très stricte des fichiers précédemment installés. Si un seul d'entre eux a été modifié, vous ne pourrez pas mettre à jour.

Note :

Avec une installation optimisée, il est nécessaire de copier la dernière version du thème par défaut dans le dossier de thèmes (voire dans chaque dossier de thèmes).

Il peut arriver que certains fichiers soient signalés comme modifiés alors qu'il ne l'ont pas été. Cela se produit si vous avez installé Dotclear en utilisant un mode de transfert FTP ASCII et non binaire. Vous pouvez transférer à nouveau les fichiers de l'ancienne version posant problème en utilisant bien un mode de transfert binaire. Les anciens fichiers zip sont disponibles dans le répertoire attic des téléchargements.

Mise à jour manuelle du programme

Note :

Pour mettre à jour Dotclear, il suffit d'installer la dernière version, il n'y a pas besoin de faire toutes les mises à jour successives depuis la version installée.

Important :

Déconnectez-vous complètement au moyen du lien Déconnexion de l'interface d'administration avant toute mise à jour ! Fermer seulement la fenêtre du navigateur ne suffit pas et peut provoquer des erreurs.

Vous avez fait une installation standard ?

Modifier le fichier index.php pour y indiquer à nouveau l'identifiant de votre blog en lieu et place de default si vous l'aviez modifié dans la version précédente.

Rapatriez dans cette nouvelle installation uniquement les fichiers et sous-répertoires que vous avez personnalisés. Sont souvent concernés : les répertoires public, themes, plugins et le fichier .htaccess. De plus il est recommandé de vérifier les différences entre vos fichiers personnalisés et les nouveaux fichiers avant d'effectuer l'écrasement.

Vous avez fait une installation optimisée ? (recommandé)

Avec une installation optimisée, il est nécessaire de copier la dernière version du thème par défaut dans le dossier de thèmes (voire dans chaque dossier de thèmes).

Note :

Certains thèmes ou plugins peuvent ne plus être compatibles avec la nouvelle version. En cas de doute, finissez la procédure de mise à jour sans les restaurer puis restaurez-les un par un en vérifiant après chaque que tout se passe bien.

Important :

Pour le passage de la version 2.1.7 (ou version précédente) à la 2.2, il ne faut pas restaurer le plugin metadata dans la nouvelle version.

Si le dossier temporaire est situé hors du dossier dotclear (ce qui n’est pas la configuration par défaut), pensez à vider le répertoire de cache des templates. Un bouton à cet effet est accessible par le lien Maintenance (sous Extensions dans l’administration).

Mise à jour de la base de données

Finissez la procédure de mise à jour en vous rendant sur la page d'authentification de Dotclear. Un message vous indiquera que Dotclear a été mis à jour, c'est terminé, vous pouvez vous connecter.

Avec SQLite

Le schéma de la base de données ne peut pas être mis à jour pour les bases de données de type SQLite. Pour faire une mise à jour, vous devez exporter les données, puis faire une nouvelle installation de Dotclear pour y réimporter ces données.

Annexe : mise à jour d'un clone mercurial

Si vous utilisez une copie mercurialde Dotclear, la mise à jour est encore plus simple :

Si vous souhaitez utiliser des fichiers PHP à la place des fichiers de langue gettext, créez les manuellement en lançant le programme build-tools/make-l10n.php depuis la raçine de votre copie de Dotclear. Pensez à le faire à chaque mise à jour si vous souhaitez conserver une traduction à jour.