Comment mettre à jour PhpGedView d'une version 4.0.2 ou 4.1.x vers une version supérieure

Cet article vous explique comment effectuer une mise à jour d'une version PhpGedView v4.0.x ou 4.1.y vers une version PhpGedView v4.1.x.

Mise à jour de 4.1 vers 4.1.x

Mettre à jour PhpGedView d'une version 4.1 vers une version 4.1.4 ou toute autre version 4.1.x n'est pas difficile, mais cette opération ne consiste pas uniquement à remplacer les fichiers présents sur le serveur par de nouveaux fichiers.

Voici les différentes étapes à suivre pour réaliser cette migration:

1. Pour effectuer une mise à jour d'une version 4.1 vers une version 4.1.4 ou toute autre version 4.1.x, remplacez les fichiers présents sur votre serveur par les fichiers de la nouvelle version, en écrasant les fichiers présents sur votre serveur.
2. N'oubliez pas de supprimer également tous les fichiers qui sont présents dans le répertoire PhpGedView/index/cache, car ces fichiers sont faits pour fonctionner avec votre version actuelle de PhpGedView, pas avec une nouvelle version. Pour supprimer les fichiers présents dans le répertoire PhpGedView/index/cache, il vous suffit de vous rendre sur la page "Mon Portail --> Administration --> Nettoyer le répertoire «index»", puis de cocher la case "cache" qui apparaît sur la page "Nettoyer le répertoire «index»". Vous pouvez également détruire manuellement ces fichiers dans votre répertoire "index" en utilisant votre logiciel FTP.

Cas particulier des sites pour lesquels aucune modification de la base de données n'a été faite en ligne ou pour les sites dont les modifications ont été réalisées en ligne mais dont leur base de données et leurs fichiers GEDCOM sont synchronisés

Ces instructions concernent les sites pour lesquels aucune modification de la base de données n'a été faite en ligne ou pour les sites dont les modifications ont été réalisées en ligne mais dont leur base de données et leurs fichiers GEDCOM sont synchronisés. Si vous n'avez pas synchronisé votre base de données et vos fichiers GEDCOM, exportez une copie de votre base de données.

Préparation d'une copie d'installation de la dernière version de phpGedView sur votre ordinateur personnel

1. Réalisez une sauvegarde (backup) de votre base de données SQL. Vous pouvez avoir besoin de faire appel à l'aide de votre hébergeur web pour réaliser cette opération.
2. Faites une sauvegarde de votre répertoire /index, de votre répertoire /media et de votre fichier "config.php".
3. Si vous avez effectué des modifications sur vos fichiers de langues (ces fichiers se nomment "languages/extra.xx.php"), faites également une sauvegarde de ces fichiers.
4. Faites une sauvegarde de toutes les modifications ou ajouts que vous avez effectuées sur les thèmes.
5. Si vous avez de la place sur votre serveur, renommez votre installation existante et laissez la en place momentanément. Cela vous servira de sauvegarde supplémentaire.
6. Téléchargez une copie de la dernière version de PhpGedView et décompressez-la sur votre ordinateur personnel.
7. Remplacez les fichiers/répertoires suivants que vous venez de récupérer de la dernière version de phpGedView, par ceux que vous avez sauvegardés précédemment sur votre ordinateur:

• fichier "config.php"
• drépertoire "media"
• répertoire "index"
• modifications apportées aux thèmes. Ne copiez pas en intégralité la sauvegarde de votre répertoire "themes", parce que les dernières versions de PhpGedView peuvent contenir des mises à jour très importantes pour les thèmes.
• fichier "languages/extra.xx.php" - Si vous avez modifié les fichiers de langues, ajoutez-les. Ne copiez pas en intégralité la sauvegarde de votre répertoire "languages" parce que les dernières versions de PhpGedView peuvent contenir des mises à jour très importantes.
• Si vous n'envisagez pas d'utiliser tous les modules disponibles, vous pouvez supprimer les répertoires correspondant aux modules que vous ne souhaitez pas utiliser.

Installation de la copie d'installation de la dernière version de phpGedView sur votre serveur

Cette étape préparatoire vous a donné une copie complète (à l'exception de la base de données) de l'installation de phpGedView sur votre ordinateur personnel. Suivez maintenant les étapes suivantes pour installer cette copie sur votre serveur:

1. Copiez sur votre serveur, l'intégralité du contenu du répertoire de votre ordinateur personnel qui contient la dernière version de phpGedView que vous avez préparée précédemment.
2. Assurez-vous que les attributs du répertoire "index" et des fichiers qu'il contient, sont bien paramétrés à 0777 (lire/écrire/modifier).
3. Si vous avez l'intention d'utiliser PhpGedView pour transférer des fichiers media ou pour créer des vignettes à partir de fichiers media que vous avez transféré sur votre serveur sans utiliser phpGedView, vous devez paramétrer les attributs du répertoire "media" et des sous répertoires et fichiers qu'il contient à 0777 (lire/écrire/modifier). Lisez attentivement cet article Media_Firewall pour connaître les instructions qui vous permettront de relocaliser votre répertoire "media" à l'extérieur de l'espace pouvant être adressé par le web.
4. Si vous avez besoin de reconfigurer entièrement votre site PhpGedView ou si vous avez besoin de modifier des informations relatives à la connexion à votre base de données, vous devez paramétrer les attributs du fichier "config.php" à 0777 (lire/écrire/modifier). Une fois que vous terminé vos modifications sur ce fichier, vous pouvez paramétrer ses attributs à "lire" uniquement.
5. Puisque le programme de phpGedView a été modifié, vous devez supprimer le fichier de cache "Evénements à venir". Le nom de ce fichier se termine par "_upcoming.php" et se trouve dans votre répertoire "index".
6. A partir de votre navigateur Internet, rendez-vous sur votre site PhpGedView et connectez-vous en tant qu'administrateur.
7. Ré-importez votre GEDCOM (un nouveau transfert de ce fichier GEDCOM sur votre serveur n'est pas nécessaire sauf si vous avez modifié hors-ligne ce fichier ou si vous n'avez pas utilisé la fonction de synchronistaion).

• Laissez le soin à PhpGedView d'effectuer toutes les corrections qu'il estimera nécessaires.
• Laissez PhpGedView nettoyer le contenu de votre base de données. PhpGedView ne mettra à jour que les tables qui concernent le fichier GEDCOM.
• PhpGedView peut modifier la structure d'autres tables, telles que celles relatives aux utilisateurs (Users), aux favoris (Favorites), aux nouvelles (News), ainsi qu'aux blocs (Blocks) afin de respecter les exigences de la nouvelle version, mais le contenu de ces tables retsera intact.

Upgrading 4.0 to 4.1.x

Use the following steps to upgrade to v4.1. These steps assume that you are familiar with PhpGedView and have successfully installed it before.

1. Upload the new 4.1 files to your server replacing the old files with the new files. Do not replace the config.php file or the index directory.
2. In order to create the data required for the new version, you will have to re-import your GEDCOM.
3. You can now use your upgraded site.
4. If you are using a customized theme you will need to update your theme with new stylesheets and variables. An excellent tool that can help you to merge themes is the WinMerge project http://winmerge.sourceforge.net/

Note to SQLite users: Unfortunately SQLite does not support the ALTER TABLE
SQL command.  This means that we must first drop the tables and recrate
them.  It is highly reccomended that you run the backup before upgrading.

Version 4.x no longer includes support for index files. If you do not have PHP 5 with built-in SQLite support or a database account then you should not upgrade to PhpGedView 4.x. Maintenance releases will continue for the 3.3.x version until PHP 4 is no longer supported.