Qui est en ligne

4 visiteurs en ligne.

Mise à jour de Zikula


1. Mise en garde

Votre installation de PostNuke doit avoir été mise à jour vers la version 0.764 ou plus avant d'essayer de faire la mise à jour vers Zikula. La mise à jour à partir de versions antérieures n'est pas supportée. N'oubliez pas que PostNuke 0.7x ne sera plus supporté par la Team Zikula à partir du 1 juillet 2009.


2. Pré-requis

Avant de mettre à jour votre site, veuillez prendre connaissance des pré-requis situés en haut de la page concernant l'installation.


3. Mise à jour depuis la version 0.764

Respectez l'ordre des étapes indiquées ci-dessous et lisez chacune d'entre elles en détail avant de commencer. Si vous suivez à la lettre les instructions, la mise à jour devrait se faire sans aucun problème.
  • 3.1 Sauvegarde de votre base de données et de vos fichiers
  • 3.2 Préparer votre version 0.7x
  • 3.3 Mise à jour du fichier config.php
  • 3.4 Exécuter la mise à jour
  • 3.5 Nettoyer

3.1 Sauvegarde de votre base de données et de vos fichiers
Il est vital de sauvegarder votre base de données v0.7x et vos fichiers avant d'exécuter la mise à jour. Il n'est pas possible de revenir en arrière après une mise à jour, dans ce cas la seule solution pour récupérer les informations en cas de problème est de restaurer les données sauvegardées. pour sauvegarder votre base de données, essayez en utilisant un outil tel que phpMyAdmin ou via SSH ou encore votre le système d'administration de votre hébergement. Des instructions complètes et des tutoriels à propos de la sauvegarde d'une base de données peuvent être trouvés en cherchant sur le web ou dans la documentation de l'outil que vous désirez utiliser.

3.2 Préparer votre version 0.7x
Connectez-vous à votre site PostNuke avec un compte administrateur et assurez-vous que chaque module listé ci-dessous est installé et activé. Ils sont tous inclus dans la version 0.764 - pour rappel seule cette version peut être mise à jour vers Zikula v1.0.
  • Admin
  • Admin_Messages
  • Blocks
  • Groups
  • Header_Footer
  • legal
  • Mailer
  • Permissions
  • pnRender
  • Search
  • Settings
  • User
  • Xanthia

Après cela, désactivez et supprimez le module Members_List. Les autres modules sont optionnels car le cœur de Zikula comporte désormais moins de modules (ceux facultatifs ont été retirés). Vous pouvez les mettre à jour séparément en télécharger le pack de ValueAddons? ou en utilisant le pack spécial de mise à jour vers Zikula 1.1.2, qui sont tout deux disponibles sur le CoZi. Vous pourrez, désormais, mettre à jour votre site vers toutes les futures versions de Zikula. Lorsque cette étape est terminée votre base de données est prête pour être mise à jour.
  • Note : Pour des raisons de performance, les permissions par utilisateur ne sont plus disponibles depuis Zikula 1.1. Il est recommandé de modifier vos permissions par utilisateur, pour les intégrer à vos permissions par groupe avant de faire la mise à jour.

Pour finir, supprimez tous vos fichiers de PostNuke v0.7x. Les fichiers du système de Zikula v1.0 ont beaucoup changé depuis les précédentes versions et cette étape est nécessaire pour éviter tout problème durant la mise à jour. Il est conseillé de déplacer tous les fichiers dans un répertoire de sauvegarde et ensuite des les recopier (pour par exemple les modules complémentaires, les thèmes, les téléchargements, les images, etc.) ensuite lorsque la mise à jour sera faite. Lorsque tous les fichiers de la v0.7x seront supprimés, envoyez les fichiers de Zikula sur votre hébergement. Vu que vous allez envoyer un nouveau répertoire pnTemp, assurez-vous qu'il soit inscriptible tout comme tous ses sous-répertoires (chmod -R 777).

3.3 Mise à jour du fichier config.php.
Le fichier config.php a été déplacé dans le répertoire /config. Ouvrez ce fichier inclus dans Zikula v1.0 et ajoutez les informations concernant votre base de données aux lignes suivantes :
$PNConfig['System']['prefix'];
$PNConfig['DBInfo']['default']['dbuname'];
$PNConfig['DBInfo']['default']['dbpass'];
$PNConfig['DBInfo']['default']['dbname'];


