Guide d'installation

De PGVWiki
Sauter à la navigation Sauter à la recherche

PhpGedView pour les débutants

Introduction

PhpGedView est un programme de généalogie qui vous permet de visualiser et d'éditer votre généalogie sur un site web. PhpGedView dispose de capacités d'édition, de fonctions de confidentialité, et de supports multimedia telles que des photos et des images. PhpGedView facilite également les processus de travail collaboratif avec d'autres personnes sur votre arbre généalogique. Vos dernières informations peuvent ainsi toujours être disponible en lecture aux autres sur votre site web.

Pour obtenir plus d'informations et accéder aux démonstrations, vous pouvez visiter le site (en anglais) http://www.phpGedView.net/

PhpGedView est un logiciel libre (Open Source) qui a été développé par des personnes de beaucoup de pays différentes qui ont donné de leur temps et de leurs compétences pour ce projet. Le service, le support et les développements futurs sont dépendants du temps que les développeurs veulent bien accorder au profit de projet, souvent au détriment de leur travail, de leurs loisirs et de leur vie familiale. Au delà des qualques donations que certains utilisateurs envoient, les développeurs ne reçoivent aucune compensation pour le temps qu'ils consacrent au projet. Il n'existe pas non plus de source de revenus extérieure qui supporte ce projet.

