Guide d'installation
Sommaire
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”
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…”
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 :
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.
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.
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.)
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.
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.
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.
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.
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".
Objets Multimedia
Note: Si vous voulez transférer des fichiers multimedia depuis le section "Gestion des objets multimedia" du menu d'Administration, vous devez autoriser les droits d'écriture de vos répertoires ./media et ./media/thumbs. Pour ce faire, il vous faut modifier les attributs de ces répertoires à l'aide de votre client FTP en fixant leur valeur numérique à 777.
Le standard GEDCOM 5.5 supporte tous les types de fichiers multimedia. Actuellement, PhpGedView ne supporte les objets multimedia qu'en tant que fichiers externes. Les objets multimedia qui sont insérés tels quels dans un fichier GEDCOM seront ignorés. Pour bénéficier du suport des objets multimedia par PhpGedView vous devez copier les fichiers multimedia dans le répertoire media qui se trouve dans le répertoire où vous avez installé PhpGedView.
Pour le choix de l'imagequi apparaîtra sur la page d'un individu, PhpGedView choisira la première image qui a un marqueur _PRIM Y (qui signifie primary YES) dans le fichier GEDCOM. S'il n'y a pas de balise _PRIM dans la liste des objets multimedia de votre fichier GEDCOM, le premier objet multimedia trouvé par PhpGedView en lisant le fichier sera alors affiché. Vous pouvez empêcher l'affichage de toutes les photos pour une personne en particulier en mettant le marqueur _PRIM N (qui signifie primary NO) sur tous les objets multimedia de cette personne. La plupart des programmes de généalogie le feront automatiquement pour vous.
Vous pouvez trouver l'inventaire de toutes les images référencées dans votre fichier en ouvrant votre fichier GEDCOM avec un éditeur de texte et en recherchant les marqueurs (on dit aussi balises) OBJE (pour objet) ou FILE (pour files = fichiers).
PhpGedView contient un répertoire "media/thumbs" dans lequel vous pouvez placer des vignettes pour chacune de vos images afin que ces vignettes apparaissent en lieu et place de vos images dans des listes et sur d'autres pages. PhpGedView vous offre la possibilité de créer vos propres vignettes afin que vous puissiez conserver le contrôle artistique sur vos media et vous éviter l'installation d'autres logiciels spécialisés sur votre serveur. Réalisez une copie de vos images et réduisez leur taille pour obtenir des vignettes d'une taille d'environ 100 pixels de large et transférez les sur votre répertoire "media/thumbs". Conservez comme nom de fichier exactement le même que la photo originale.
Les vignettes peuvent être créées également pour des fichiers media qui ne sont pas des images. Pour le faire, créez une image de la taille d'une vignette au format gif, jpeg, png ou bmp et sauvegradez-la dans le sous-répertoire “thumbs” en lui donnant le même nom que le fichier media avec la même extension que le fichier media (même si le media n'est pas une image comme par exemple un fichier PDF ou AVI, nommez la vignette IMAGE avec l'extension PDF ou AVI).
Il existe un module Image module qui est totalement intégré à PhpGedView PGV et qui créera automatiquement des vignettes pour vous si vous utilisez ce module pour transférer vos images sur votre serveur. Ce module n'est pas inclus dans les fichiers de base de PhpGedView parce qu'il nécessite des bibliothèques externes que tous les hébergeurs n'ont pas toujours installé. Vous devriez être capable de faire fonctionner ce module en suivant les instructions ci-dessous.
Vous pouvez télécharge le module Image à l'adresse suivante: http://sourceforge.net/project/showfiles.php?group_id=55456&package_id=88140
Vous pouvez configurer PhpGedView afin qu'il reconnaisse le répertoire "media". Les sous-répertoires des images et des vignettes doivent avoir les mêmes noms que les sous-répertoires qui font référence à des fichiers media dans votre fichier GEDCOM. Par exemple, si vous avez les références des media suivants dans votre fichier GEDCOM:
C:\Pictures\Genealogy\photo.jpg C:\Pictures\Scans\scan1.jpg scan2.jpg
Avec la profondeur du répertoire media paramétrée à 1, vous devez structurer vos répertoires comme suit:
media/Genealogy/photo.jpg media/Scans/scan1.jpg media/scan2.jpg media/thumbs/Genealogy/photo.jpg media/thumbs/Scans/scan1.jpg media/thumbs/scan2.jpg
Avec la profondeur du répertoire media paramétrée à 2, vous devez structurer vos répertoires comme suit:
media/Pictures/Genealogy/photo.jpg media/Pictures/Scans/scan1.jpg media/scan2.jpg media/thumbs/Pictures/Genealogy/photo.jpg media/thumbs/Pictures/Scans/scan1.jpg media/thumbs/scan2.jpg
Sécurité et bonnes pratiques
Bien que PhpGedView vous offre la possibilité de masquer les détails des personnes encore en vie, à chaque fois que vous postez les détails personnels d'une personne vivante sur Internet, vous devriez d'abord obtenir la permission de CHAQUE personne vivante sur laquelle vous transmettez des détails privés. Il y a beaucoup de gens qui ne veulent pas avoir leur nom lié à leur histoire familiale rendue publique sur Internet et leurs souhaits doivent être respectés. La plupart des programmes de généalogie vous offrent la possibilité de choisir les personnes qui sont exportées quand vous créez un fichier GEDCOM. L'option la plus sécurisée est d'ôter toutes les personnes vivantes de votre programme de généalogie lorsque vous exportez vos données généalogiques sur un fichier GEDCOM.
Si vous voulez protéger votre fichier GEDCOM d'un téléchargement éventuel sur Internet vous devez placer ce fichier dans le répertoire racine de votre serveur et paramétrer la valeur de la variable $GEDCOM pour qu'elle pointe sur cet emplacement. Par exemple, si votre répertoire de travail est quelque chose comme "/home/nom_utilisateur" et si le répertoire racine de votre site web est "/home/nom_utilisateur/public_html" et si vous avez installé PhpGedView dans le répertoire "public_html/phpGedView" alors vous devez placer votre fichier GEDCOM dans votre répertoire de travail au même niveau que votre répertoire "public_html". Vous devez alors paramétrez le chemin du fichier GEDCOM comme suit "/home/nom_utilisateur/GEDCOM.ged" en éditant la configuration du fichier GEDCOM.
Vous pouvez aussi paramétrez manuellement l'emplacement en modifiant la ligne "path" dans le fichier "index/gedcoms.php":
$gedarray["path"] = "../../GEDCOM.ged";
ou
$gedarray["path"] = "/home/username/GEDCOM.ged";
Puisque votre fichier GEDCOM se situe dans un répertoire extérieur au répertoire racine de votre serveur, votre serveur web ne remplira pas les conditions nécessaires pour le télécharger. Cependant, PhpGedView sera encore capable de lire et afficher son contenu.
Enfin, il est de votre responsabilité de garantir de garantir qu'il n'y a pas de violation de la vie privée d'un individu. Vous pourriez être tenu pour responsable si vous rendez publiques des informations privées sur le site web dont vous êtes l'administrateur.
Pour plus d'information sur les options de PhpGedView relatives à la vie privée, vous pouvez consulter cette page (en anglais): http://www.phpGedView.net/privacy.php
Préserver la bande passante
Les pages générées par PhpGedView peuvent être importantes et utiliser beaucoup de bande passante. La compression des données (en utilisant Gzip) entre le serveur web et le navigateur internet peut réduire la bande passante nécessaire jusqu'à 90% (habituellement 80% - 90% suite aux tests qui ont réalisés avec PhpGedView). Si votre serveur web est Apache, le configurer est très facile. Ajoutez les 2 lignes suivantes à votre fichier php.ini:
php_flag zlib.output_compression On php_value zlib.output_compression_level 5
Si vous n'avez pas accès au fichier php.ini (ce qui est le cas quand vous faîtes appel à un hébregement mutualisé chez un hébergeur web), créez un fichier vierge que vous nommerez .htaccess (sans oublier le point) et mettez ces lignes dans ce fichier (ou ajoutez-les à votre fichier .htaccess si vous avez déjà un tel fichier et transférez ce fichier dans votre répertoire PhpGedView. Vous devz vérifier si cet ajout est accepté par votre hébergeur internet.
Note: si votre hébergeur utilise mod_gzip ou bien une autre méthode de compression, l'utilisation de cette technique peut causer des problèmes. La compression n'aura aucun effet sur les navigateurs qui ne la supportent pas. Vous pouvez tester les effets de cette compression en vous connectant à cett adresse http://leknor.com/code/gziped.php
Fils RSS
PGV contient maintenant un fil RSS. RSS est un format XML qui permet à d'autres sites d'obtenir des informations et des données diverses de votre site. Le langage utilisé est le langage par défaut de votre site. Le langage du feed peut être changé vers n'importe quel langage supporté par PhpGedView en modifiant l'adresse URL que votre aggrégateur RSS utilise en modifiant la valeur par défaut /phpGedView/rss.php en /phpGedView/rss.php?lang=french (si vous voulez basculer en français).
Actuellement, seul le site GEDCOM supporte les fils RSS. D'autres options disponibles dans le fil RSS sont la possibilité de spécifier le type de feed via le paramètre rssStyle. Par défaut, PhpGedView a mis ce paramètre à "RSS1.0". Il est possible de modifier le type de feed dans l'un des types suivants: "PIE0.1", "mbox","RSS0.91", "RSS1.0", "RSS2.0", "OPML", "ATOM0.3", "HTML", "JS".
Par exemple, en appelant /phpGedView/rss.php?rssStyle=HTML vous créerez des sorties HTML qui pourront être incluses dans une autre page via un iFrame. L'option JS permettra à JavaScript d'être inclus dans une autre page sans utiliser un iFrame.
Vous pouvez aussi spécifier un module que vous voulez en sortie (seulement 1 module) de telle sorte que seul ce module sera en sortie. Cette opération peut être réalisée via le paramètre module. Par exemple, /phpGedView/rss.php?module=gedcomStats placera en sortie le seul bloc GEDCOM Stats.
Ces paramètres peuvent être enchainés de telle sorte que /phpGedView/rss.php?lang=hebrew&module=gedcomStats&rssStyle=HTML placera en sortie le module GEDCOM Stats en hébreu et en HTML.
PhpGedView pour les utilisateurs avancés
Tables de la base de données pour la version v4
PhpGedView utilise une structure très simple pour les tables de sa base de données parce que ce logiciel travaille principalement à partir des informations du fichier GEDCOM et n'utilise la base de données que pour rechercher et rapatrier ces données. Il existe 17 tables dans la base de données de la version v4, et cette note suppose l'utilisation du préfixe “pgv_” pour le nom de chacune des tables de données (ce préfixe est proposé par défaut lors de l'installation de PhpGedView):
| pgv_blocks | Description de la page "Mon portail" de chaque utilisateur |
| pgv_dates | Archive les information de dates à partir des enregistrements du fichier GEDCOM |
| pgv_families | Toutes les familles présentes dans le fichier GEDCOM |
| pgv_favorites | Archive les favoris des différents utilisateurs |
| pgv_individuals | Tous les individus présents dans le fichier GEDCOM |
| pgv_media | Tous les objets multimedia présents dans le fichier GEDCOM |
| pgv_media_mapping | Relations entre les individus et les objets multimedia |
| pgv_messages | Messages des utilisateurs (envoyés et reçus) |
| pgv_names | Archive les information de noms à partir des enregistrements du fichier GEDCOM |
| pgv_news | Archive les nouvelles qui apparaissent sur les pages "Mon Portail" et "Accueil" |
| pgv_placelinks | Relations entre les lieux et les individus et les familles |
| pgv_places | Hiérarchie des lieux |
| pgv_remotelinks | |
| pgv_other | Tous les autres enregistrements du fichier GEDCOM de niveau 0 (i.e., archives, objets multimedia, notes, etc.) |
| pgv_sources | Toutes les sources dans le fichier GEDCOM |
| pgv_users | Table pour les données de l'utilisateur (N'existe que si le module d'authentification MySQL par défaut est utilisé) |
| pgv_next_id |
Les tables sont toutes très semblables. Elles ont toutes un champ pour le GEDCOM ID, qui indique de quel fichier GEDCOM l'enregistrement est issu, quelques champs pour des choses tels que le rapatriement rapide des informations de noms, et un champ pour les enregistrements de données brutes dans le fichier GEDCOM.
Une description plus détaillée de chacune des tables apparait ci-dessous:
| b_id INT(11) | Enregistrement ID |
| b_username VARCHAR(100) | Nom de l'utilisateur auquel le bloc appartient |
| b_location VARCHAR(30) | Emplacement du bloc - colonne principale ou colonne de droite |
| b_order INT(11) | Position du bloc dans la colonne |
| b_name VARCHAR(255) | Nom du bloc |
| b_config TEXT | Paramètres de configuration pour ce bloc |
| d_day INT(11) | Le jour du mois pour cette date |
| d_month VARCHAR(5) | L'abréviation en 3 lettres du mois de l'année |
| d_mon INT(11) | Entier entre 1 et 12 pour le mois de l'année |
| d_year INT(11) | L'année pour cette date |
| d_datestamp INT(11) | Une date au format AAAAMMJJ utilisé pour des faire des comparaisons simples |
| d_fact VARCHAR(10) | L'événement auquel est associé cette date |
| d_gid VARCHAR(255) | Le GEDCOM XREF ID où cet événement et cette date ont été trouvés |
| d_file INT(11) | L'id du fichier GEDCOM où cet événement a été trouvé |
| d_type VARCHAR(13) | Utilisé si cette date utilise un autre type de calendrier |
| f_id VARCHAR(255) | ID de la famille dans le fichier GEDCOM |
| f_file INT | ID du fichier GEDCOM dont est issu l'enregistrement |
| f_husb VARCHAR(255) | ID du mari |
| f_wife VARCHAR(255) | ID de la femme |
| f_chil TEXT | Liste des IDs des enfants, délimitée par des (;) |
| f_GEDCOM TEXT | Enregistrement GEDCOM brut (texte) pour cette famille |
| f_numchil INT | Nombre d'enfants dans cette famille |
| fv_id INT(11) | ID de l'enregistrement |
| fv_username VARCHAR(30) | Nom de l'utilisateur auquel appartient le favori |
| fv_gid VARCHAR(10) | ID du favori |
| fv_type VARCHAR(10) | Type du favori (actuellement seulement INDI) |
| fv_file VARCHAR(100) | Fichier auquel appartient ce favori |
| fv_url VARCHAR(255) | L'URL du favori si ce favori ne fait pas partie des favoris types |
| fv_title VARCHAR(255) | Un titre pour les favoris de type URL |
| fv_note TEXT | Information optionnelle descriptive de ce favori |
| i_id VARCHAR(255) | ID de l'individu du GEDCOM |
| i_file INT | ID qui représente le numéro du fichier GEDCOM dont est issu l'enregistrement |
| i_rin VARCHAR(30) | Numéro RIN de l'individu |
| i_name VARCHAR(255) | Nom de la personne pris dans la première ligne 1 NAME du fichier GEDCOM qui est au format nom |
| i_isdead INT(1) | Statut Vivant/Décédé de l'individu -1:non calculé 0:en vie 1:décédé |
| i_GEDCOM TEXT | Enregistrement brut (texte) GEDCOM pour cet individu |
| i_letter VARCHAR(5) | Première lettre du nom de l'individu |
| i_surname VARCHAR(100) | Surnom de la personne |
| m_id INT(11) | ID de l'objet multimedia |
| m_media VARCHAR(15) | Numéro de référence de l'objet multimedia |
| m_ext VARCHAR(6) | Type de fichier multimedia (par ex jpg) |
| m_titl VARCHAR(255) | Titre de l'objet multimedia |
| m_file (VARCHAR(255) | Nom du fichier multimedia (par ex media/belle maman.jpg) |
| m_gedfile INT(11) | |
| m_gedrec TEXT | Enregistrement GEDCOM brut pour ce media |
| mm_id INT(11) | ID de l'objet multimedia |
| mm_media VARCHAR(15) | Numéro de référence de l'objet multimedia |
| mm_gid VARCHAR(15) | Rattaché à l'invidu Ixxx |
| mm_order INT(11) | Séquence |
| mm_gedfile INT(11) | Fichier GEDCOM auquel appartient ce media |
| mm_gedrec TEXT | Enregistrement GEDCOM brut pour ce media |
| m_id INT(11) | Enregistrement ID |
| m_from VARCHAR(255) | Nom ou adresse email de l'émetteur |
| m_to VARCHAR(30) | Nom d'utilisateur du destinataire |
| m_subject VARCHAR(255) | Objet du message |
| m_body TEXT | Corps du texte du message |
| m_created VARCHAR(255) | Heure de création du message |
| n_gid VARCHAR(255) | ID de l'individu qui correspond au nom |
| n_file INT(11) | Numéro ID du fichier GEDCOM dont provient l'enregistrement |
| n_name VARCHAR(255) | Nom dans le format GEDCOM, avec / / pour le surnom |
| n_letter VARCHAR(5) | Première lettre du surnom |
| n_surname VARCHAR(100) | Surnom pour l'enregistrement du nom |
| n_type VARCHAR(10) | Type du nom, P=principal, A=additionel, C=calculé |
| n_id INT(11) | Identifiant unique |
| n_username VARCHAR(100) | Nom de l'utilisateur ou du GEDCOM auquel appartient la nouvelle |
| n_date INT(11) | Heure de la dernière mise à jour |
| n_title VARCHAR(255) | Titre de l'article |
| n_text TEXT | Corps du texte de l'article |
| ni_id INT(11) | |
| ni_type VARCHAR(30) | |
| ni_gedfile INT(11) |
| o_id VARCHAR(255) | GEDCOM enregistrement ID |
| o_file INT(11) | ID numéro du fichier GEDCOM dont est issu l'enregistrement |
| o_type VARCHAR(20) | Type de l'enregistrement GEDCOM (REPO, ADDR, NOTE, OBJE, etc) |
| o_GEDCOM TEXT | Enregistrement GEDCOM brut pour cet item |
| pl_p_id INT(11) | Identifiant unique |
| pl_gid VARCHAR(30) | ID de l'individu ou de la famille qui fait référence à ce lieu |
| pl_file INT(11) | ID numéro du fichier GEDCOM dont est issu l'enregistrement |
| p_id INT(11) | Identifiant unique |
| p_place VARCHAR(150) | Nom du lieu |
| p_level INT(11) | Niveau du lieu dans la hiérarchie des lieux, 0 correspond au pays, 1 correspond à la région,... |
| p_parent_id INT(11) | ID des lieux "parentes" des items dans la hiérarchie des lieux. Le lieu parent d'une ville est le département dans lequel se situe la ville, le lieu parent d'un département est la région dans laquelle se situe le département, et une région a un pays pour parent. |
| p_file INT(11) | ID numéro du fichier GEDCOM dont est issu l'enregistrement |
| r_gid VARCHAR(255) | |
| r_linkid VARCHAR(255) | |
| r_file INT(11) |
| s_id VARCHAR(255) | ID de la source du fichier GEDCOM |
| s_file INT(11) | Numéro ID du fichier GEDCOM dont l'enregistrement est issu |
| s_name VARCHAR(255) | Titre abrégé de la source |
| s_GEDCOM TEXT | Enregistrement GEDCOM brut de cette source |
| u_username VARCHAR(30) | Nom d'utilisateur |
| u_password VARCHAR(255) | Mot de passe crypté |
| u_fullname VARCHAR(255) | Nom complet de l'utilisateur |
| u_GEDCOMid TEXT | Série représentant les IDs du fichier GEDCOM pour cet utilisateur |
| u_rootid TEXT | Série représentant les IDs racine pour cet utilisateur |
| u_canadmin ENUM('Y','N') | Est-ce que l'utilisateur est administrateur ou non ? |
| u_canedit TEXT | Série représentant les privilèges d'édition qu'un utilisateur a pour chaque fichier GEDCOM |
| u_email TEXT | Adresse email |
| u_verified VARCHAR(20) | Utilisateur auto vérifié |
| u_verified_by_admin VARCHAR(20) | L'utilisateur a été vérifié par l'administrateur |
| u_language VARCHAR(50) | Langage préféré de l'utilisateur |
| u_pwrequested VARCHAR(20) | L'utilisateur a demandé un nouveau mot de passe |
| u_reg_timestamp VARCHAR(50) | Heure de l'enregistrement |
| u_reg_hashcode VARCHAR(255) | Clé d'auto-enregistrement |
| u_theme VARCHAR(50) | Thème préféré de l'utilisateur |
| u_loggedin ENUM('Y','N') | Etat de connection de l'utilisateur |
| u_sessiontime INT(14) | Heure de la dernière connexion de l'utilisateur |
| u_contactmethod VARCHAR(20) | Méthode de contact préférée de l'utilisateur |
| u_visibleonline ENUM('Y','N') | Indique si l'utilisateur est visible ou non dans le bloc "utilisateurs connectés" |
| u_editaccount ENUM('Y', 'N') | Indique si l'utilisateur peut éditer ses informations de compte |
| u_defaulttab INT(10) | tab par défaut sur le portail de cet utilisateur |
| u_comment VARCHAR(255) | Commentaires de l'administrateur sur cet utilisateur |
| u_comment_exp VARCHAR(20) | Date d'alerte pour l'administrateur, par exemple pour les comptes temporaires. |
| u_sync_gedcom VARCHAR(2) | Si l'utilisateur a un enregistrement ID dans le GEDCOM, alors une parti des données de l'utilisateur (nom, email) doivent être synchronisée avec les données du GEDCOM. |
| u_relationship_privacy VARCHAR(2) | Si l'utilisateur doit avoir accès aux détails privés des proches |
| u_max_relation_length INT | Le degré maximum de parenté des personnes pour lesquelles l'utilisateur a accès |
| u_auto_accept VARCHAR(2) | Si les changements effectués par l'utilisateur sont automatiquement acceptés dans la base de données |
la structure de cette table a reçu des critiques de certains pour sa simplicité, sa taille, et parce qu'elle ne suit pas un modèle de génalogie tel que GENTECH. Nous reconnaissons que ces tables peuvent être difficiles à interfacer parce que le code doit pouvoir interpréter le fichier GEDCOM afin d'en sortir les données. Nous reconnaissons aussi que le fait d'enregistrer les données GEDCOM brutes (texte) peut avoir pour conséquence d'avoir des tables de dimensions importantes.
Heureusement, le standard GEDCOM n'est pas un format très compliqué; il n'exige que 6 caractères par ligne, ce qui est très bien en comparaison avec quelque chose comme XML. Cependant, il y a des raisons irréfutables qui expliquent le choix de cette structure de table:
- Des tables plus simples signifient des requêtes moins nombreuses et plus simples vers les bases de données. Celà diminue la charge de calcul des bases de données et rend le programme plus rapide.
- Rien n'est perdu lors de l'import. Bien que GEDCOM soit un standard, chaque programme de généalogie interprète le standard un peu différemment et ajoute ses propres balises (tags). Créer un modèle de base de données qui se conforme à toutes les sorties des différents programmes de généalogie est très difficile.
Configuration manuelle
Les utilisateurs expérimentés qui comprennet le language PHP peuvent vouloir configurer manuellement le programme en éditant le fichier configuration config.php. Quand vous avez fini d'éditer config.php assurez-vous que la variable $CONFIGURED=true; ceci afin que le programme n'essaie pas de vous diriger vers le script configuration.php comme lorsque vous lancez le programme pour la première fois.
Vous pouvez ajouter manuellement des fichiers GEDCOMS au système en les ajoutant dans le tableau $GEDCOMS dans le fichier index/GEDCOMs.php. Le tableau GEDCOM ressemble à ceci:
$gedarray = array(); $gedarray["GEDCOM"] = "surname.ged"; $gedarray["config"] = "./index/surname.ged_conf.php"; $gedarray["privacy"] = "./index/surname.ged_priv.php"; $gedarray["title"] = "Surname Genealogy"; $gedarray["path"] = "./surname.ged"; $GEDCOMS["surname.ged"] = $gedarray;
"surname" ci-dessus peut être n'importe quoi, par exemple, "jean" ou "privé". Vous devez faire attention si vous entrez des majuscules ou des minuscules car PhpGedView fait la différence.
Chaque fichier GEDCOM a besoin d'un fichier de configuration. Vous pouvez copier le fichier config_gedcom.php qui a toutes les valeurs par défaut pour chacun des fichiers GEDCOM que vous ajoutez manuellement. Puis paramétrez la partie "config" du tableau GEDCOMs pour pointer sur le fichier que vous avez copié.
Chaque fichier GEDCOM a besoin aussi d'un fichier de confidentialité. Faites une copie du fichier privacy.php pour chaque fichier GEDCOM et paramétrez la partie "privacy" du tableau GEDCOMs à l'emplacement du nouveau fichier privacy.php.
Thèmes
PhpGedView utilise une architecture qui s'appuie sur des thèmes afin de vous offrir une plus garnde flexibilité sur l'apparence du site. Le répertoire "themes" contient les thèmes standards qui sont livrés avec le paquet logiciel PhpGedView. Vous pouvez adapter chacun de ces thèmes à votre convenance ou bien créer votre propre thème en copiant l'un des thèmes standards dans un nouveau répertoire et en le modifiant. Quand vous configurez PhpGedView, vous devez lui indiquer d'aller chercher votre nouveau thème dans votre nouveau répertoire de thèmes.
Un répertoire de thème doit contenir au moins les 8 fichiers suivants:
| footer.html | PHP/HTML pour le bas de chaque page |
| header.html | PHP/HTML pour le haut de chaque page |
| print_footer.html | PHP/HTML pour le bas de chaque page en mode "impression" |
| print_header.html | PHP/HTML pour le haut de chaque page en mode "impression" |
| style.css | Une feuille de style CSS qui contient tous les styles |
| sublinks.html | PHP/HTML pour imprimer les liens vers d'autres emplacements |
| theme.php | Les variables PHP liées au design que vous pouvez modifier |
| toplinks.html | PHP/HTML qui apparait juste en dessous du header.html |
Vous pouvez consulter le guide suivant pour apprendre comment construire votre propre thème personnalisé PhpGedView (pour l'instant, en anglais): http://www.phpGedView.net/styleguide.php
Si vous aimez vraiment un thème que vous avez conçu et que vous voulez l'inclure dans le projet, vous pouvez envoyer les fichiers de votre thème aux développeurs à yalnifj@users.sourceforge.net.
Codes GEDCOM non standards
Le standard GEDCOM 5.5 a défini une série de codes. Une partie des standard permet aux logiciels de généalogie de définir leurs propres codes, et demandent qu'ils commencent par un « underscore » "_" .
Quand PhpGedView arrive sur une balise qui n'est pas définie, il affiche un message d'erreur. Vous pouvez supprimer l'affichage de ces messages d'erreur en paramétrant $HIDE_GEDCOM_ERRORS=true dans le fichier config_gedcom.php. PhpGedView peut aussi être modifié pour travailler avec ces codes en les ajoutant aux tableaux des événements dans un nouveau fichier dénommé "facts.en.extra.php". Si vous l'ajoutez au fichier des événements en anglais, vous devez aussi l'ajouter aux fichiers des événements pour les langues que vous utilisez sur votre site si vous voulez que les autres languages traduisent correctement la balise.
Le format d'un fichier des événements est une série PHP associative. Chaque balise nécessite une ligne dans le tableau. La ligne suivante définit le label "Abréviation" pour la balise ABBR GEDCOM.
$factarray["ABBR"] = "Abréviation";
A titre d'exemple, si vous utilisez un programme de généalogie qui génère la balise "_ZZZZ" vous pouvez modifier PhpGedView pour qu'il accepte ce code en ajoutant les lignes suivantes au fichier « facts.en.extra.php »:
<?php $factarray["_ZZZZ"] = "Les balises se placent ici"; ?>
Vous pouvez annihiler les messages d'erreurs dans le fichier config.php en paramétrant $HIDE_GEDCOM_ERRORS=true.