Si vous avez copié les informations non encodées du fichier config.php de votre version 0.764, vérifiez que la ligne ci-dessous soit bien sur "0"
$PNConfig['DBInfo']['default']['encoded'] = 0;


Et modifiez cette ligne pour qu'elle soit sur "1" :
$PNConfig['System']['installed'] = 1;


Dans certains cas il sera aussi nécessaire d'éditer le type de votre base de données, de table et d'hébergeur si vous n'utilisez pas ceux par défaut.

3.4 Exécuter la mise à jour.
Pour mettre à jour votre base de données, ouvrez le fichier upgrade.php dans votre navigateur internet. Vous aurez besoin de votre identifiant et mot de passe administrateur afin de procéder à la mise à jour. Suivez les instructions qui s'affichent afin de compléter la mise à jour.
  • Note : Zikula supprime le message de bas de page dans l'interface d'administration, il disparaitra donc après la mise à jour. Nous vous recommandons de hardcoder votre message de bas de page dans les templates de votre thème. Pour information, le processus de mise à jour copie votre ancien message de bas de page dans le répertoire pnTemp afin de pouvoir le récupérer facilement.

3.5 Nettoyer
Et enfin, supprimez les fichiers upgrade.php, install.php et le répertoire install.


4. Mise à jour depuis Zikula 1.0.x

Respectez l'ordre des étapes indiquées ci-dessous et lisez chacune d'entre elles en détail avant de commencer. Si vous suivez à la lettre les instructions, la mise à jour devrait se faire sans aucun problème.
  • 4.1 Sauvegarde de votre base de données et de vos fichiers
  • 4.2 Préparer votre version 1.0.x
  • 4.3 Exécuter la mise à jour
  • 4.4 Nettoyer et configuration additionnelle

4.1 Sauvegarde de votre base de données et de vos fichiers
Il est vital de sauvegarder votre base de données 1.0.x et vos fichiers avant d'exécuter la mise à jour. Il n'est pas possible de revenir en arrière après une mise à jour, dans ce cas la seule solution pour récupérer les informations en cas de problème est de restaurer les données sauvegardées. pour sauvegarder votre base de données, essayez en utilisant un outil tel que mysqldumper, phpMyAdmin ou via SSH ou encore votre le système d'administration de votre hébergement. Des instructions complètes et des tutoriels à propos de la sauvegarde d'une base de données peuvent être trouvés en cherchant sur le web ou dans la documentation de l'outil que vous désirez utiliser.

4.2 Préparer votre version 1.0.x
Connectez-vous à votre site Zikula avec un compte administrateur. Si vous le désirez, vous pouvez mettre votre site hors ligne durant la mise à jour en modifiant la configuration dans index.php?module=Settings&type=admin. Rendez-vous dans l'administration des modules et désactivez puis supprimez le module Members_List.

Supprimez tous vos fichiers de Zikula 1.0.x, une fois de plus soyez certain d'avoir bien fait une sauvegarde des fichiers et tout particulièrement du dossier config/. Les fichiers de Zikula v1.1 ont changé depuis Zikula v1.0.x et cette étape est nécessaire pour éviter des conflits durant le processus de mise à jour. Il vous est recommandé de déplacer tous vos fichiers dans un répertoire de sauvegarde et ensuite de restaurer ces fichiers (tel que les modules tiers, thèmes, téléchargements, images, etc.) dont vous avez besoin lorsque la mise à jour est terminée. Lorsque vos fichiers de la version 1.0.x auront été supprimés, envoyez les fichiers de la dernière version de Zikula sur votre hébergement. Vu que vous avez envoyé un nouveau dossier pnTemp, soyez certain que celui-ci et tous ses sous-dossiers sont inscriptibles (chmod -R 777).

Envoyez tous les fichiers du pack que vous avez téléchargé. Après quoi, vous pourrez remplacer le dossier config/ de ce pack par celui de votre précédente installation. De cette façon, votre configuration sera automatiquement incluse et votre installation sera prête à être mise à jour.

4.3 Exécuter la mise à jour
Exécutez le script upgrade10xto11x.php et suivez les étapes indiquées. Il n'y a aucune vrai interaction en dehors du fait de cliquer sur 'suivant'. Tous les changements nécessaires dans le base de données seront fait automatiquement. A la fin, vous serez redirigé vers le panneau d'administration.