Ce dont vous aurez besoin

  • Il vous faut un fournisseur internet qui offre le PHP (version 4.3 minimum) disponible pour tous les utilisateurs. Cette information est en général disponible dur le site du fournisseur de votre internet.
  • Au moins 20MB d'espace disque sur le serveur qui doit héberger PhpGedView. Pour vérifier l'espace disponible, visitez la page web de votre fournisseur internet, qui vous indiquera l'espace libre.
  • Un logiciel de transfert de fichiers dit FTP (File Transfer Protocol). Bien qu'un tel logiciel existe au sein de certains navigateurs internet (par ex Windows Internet Explorer ou Mozilla Firefox) il est plus agréable d'utiliser un logiciel un peu plus évolué. Il existe ainsi quelques logiciels FTP faciles d'utilisation tels que FileZilla (Windows et Linux) et Fetch (Mac). Vous pouvez obtenir Filezilla à cette adresse http://sourceforge.net/projects/filezilla
  • Un fichier GEDCOM qui contient vos données généalogiques. (Un quoi ? Si vous n'êtes pas familier avec un fichier GEDCOM, je vous conseille de consulter le site internet suivant http://fr.wikipedia.org/wiki/Norme_GEDCOM)

Les différentes versions (Janvier 2007)

PhpGedView a été conçu à l'origine pour utiliser le mode qui s'appelle "index". Dans ce mode, les données généalogiques sont enregistrées comme un gros fichier texte, et les informations sont rapatriées à partir de ce gros fichier en allant lire à l'intérieur. Cette méthode était acceptable pour des fichiers de petite taille, mais pour des fichiers plus volumineux. C'est pourquoi une autre méthode a été développée dans laquelle les informations du fichier GEDCOM sont transférées sur une base de données (mode "base de données"). Celà a grandement réduit le temps nécessaire pour chaque opération effectuée par le logiciel.

Il existe deux principales versions de PhpGedView - plus connues sous le nom de v3 et v4.

Les noms exacts des versions au 1 Janvier 2007 sont 3.3.8 et 4.0.2

  • PhpGedView v3 vous offre la possibilité d'utiliser le mode index ou le mode base de données. Cette version nécessite que votre serveur web dispose au minimum de la version PHP v4.3 et d'environ 20MB d'espace disque. Les installations par défaut de PHP sur la plupart des serveurs devraient offrir toutes les fonctionnalités de PHP dont vous aurez besoin.
  • PhpGedView v4 is database mode fonctionne uniquement en mode "base de données". Cette version nécessite les mêmes exigences minimales que pour la version v3, avec en plus, plus MySQL, qui est une application de base de données. L'utilisation d'une base de données permet une utilisation pour plus efficiente de vos informations généalogiques.

Vous pouvez avoir besoin de contacter votre hébergeur internet afin de vérifier qulles sont les fonctionnalités qui vous sont mises à disposition. Si vous avez l'intention d'utiliser le mode "base de données", votre fournisseur devra vous mettre à disposition une base de données avec un nom et un mot de passe, ou vous offrir la possibilité de la créeer et de choisir son nom et son mot de passe.

Taille maximum du fichier GEDCOM

Pour les fichiers GEDCOMs qui ont une taille supérieure à 2MB, vous aurez probablement besoin de rechercher des solutions d'hébergement différentes et en trouver une qui acceptera que vous puissiez modifier les paramètres de taille de mémoire par défaut ainsi que de limite de temps mémoire qui sont déterminés par les caractéristiques PHP de votre hébergeur. Si vous avez des fichiers GEDCOM de cette taille, il vous faut impérativement résoudre ces problèmes de taille et d'hébergement avant nde poursuivre plus loin. Vous pouvez obtenir plus d'informations dans la rubrique FAQ de ce PGWiki: FAQ: Questions sur l'installation de phpGedView

Préparation du transfert FTP

Avant de commencer quoi que ce soit, vous avez besoin d'un moyen pour trandférer des fichiers depuis votre ordinateur sur votre serveur web. Votre fournisseur internet vous communiquera ses conditions de transfert, prenez-en connaissance. N'allez pas plus loin avant de savoir précisément quel volume d'espace web votre fournisseur vous offre et quelles sont ses conditions d'utilisation de cet espace web.

Vous aurez besoin d'un utilitaire de transfert FTP – FTP est l'abréviation de File Transfer Protocol, qui est la "règle" pour transférer des fichiers dans le monde internet. Comme celà a été mentionné plus haut, vous pouvez utiliser FileZilla ou Fetch, qui sont gratuits. Installez l'un de ces logiciels, et paramétrez-le pour votre fournisseur internet.

Connectez vous à votre espace web. Vous devriez normalement avoir à votre disposition un répertoire nommé "WWW" ou "public_html", qui est l'endroit qui vous est réservé par votre hébergeur internet afin que vous puissiez y transférer vos fichiers. Ouvrez cet espace. Ensuite, créez un nouveau répertoire dans cet esapce, nommez le par exemple "famille" (vous pouvez choisir le nom que vous voulez, il ne s'agit là que d'une simple suggestion).

Vous êtes maintenant prêt à télécharger une copie de PhpGedView, et à l'installer.

Préparation de PhpGedView

Allez sur ce site http://sourceforge.net/projects/phpgedview/ et téléchargez le paquet logiciel que vous voulez (v3 ou v4). Placez-le dans un répertoire approprié sur votre propre ordinateur, par exemple PHP402. Décompressez ("dézippez") tous les fichiers du paquet logiciel (V3 ou V4) que vous venez de télécharger dans ce sous-répertoire. “PHP402” sera votre répertoire source. Conservez les fichiers compressés (c'est à dire le paquet logiciel avec l'extension .zip) dans le cas où vous en auriez besoin plus tard.

Vous pouvez transférer l'intégralité de ces fichiers si vous le souhaitez, mais au fur et à mesure que gagnerez en expérience, vous serez capable d'identifier les fichiers dont vous savez qu'ils ne vous seront pas utiles,vous évitant ainsi de les transférer sur votre serveur. Si vous téléchargez la totalité, le transfert occupera envron 18MB sur le serveur. Si vous effectuez ce tri, l'espace occupé se limitera à environ 7MB.

  • Dans le répertoire “PHP402/themes”, supprimez les thèmes que vous ne comptez pas utiliser. Conservez au moins le thème “standard”.
  • Supprimez les fichiers de languages dont vous n'avez pas l'utilité. Les fichiers en anglais sont nommés configure_help.en.php, countries.en.php, facts.en.php, help_text.en.php and lang.en.php. Les fichiers en français sont par exemple constitués dans le nom deu fichier de la partie ".fr." à la place de ".en.

(Les fichiers en langue anglaise ne doivent surtout pas être supprimés. Ils sont en effet systématiquement utilisés par le logiciel avant de faire appel aux fichiers de traduction. Celà permet d'être certain que tous les languages sont bien définis, et que la version anglaise pourra être utilisée dans le cas où la traduction d'un mot dans le language voulu a été oubliée.)

  • Ne transférez pas tout de suite la totalité du répertoire "places". Ce répertoire contient les cartes de certains pays. Il contient aussi des fichiers texte qui recensent les noms d'états, de régions et de lieux. Ces fichiers vous permettent d'entrer les noms de lieux en les choisissant parmi des listes. Its purpose is to allow you to enter place names by picking them from lists. (il est conseillé de vérifier ces fichiers et de les tester au préalable car il peut y avoir des erreurs...)
  • Allez dans le répertoire images/flags et supprimez les drapeaux des pays qui ne vous intéressent pas.
  • Vérifiez le répertoire "modules" - il peut contenir plus de modules optionnels que ceux dont vous avez besoin. En cas de doute sur ce que font ces différents modules, ouvrez les fichiers "read-me.txt" et vérifiez.

Installation de PhpGedView

Démarrez FileZilla et connectez vous sur votre espace web après vous être identifié. Copiez tous les fichiers et les répertoire du paquet logiciel que vous avez téléchargé dans votre répertoire "work" vers le répertoire "famille" de votre serveur. Pour transférer ensuite ces fichiers et répertoires sur votre serveur, faites simplement un double clic sur les noms des fichiers et des répertoires dans le panneau gauche de FileZilla. Vous pouvez surveiller la progression du transfert de ces fichiers et répertoires dans le panneau inférieur.

Afin de vérifier que vous avez correctement effectué cette étape, vérifiez que vous avez bien le même nombre de répertoires, de fichiers ainsi que la même occupation en bits dans votre répertoire “famille” que dans votre répertoire “PHP402”

Erreur lors de la création de la miniature : Fichier manquant
Figure 1

Il faut ensuite réaliser un léger nettoyage. Les fichiers et les répertoires que avez transféré ont des “attributs” – ces attributs vous autorisent (ou vous interdisent) de les lire, de les modifier ou d'exécuter leur contenu. Si votre connection FTP est encore active, recherchez le fichier config.php dans le panneau de droite, puis effectuez un clic droit sur le nom de ce fichier et sélectionnez “Attributs du fichier…”

Erreur lors de la création de la miniature : Fichier manquant
Figure 2

La fenêtre “Changer les attributs du fichier” qui apparait vous permet de choisir les différents niveaux d'autorisation du fichier. La valeur numérique (appelée “chmod” en anglais car c'est le nom de la commande informatique qui permet de changer les niveaux d'autorisation d'un fichier), synthétise ces différentes autorisations. Essayez de cliquer sur les différentes options qui vous sont présentées - par exemple autorisez les différents utilisateurs (Permissions du groupe, Permissions du propriétaire, Permissions publiques) à écrire dans le fichier config.php, en cliquant sur les cases vides "Ecriture". La valeur numérique sera alors modifiée de la valeur 644 à la valeur 666. Puis cochez les trois cases "Exécution", et vous verrez que la valeur numérique (chmod) passera à 777. Laissez ces cases cochées ainsi – ce fichier a besoin de niveau de permissions. Plus tard, lorsque votre site sera configuré, il vous sera demandé de revenir sur ce point et de ramener la valeur numérique pour ce fichier à 644.

