====== Mise à jour ====== Attention, en cas de mise à jour de la version 1.2.7 à la version 2.x, consulter : [[1-to-2|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 : * 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 ===== 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. 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. Avec une [[clean-install|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 [[http://download.dotclear.net/attic/|attic]] des téléchargements. ===== Mise à jour manuelle du programme ===== 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. 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. * 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). ==== 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 [[clean-install|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). 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. 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 : * 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.