4.4 Nettoyer et configuration additionnelle
Après une mise à jour réussie vous pouvez supprimer
  • le répertoire install et les fichiers install.php, upgrade.php et upgrade10xto11x.php du répertoire principal de votre site.

Si vous avez un bloc menu avez des liens qui pointent vers l'ancien module Members_List pour qu'ils pointent désormais vers index.php?module=Profile&func=viewmembers. Les permissions devront aussi être modifiées comme ceci 'Profile:Members:'.

Zikula 1.1 vous permet de configurer votre module favoris pour la gestion des profils et la messagerie interne, vous devrez donc vous rendre dans les préférences et vérifier que le script de mise à jour a sélectionné le bon module. Nous ne connaissons pas vos préférences, il est donc préférable de vérifier ces informations maintenant.

actuellement les modules suivants supportent cette technique :

Si vous avez mis votre site hors ligne avant de faire la mise à jour (voir 4.2) vous devrez le remettre en ligne.


5. Correctif pour Zikula 1.1.x

Veuillez suivre les étapes ci-dessous dans l'ordre et lire chacune d'elle en détail avant de commencer. Si vous suivez exactement les instructions indiquées, votre mise à jour devrait se dérouler sans problèmes.
  • 5.1 Sauvegarde de votre base de données et de vos fichiers
  • 5.2 Copier les fichiers du correctif
  • 5.3 Configuration additionnelle

5.1 Sauvegarde de votre base de données et de vos fichiers
Pour des raisons de sécurité, vous devriez toujours faire une mise à jour de votre base de données et des fichiers. Il n'est pas possible de revenir en arrière après une mise à jour, dans ce cas la seule solution pour récupérer les informations en cas de problème est de restaurer les données sauvegardées. Pour sauvegarder votre base de données, essayez en utilisant un outil tel que mysqldumper, phpMyAdmin ou via SSH ou encore votre le système d'administration de votre hébergement. Des instructions complètes et des tutoriels à propos de la sauvegarde d'une base de données peuvent être trouvés en cherchant sur le web ou dans la documentation de l'outil que vous désirez utiliser.

5.2 Copier les fichiers du correctif
Copiez tous les fichiers du correctif que vous avez téléchargé. Faites bien attention à ne pas remplacer votre fichier config/config.php.

5.3 Configuration additionnelle
Vérifier dans votre panneau d'administration que vous avez bien la dernière version de Zikula. Après quoi, allez dans l'administration des Modules et régénérez la liste. Certains modules peuvent nécessiter une mise à jour, vous pouvez alors terminer votre mise à jour en faisant ces dernières étapes.


6. Attention

Avant que l'API de PostNuke ne soit stable, il était courant que des modules tiers modifient des tables (dans la table de données) contenant les données du coeur en ajoutant des champs, modifiant leur noms, etc. Il est important de noter qui Zikula ne supporte aucun changement dans le code du coeur ou la structure des données. Zikula v1.0 a été pensé de façon assez flexible afin d'éviter tout modification du coeur, mais si vous remarquez qu'il manque quelque chose que vous considérez comme important, veuillez en faire la demande sur code.zikula.org/core.


7. Mise à jour des thèmes

Dans Zikula v1.0 la structure de thème a été reconfigurée pour le nouveau module de thèmes, appelé désormais Themes (Xanthia version 3). si vous utilisez un thème pour Xanthia 2, Zikula v1.0 dispose d'une option de mise à jour. Pour utiliser cet outil vous devez modifier les répertoires de vos thèmes pour les rendre inscriptibles (chmod -R 777). Rendez-vous dans l'administration du module Themes et cliquez sur l'option 'mise à jour'. Notez bien qu'il ne s'agit que d'un outil et non du script de mise à jour définitif. Pour la plupart des thèmes Xanthia cela devrait fonctionner, bien que pour des thèmes plus avancés il se peut que le thème ne soit pas totalement mis à jour. Vous devrez peut-être modifier certaines parties de votre thème manuellement. Pour les autres thèmes (ex. AutoTheme?) veuillez contacter le responsable de votre système de thème. Lorsque vous avez mis à jour vos thèmes, faites attention à bien modifier à nouveau le répertoire de vos thèmes en les mettant en lecture seule à nouveau !


8. Note finale

Félicitation ! La mise à jour est terminée. Nous espérons que vous serez ravi d'utiliser la nouvelle version de Zikula. Si vous avez certaines remarques, merci de nous en faire part dans nos forums.