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

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 :

• Le fichier de configuration (généralement inc/config.php)
• Vos éventuels thèmes et plugins personnels
• Vos fichiers publics
• Votre fichier .htaccess, si vous en avez un

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.

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.

• Renommez la nouvelle du copie du programme (dotclear-new par exemple)

• Transférez la nouvelle copie du programme au même niveau que le répertoire de l'ancienne version (appelée le plus souvent dotclear).

• Copiez ensuite le fichier de configuration à son emplacement dans la nouvelle version (inc/config.php dans la majorité des cas).

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.

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).

• Renommez le répertoire contenant la copie actuelle du programme (dotclear-old par exemple).

• Renommez le nouveau répertoire (dotclear-new) avec le nom correct (dotclear en général).

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).

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.

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.

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

• Déconnectez vous
• Mettez à jour votre copie de travail (hg pull)
• Rendez-vous sur la page d'authentification

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.