Pendant que vous effectuez cette opération, faites un clic droit sur l'icône du répertoire "index", et changez sa valeur numérique à 777. Faites la même opération pour le répertoire "media".

Transfert du fichier GEDCOM

Partant de l'hypothèse que vous avez un fichier GEDCOM disponible (si tel n'est pas le cas, il faut que vous en créiez un) vous pouvez maintenant le transférer sur votre serveur. Ce n'est pas une étape obligatoire, mais pour votre premier essai, allez-y maintenant.

Rechercher l'emplacement de votre fichier GEDCOM sur votre ordinateur (dans le panneau gauche de l'affichage de votre logiciel FTP), puis ouvrez le répertoire “index” de votre espace web (dans le panneau droit de l'affichage de votre logiciel FTP). Puis faites un double clic sur le nom de votre fichier GEDCOM dans le panneau gauche, et assurez-vous bien que le fichier GEDCOM est copué dans le répertoire “index” de votre espace web sur le panneau de droite.

Faites un clic droit sur le nom de votre fichier GEDCOM dans le panneau de droite, et paramétrez les attributs de ce fichier à la valeur numérique 644.

Vous y êtes presque !

a. Rentrez sur votre navigateur internet l'adresse internet du répertoire dans lequel vous avez transféré vos fichiers PhpGedView (par exemple, http://www.votreserver.com/monnom/). Si vous êtes arrivé à atteindre cette adresse, et que l'écran de configuration de PhpGedView s'affiche, alors félicitations ! Dans la version v4 de PhpGedView l'écran de configuration apparaît ainsi :

Erreur lors de la création de la miniature : Fichier manquant
Figure 3

Les informations nécessaires sur chacune des différentes options de la configuration de PhpgedView sont accessibles en ligne en cliquant sur le point d'interrogation (?) qui apparaît à proximité de chaque rubrique.

Vous avez 2 options, comme mentionné précédemment– (i) le mode Index (v3 uniquement) (ii) le mode base de données (v3 et v4)

Pour le mode index, sélectionnez tout simplement ce mode dans la case appropriée.

Pour le mode base de données, vous devrez avoir préparé (ou on l'aura préparé pour vous) une base de données vide, avec un nom pour cette base de données, un nom d'utilisateur et un mot de passe. PhpGedView créera alors automatiquement toutes les tables de la base de données au fur et à mesure que vous suivez le processus.

(Dans la version v3, vous pouvez changer d'option plus tard, et basculer du mode index au mode base de données vice et versa. Celà est maintenant probablement passé de mode, mais il existe une description de la méthode pour basculer du mode index au mode base de données dans la rubrique ci-dessous.

b. Utilisateur administrateur (Admin): après avoir cliqué sur le bouton "sauvegarde", il vous sera demandé de créer un utilisateur qui sera administrateur et de vous connecter sous ce nom d'utilisateur.

Erreur lors de la création de la miniature : Fichier manquant
Figure 4

Vous arrivez ensuite à un écran qui vous confirme la création de l'utilisateur et vous propose de cliquer sur le lien "cliquez ici pour continuer". Cliquez ensuite sur le lien "Cliquez ici pour continuer" qui vous amènera sur l'espace de "Gestion des fichiers GEDCOMs". Dans l'espace "Gestion des fichiers GEDCOMs" vous pourrez ajouter des fichiers GEDCOMs à votre site.

Erreur lors de la création de la miniature : Fichier manquant
Figure 6

Transférez votre fichier GEDCOM sur votre site. Maintenant que vous l'avez transféré, il est prêt à être utilisé. Pour un utilisateur qui effectue ce type d'opération la première fois, il s'agit du moyen le plus facile pour transférer un fichier GEDCOM. Mais plus tard, vous verrez qu'il existe plusieurs méthodes de transfert d'un fichier GEDCOM.

Choisissez "Paramétrez un GEDCOM déjà envoyé sur le serveur", et indiquez à PhpGedView où se situe l'emplacement de ce fichier sur votre serveur. Donnez lui un titre (ce titre apparaîtra en tant qu'en-tête sur les pages de votre site.)

Erreur lors de la création de la miniature : Fichier manquant
Figure 7

c. Paramétrez le fichier GEDCOM que vous avez transféré sur votre serveur à partir de la fenêtre "Configuration GEDCOM - Paramètrer un GEDCOM déjà envoyé sur le serveur" qui se présente à vous. Il y a beaucoup trop de paramètres pour dresser ici l'inventaire de toutes les options possibles, mais pour une première utilisation, laissez les choix par défaut des paramètres qui vous sont présentés.

d. Validez le fichier GEDCOM en cliquant sur "Sauvegarder la configuration". Après avoir sauvegardé la configuration de votre fichier GEDCOM, PhpGedView validera votre fichier GEDCOM et affichera toutes les erreurs éventuelles qu'il aura trouvées. Si certaines de ces erreurs de votre fichier GEDCOM nécessitent une intervention de la part de l'utilisateur, vous serez invité à les corriger. Pour connaître la marche à suivre, utilisez l'aide en ligne ? afin d'obtenir des informations plus détaillées.

Erreur lors de la création de la miniature : Fichier manquant
Figure 8

e. Import du fichier GEDCOM: il s'agit de la dernière étape avant que ne puissiez commencer à visulaiser vos données. Une fois que vous avez validé votre fichier GEDCOM et que vous avez corrigé vos éventuelles erreurs, vous devez importer ce fichier GEDCOM dans l'entrepôt de données (cet entrepôt sera le lieu d'archivage de toutes les informations généalogiques que vous enrichirez au fur et à mesure de votre utilisation de PhpGedView). Pendant la phase d'import de votre fichier GEDCOM, vous verrez un certain nombre de statistiques sur l'écran.

Erreur lors de la création de la miniature : Fichier manquant
Figure 9

Si vous avez dépassé le temps maximum d'exécution qui est déterminé dans les nombreux paramètres de configuration du fichier GEDCOM, vous verrez affiché le message suivant: "Dépassement de la limite de temps d'exécution". Ce n'est pas grave. Il vous suffit alors de cliquer sur le bouton "Continuer" qui se trouve juste en dessous de ce message.

Erreur lors de la création de la miniature : Fichier manquant
Figure 10

Si l'import a été réalisé avec succès vous verrez le message "Import terminé". Tout est maintenant prêt et vous pouvez donc commencer à utiliser PhpGedView.

Erreur lors de la création de la miniature : Fichier manquant
Figure 11

f. Rétablir les attributs du fichier config.php

Pour des raisons de sécurité il est recommandé de rétablir les attributs du fichier config.php back à la valeur numérique 755. Cette valeur n'autorise que la seule lecture du fichier et empêchera ainsi quiconque de venir modifier votre fichier de configuration. Les permissions d'écriture de ce fichier ne seront autorisées que lorsque vous accéderez dans menu "Administration", puis dans la rubrique "Configuration".

Vous disposez maintenant d'une configuration standard de PhpGedView. Félicitations . . . . bienvenue dans l'univers de PhpGedView !

PhpGedViewpour les initiés

Cette partie du guide d'installation est faite pour les utilisateurs qui ont une certaine expérience dans l'utilisation de PhpGedView. Elle contient des informations qui vous permettront d'apprendre comment fonctionne ce logiciel, et vous donnera quelques astuces qui faciliteront la gestion de votre site.

GEDCOMs

Pour ajouter des fichiers GEDCOM au système, vous pouvez transférer votre fichier GEDCOM en utilisant l'option "Envoyer un fichier GEDCOM sur le serveur (upload)" à partie du menu Administration. Tous les fichiers GEDCOM qui sont transférés en utilisant l'option "Envoyer un fichier GEDCOM sur le serveur (upload)" sont suavegardés dans votre répertoire "index".

La plupart des hébergeurs limitent la taille des fichiers qui peuvent être transférés à partir d'une page web pour des raisons de sécurité, vous pouvez donc être contraint à utiliser une méthode manuelle (en utilisant un client FTP) pour transférer votre fichier GEDCOM. Vous pouvez aussi transférer votre fichier GEDCOM au format .ZIP, manuellement ou en utilisant l'option "Envoyer un fichier GEDCOM sur le serveur (upload)". Choisissez un nom pour votre fichier .ZIP. PhpGedView décomprimera (dézippera) automatiquement ce fichier .ZIP et utilisera le fichier GEDCOM décomprimé. Assurez-vous d'avoir bien inclus votre fichier GEDCOM dans votre fichier .ZIP.

Mettre à jour les fichiers GEDCOMs

Lorsque vous changez vos données généalogiques sans passer par PhpGedView, il n'est pas nécessaire de supprimer vos fichiers GEDCOMs à partir de PhpGedView et de recommencer le processus. Suivez ces étapes pour mettre à jour votre fichier GEDCOM que vous êtes en train d'utiliser:

a. La première étape consiste à remplacer votre ancien fichier GEDCOM sur votre site par votre nouveau fichier GEDCOM. Vous pouvez effectuer cette opération en utilisant votre logiciel FTP, ou bien en utilisant l'option "Transférez un fichier GEDCOM" à partir de la page d'administration en transférant le nouveau GEDCOM avec le même nom de fichier que l'ancien. Faites attention à l'emploi des majuscules et des minuscules quand vous nommez un fichier !

b. Ré-importez le fichier GEDCOM en allant dans Administration->Gérer les fichiers GEDCOMs->Importer GEDCOM. Le fichier GEDCOM sera à nouveau validé (testé) avant la phase d'importation.

c. Le script d'import détectera que la fichier GEDCOM a déjà été importé et vous demandera si vous voulez remplacer les anciennes données. Cliquez sur le bouton "Oui".

d. Vous verrez à nouveau affichées les statistiques d'importation et le message “Import terminé” s'affichera à la fin de l'opération.

Si vous voulez utiliser un fichier compressé (.ZIP) pour transférer votre fichier GEDCOM, vous devrez utiliser ou bien l'option "Envoyer un fichier GEDCOM sur le serveur (upload)" ou bien l'option "Paramètrer un GEDCOM déjà envoyé sur le serveur". Le fichier GEDCOM qui sera dans le fichier compressé (.ZIP) dvra avoir exactement le même nom que le fichier GEDCOM actuellement utilisé. Ainsi, les paramètres de votre fichier GEDCOM seront préservés.

Si vous aviez des objets multimedia attachés à certains individus dans votre ancienne configuration, vous devrez rétablir ces liens dans votre nouveau fichier GEDCOM. Cependant, si le fichier GEDCOM que vous avez importé contient déjà des références à des objets multimedia, ces références seront préservées et les liens seront automatiquement rétablis. PhpGedView ne réimportera pas les objets multimedia qui sont écrits dans votre fichier GEDCOM comme des données binaires; tous les objets multimedia dans ce fichier doivent faire référence à des fichiers externes.

Supprimer des fichiers GEDCOMs

Vous pouvez supprimer des fichiers GEDCOMs sur votre site à partir du menu "Portail" --> "Gérer les fichiers GEDCOMs". Supprimer un fichier GEDCOM à partir du site le supprimera de la base de données mais ne supprimera pas le fichier original que vous avez importé. Ce fichier sera toujours présent sur votre serveur dans votre répertoire d'installation de PhpGedView. Celà ne supprimera pas non plus les fichiers privés qui sont liés à ce fichier GEDCOM. Ces fichiers, qui ne sont plus utilisés par PhpGedView, sont tous situés dans le répertoire "index".