PGVWiki - Contributions de l’utilisateur [fr]

Comment modifier un thème

2007-09-02T13:24:45Z

Papagolf : /* Changer le thème */

autres possibilités de personnalisation des thèmes, aussi n'hésitez pas à écrire vos bonnes idées ici même en ajoutant votre propre contribution.

==Outils==
Vous aurez besoin d'un bon éditeur de texte, n'utilisez pas Notepad qui laisse des caractères aléatoires dans vos scripts qui peuvent être gênants. Il y a quelques bons éditeurs de texte gratuits tels que Notepad2, [http://notepad-plus.sourceforge.net/fr/site.htm Notepad++] et Crimson Editor qui créeront du code propre. Pour ceux qui utilisent Linux, Kedit, Kwrite (sous environnement KDE) , ou Gedit (sous environnement Gnome) sont parfaits. EditPlus est très bien et utilise peu de ressources système, mais il n'est pas gratuit.

Si vous avez un éditeur HTML WYSIWYG, il peut également convenir, mais n'est pas vraiment nécessaire à moins que vous ne désiriez réécrire la page entière. NVU et Bluefish sont d'excellents éditeurs HTML libre. Si vous avez Dreamweaver (qui est payant) c'est bien évidemment parfait !

Dans les faits vous n'aurez besoin que d'ouvrir la page web dans votre navigateur. Firefox est parfait pour celà parce qu'il dispose de fonctionnalités supplémentaires dans le menu qui apparait lorsque vous faites un clic droit, telles que par exemple la fonction de visualisation de l'image d'arrière plan. Cette fonctionnalité vous indique ainsi quelle est l'image que vous voyez à l'écran et où vous pouvez la trouver.

Vérifiez toujours le résultat de votre travail en utilisant Internet Explorer si vous utilisez Firefox parce que quelques détails peuvent apparaitre de manière différente selon que vous utilisiez l'un ou l'autre de ces navigateurs. Il est par exemple très utile de conserver ces deux navigateurs ouverts en permanence et de rafraichir leur affichage afin d'avoir en permanence un oeil sur le résultat de l'affichage de votre travail dans chacun de ces navigateurs.

Pour modifier les couleurs d'un thème, je vous recommande un utilitaire gratuit très utile: [http://pourpre.com/colorbox/index.php La boite à couleurs].
Ce logiciel écrit pour Windows par Benjamin Chartier permet de sélectionner avec une pipette n’importe quelle couleur présente sur l’écran. Il donne alors le code hexadécimal exact de la couleur sélectionnée et vous permet de modifier cette couleur en agissant sur la balance rouge / vert / bleu et sur la teinte / luminosité / saturation.

==Etapes==
===Gestion des fichiers===
La première étape consiste à copier et renommer le thème que vous voulez modifier afin que vous puissiez travailler sur ce nouveau thème. L'exemple détaillé ici utilise le thème Xenea qui se trouve dans le répertoire '''themes/xenea''' du répertoire dans lequel vous avez installé PhpGedView, mais cet exemple s'applique à l'identique pour tous les autres thèmes qui existent dans PhpGedView.

Tous les fichiers dont avez besoin se trouvent dans le répertoire '''themes''' de votre répertoire PhpGedView. Ces fichiers sont les suivants: ''header.html'', ''toplinks.html'', ''style.css'' et ''theme.php''.
Le fichier ''header.html'' contient l'ensemble des informations de mise en forme de l'en-tête des pages du site.
Le fichier ''toplinks.html'' contient l'ensemble des informations qui permettent d'afficher les icônes et les liens présents sur les différentes pages.
Le fichier ''style.css'' contient l'ensemble des règles de style des différentes pages du site.
Le fichier ''theme.php'' est le fichier qui contient les informations générales relatives au thème.

Copiez le répertoire ''themes/xenea'' dans un autre répertoire et donnez lui un nouveau nom qui vous convienne, par exemple : ''themes/xenea_gris'', n'utilisez aucun espace dans le nom, utilisez plutôt des underscores _ à la place. En effet, les serveurs n'aiment pas les espaces dans les noms de répertoires. Après avoir renommé le nom du répertoire ''themes/xenea'' en ''themes/xenea_gris''' vous trouverez à l'intérieur de ce répertoire le fichier theme.php que devrez modifier.
Si vous ouvrez le fichier theme.php dans votre éditeur de texte, vous devriez trouver ceci aux environs de la ligne 27:

$theme_name = "Xenea"; //-- the name of this theme (le nom du thème)

Changez cette ligne par la ligne suivante:

$theme_name = "Xenea_Gris";

ou donnez lui le nom que vous voulez.
De même à la ligne 37, vous verrez apparaître ce code:

$PGV_IMAGE_DIR = "themes/xenea/images"; //-- directory to look for images

Ce code indique l'endroit où se trouvent les images utilisées par le thème Xenea. Comme vous êtes en train de fabriquer un nouveau thème "Xenea_Gris", vos images seront dans le nouveau répertoire ''themes/xenea_gris''. Il faut donc changer cette ligne par la ligne suivante:

$PGV_IMAGE_DIR = "themes/xenea_gris/images"; //-- répertoire dans lequel se situent les images utilisées par le thème xenea_gris

Ensuite, copiez le répertoire ainsi modifié dans le répertoire ''themes'' de PhpGedView, puis allez sur la page d'administration de votre site, et choisissez ce thème par défaut pour votre site.

Vous pouvez alors visualiser en direct ce thème que vous allez modifier et voir ainsi les conséquences des modifications que vous allez lui apporter en rafraichissant votre navigateur à chaque fois que vous modifiez votre thème.

===Changer le thème===
Maintenant, ouvrez le programme '''La boite à couleurs''' sur votre page web et trouvez le code hexadécimal des couleurs de la partie de la page que vous voulez modifier. Placez simplement votre curseur sur la partie de la page que vous voulez modifier, et lisez le code à 6 caractères que vous affiche La boite à couleurs. Ce code ressemble à quelque chose comme #FFFFFF, qui correspond au code de la couleur blanche. Ce code est en fait une combinaison de chiffres et de lettres.

Ensuite, cherchez dans les quatre fichiers qui sont présents dans votre répertoire themes/xenea_gris et qui sont mentionnés plus haut (''header.html'', ''toplinks.html'', ''style.css'' et ''theme.php'') les lignes sur lesquelles apparaissent ce code hexadécimal. Utilisez l'option "rechercher et remplacer" de votre éditeur de texte pour remplacer le code hexadécimal de la couleur que vous voulez changer par le nouveau code, ainsi vous n'aurez qu'à taper votre nouveau code une seule fois pour qu'il soit remplacé dans la totalité du fichier. N'effectuez pas le remplacement automatique, remplacez chaque ligne proposée l'une après l'autre. A chaque fois que vous remplacez une ligne, sauvegardez le fichier, rafraichissez votre navigateur et regardez le résultat obtenu. Si vous n'aimez pas le changement effectué ou si vous avez fait une erreur, vous n'avez qu'à cliquer sur "annuler" dans le menu de votre éditeur de texte afin qu'il annule votre dernière modification, puis sauvegarder votre fichier, rafraichir votre navigateur, et votre thème retrouvera son aspect précédent.

Vous pouvez aussi changer des graphiques ou des images, ou placer des commentaires dans le script afin que ces commentaires ne se voient pas à l'écran. Il est recommandé de placer un ''underscore'' au début du nom de l'image afin que vous puissiez la réutiliser éventuellement plus tard si vous changez d'avis. Il y a des couleurs d'arrière-plan qui sont définies dans les quatre fichiers mentionnés plus haut: ces couleurs d'arrière plan s'appellent "background". Il suffit de modifier le code hexadécimal qui apparait juste derrière ce terme.

Vous pouvez maintenant changer à loisir les couleurs des différents thèmes de PhpGedView, et si le résultat ne vous plait pas ou si vous vous trompez, ne vous inquiétez pas, il vous suffit de supprimer le répertoire que vous avez créé et de recommencer. PhpGedView utilisera le thème par défaut s'il n'en trouve pas d'autre. Si par erreur vous veniez à supprimer ce thème par défaut, il vous suffit de le recopier à partir du fichier zippé que vous avez téléchargé et de le réinstaller.

[[en:How to modify your theme]]

Comment modifier un thème

2007-09-02T13:23:51Z

Papagolf : /* Changer le thème */

autres possibilités de personnalisation des thèmes, aussi n'hésitez pas à écrire vos bonnes idées ici même en ajoutant votre propre contribution.

==Outils==
Vous aurez besoin d'un bon éditeur de texte, n'utilisez pas Notepad qui laisse des caractères aléatoires dans vos scripts qui peuvent être gênants. Il y a quelques bons éditeurs de texte gratuits tels que Notepad2, [http://notepad-plus.sourceforge.net/fr/site.htm Notepad++] et Crimson Editor qui créeront du code propre. Pour ceux qui utilisent Linux, Kedit, Kwrite (sous environnement KDE) , ou Gedit (sous environnement Gnome) sont parfaits. EditPlus est très bien et utilise peu de ressources système, mais il n'est pas gratuit.

Si vous avez un éditeur HTML WYSIWYG, il peut également convenir, mais n'est pas vraiment nécessaire à moins que vous ne désiriez réécrire la page entière. NVU et Bluefish sont d'excellents éditeurs HTML libre. Si vous avez Dreamweaver (qui est payant) c'est bien évidemment parfait !

Dans les faits vous n'aurez besoin que d'ouvrir la page web dans votre navigateur. Firefox est parfait pour celà parce qu'il dispose de fonctionnalités supplémentaires dans le menu qui apparait lorsque vous faites un clic droit, telles que par exemple la fonction de visualisation de l'image d'arrière plan. Cette fonctionnalité vous indique ainsi quelle est l'image que vous voyez à l'écran et où vous pouvez la trouver.

Vérifiez toujours le résultat de votre travail en utilisant Internet Explorer si vous utilisez Firefox parce que quelques détails peuvent apparaitre de manière différente selon que vous utilisiez l'un ou l'autre de ces navigateurs. Il est par exemple très utile de conserver ces deux navigateurs ouverts en permanence et de rafraichir leur affichage afin d'avoir en permanence un oeil sur le résultat de l'affichage de votre travail dans chacun de ces navigateurs.

Pour modifier les couleurs d'un thème, je vous recommande un utilitaire gratuit très utile: [http://pourpre.com/colorbox/index.php La boite à couleurs].
Ce logiciel écrit pour Windows par Benjamin Chartier permet de sélectionner avec une pipette n’importe quelle couleur présente sur l’écran. Il donne alors le code hexadécimal exact de la couleur sélectionnée et vous permet de modifier cette couleur en agissant sur la balance rouge / vert / bleu et sur la teinte / luminosité / saturation.

==Etapes==
===Gestion des fichiers===
La première étape consiste à copier et renommer le thème que vous voulez modifier afin que vous puissiez travailler sur ce nouveau thème. L'exemple détaillé ici utilise le thème Xenea qui se trouve dans le répertoire '''themes/xenea''' du répertoire dans lequel vous avez installé PhpGedView, mais cet exemple s'applique à l'identique pour tous les autres thèmes qui existent dans PhpGedView.

Tous les fichiers dont avez besoin se trouvent dans le répertoire '''themes''' de votre répertoire PhpGedView. Ces fichiers sont les suivants: ''header.html'', ''toplinks.html'', ''style.css'' et ''theme.php''.
Le fichier ''header.html'' contient l'ensemble des informations de mise en forme de l'en-tête des pages du site.
Le fichier ''toplinks.html'' contient l'ensemble des informations qui permettent d'afficher les icônes et les liens présents sur les différentes pages.
Le fichier ''style.css'' contient l'ensemble des règles de style des différentes pages du site.
Le fichier ''theme.php'' est le fichier qui contient les informations générales relatives au thème.

Copiez le répertoire ''themes/xenea'' dans un autre répertoire et donnez lui un nouveau nom qui vous convienne, par exemple : ''themes/xenea_gris'', n'utilisez aucun espace dans le nom, utilisez plutôt des underscores _ à la place. En effet, les serveurs n'aiment pas les espaces dans les noms de répertoires. Après avoir renommé le nom du répertoire ''themes/xenea'' en ''themes/xenea_gris''' vous trouverez à l'intérieur de ce répertoire le fichier theme.php que devrez modifier.
Si vous ouvrez le fichier theme.php dans votre éditeur de texte, vous devriez trouver ceci aux environs de la ligne 27:

$theme_name = "Xenea"; //-- the name of this theme (le nom du thème)

Changez cette ligne par la ligne suivante:

$theme_name = "Xenea_Gris";

ou donnez lui le nom que vous voulez.
De même à la ligne 37, vous verrez apparaître ce code:

$PGV_IMAGE_DIR = "themes/xenea/images"; //-- directory to look for images

Ce code indique l'endroit où se trouvent les images utilisées par le thème Xenea. Comme vous êtes en train de fabriquer un nouveau thème "Xenea_Gris", vos images seront dans le nouveau répertoire ''themes/xenea_gris''. Il faut donc changer cette ligne par la ligne suivante:

$PGV_IMAGE_DIR = "themes/xenea_gris/images"; //-- répertoire dans lequel se situent les images utilisées par le thème xenea_gris

Ensuite, copiez le répertoire ainsi modifié dans le répertoire ''themes'' de PhpGedView, puis allez sur la page d'administration de votre site, et choisissez ce thème par défaut pour votre site.

Vous pouvez alors visualiser en direct ce thème que vous allez modifier et voir ainsi les conséquences des modifications que vous allez lui apporter en rafraichissant votre navigateur à chaque fois que vous modifiez votre thème.

===Changer le thème===
Maintenant, ouvrez le programme '''La boite à couleurs''' sur votre page web et trouvez le code hexadécimal des couleurs de la partie de la page que vous voulez modifier. Placez simplement votre curseur sur la partie de la page que vous voulez modifier, et lisez le code à 6 caractères que vous affiche La boite à couleurs. Ce code ressemble à quelque chose comme #FFFFFF, qui correspond au code de la couleur blanche. Ce code est en fait une combinaison de chiffres et de lettres.

Ensuite, cherchez dans les quatre fichiers qui sont présents dans votre répertoire themes/xenea_gris et qui sont mentionnés plus haut (''header.html'', ''toplinks.html'', ''style.css'' et ''theme.php'') les lignes sur lesquelles apparaissent ce code hexadécimal. Utilisez l'option "rechercher et remplacer" de votre éditeur de texte pour remplacer le code hexadécimal de la couleur que vous voulez changer par le nouveau code, ainsi vous n'aurez qu'à taper votre nouveau code une seule fois pour qu'il soit remplacé dans la totalité du fichier. N'effectuez pas le remplacement automatique, remplacez chaque ligne proposée l'une après l'autre. A chaque fois que vous remplacez une ligne, sauvegardez le fichier, rafraichissez votre navigateur et regardez le résultat obtenu. Si vous n'aimez pas le changement effectué ou si vous avez fait une erreur, vous n'avez qu'à cliquer sur "annuler" dans le menu de votre éditeur de texte afin qu'il annule votre dernière modification, puis sauvegarder votre fichier, rafraichir votre navigateur, et votre thème retrouvera son aspect précédent.

Vous pouvez aussi changer des graphiques ou des images, ou placer des commentaires dans le script afin que ces commentaires ne se voient pas à l'écran. Il est recommandé de placer un ''underscore'' au début du nom de l'image afin que vous puissiez la réutiliser éventuellement plus tard si vous changez d'avis. Il y a des couleurs d'arrière-plan qui sont définies dans les quatre fichiers mentionnés plus haut: ces couleurs d'arrière plan s'appellent "background". Il suffit de modifier le code hexadécimal qui apparait juste derrière ce terme.

Vous pouvez maintenant changer à loisir les couleurs des différents thèmes de PhpGedView, et si le résultat ne vous plait pas ou si vous vous vous trompez, ne vous inquiétez pas, il vous suffit de supprimer le répertoire que avez créé et de recommencer. PhpGedView utilisera le thème par défaut s'il n'en trouve pas d'autre. Si par erreur vous veniez à supprimer ce thème par défaut, il vous suffit de le recopier à partir du fichier zippé que vous avez téléchargé et de le réinstaller.

[[en:How to modify your theme]]

Comment modifier un thème

2007-09-02T13:19:35Z

Papagolf : /* Outils */

autres possibilités de personnalisation des thèmes, aussi n'hésitez pas à écrire vos bonnes idées ici même en ajoutant votre propre contribution.

==Outils==
Vous aurez besoin d'un bon éditeur de texte, n'utilisez pas Notepad qui laisse des caractères aléatoires dans vos scripts qui peuvent être gênants. Il y a quelques bons éditeurs de texte gratuits tels que Notepad2, [http://notepad-plus.sourceforge.net/fr/site.htm Notepad++] et Crimson Editor qui créeront du code propre. Pour ceux qui utilisent Linux, Kedit, Kwrite (sous environnement KDE) , ou Gedit (sous environnement Gnome) sont parfaits. EditPlus est très bien et utilise peu de ressources système, mais il n'est pas gratuit.

Si vous avez un éditeur HTML WYSIWYG, il peut également convenir, mais n'est pas vraiment nécessaire à moins que vous ne désiriez réécrire la page entière. NVU et Bluefish sont d'excellents éditeurs HTML libre. Si vous avez Dreamweaver (qui est payant) c'est bien évidemment parfait !

Dans les faits vous n'aurez besoin que d'ouvrir la page web dans votre navigateur. Firefox est parfait pour celà parce qu'il dispose de fonctionnalités supplémentaires dans le menu qui apparait lorsque vous faites un clic droit, telles que par exemple la fonction de visualisation de l'image d'arrière plan. Cette fonctionnalité vous indique ainsi quelle est l'image que vous voyez à l'écran et où vous pouvez la trouver.

Vérifiez toujours le résultat de votre travail en utilisant Internet Explorer si vous utilisez Firefox parce que quelques détails peuvent apparaitre de manière différente selon que vous utilisiez l'un ou l'autre de ces navigateurs. Il est par exemple très utile de conserver ces deux navigateurs ouverts en permanence et de rafraichir leur affichage afin d'avoir en permanence un oeil sur le résultat de l'affichage de votre travail dans chacun de ces navigateurs.

Pour modifier les couleurs d'un thème, je vous recommande un utilitaire gratuit très utile: [http://pourpre.com/colorbox/index.php La boite à couleurs].
Ce logiciel écrit pour Windows par Benjamin Chartier permet de sélectionner avec une pipette n’importe quelle couleur présente sur l’écran. Il donne alors le code hexadécimal exact de la couleur sélectionnée et vous permet de modifier cette couleur en agissant sur la balance rouge / vert / bleu et sur la teinte / luminosité / saturation.

==Etapes==
===Gestion des fichiers===
La première étape consiste à copier et renommer le thème que vous voulez modifier afin que vous puissiez travailler sur ce nouveau thème. L'exemple détaillé ici utilise le thème Xenea qui se trouve dans le répertoire '''themes/xenea''' du répertoire dans lequel vous avez installé PhpGedView, mais cet exemple s'applique à l'identique pour tous les autres thèmes qui existent dans PhpGedView.

Tous les fichiers dont avez besoin se trouvent dans le répertoire '''themes''' de votre répertoire PhpGedView. Ces fichiers sont les suivants: ''header.html'', ''toplinks.html'', ''style.css'' et ''theme.php''.
Le fichier ''header.html'' contient l'ensemble des informations de mise en forme de l'en-tête des pages du site.
Le fichier ''toplinks.html'' contient l'ensemble des informations qui permettent d'afficher les icônes et les liens présents sur les différentes pages.
Le fichier ''style.css'' contient l'ensemble des règles de style des différentes pages du site.
Le fichier ''theme.php'' est le fichier qui contient les informations générales relatives au thème.

Copiez le répertoire ''themes/xenea'' dans un autre répertoire et donnez lui un nouveau nom qui vous convienne, par exemple : ''themes/xenea_gris'', n'utilisez aucun espace dans le nom, utilisez plutôt des underscores _ à la place. En effet, les serveurs n'aiment pas les espaces dans les noms de répertoires. Après avoir renommé le nom du répertoire ''themes/xenea'' en ''themes/xenea_gris''' vous trouverez à l'intérieur de ce répertoire le fichier theme.php que devrez modifier.
Si vous ouvrez le fichier theme.php dans votre éditeur de texte, vous devriez trouver ceci aux environs de la ligne 27:

$theme_name = "Xenea"; //-- the name of this theme (le nom du thème)

Changez cette ligne par la ligne suivante:

$theme_name = "Xenea_Gris";

ou donnez lui le nom que vous voulez.
De même à la ligne 37, vous verrez apparaître ce code:

$PGV_IMAGE_DIR = "themes/xenea/images"; //-- directory to look for images

Ce code indique l'endroit où se trouvent les images utilisées par le thème Xenea. Comme vous êtes en train de fabriquer un nouveau thème "Xenea_Gris", vos images seront dans le nouveau répertoire ''themes/xenea_gris''. Il faut donc changer cette ligne par la ligne suivante:

$PGV_IMAGE_DIR = "themes/xenea_gris/images"; //-- répertoire dans lequel se situent les images utilisées par le thème xenea_gris

Ensuite, copiez le répertoire ainsi modifié dans le répertoire ''themes'' de PhpGedView, puis allez sur la page d'administration de votre site, et choisissez ce thème par défaut pour votre site.

Vous pouvez alors visualiser en direct ce thème que vous allez modifier et voir ainsi les conséquences des modifications que vous allez lui apporter en rafraichissant votre navigateur à chaque fois que vous modifiez votre thème.

===Changer le thème===
Maintenant, ouvrez le programme '''La boite à couleurs''' sur votre page web et trouvez le code hexadécimal des couleurs de la partie de la page que vous voulez modifier. Placez simplement votre curseur sur la partie de la page que vous voulez modifier, et lisez le code à 6 caractères que vous affiche La boite à couleurs. Ce code ressemble à quelque chose comme #FFFFFF, qui correspond au code de la couleur blanche. Ce code est en fait une combinaison de chiffres et de lettres.

Ensuite, cherchez dans les quatre fichiers qui sont présents dans votre répertoire themes/xenea_gris et qui sont mentionnés plus haut (''header.html'', ''toplinks.html'', ''style.css'' et ''theme.php'') les lignes sur lesquelles apparaissent ce code hexadécimal. Utilisez l'option "rechercher et remplacer" de votre éditeur de texte pour remplacer le code hexadécimal de la couleur que vous voulez changer par le nouveau code, ainsi vous n'aurez qu'à taper votre nouveau code une seule fois pour qu'il soit remplacé dans la totalité du fichier. N'effectuez pas le remplacement automatique, remplacez chaque ligne proposée l'une après l'autre. A chaque fois que vous remplacez une ligne, sauvegardez le fichier, rafraichissez votre navigateur et regardez le résultat obtenu. Si vous n'aimez pas le changement effectué ou si vous avez fait une erreur, vous n'avez qu'à cliquer sur "annuler" dans le menu de votre éditeur de texte afin qu'il annule votre dernière modification, puis sauvegarder votre fichier, rafraichir votre navigateur, et votre thème retrouvera son aspect précédent.

Vous pouvez aussi changer des graphiques ou des images, ou placer des commentaires dans le script afin que ces commentaires ne se voent pas à l'écran. Il est recommandé de placer un ''underscore'' au début du nom de l'image afin que vous puissiez la réutiliser éventuellement plus tard si vous changez d'avis. Il y a des couleurs d'arrière-plan qui sont définies dans les quatre fichiers mentionnés plus haut: ces couleurs d'arrière plan s'appellent "background". Il suffit de modifier le code hexadécimal qui apparait juste derrière ce terme.

Vous pouvez maintenant changer à loisir les couleurs des différents thèmes de PhpGedView, et si le résultat ne vous plait pas ou si vous vous vous trompez, ne vous inquiétez pas, il vous suffit de supprimer le répertoire que avez créé et de recommencer. PhpGedView utilisera le thème par défaut s'il n'en trouve pas d'autre. Si par erreur vous veniez à supprimer ce thème par défaut, il vous suffit de le recopier à partir du fichier zippé que vous avez téléchargé et de le réinstaller.

[[en:How to modify your theme]]

Comment construire un nouveau menu

2007-09-02T13:08:58Z

Papagolf : /* Ajouter un nouveau Menu */

== Quelle utilité de vouloir construire un nouveau menu ? ==

PhpGedView vous permet de donner une vie à votre généalogie grâce aux différents événements qui ont tracé la vie de vos ancêtres. 
Parmi ces événements, les plus intéressants sont souvent les '''petites histoires''': 
* les anecdotes, les rumeurs,... 
* les photos ou les dessins qui retracent ces histoires ainsi que les vrais photos.

Avec ce '''tutoriel''', vous serez capable de construire un '''nouveau menu''' qui vous permettra d'afficher le contenu que vous voudrez. 
Vous permettrez ainsi à PhpGedView de donner vie à toutes les histoires de votre famille...!

== Ajouter un nouveau Menu ==
Avant d'effectuer toute modification, [[Comment personnaliser votre thème|sauvegardez]] le thème "Cloudy" et travaillez uniquement sur une copie avec un nom différent.

Vous trouverez le code PHP qui devra être modifié dans le fichier "'''header.html'''". 
Parce que chaque thème a son propre type de menu, nous vous montrerons les modifications principales à apporter à partir de l'exemple du thème "'''Cloudy'''". 
Dans ce cas, dans le fichier de configuration du GEDCOM, rubrique "utilisateurs", nous avons paramétré l'option "Affichage d'une liste de choix pour changer le thème" à "Non" et nous avons choisi "Cloudy" comme "thème Standard". 

Vous trouverez le fichier "header.html" du thème "Cloudy" dans ce répertoire de votre installation de PhpGedView:

/phpGedView/themes/cloudy/header.html

Ouvrez ce fichier avec un simple éditeur de texte et cherchez la ligne suivante:

$my_temp_menu= array();

Les lignes suivantes construisent la première partie du menu de PGV, visible sur la page d'accueil de PGV par l'icône "Page d'accueil". 
Tout ce qui figure dans ce menu (ainsi que dans les sous-menus) est encapsulé entre des balises "<nowiki><td></nowiki>" et "<nowiki></td></nowiki>". 
Chaque bloc "<nowiki><td></nowiki>...<nowiki></td></nowiki>" contient une icône du menu avec ses sous-menus. 
Une douzaine de rubriques du menu sont encapsulées dans un bloc "<nowiki><table></nowiki>...<nowiki></table></nowiki>".<br/
La "structure générale du menu" ressemble à ceci:

<pre>
<table>
<tr>
<td>
1. rubrique 1 du menu (avec toutes les rubriques des sous-menus)
</td>
</tr>
<tr>
<td>
2. rubrique 2 du menu (avec toutes les rubriques des sous-menus)
</td>
</tr>
</tr>
<td>
peut-être votre propre rubrique (avec toutes les rubriques des sous-menus)
</td>
</tr>
<tr>
<td>
dernière rubrique du menu (avec toutes les rubriques des sous-menus)
</td>
</tr>
</table>
</pre>

Les codes pour le '''menu''' et les '''sous-menus''' ressemblent à ceci:


<td valign="middle" width="1" >
<?php
$menu = array();
$menu["label"] = "...............";
$menu["labelpos"] = "none";
$menu["icon"] = "...............";
$menu["class"] = "menuitem";
$menu["hoverclass"] = "menuitem_hover";
$menu["flyout"] = "down";
$menu["submenuclass"] = "submenu$ff";
$menu["items"] = array();

$submenu = array();
$submenu["label"] = "...............";
$submenu["labelpos"] = "right";
$submenu["icon"] = "...............";
$submenu["link"] = "...............";
$submenu["class"] = "submenuitem$ff";
$submenu["hoverclass"] = "submenuitem_hover$ff";

print_menu($menu);
?>
</td>

Avec un "copier coller" copiez les lignes de code ci-dessus et placez-les entre deux blocs "<nowiki><td></nowiki>...<nowiki></td></nowiki>" , là où vous voulez mettre en place la rubrique de votre menu, en prenant en compte la structure générale du menu décrite plus haut.

 

Maintenant vous allez apprendre à modifier les principales lignes de code qui vous permettront de modifier votre menu. 

Vous avez le -bloc '''$menu''', qui construit l'icône supérieure qui apparaît sur la page de PhpGedView et le -bloc '''$submenu'''-block, qui construit le menu popup avec les entrées du sous-menu the submenu-entries sur la page de PhpGedView. 

Vous pouvez copier le bloc $submenu autant de fois que vous le souhaitez, il y a un bloc pour chacune des entrées du sous-menu. 

Le menu d'impression (print_menu-line) imprime le contenu des rubriques du menu (en incluant les roubriques du sous-menu). 

Trouvez un nom de '''label''' pour chaque entrée du menu et du sous-menu, par exemple "ma Famille" et "d'où nous venons" et écrivez les lignes de code suivantes:

$menu["label"] = "ma Famille";

$submenu["label"] = "d'où nous venons"; 

Dessinez une '''nouvelle icône pour ce menu''' avec un programme de dessin ou cherchez en une avec Google. Enregistrez cette icône avec un nouveau nom par exemple "nouvelleicônemenu.gif" dans le répertoire suivant:

/phpGedView/themes/cloudy/images/nouvelleicônemenu.gif

et placez-là dans votre code comme suit:

$menu["icon"] = "themes/cloudy/images/nouvelleicônemenu.gif;
"
 

== Ouvrir des liens extérieurs ==

Vous pouvez avoir envie de créer dans votre menu, des rubriques qui renvoient vers des pages web externes, c'est à dire vers des pages situées sur d'autres sites web que celui de votre logiciel PhpGedView.
Prenons l'exemple de votre père qui a fait son propre site de généalogie. Ce site se situe à l'adresse "http//www.généalogie_de_mon_papa.fr".

Pour ouvrir à partir du menu une fenêtre vers le site de généalogie de votre papa, et si vous voulez que ce site s'affiche dans '''la même fenêtre que la page affichée''', il vous suffit de rentrer la ligne de code suivante:
<pre>
$submenu["link"] = "http://www.généalogie_de_mon_papa.fr";
</pre>
Si vous voulez que cette page s'affiche dans '''une nouvelle fenêtre''', il vous suffit de rentrer la ligne de code suivante:
<pre>
$submenu["link"] = "http://www.généalogie_de_mon_papa.fr\" target=\"_blank\"";
</pre>
Si vous voulez que ce site s'affiche dans une '''fenêtre popup''', il vous suffit de rentrer la ligne de code suivante:
<pre>
$submenu["link"] = "#\" onclick=\"window.open('http://www.généalogie_de_mon_papa.fr','','
left=50,top=50,width=600,height=320,resizable=1,scroll bars=1'); \"";
</pre>

"left" correspond à la distance de la fenêtre d'affichage à partir du bord gaucha 
"top" correspond à la distance de la fenêtre d'affichage à partir du bord supérieur 
"width" correspond à la largeur de la fenêtre 
"height" correspond à la hauteur de la fenêtre 
"scrollbars = 1" si vous voulez faire apparaître un ascenseur sur la partie droite de votre fenêtre 
"scrollbars = 0" si vous ne voulez pas faire apparaître d'ascenseur 



[[en:How To:Build a New Menu]]

Comment ajouter une carte Googlemap

2007-09-02T13:05:02Z

Papagolf : /* Importer à partir d'un fichier */

==Ajouter des cartes à PhpGedView==

Un module additionnel a été développé pour PhpGedView (PGV) afin de permettre aux utilisateurs d'ajouter des cartes aux données de leur famille. Ce module s'appelle Googlemap, et fonctionne avec les versions PGV 3.3.8 et 4.0.x.

['''Note:''' ''Cette carte additionnelle est bien distincte des petites icônes de couleur présentes sur les fiches individuelles qui permettent en cliquant dessus, d'accéder à des cartes sur différents sites web. Ces cartes sont générées à partir des renseignements de longitude et de latitude qui ont été ajoutés dans le fichier GEDCOM.'']

Ce module affiche des informations supplémentaires sur les individus - voir Figure 1. Il y a un onglet supplémentaire sur la fiche de chaque individu qui présente une carte issue de Google Maps.

On peut cliquer sur chacun des marqueurs présents sur cette carte afin d'afficher les données qui sont attachées au lieu pointé par le marqueur. Si plus d'un événement s'est déroulé à l'endroit du marqueur, les événéments supplémentaires sont alors affichés dans des tableaux.

[[Image:Carte googlemap.png|thumb|center|Figure 1]]

===Logiciel===

Vous devrez télécharger le module "googlemap files" nécessaire à l'adresse suivante [http://sourceforge.net/project/showfiles.php?group_id=55456&package_id=88140&release_id=427780]

Soyez bien conscient que ce module est encore en cours de développement et peut évoluer de temps à autre.

Si vous voulez être tenu informé des dernières modifications (ainsi que des derniers développements sur l'ensemble de PhpGedView) je vous conseille de visiter régulièrement cette adresse: [http://sourceforge.net/project/showfiles.php?group_id=55456&package_id=88140&release_id=427780] (évidemment, c'est en anglais !)

Une fois que vous aurez téléchargé ce module, vous obtiendrez les fichiers suivants:

[[Image:Gm2.jpg|center|450px|thumb|Figure 2]]

Le répertoire ‘extra’ n'est pas nécessaire: vous pouvez ou non le télécharger (les fichiers qui appartiennent à ce répertoire sont des listes de lieux que vous pouvez importer au moyen de la fonction "Editer des lieux").

Copiez la totalité des fichiers du module googlemap que venez de télécharger (avec ou sans le répertoire extra. '''N'oubliez pas de télécharger le fichier googlemap.php !''') dans le répertoire "modules" du logiciel PhpGedView que vous avez installé. Modifiez les permissions du répertoire "modules" ainsi que celles de tous les fichiers du répertoire à ‘777’.

De plus, les fichiers suivants doivent aussi être mis à jour:
* le fichier '''admin.php''' qui se situe à la racine du répertoire de votre logiciel PhpGedView a besoin d'être mise à jour. En effet, cette nouvelle version est nécessaire afin de faire apparaître, au bas de la page d'administration du logiciel, la rubrique "configuration googlemap". Pour celà, allez à l'adresse http://phpgedview.svn.sourceforge.net/viewvc/phpgedview/trunk/phpGedView/ et récupérez la dernière version de ce fichier. Téléchargez cette nouvelle version sur votre serveur (dans le répertoire d'installation de votre logiciel PhpGedView) afin de remplacer le fichier admin.php qui y était.
* le fichier '''lang.fr.php''' qui se trouve dans le répertoire 'modules/googlemap/langages' de votre logiciel PhpGedView a également besoin d'être mise à jour. En effet, cette nouvelle version est nécessaire afin de faire apparaître en français la rubrique "configuration googlemap" qui a été ajoutée par la nouvelle version du fichier '''admin.php''' que vous avez téléchargée ci-dessus. Pour celà, allez à l'adresse http://phpgedview.svn.sourceforge.net/viewvc/phpgedview/trunk/phpGedView/modules/googlemap/languages/

Note spéciale pour les utilisateurs de la version PGV3.3.8: allez à la racine de répertoire d'installation de PhpGedView, et renommez le fichier ‘individual.php’ en ‘zindividual.php’ (ou n'importe quel autre nom). Puis copiez le fichier ‘individual-3.3.8.php’ à la place du fichier ‘individual.php’

===La clé d'enregistrement===

Pour permettre une connection au serveur Google Maps, vous devz obtenir une clé d'enregistrement auprès de Google.

Allez à l'adresse suivante http://www.google.com/apis/maps/signup.html. Cette adresse correspond au site Google Map, et vous devrez vous enregistrer en tant que membre de Google pour pouvoir aller à l'étape suivante. Donc, enregistrez-vous. IL n'y a aucun danger.

Une fois que vous avez réalisé votre enregistrement, vous pouvez allors vous connecter avec votre identifiant de membre Google. Google vous demandera alors où se situe votre répertoire d'installation de PhpGedView installation, il vous faut donc rentrer l'URL (l'adresse internet) www.xxxx.yyyy.zz/place de votre répertoire PhpGedView. Choisissez un endroit de votre arborescence qui vous permettra d'utiliser votré clé d'enregistrement pour plusieurs bases de données (si tant est que vous ayez plusieurs bases de données avec votre logiciel PhpGedView).

Une fois que vous avez obtenu votre clé d'enregistrement, gardez en une copie. Sous Windows, surlignez là, faites Ctrl+C - n'essayez pas de copier la clé en recopiant chaque caractère – vous risqueriez de vous tromper! Et, par sécurité, ouvrez Notepad, copiez la clé, et sauvegardez le fichier pour plus tard (au cas où).

===Commencer l'opération===

Vous pouvez maintenant vous connecter en tant qu'administrateur à PhpGedView. Pendant cette opération, le module Googlemap va créer une nouvelle table (‘placelocation’) dans la base de données de votre serveur.

Le menu d'administration s'affiche alors, et en bas de la page vous verrez apparaitre un lien de configuration de Googlemap. Choisissez ‘Configuration Googlemap’. Si l'option de configuration n'apparait pas, vérifiez que vous avez bien le fichier ‘config.php’ que vous avez créé.

[[Image:Config google.png|center|485px|thumb|Figure 3]]

Une nouvelle fenêtre s'ouvre alors:

[[Image:activer googlemap.png|center|690px|thumb|Figure 4]]

Sélectionnez "Activer Googlemap" à ‘Oui’ and et copiez votre clé d'enregistrement Googlemap dans l'emplacement "Clé API Google Maps". Sauvegardez votre configuration. Vous pourrez toujours par la suite revenir à cette page de configuration de Googlemap pour modifier les autres paramètres de cette page lorsque vous aurez acquis plus d'expérience.

A ce stade, déconnectez-vous de PhpGedView. Puis connectez-vous à nouveau, et vérifiez que la page de chaque individu dispose bien d'un onglet "Carte", bien que cet onglet soit grisé en clair. Si tel n'est pas le cas, recommencez l'opération depuis le début.….mais, avant de toute recommencer depuis le début, copiez le fichier defaultconfig.php sur votre serveur, et renommez le config.php (celà signifiera que vous avez les deux fichiers config.php et defaultconfig.php dans le répertoire googlemap). Et vérifiez également la configuration de Googlemap configuration afin de vous assurer que vous n'avez pas égaré votre clé d'enregistrement...

Maintenant, revenez au sommet de la page de configuration et recommencez l'opération...

Vous êtes maintenant près à inclure les données de cartographie dans votre fichier. Avant celà, n'oubliez pas de modifier les droits à permission de votre répertoire "modules" à ‘644’.

==Comment faire apparaître les cartes==

L'étape suivante nécessite quelques explications.

===Obtenir les coordonnées (latitude, longitude) des lieux===

Les coordonnées (latitude, longitude) des lieux peuvent être obtenues de plusieurs façons.

Voici une liste non exhaustive de sites vous permettant d'obtenir ces coordonnées:
* en utilisant le logiciel Google Earth, vous explorez la planète et obtenez instantanément les coordonnées d'un lieu en pointant votre souris
* en utilisant le site de cartographie [http://www.infosports.com/m/map.htm Cartes Googlemap], vous pouvez lire les coordonnées directement en parcourant les cartes
* http://www.beeloop.com/maps/flickr_geotagr.php?language=english, est un autre site qui vous permet également de parcourir les cartes de la planète et d'afficher en instantané les des lieux visités
* sur le [https://sourceforge.net/project/showfiles.php?group_id=55456&package_id=61563&release_id=435146 site officiel de PhpGedView ] vous pouvez téléchargez les fichiers qui contiennent les coordonnées des villes de différents pays (Allemagne, Royaume Uni, Pays Bas, Etats-Unis sont les pays disponibles à la date du 20 mars 2007), et vous pouvez ensuite importer les fichiers à partir du menu de configuration de Googlemap selon la méthode décrite ci-après.

Il n'est pas inutile de vérifier les données que vous avez importées pour vérifier qu'elles respectent les conventions suivantes:

===Coordonnées===

Habituellement, les coordonnées sont rentrées en degrés, minutes (il y a 60 degrés dans une minute) et secondes (il y a 60 secondes dans une minute), et sont écrites selon ce format: 33° 44’ 55”. Dans la plupart des ordinateurs, vous pouvez entrer ces coordonnées sans avoir besoin de saisir les symboles ° ' " - 33 44 55, vous pouvez aussi les rentrer au format décimal: 33.7486 (pour arriver à ce format il suffit de multiplier les minutes par 60, d'ajouter les secondes, puis diviser la somme par 3600. Enfin, il faut ajouter les degrés).

Coordonnées positives et négatives: les coordonnées au Nord et à l'Est sont des nombres positifs, les coordonnées au Sud et à l'Ouest sont des nombres négatifs – ainsi -23.456 144.666 correspond à 23.456S 144.666E

Souvenez-vous que les latitudes ne peuvent pas être supérieures à +/- 90 degrés, et que les longitudes ne peuvent pas être supérieures à 180 degrés

===Lieux===

Les noms de lieux sont définis par ordre d'importance décroissant, d'un point de vue géographique, et sont séparés par des virgules. Ainsi, les lieux français sont classés comme suit : Pays, Région, Département, Ville. Vous n'avez besoin de rentrer un lieu particulier une seule fois lorsque vous cliquez sur "éditer un lieu" - le logiciel PhpGedView le réutilisera autant que de besoin.

===Comment ajouter un lieu en utilisant le module Googlemap de PhpGedView (méthode recommandée)===

''Note préliminaire: le module Google Map est conçu pour fonctionner avec des lieux qui sont décrits de manière hiérarchique, d'un pont de vue géographique, un peu comme un arbre. Si nous considérons une ville de la région parisienne, cet arbre aurait la structure suivante 'France, Ile de France, Val d'Oise, Pontoise'. Cette structure hiérarchique vous aidera ainsi à retrouver un ensemble de personnes habitant ou ayant habité la même ville. Et cette structure est conforme aux spécifications du format GEDCOM, utilisé par PhpGedView.''

''Et, AVANT que vous ne commenciez votre travail de cartographie des lieux de vos ancêtres, vérifiez attentivement vos données. Assurez-vous que la structure des lieux est bien correcte et respecte la structure hiérarchique, qu'il n'y a pas de doublons, que les lieux sont bien rangés dans le bon département. Alors, le module Googlemap vous affichera très facilement les cartes correspondant aux données que vous aurez entrées.''

Cette fonctionnalité utilise de nouvelles tables dans votre base de données SQL pour enregistrer les noms et les coordonnées des lieux. Les lieux existants peuvent être importés et les informations relatives aux coordonnées de ces lieux peuvent être ajoutées en faisant appel aux outils graphiques (zoom/clic sur une carte) ou en entrant des coordonnées.

Les informations de localisation sont enregistrées ailleurs que dans le fichier GEDCOM (et peuvent être échangées entre des fichiers GEDCOM au format PhpGedView) et les données de localisation ne sont entrées qu'une seule fois pour un lieu donné. La restauration des données de localisation est possible par un export des nouvelles tables de la base de données SQL au format CSV. Des ajouts de données de localisation peuvent être effectués par un import de fichiers au format CSV (en respectant la structure hiérarchique exacte de description des lieux).

En utilisant la structure en arbre mentionnée plus haut, les données de localisation sont rentrées pour ce qui concerne les lieux français, en commençant par le pays, puis le région, le département et enfin la ville. En fonction des pays, cette description des localisations peut évoluer (il peut y avoir des comtés, des cantons,...). Dans tous les cas, il est impératif que cette structure soit en arbre (ou en poupées russes), en commençant par l'entité géographique la plus large (le pays) et en terminant par l'entité géographique la plus petite (la ville).

En utilisant vos droits d'administrateur, allez dans le menu d'administration et (à la fin de ce menu en bas à droite) cliquez sur "éditer les coordonnées d'un lieu". La partie supérieure gauche de l'écran ressemblera à ceci:

[[Image: Editer_un_lieu.jpg|center|Figure 6a]]

Le mot "Sommaire" qui apparaît sur cette fenêtre représente le niveau le plus haut de l'arbre hiérarchisé des lieux que vous utilisez dans votre logiciel. En règle générale, ce niveau le plus élevé correspond au pays, mais il pourrait correspondre à un continent si vous avez décidé de rentrer tous vos lieux sous la forme [Continent, Pays, Région, Département, Ville].

Cliquez sur 'Ajouter un lieu', et nous allons vous illustrer comment cette saisie de lieu se déroule pour le cas le plus courant où la niveau le plus élevé de l'arbre des lieux est le pays, et nous prendrons comme pays l'exemple de la France.

Une fois que l'on a cliqué sur "Ajouter un lieu", cette nouvelle fenêtre apparaît:

[[Image:Carteediterpays.jpg|center|452px|thumb|Figure 6b]]

Tapez alors 'France' dans la case "lieu", cliquez sur 'Pays' dans la case "précision", puis cliquez sur "Recherche" (Nota: il faut avoir place le curseur de votre souris à l'extérieur de la boite "pays" pour que le lien "Recherche" apparaisse et puisse être cliqué).

Si vous êtes connectés à Internet, le module Googlemap de PhpGedView va alors se connecter sur le site [http://www.geonames.org/ Geonames], qui dispose de l'enregistrement de 2.2 millions de lieux différents sur la planète entière. Si le lieu que vous avez entré a été trouvé par ce site, les détails apparaîtront automatiquement sur cette fenêtre. Vous pouvez toujours visiter le site par vous-même(http://www.geonames.org/).

Ainsi, pour la France, vous voyez alors apparaître sur la carte du monde 4 repères jaunes placés sur la France, l'Ile Maurice, l'Ile de France, et l'arrondissement de Fort de France. Et en dessous de la carte, ces quatre lieux apparaissent sous forme de liens cliquables.

[[Image:Carteediterpays2.jpg|center|452px|thumb|Figure 6c]]

Parmi ces quatre choix de lieux qui vous sont proposés par ce site, choisissez celui qui correspond à celui que vous voulez en cliquant sur 'Utiliser cette valeur'.

La fenêtre de dialogue fait alors apparaître une seul repère rouge placé sur la France, et les coordonnées moyennes en latitude et longitude de la France sont renseignées dans cette fenêtre:

[[Image:Carteediterpays3.jpg|center|452px|thumb|Figure 6d]]

Vous pouvez alors cliquer sur "Sauvegarder". Maintenant, vous aurez une entrée dans votre table des lieux chaque fois que vous cliquerez sur "Sommaire" (cf. figure 6a)

[[Image:Carteediterpays4.jpg|center|452px|thumb|Figure 6e]]

Vous pouvez remarquer que le pays, France, est un lien hypertexte que lequel on peut cliquer. Vous remarquez la présence d'une croix rouge '''X''' en bout de ligne qui indique que vous pouvez supprimer ce lieu si vous le désirez. La suppression est effective si vous cliquez sur cette croix.

Si vous cliquez sur ce lien "France" une fenêtre s'affiche vous indiquant qu'il n'y a aucun lieu à afficher. Celà signifie que les lieux qui constituent la France (les régions, les départements, les villes) n'ont pas encore été renseignés dans le logiciel.

Maintenant vous pouvez entrer la ville de Paris….Il suffit de cliquer sur 'Ajouter un lieu' et de recommencer la procédure indiquée au début de ce paragraphe.

La croix rouge '''X''' a été mentionnée. Au fur et à mesure que vous ajouter des niveaux hiérarchiques aux différents lieux, seules les catégories de lieux enregistrées correspondant au niveau le plus bas dans la hiérarchie des lieux feront apparaître le X. Les lieux qui correspondent à un niveau hiérarchique supérieur ne feront pas apparaître de X, parce qu'il existe des lieux de niveau inférieur qui dépendent de ce niveau supérieur. Si vous voulez supprimer quelque chose en utilisant cette croix rouge '''X''' , vous devrez commencer par détruire le lieu qui se situe au plus bas niveau hiérarchique - supprimer la ville, puis le département, puis la région, puis le pays. En clair, vous ne pourrez pas supprimer par cette méthode un département si vous n'avez pas supprimé l'ensemble des villes du département que vous aurez rentrées dans le logiciel.

===Ajouter des lieux un par un à partir du fichier GEDCOM (non recommandé)===

Cette méthode est expliquée ici afin que ayez une idée sur la façon des les enregistrements de lieux sont écrits dans un fichier GEDCOM. Vous n'avez pas besoin d'utiliser le module Googlemap pour utiliser cette procédure.

Les événements peuvent avoir des lieux qui leur sont "attachés", ainsi vous pouvez ajouter des lieux à des événements manuellement. Cette procédure est délicate et n'est pas conseillée. Ce processus ne permet pas à un lieu qui serait rentré de pouvoir être utilisé par plusieurs événements individuels

Les coordonnées géographiques d'un événement peuvent être ajoutées de manière isolée directement sur un fichier GEDCOM. Pour le faire, il suffit d'ajouter dans le fichier GEDCOM une balise PLAC suivie des informations:
::2 PLAC <Nom du lieu>
::3 MAP (Vérifiez bien que la balise ‘3 MAP’ est placée après la balise PLAC)
::4 LONG <Longitude>
::4 LATI <Latitude>

Les lignes MAP, LONG and LATI doivent être ajoutées directement après la ligne PLAC.

Dans la fenêtre d'édition qui s'affiche, il y a un signe ‘+’ sous le ‘lieu’ où vous pouvez enregistrer le pays, la région, le département et la ville qui existe dans le répertoire ‘places’ de votre logiciel PhpGedView. Celà peut vous éviter des doublons en rentrant une même commune avec des orthographes légèrement différentes. La configuration de PhpGedView vous permet, si vous sélectionnez l'option "découper les lieux" dans le menu administration, d'être guidé lors de la saisie de vos lieux afin d'éviter de tels doublons.

Cette méthode place 4 icônes en relation avec l'événement sur la fiche de l'individu. Ces icônes vous offrent les options d'utilisation des sites de cartographie Mapquest, Google Maps, Multimap ou Terraserver. Vous n'obtenez pas par cette méthode, d'affichage automatique d'onglet "carte".

===Importer les données de votre (ou de vos) fichier(s) GEDCOM===

En important les données de votre fichier GEDCOM, vous peuplez la table des "lieux" (appelée "''placelocation''" en anglais) avec tous les lieux qui sont présents dans votre fichier GEDCOM. MaiS – ces lieux n'auront pas de coordonnées en LATITUDE / LONGITUDE. Vous aurez besoin d'entrer ces coordonnées pour chacun des lieux existants. Voir plus bas le paragraphe ‘Vous pouvez éditer et supprimer…’.

===Importer à partir d'un fichier===

Cette option vous permet d'importer des données de lieux, en incluant tous les champs nécessaires pour la table des coordonnées en LATITUDE/LONGITUDE, à partir de fichiers préparés à l'avance au format Excel (.csv). Vous pouvez:
* créer votre propre table,
* utiliser celles qui sont fournies dans le répertoire ‘modules/googlemap/extra’,
* utiliser les tables des villes françaises qui ont été spécialement créées par les membres du forum. '''Je vous conseille cette méthode'''. Vous pouvez télécharger ces fichiers sur le [http://forum.fr.phpgedview.free.fr/spip.php?article28 site du forum français de PhpGedView]
Si vous avez un nombre important de pays disponibles sous forme de fichiers Excel (.csv), c'est la méthode la plus rapide et la plus facile pour créer automatiquement vos cartes.

Cependant – il est conseillé de vérifier que les marqueurs PLAC qui sont présents dans votre fichier GEDCOM correspondent très EXACTEMENT aux lieux qui sont présents dans les fichiers au format Excel que vous importez, en respectant la structure et la hiérarchie – c'est à dire, avez-vous chaque ville dans le bon département et/ou la bonne région ?

==Vous pouvez éditer et supprimer les coordonnées…..==

Cette méthode est intuitive. Cliquez sur "Editer les coordonnées du lieu" à partir du menu administration et vous afficherez une fenêtre qui ressemble à celle de la figure 8.

La crois rouge X permet de supprimer l'élément. Si la croix X est grise (ou s'il n'y a pas de croix X), celà indique que l'élément a des lieux de niveau inférieur qui ont été entrées dans la table. Si vous voulez supprimer l'entité de niveau supérieur, vous devez d'abord supprimer les entités de niveaux inférieurs. Lisez le paragraphe technique ci-dessous si vous voulez en savoir plus sur ce point.

[[Image:Editer_un_lieu1.jpg|center|532px|thumb|Figure 8]]

==Paragraphe technique==

Les données de lieux du module GoogleMaps sont placées dans une table à part, distincte de la table des lieux du logiciel PhpGeView. Cette table, appelée "placelocation" a la structure suivante:

<center>Table 1: placelocation</center>

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
!Field!!Def!!Desc
|-
|pl_id||int(11)||Index incrémental
|-
|pl_parent_id||int(11)||Fait référence au niveau hiérarchique ‘parent’
|-
|pl_level||int(11)||Niveau hiérarchique (Le niveau 0 correspond au pays, le niveau 3 à une commune)
|-
|pl_place||varchar(255)||Le nom du lieu
|-
|pl_long||varchar(30)||Coordonnées de Longitude
|-
|pl_lati||varchar(30)||Coordonnées de Latitude
|-
|pl_zoom||int(4)||Niveau de zoom dans Googlemap
|-
|pl_icon||varchar(255)||Indique l'icône qui sera utilisée pour marquer le lieu
|-
|}

Les données sont enregistrées dans une table séparée afin que cette table puisse être utilisée par plusieurs fichiers GEDCOM. Ainsi, lorsque vous supprimez un fichier GEDCOM, les coordonnées des lieux sont conservées et pourront être utilisées lorsque vous réimporterez votre fichier GEDCOM.

===Lieux===

En pratique, tous les ‘lieux’ sont définis par un identifiant qui correspond à ‘Monpays, MaRégion, MonDépartement, MaVille’. Ces identifiants ont un 'niveau' équivalent:

::Pays = niveau 0 
::Région = niveau 1 
::Département = niveau 2 
::Commune = niveau 3 

Lorsque vous recherchez le nom d'un lieu dans la table, le logiciel va rechercher si ce lieu existe dans la table de manière séquentielle en commençant par le niveau le plus haut et en desendant jusqu'au niveau le plus bas, jusqu'à ce qu'il trouve le lieu.

Quand vous créez une définition pour un lieu, vous le spécifiez de la même façon. Pour pointer sur le lieu auquel vous faites référence, vous ajoutez un 'niveau' à l'ensemble de la description du lieu. Ainsi la description de votre lieu ressemble à ceci: "Niveau, Monpays, MaRégion, MonDépartement, MaVille".

Le niveau correspond à la place du lieu que vous voulez définir dans l'ordre hiérarchique des lieux. Ainsi, Monpays correspond au niveau 0, Macommune correspond au niveau 4.

La longitude, la latitude, le niveau de zoom et l'icône sont des valeurs qui sont simplement ajoutées à la fin de l'identifiant du lieu.

Ainsi la description complète d'un lieu aura la forme suivante: 
"Niveau, Monpays, MaRégion, MonDépartement, MaVille, MaLongitude, MaLatitude, Monniveaudezoom, MonIcône".

Vous pouvez omettre une partie de la description du lieu, mais pas le caractère ‘''','''’ qui sépare les différentes composantes de votre description. Vous pouvez ainsi avoir la description suivante (en omettant la région): 
"Niveau, Monpays''',,''' MonDépartement, MaVille, MaLongitude, MaLatitude, Monniveaudezoom, MonIcône". (notez bien les deux virgules qui séparent Mopays et Mondépartement).

Le corollaire de ceci est que vous avez besoin de prendre en considération la séquence de lieux quand vous importez des données d'une source quelconque. Vous devez construire dès le début la séquence des lieux, de manière à obtenir, dans l'ordre: 
‘Niveau, MonPays,,,, MaLongitude, MaLatitude, MonfacteurdeZoom, MonIcône’ 
‘Niveau, MonPays, MaRégion,,, MaLongitude, MaLatitude, MonfacteurdeZoom, MonIcône’ 
‘Niveau, MonPays, MaRégion, MonDépartement,, MaLongitude, MaLatitude, MonfacteurdeZoom, MonIcône’ 
…et ainsi de suite...

La table ‘placelocation’ enregistre les lieux dans 8 champs, qui ont été conçus pour enregistrer chaque lieu une fois pour toutes, avec une référence au lieu de niveau immédiatement supérieur (appelé niveau parent) qui est enregistré dans le champ pl_parent_id. Le champ pl_id auquel le lieu fait référence est un nombre séquentiel généréré automatiquement.

Une structure typique de la table, ressemble donc à ceci:
[Note – some columns have been ignored for display purposes only]

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
!pl_id!!pl_parent_id!!pl_level!!pl-place!!pl_long!! pl_lati
|-
!1!! 0|| 0|| France|| E2.00|| N46.00
|-
!6!! 1|| 1|| Alsace|| E7.3004|| N47.6894
|-
!7!! 6|| 2|| Bas-Rhin|| E7.5421|| N48.5602
|-
!8!! 7|| 3|| Strasbourg 67482|| E7.7500|| N48.5833
|-
|}

Remarquez qu'il y a 9 champs dans la table. Ce nombre est fixé. Si vous avez l'intention de construire un fichier .CSV afin de l'importer, assurez vous de bien avoir 9 champs sur chaque ligne de votre fichier.

==Configuration de Googlemap – signification des différentes rubriques==

Référez-vous à la Figure 4

La première ligne de saisie vous permet d'activer ou non la fonction Googlemap.

La deuxième ligne vous permet d'entrer la clé d'enregistrement API de Googlemap.

La troisième ligne définit le type d'affichage – carte, image satellite, ou une combinaison des deux (hybride).

La quatrième ligne définit la taille de la carte lorsqu'elle est affichée sur l'écran. La taille par défaut (600 x 400 pixels) peut être ajustée à vos desiderata.

La cinquième ligne correspond au niveau de zoom. Le niveau 0 correspond au pays (niveau de détail le plus bas), le niveau maximum correspond au niveau de détail le plus élevé. Remarquez que quelques cartes satellites ne sont pas disponibles pour le niveau de zoom le plus élevé.

Précision: celà détermine le nombre de décimales qui sont utilisés pour les coordonnées des lieux. Un pays a probablement d'une seul décimale, une commune a besoin de 3 décimales. La troisième décimale fait déplacer le pointeur sur la carte par incréments d'environ 110 mètres. La sixième décimale a une précision d'environ 0.1 mètre.

[[en: Add Google maps]]

Comment ajouter une carte Googlemap

2007-09-02T13:03:57Z

Papagolf : /* Importer les données de votre (ou de vos) fichier(s) GEDCOM */

==Ajouter des cartes à PhpGedView==

Un module additionnel a été développé pour PhpGedView (PGV) afin de permettre aux utilisateurs d'ajouter des cartes aux données de leur famille. Ce module s'appelle Googlemap, et fonctionne avec les versions PGV 3.3.8 et 4.0.x.

['''Note:''' ''Cette carte additionnelle est bien distincte des petites icônes de couleur présentes sur les fiches individuelles qui permettent en cliquant dessus, d'accéder à des cartes sur différents sites web. Ces cartes sont générées à partir des renseignements de longitude et de latitude qui ont été ajoutés dans le fichier GEDCOM.'']

Ce module affiche des informations supplémentaires sur les individus - voir Figure 1. Il y a un onglet supplémentaire sur la fiche de chaque individu qui présente une carte issue de Google Maps.

On peut cliquer sur chacun des marqueurs présents sur cette carte afin d'afficher les données qui sont attachées au lieu pointé par le marqueur. Si plus d'un événement s'est déroulé à l'endroit du marqueur, les événéments supplémentaires sont alors affichés dans des tableaux.

[[Image:Carte googlemap.png|thumb|center|Figure 1]]

===Logiciel===

Vous devrez télécharger le module "googlemap files" nécessaire à l'adresse suivante [http://sourceforge.net/project/showfiles.php?group_id=55456&package_id=88140&release_id=427780]

Soyez bien conscient que ce module est encore en cours de développement et peut évoluer de temps à autre.

Si vous voulez être tenu informé des dernières modifications (ainsi que des derniers développements sur l'ensemble de PhpGedView) je vous conseille de visiter régulièrement cette adresse: [http://sourceforge.net/project/showfiles.php?group_id=55456&package_id=88140&release_id=427780] (évidemment, c'est en anglais !)

Une fois que vous aurez téléchargé ce module, vous obtiendrez les fichiers suivants:

[[Image:Gm2.jpg|center|450px|thumb|Figure 2]]

Le répertoire ‘extra’ n'est pas nécessaire: vous pouvez ou non le télécharger (les fichiers qui appartiennent à ce répertoire sont des listes de lieux que vous pouvez importer au moyen de la fonction "Editer des lieux").

Copiez la totalité des fichiers du module googlemap que venez de télécharger (avec ou sans le répertoire extra. '''N'oubliez pas de télécharger le fichier googlemap.php !''') dans le répertoire "modules" du logiciel PhpGedView que vous avez installé. Modifiez les permissions du répertoire "modules" ainsi que celles de tous les fichiers du répertoire à ‘777’.

De plus, les fichiers suivants doivent aussi être mis à jour:
* le fichier '''admin.php''' qui se situe à la racine du répertoire de votre logiciel PhpGedView a besoin d'être mise à jour. En effet, cette nouvelle version est nécessaire afin de faire apparaître, au bas de la page d'administration du logiciel, la rubrique "configuration googlemap". Pour celà, allez à l'adresse http://phpgedview.svn.sourceforge.net/viewvc/phpgedview/trunk/phpGedView/ et récupérez la dernière version de ce fichier. Téléchargez cette nouvelle version sur votre serveur (dans le répertoire d'installation de votre logiciel PhpGedView) afin de remplacer le fichier admin.php qui y était.
* le fichier '''lang.fr.php''' qui se trouve dans le répertoire 'modules/googlemap/langages' de votre logiciel PhpGedView a également besoin d'être mise à jour. En effet, cette nouvelle version est nécessaire afin de faire apparaître en français la rubrique "configuration googlemap" qui a été ajoutée par la nouvelle version du fichier '''admin.php''' que vous avez téléchargée ci-dessus. Pour celà, allez à l'adresse http://phpgedview.svn.sourceforge.net/viewvc/phpgedview/trunk/phpGedView/modules/googlemap/languages/

Note spéciale pour les utilisateurs de la version PGV3.3.8: allez à la racine de répertoire d'installation de PhpGedView, et renommez le fichier ‘individual.php’ en ‘zindividual.php’ (ou n'importe quel autre nom). Puis copiez le fichier ‘individual-3.3.8.php’ à la place du fichier ‘individual.php’

===La clé d'enregistrement===

Pour permettre une connection au serveur Google Maps, vous devz obtenir une clé d'enregistrement auprès de Google.

Allez à l'adresse suivante http://www.google.com/apis/maps/signup.html. Cette adresse correspond au site Google Map, et vous devrez vous enregistrer en tant que membre de Google pour pouvoir aller à l'étape suivante. Donc, enregistrez-vous. IL n'y a aucun danger.

Une fois que vous avez réalisé votre enregistrement, vous pouvez allors vous connecter avec votre identifiant de membre Google. Google vous demandera alors où se situe votre répertoire d'installation de PhpGedView installation, il vous faut donc rentrer l'URL (l'adresse internet) www.xxxx.yyyy.zz/place de votre répertoire PhpGedView. Choisissez un endroit de votre arborescence qui vous permettra d'utiliser votré clé d'enregistrement pour plusieurs bases de données (si tant est que vous ayez plusieurs bases de données avec votre logiciel PhpGedView).

Une fois que vous avez obtenu votre clé d'enregistrement, gardez en une copie. Sous Windows, surlignez là, faites Ctrl+C - n'essayez pas de copier la clé en recopiant chaque caractère – vous risqueriez de vous tromper! Et, par sécurité, ouvrez Notepad, copiez la clé, et sauvegardez le fichier pour plus tard (au cas où).

===Commencer l'opération===

Vous pouvez maintenant vous connecter en tant qu'administrateur à PhpGedView. Pendant cette opération, le module Googlemap va créer une nouvelle table (‘placelocation’) dans la base de données de votre serveur.

Le menu d'administration s'affiche alors, et en bas de la page vous verrez apparaitre un lien de configuration de Googlemap. Choisissez ‘Configuration Googlemap’. Si l'option de configuration n'apparait pas, vérifiez que vous avez bien le fichier ‘config.php’ que vous avez créé.

[[Image:Config google.png|center|485px|thumb|Figure 3]]

Une nouvelle fenêtre s'ouvre alors:

[[Image:activer googlemap.png|center|690px|thumb|Figure 4]]

Sélectionnez "Activer Googlemap" à ‘Oui’ and et copiez votre clé d'enregistrement Googlemap dans l'emplacement "Clé API Google Maps". Sauvegardez votre configuration. Vous pourrez toujours par la suite revenir à cette page de configuration de Googlemap pour modifier les autres paramètres de cette page lorsque vous aurez acquis plus d'expérience.

A ce stade, déconnectez-vous de PhpGedView. Puis connectez-vous à nouveau, et vérifiez que la page de chaque individu dispose bien d'un onglet "Carte", bien que cet onglet soit grisé en clair. Si tel n'est pas le cas, recommencez l'opération depuis le début.….mais, avant de toute recommencer depuis le début, copiez le fichier defaultconfig.php sur votre serveur, et renommez le config.php (celà signifiera que vous avez les deux fichiers config.php et defaultconfig.php dans le répertoire googlemap). Et vérifiez également la configuration de Googlemap configuration afin de vous assurer que vous n'avez pas égaré votre clé d'enregistrement...

Maintenant, revenez au sommet de la page de configuration et recommencez l'opération...

Vous êtes maintenant près à inclure les données de cartographie dans votre fichier. Avant celà, n'oubliez pas de modifier les droits à permission de votre répertoire "modules" à ‘644’.

==Comment faire apparaître les cartes==

L'étape suivante nécessite quelques explications.

===Obtenir les coordonnées (latitude, longitude) des lieux===

Les coordonnées (latitude, longitude) des lieux peuvent être obtenues de plusieurs façons.

Voici une liste non exhaustive de sites vous permettant d'obtenir ces coordonnées:
* en utilisant le logiciel Google Earth, vous explorez la planète et obtenez instantanément les coordonnées d'un lieu en pointant votre souris
* en utilisant le site de cartographie [http://www.infosports.com/m/map.htm Cartes Googlemap], vous pouvez lire les coordonnées directement en parcourant les cartes
* http://www.beeloop.com/maps/flickr_geotagr.php?language=english, est un autre site qui vous permet également de parcourir les cartes de la planète et d'afficher en instantané les des lieux visités
* sur le [https://sourceforge.net/project/showfiles.php?group_id=55456&package_id=61563&release_id=435146 site officiel de PhpGedView ] vous pouvez téléchargez les fichiers qui contiennent les coordonnées des villes de différents pays (Allemagne, Royaume Uni, Pays Bas, Etats-Unis sont les pays disponibles à la date du 20 mars 2007), et vous pouvez ensuite importer les fichiers à partir du menu de configuration de Googlemap selon la méthode décrite ci-après.

Il n'est pas inutile de vérifier les données que vous avez importées pour vérifier qu'elles respectent les conventions suivantes:

===Coordonnées===

Habituellement, les coordonnées sont rentrées en degrés, minutes (il y a 60 degrés dans une minute) et secondes (il y a 60 secondes dans une minute), et sont écrites selon ce format: 33° 44’ 55”. Dans la plupart des ordinateurs, vous pouvez entrer ces coordonnées sans avoir besoin de saisir les symboles ° ' " - 33 44 55, vous pouvez aussi les rentrer au format décimal: 33.7486 (pour arriver à ce format il suffit de multiplier les minutes par 60, d'ajouter les secondes, puis diviser la somme par 3600. Enfin, il faut ajouter les degrés).

Coordonnées positives et négatives: les coordonnées au Nord et à l'Est sont des nombres positifs, les coordonnées au Sud et à l'Ouest sont des nombres négatifs – ainsi -23.456 144.666 correspond à 23.456S 144.666E

Souvenez-vous que les latitudes ne peuvent pas être supérieures à +/- 90 degrés, et que les longitudes ne peuvent pas être supérieures à 180 degrés

===Lieux===

Les noms de lieux sont définis par ordre d'importance décroissant, d'un point de vue géographique, et sont séparés par des virgules. Ainsi, les lieux français sont classés comme suit : Pays, Région, Département, Ville. Vous n'avez besoin de rentrer un lieu particulier une seule fois lorsque vous cliquez sur "éditer un lieu" - le logiciel PhpGedView le réutilisera autant que de besoin.

===Comment ajouter un lieu en utilisant le module Googlemap de PhpGedView (méthode recommandée)===

''Note préliminaire: le module Google Map est conçu pour fonctionner avec des lieux qui sont décrits de manière hiérarchique, d'un pont de vue géographique, un peu comme un arbre. Si nous considérons une ville de la région parisienne, cet arbre aurait la structure suivante 'France, Ile de France, Val d'Oise, Pontoise'. Cette structure hiérarchique vous aidera ainsi à retrouver un ensemble de personnes habitant ou ayant habité la même ville. Et cette structure est conforme aux spécifications du format GEDCOM, utilisé par PhpGedView.''

''Et, AVANT que vous ne commenciez votre travail de cartographie des lieux de vos ancêtres, vérifiez attentivement vos données. Assurez-vous que la structure des lieux est bien correcte et respecte la structure hiérarchique, qu'il n'y a pas de doublons, que les lieux sont bien rangés dans le bon département. Alors, le module Googlemap vous affichera très facilement les cartes correspondant aux données que vous aurez entrées.''

Cette fonctionnalité utilise de nouvelles tables dans votre base de données SQL pour enregistrer les noms et les coordonnées des lieux. Les lieux existants peuvent être importés et les informations relatives aux coordonnées de ces lieux peuvent être ajoutées en faisant appel aux outils graphiques (zoom/clic sur une carte) ou en entrant des coordonnées.

Les informations de localisation sont enregistrées ailleurs que dans le fichier GEDCOM (et peuvent être échangées entre des fichiers GEDCOM au format PhpGedView) et les données de localisation ne sont entrées qu'une seule fois pour un lieu donné. La restauration des données de localisation est possible par un export des nouvelles tables de la base de données SQL au format CSV. Des ajouts de données de localisation peuvent être effectués par un import de fichiers au format CSV (en respectant la structure hiérarchique exacte de description des lieux).

En utilisant la structure en arbre mentionnée plus haut, les données de localisation sont rentrées pour ce qui concerne les lieux français, en commençant par le pays, puis le région, le département et enfin la ville. En fonction des pays, cette description des localisations peut évoluer (il peut y avoir des comtés, des cantons,...). Dans tous les cas, il est impératif que cette structure soit en arbre (ou en poupées russes), en commençant par l'entité géographique la plus large (le pays) et en terminant par l'entité géographique la plus petite (la ville).

En utilisant vos droits d'administrateur, allez dans le menu d'administration et (à la fin de ce menu en bas à droite) cliquez sur "éditer les coordonnées d'un lieu". La partie supérieure gauche de l'écran ressemblera à ceci:

[[Image: Editer_un_lieu.jpg|center|Figure 6a]]

Le mot "Sommaire" qui apparaît sur cette fenêtre représente le niveau le plus haut de l'arbre hiérarchisé des lieux que vous utilisez dans votre logiciel. En règle générale, ce niveau le plus élevé correspond au pays, mais il pourrait correspondre à un continent si vous avez décidé de rentrer tous vos lieux sous la forme [Continent, Pays, Région, Département, Ville].

Cliquez sur 'Ajouter un lieu', et nous allons vous illustrer comment cette saisie de lieu se déroule pour le cas le plus courant où la niveau le plus élevé de l'arbre des lieux est le pays, et nous prendrons comme pays l'exemple de la France.

Une fois que l'on a cliqué sur "Ajouter un lieu", cette nouvelle fenêtre apparaît:

[[Image:Carteediterpays.jpg|center|452px|thumb|Figure 6b]]

Tapez alors 'France' dans la case "lieu", cliquez sur 'Pays' dans la case "précision", puis cliquez sur "Recherche" (Nota: il faut avoir place le curseur de votre souris à l'extérieur de la boite "pays" pour que le lien "Recherche" apparaisse et puisse être cliqué).

Si vous êtes connectés à Internet, le module Googlemap de PhpGedView va alors se connecter sur le site [http://www.geonames.org/ Geonames], qui dispose de l'enregistrement de 2.2 millions de lieux différents sur la planète entière. Si le lieu que vous avez entré a été trouvé par ce site, les détails apparaîtront automatiquement sur cette fenêtre. Vous pouvez toujours visiter le site par vous-même(http://www.geonames.org/).

Ainsi, pour la France, vous voyez alors apparaître sur la carte du monde 4 repères jaunes placés sur la France, l'Ile Maurice, l'Ile de France, et l'arrondissement de Fort de France. Et en dessous de la carte, ces quatre lieux apparaissent sous forme de liens cliquables.

[[Image:Carteediterpays2.jpg|center|452px|thumb|Figure 6c]]

Parmi ces quatre choix de lieux qui vous sont proposés par ce site, choisissez celui qui correspond à celui que vous voulez en cliquant sur 'Utiliser cette valeur'.

La fenêtre de dialogue fait alors apparaître une seul repère rouge placé sur la France, et les coordonnées moyennes en latitude et longitude de la France sont renseignées dans cette fenêtre:

[[Image:Carteediterpays3.jpg|center|452px|thumb|Figure 6d]]

Vous pouvez alors cliquer sur "Sauvegarder". Maintenant, vous aurez une entrée dans votre table des lieux chaque fois que vous cliquerez sur "Sommaire" (cf. figure 6a)

[[Image:Carteediterpays4.jpg|center|452px|thumb|Figure 6e]]

Vous pouvez remarquer que le pays, France, est un lien hypertexte que lequel on peut cliquer. Vous remarquez la présence d'une croix rouge '''X''' en bout de ligne qui indique que vous pouvez supprimer ce lieu si vous le désirez. La suppression est effective si vous cliquez sur cette croix.

Si vous cliquez sur ce lien "France" une fenêtre s'affiche vous indiquant qu'il n'y a aucun lieu à afficher. Celà signifie que les lieux qui constituent la France (les régions, les départements, les villes) n'ont pas encore été renseignés dans le logiciel.

Maintenant vous pouvez entrer la ville de Paris….Il suffit de cliquer sur 'Ajouter un lieu' et de recommencer la procédure indiquée au début de ce paragraphe.

La croix rouge '''X''' a été mentionnée. Au fur et à mesure que vous ajouter des niveaux hiérarchiques aux différents lieux, seules les catégories de lieux enregistrées correspondant au niveau le plus bas dans la hiérarchie des lieux feront apparaître le X. Les lieux qui correspondent à un niveau hiérarchique supérieur ne feront pas apparaître de X, parce qu'il existe des lieux de niveau inférieur qui dépendent de ce niveau supérieur. Si vous voulez supprimer quelque chose en utilisant cette croix rouge '''X''' , vous devrez commencer par détruire le lieu qui se situe au plus bas niveau hiérarchique - supprimer la ville, puis le département, puis la région, puis le pays. En clair, vous ne pourrez pas supprimer par cette méthode un département si vous n'avez pas supprimé l'ensemble des villes du département que vous aurez rentrées dans le logiciel.

===Ajouter des lieux un par un à partir du fichier GEDCOM (non recommandé)===

Cette méthode est expliquée ici afin que ayez une idée sur la façon des les enregistrements de lieux sont écrits dans un fichier GEDCOM. Vous n'avez pas besoin d'utiliser le module Googlemap pour utiliser cette procédure.

Les événements peuvent avoir des lieux qui leur sont "attachés", ainsi vous pouvez ajouter des lieux à des événements manuellement. Cette procédure est délicate et n'est pas conseillée. Ce processus ne permet pas à un lieu qui serait rentré de pouvoir être utilisé par plusieurs événements individuels

Les coordonnées géographiques d'un événement peuvent être ajoutées de manière isolée directement sur un fichier GEDCOM. Pour le faire, il suffit d'ajouter dans le fichier GEDCOM une balise PLAC suivie des informations:
::2 PLAC <Nom du lieu>
::3 MAP (Vérifiez bien que la balise ‘3 MAP’ est placée après la balise PLAC)
::4 LONG <Longitude>
::4 LATI <Latitude>

Les lignes MAP, LONG and LATI doivent être ajoutées directement après la ligne PLAC.

Dans la fenêtre d'édition qui s'affiche, il y a un signe ‘+’ sous le ‘lieu’ où vous pouvez enregistrer le pays, la région, le département et la ville qui existe dans le répertoire ‘places’ de votre logiciel PhpGedView. Celà peut vous éviter des doublons en rentrant une même commune avec des orthographes légèrement différentes. La configuration de PhpGedView vous permet, si vous sélectionnez l'option "découper les lieux" dans le menu administration, d'être guidé lors de la saisie de vos lieux afin d'éviter de tels doublons.

Cette méthode place 4 icônes en relation avec l'événement sur la fiche de l'individu. Ces icônes vous offrent les options d'utilisation des sites de cartographie Mapquest, Google Maps, Multimap ou Terraserver. Vous n'obtenez pas par cette méthode, d'affichage automatique d'onglet "carte".

===Importer les données de votre (ou de vos) fichier(s) GEDCOM===

En important les données de votre fichier GEDCOM, vous peuplez la table des "lieux" (appelée "''placelocation''" en anglais) avec tous les lieux qui sont présents dans votre fichier GEDCOM. MaiS – ces lieux n'auront pas de coordonnées en LATITUDE / LONGITUDE. Vous aurez besoin d'entrer ces coordonnées pour chacun des lieux existants. Voir plus bas le paragraphe ‘Vous pouvez éditer et supprimer…’.

===Importer à partir d'un fichier===

Cette option vous permet d'importer des données de lieux, en incluant tous les champs nécessaires pour la table des coordonnées en LATITUDE/LONGITUDE, à partir de fichiers préparés à l'avance au format Excel (.csv). Vous pouvez:
* créer votre propre table,
* utiliser celles qui sont fournies dans le répertoire ‘modules/googlemap/extra’,
* utiliser les tables des villes françaises qui ont été spécialement créées par les membres du forum. '''Je vous conseille cete méthode'''. Vous pouvez télécharger ces fichiers sur le [http://forum.fr.phpgedview.free.fr/spip.php?article28 site du forum français de PhpGedView]
Si vous avez un nombre important de pays disponibles sous forme de fichiers Excel (.csv), c'est la méthode la plus rapide et la plus facile pour créer automatiquement vos cartes.

Cependant – il est conseillé de vérifier que les marqueurs PLAC qui sont présents dans votre fichier GEDCOM correspondent très EXACTEMENT aux lieux qui sont présents dans les fichiers au format Excel que vous importez, en respectant la structure et la hiérarchie – c'est à dire, avez-vous chaque ville dans le bon département et/ou la bonne région ?

==Vous pouvez éditer et supprimer les coordonnées…..==

Cette méthode est intuitive. Cliquez sur "Editer les coordonnées du lieu" à partir du menu administration et vous afficherez une fenêtre qui ressemble à celle de la figure 8.

La crois rouge X permet de supprimer l'élément. Si la croix X est grise (ou s'il n'y a pas de croix X), celà indique que l'élément a des lieux de niveau inférieur qui ont été entrées dans la table. Si vous voulez supprimer l'entité de niveau supérieur, vous devez d'abord supprimer les entités de niveaux inférieurs. Lisez le paragraphe technique ci-dessous si vous voulez en savoir plus sur ce point.

[[Image:Editer_un_lieu1.jpg|center|532px|thumb|Figure 8]]

==Paragraphe technique==

Les données de lieux du module GoogleMaps sont placées dans une table à part, distincte de la table des lieux du logiciel PhpGeView. Cette table, appelée "placelocation" a la structure suivante:

<center>Table 1: placelocation</center>

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
!Field!!Def!!Desc
|-
|pl_id||int(11)||Index incrémental
|-
|pl_parent_id||int(11)||Fait référence au niveau hiérarchique ‘parent’
|-
|pl_level||int(11)||Niveau hiérarchique (Le niveau 0 correspond au pays, le niveau 3 à une commune)
|-
|pl_place||varchar(255)||Le nom du lieu
|-
|pl_long||varchar(30)||Coordonnées de Longitude
|-
|pl_lati||varchar(30)||Coordonnées de Latitude
|-
|pl_zoom||int(4)||Niveau de zoom dans Googlemap
|-
|pl_icon||varchar(255)||Indique l'icône qui sera utilisée pour marquer le lieu
|-
|}

Les données sont enregistrées dans une table séparée afin que cette table puisse être utilisée par plusieurs fichiers GEDCOM. Ainsi, lorsque vous supprimez un fichier GEDCOM, les coordonnées des lieux sont conservées et pourront être utilisées lorsque vous réimporterez votre fichier GEDCOM.

===Lieux===

En pratique, tous les ‘lieux’ sont définis par un identifiant qui correspond à ‘Monpays, MaRégion, MonDépartement, MaVille’. Ces identifiants ont un 'niveau' équivalent:

::Pays = niveau 0 
::Région = niveau 1 
::Département = niveau 2 
::Commune = niveau 3 

Lorsque vous recherchez le nom d'un lieu dans la table, le logiciel va rechercher si ce lieu existe dans la table de manière séquentielle en commençant par le niveau le plus haut et en desendant jusqu'au niveau le plus bas, jusqu'à ce qu'il trouve le lieu.

Quand vous créez une définition pour un lieu, vous le spécifiez de la même façon. Pour pointer sur le lieu auquel vous faites référence, vous ajoutez un 'niveau' à l'ensemble de la description du lieu. Ainsi la description de votre lieu ressemble à ceci: "Niveau, Monpays, MaRégion, MonDépartement, MaVille".

Le niveau correspond à la place du lieu que vous voulez définir dans l'ordre hiérarchique des lieux. Ainsi, Monpays correspond au niveau 0, Macommune correspond au niveau 4.

La longitude, la latitude, le niveau de zoom et l'icône sont des valeurs qui sont simplement ajoutées à la fin de l'identifiant du lieu.

Ainsi la description complète d'un lieu aura la forme suivante: 
"Niveau, Monpays, MaRégion, MonDépartement, MaVille, MaLongitude, MaLatitude, Monniveaudezoom, MonIcône".

Vous pouvez omettre une partie de la description du lieu, mais pas le caractère ‘''','''’ qui sépare les différentes composantes de votre description. Vous pouvez ainsi avoir la description suivante (en omettant la région): 
"Niveau, Monpays''',,''' MonDépartement, MaVille, MaLongitude, MaLatitude, Monniveaudezoom, MonIcône". (notez bien les deux virgules qui séparent Mopays et Mondépartement).

Le corollaire de ceci est que vous avez besoin de prendre en considération la séquence de lieux quand vous importez des données d'une source quelconque. Vous devez construire dès le début la séquence des lieux, de manière à obtenir, dans l'ordre: 
‘Niveau, MonPays,,,, MaLongitude, MaLatitude, MonfacteurdeZoom, MonIcône’ 
‘Niveau, MonPays, MaRégion,,, MaLongitude, MaLatitude, MonfacteurdeZoom, MonIcône’ 
‘Niveau, MonPays, MaRégion, MonDépartement,, MaLongitude, MaLatitude, MonfacteurdeZoom, MonIcône’ 
…et ainsi de suite...

La table ‘placelocation’ enregistre les lieux dans 8 champs, qui ont été conçus pour enregistrer chaque lieu une fois pour toutes, avec une référence au lieu de niveau immédiatement supérieur (appelé niveau parent) qui est enregistré dans le champ pl_parent_id. Le champ pl_id auquel le lieu fait référence est un nombre séquentiel généréré automatiquement.

Une structure typique de la table, ressemble donc à ceci:
[Note – some columns have been ignored for display purposes only]

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
!pl_id!!pl_parent_id!!pl_level!!pl-place!!pl_long!! pl_lati
|-
!1!! 0|| 0|| France|| E2.00|| N46.00
|-
!6!! 1|| 1|| Alsace|| E7.3004|| N47.6894
|-
!7!! 6|| 2|| Bas-Rhin|| E7.5421|| N48.5602
|-
!8!! 7|| 3|| Strasbourg 67482|| E7.7500|| N48.5833
|-
|}

Remarquez qu'il y a 9 champs dans la table. Ce nombre est fixé. Si vous avez l'intention de construire un fichier .CSV afin de l'importer, assurez vous de bien avoir 9 champs sur chaque ligne de votre fichier.

==Configuration de Googlemap – signification des différentes rubriques==

Référez-vous à la Figure 4

La première ligne de saisie vous permet d'activer ou non la fonction Googlemap.

La deuxième ligne vous permet d'entrer la clé d'enregistrement API de Googlemap.

La troisième ligne définit le type d'affichage – carte, image satellite, ou une combinaison des deux (hybride).

La quatrième ligne définit la taille de la carte lorsqu'elle est affichée sur l'écran. La taille par défaut (600 x 400 pixels) peut être ajustée à vos desiderata.

La cinquième ligne correspond au niveau de zoom. Le niveau 0 correspond au pays (niveau de détail le plus bas), le niveau maximum correspond au niveau de détail le plus élevé. Remarquez que quelques cartes satellites ne sont pas disponibles pour le niveau de zoom le plus élevé.

Précision: celà détermine le nombre de décimales qui sont utilisés pour les coordonnées des lieux. Un pays a probablement d'une seul décimale, une commune a besoin de 3 décimales. La troisième décimale fait déplacer le pointeur sur la carte par incréments d'environ 110 mètres. La sixième décimale a une précision d'environ 0.1 mètre.

[[en: Add Google maps]]

Comment ajouter une carte Googlemap

2007-09-02T13:01:41Z

Papagolf : /* Lieux */

==Ajouter des cartes à PhpGedView==

Un module additionnel a été développé pour PhpGedView (PGV) afin de permettre aux utilisateurs d'ajouter des cartes aux données de leur famille. Ce module s'appelle Googlemap, et fonctionne avec les versions PGV 3.3.8 et 4.0.x.

['''Note:''' ''Cette carte additionnelle est bien distincte des petites icônes de couleur présentes sur les fiches individuelles qui permettent en cliquant dessus, d'accéder à des cartes sur différents sites web. Ces cartes sont générées à partir des renseignements de longitude et de latitude qui ont été ajoutés dans le fichier GEDCOM.'']

Ce module affiche des informations supplémentaires sur les individus - voir Figure 1. Il y a un onglet supplémentaire sur la fiche de chaque individu qui présente une carte issue de Google Maps.

On peut cliquer sur chacun des marqueurs présents sur cette carte afin d'afficher les données qui sont attachées au lieu pointé par le marqueur. Si plus d'un événement s'est déroulé à l'endroit du marqueur, les événéments supplémentaires sont alors affichés dans des tableaux.

[[Image:Carte googlemap.png|thumb|center|Figure 1]]

===Logiciel===

Vous devrez télécharger le module "googlemap files" nécessaire à l'adresse suivante [http://sourceforge.net/project/showfiles.php?group_id=55456&package_id=88140&release_id=427780]

Soyez bien conscient que ce module est encore en cours de développement et peut évoluer de temps à autre.

Si vous voulez être tenu informé des dernières modifications (ainsi que des derniers développements sur l'ensemble de PhpGedView) je vous conseille de visiter régulièrement cette adresse: [http://sourceforge.net/project/showfiles.php?group_id=55456&package_id=88140&release_id=427780] (évidemment, c'est en anglais !)

Une fois que vous aurez téléchargé ce module, vous obtiendrez les fichiers suivants:

[[Image:Gm2.jpg|center|450px|thumb|Figure 2]]

Le répertoire ‘extra’ n'est pas nécessaire: vous pouvez ou non le télécharger (les fichiers qui appartiennent à ce répertoire sont des listes de lieux que vous pouvez importer au moyen de la fonction "Editer des lieux").

Copiez la totalité des fichiers du module googlemap que venez de télécharger (avec ou sans le répertoire extra. '''N'oubliez pas de télécharger le fichier googlemap.php !''') dans le répertoire "modules" du logiciel PhpGedView que vous avez installé. Modifiez les permissions du répertoire "modules" ainsi que celles de tous les fichiers du répertoire à ‘777’.

De plus, les fichiers suivants doivent aussi être mis à jour:
* le fichier '''admin.php''' qui se situe à la racine du répertoire de votre logiciel PhpGedView a besoin d'être mise à jour. En effet, cette nouvelle version est nécessaire afin de faire apparaître, au bas de la page d'administration du logiciel, la rubrique "configuration googlemap". Pour celà, allez à l'adresse http://phpgedview.svn.sourceforge.net/viewvc/phpgedview/trunk/phpGedView/ et récupérez la dernière version de ce fichier. Téléchargez cette nouvelle version sur votre serveur (dans le répertoire d'installation de votre logiciel PhpGedView) afin de remplacer le fichier admin.php qui y était.
* le fichier '''lang.fr.php''' qui se trouve dans le répertoire 'modules/googlemap/langages' de votre logiciel PhpGedView a également besoin d'être mise à jour. En effet, cette nouvelle version est nécessaire afin de faire apparaître en français la rubrique "configuration googlemap" qui a été ajoutée par la nouvelle version du fichier '''admin.php''' que vous avez téléchargée ci-dessus. Pour celà, allez à l'adresse http://phpgedview.svn.sourceforge.net/viewvc/phpgedview/trunk/phpGedView/modules/googlemap/languages/

Note spéciale pour les utilisateurs de la version PGV3.3.8: allez à la racine de répertoire d'installation de PhpGedView, et renommez le fichier ‘individual.php’ en ‘zindividual.php’ (ou n'importe quel autre nom). Puis copiez le fichier ‘individual-3.3.8.php’ à la place du fichier ‘individual.php’

===La clé d'enregistrement===

Pour permettre une connection au serveur Google Maps, vous devz obtenir une clé d'enregistrement auprès de Google.

Allez à l'adresse suivante http://www.google.com/apis/maps/signup.html. Cette adresse correspond au site Google Map, et vous devrez vous enregistrer en tant que membre de Google pour pouvoir aller à l'étape suivante. Donc, enregistrez-vous. IL n'y a aucun danger.

Une fois que vous avez réalisé votre enregistrement, vous pouvez allors vous connecter avec votre identifiant de membre Google. Google vous demandera alors où se situe votre répertoire d'installation de PhpGedView installation, il vous faut donc rentrer l'URL (l'adresse internet) www.xxxx.yyyy.zz/place de votre répertoire PhpGedView. Choisissez un endroit de votre arborescence qui vous permettra d'utiliser votré clé d'enregistrement pour plusieurs bases de données (si tant est que vous ayez plusieurs bases de données avec votre logiciel PhpGedView).

Une fois que vous avez obtenu votre clé d'enregistrement, gardez en une copie. Sous Windows, surlignez là, faites Ctrl+C - n'essayez pas de copier la clé en recopiant chaque caractère – vous risqueriez de vous tromper! Et, par sécurité, ouvrez Notepad, copiez la clé, et sauvegardez le fichier pour plus tard (au cas où).

===Commencer l'opération===

Vous pouvez maintenant vous connecter en tant qu'administrateur à PhpGedView. Pendant cette opération, le module Googlemap va créer une nouvelle table (‘placelocation’) dans la base de données de votre serveur.

Le menu d'administration s'affiche alors, et en bas de la page vous verrez apparaitre un lien de configuration de Googlemap. Choisissez ‘Configuration Googlemap’. Si l'option de configuration n'apparait pas, vérifiez que vous avez bien le fichier ‘config.php’ que vous avez créé.

[[Image:Config google.png|center|485px|thumb|Figure 3]]

Une nouvelle fenêtre s'ouvre alors:

[[Image:activer googlemap.png|center|690px|thumb|Figure 4]]

Sélectionnez "Activer Googlemap" à ‘Oui’ and et copiez votre clé d'enregistrement Googlemap dans l'emplacement "Clé API Google Maps". Sauvegardez votre configuration. Vous pourrez toujours par la suite revenir à cette page de configuration de Googlemap pour modifier les autres paramètres de cette page lorsque vous aurez acquis plus d'expérience.

A ce stade, déconnectez-vous de PhpGedView. Puis connectez-vous à nouveau, et vérifiez que la page de chaque individu dispose bien d'un onglet "Carte", bien que cet onglet soit grisé en clair. Si tel n'est pas le cas, recommencez l'opération depuis le début.….mais, avant de toute recommencer depuis le début, copiez le fichier defaultconfig.php sur votre serveur, et renommez le config.php (celà signifiera que vous avez les deux fichiers config.php et defaultconfig.php dans le répertoire googlemap). Et vérifiez également la configuration de Googlemap configuration afin de vous assurer que vous n'avez pas égaré votre clé d'enregistrement...

Maintenant, revenez au sommet de la page de configuration et recommencez l'opération...

Vous êtes maintenant près à inclure les données de cartographie dans votre fichier. Avant celà, n'oubliez pas de modifier les droits à permission de votre répertoire "modules" à ‘644’.

==Comment faire apparaître les cartes==

L'étape suivante nécessite quelques explications.

===Obtenir les coordonnées (latitude, longitude) des lieux===

Les coordonnées (latitude, longitude) des lieux peuvent être obtenues de plusieurs façons.

Voici une liste non exhaustive de sites vous permettant d'obtenir ces coordonnées:
* en utilisant le logiciel Google Earth, vous explorez la planète et obtenez instantanément les coordonnées d'un lieu en pointant votre souris
* en utilisant le site de cartographie [http://www.infosports.com/m/map.htm Cartes Googlemap], vous pouvez lire les coordonnées directement en parcourant les cartes
* http://www.beeloop.com/maps/flickr_geotagr.php?language=english, est un autre site qui vous permet également de parcourir les cartes de la planète et d'afficher en instantané les des lieux visités
* sur le [https://sourceforge.net/project/showfiles.php?group_id=55456&package_id=61563&release_id=435146 site officiel de PhpGedView ] vous pouvez téléchargez les fichiers qui contiennent les coordonnées des villes de différents pays (Allemagne, Royaume Uni, Pays Bas, Etats-Unis sont les pays disponibles à la date du 20 mars 2007), et vous pouvez ensuite importer les fichiers à partir du menu de configuration de Googlemap selon la méthode décrite ci-après.

Il n'est pas inutile de vérifier les données que vous avez importées pour vérifier qu'elles respectent les conventions suivantes:

===Coordonnées===

Habituellement, les coordonnées sont rentrées en degrés, minutes (il y a 60 degrés dans une minute) et secondes (il y a 60 secondes dans une minute), et sont écrites selon ce format: 33° 44’ 55”. Dans la plupart des ordinateurs, vous pouvez entrer ces coordonnées sans avoir besoin de saisir les symboles ° ' " - 33 44 55, vous pouvez aussi les rentrer au format décimal: 33.7486 (pour arriver à ce format il suffit de multiplier les minutes par 60, d'ajouter les secondes, puis diviser la somme par 3600. Enfin, il faut ajouter les degrés).

Coordonnées positives et négatives: les coordonnées au Nord et à l'Est sont des nombres positifs, les coordonnées au Sud et à l'Ouest sont des nombres négatifs – ainsi -23.456 144.666 correspond à 23.456S 144.666E

Souvenez-vous que les latitudes ne peuvent pas être supérieures à +/- 90 degrés, et que les longitudes ne peuvent pas être supérieures à 180 degrés

===Lieux===

Les noms de lieux sont définis par ordre d'importance décroissant, d'un point de vue géographique, et sont séparés par des virgules. Ainsi, les lieux français sont classés comme suit : Pays, Région, Département, Ville. Vous n'avez besoin de rentrer un lieu particulier une seule fois lorsque vous cliquez sur "éditer un lieu" - le logiciel PhpGedView le réutilisera autant que de besoin.

===Comment ajouter un lieu en utilisant le module Googlemap de PhpGedView (méthode recommandée)===

''Note préliminaire: le module Google Map est conçu pour fonctionner avec des lieux qui sont décrits de manière hiérarchique, d'un pont de vue géographique, un peu comme un arbre. Si nous considérons une ville de la région parisienne, cet arbre aurait la structure suivante 'France, Ile de France, Val d'Oise, Pontoise'. Cette structure hiérarchique vous aidera ainsi à retrouver un ensemble de personnes habitant ou ayant habité la même ville. Et cette structure est conforme aux spécifications du format GEDCOM, utilisé par PhpGedView.''

''Et, AVANT que vous ne commenciez votre travail de cartographie des lieux de vos ancêtres, vérifiez attentivement vos données. Assurez-vous que la structure des lieux est bien correcte et respecte la structure hiérarchique, qu'il n'y a pas de doublons, que les lieux sont bien rangés dans le bon département. Alors, le module Googlemap vous affichera très facilement les cartes correspondant aux données que vous aurez entrées.''

Cette fonctionnalité utilise de nouvelles tables dans votre base de données SQL pour enregistrer les noms et les coordonnées des lieux. Les lieux existants peuvent être importés et les informations relatives aux coordonnées de ces lieux peuvent être ajoutées en faisant appel aux outils graphiques (zoom/clic sur une carte) ou en entrant des coordonnées.

Les informations de localisation sont enregistrées ailleurs que dans le fichier GEDCOM (et peuvent être échangées entre des fichiers GEDCOM au format PhpGedView) et les données de localisation ne sont entrées qu'une seule fois pour un lieu donné. La restauration des données de localisation est possible par un export des nouvelles tables de la base de données SQL au format CSV. Des ajouts de données de localisation peuvent être effectués par un import de fichiers au format CSV (en respectant la structure hiérarchique exacte de description des lieux).

En utilisant la structure en arbre mentionnée plus haut, les données de localisation sont rentrées pour ce qui concerne les lieux français, en commençant par le pays, puis le région, le département et enfin la ville. En fonction des pays, cette description des localisations peut évoluer (il peut y avoir des comtés, des cantons,...). Dans tous les cas, il est impératif que cette structure soit en arbre (ou en poupées russes), en commençant par l'entité géographique la plus large (le pays) et en terminant par l'entité géographique la plus petite (la ville).

En utilisant vos droits d'administrateur, allez dans le menu d'administration et (à la fin de ce menu en bas à droite) cliquez sur "éditer les coordonnées d'un lieu". La partie supérieure gauche de l'écran ressemblera à ceci:

[[Image: Editer_un_lieu.jpg|center|Figure 6a]]

Le mot "Sommaire" qui apparaît sur cette fenêtre représente le niveau le plus haut de l'arbre hiérarchisé des lieux que vous utilisez dans votre logiciel. En règle générale, ce niveau le plus élevé correspond au pays, mais il pourrait correspondre à un continent si vous avez décidé de rentrer tous vos lieux sous la forme [Continent, Pays, Région, Département, Ville].

Cliquez sur 'Ajouter un lieu', et nous allons vous illustrer comment cette saisie de lieu se déroule pour le cas le plus courant où la niveau le plus élevé de l'arbre des lieux est le pays, et nous prendrons comme pays l'exemple de la France.

Une fois que l'on a cliqué sur "Ajouter un lieu", cette nouvelle fenêtre apparaît:

[[Image:Carteediterpays.jpg|center|452px|thumb|Figure 6b]]

Tapez alors 'France' dans la case "lieu", cliquez sur 'Pays' dans la case "précision", puis cliquez sur "Recherche" (Nota: il faut avoir place le curseur de votre souris à l'extérieur de la boite "pays" pour que le lien "Recherche" apparaisse et puisse être cliqué).

Si vous êtes connectés à Internet, le module Googlemap de PhpGedView va alors se connecter sur le site [http://www.geonames.org/ Geonames], qui dispose de l'enregistrement de 2.2 millions de lieux différents sur la planète entière. Si le lieu que vous avez entré a été trouvé par ce site, les détails apparaîtront automatiquement sur cette fenêtre. Vous pouvez toujours visiter le site par vous-même(http://www.geonames.org/).

Ainsi, pour la France, vous voyez alors apparaître sur la carte du monde 4 repères jaunes placés sur la France, l'Ile Maurice, l'Ile de France, et l'arrondissement de Fort de France. Et en dessous de la carte, ces quatre lieux apparaissent sous forme de liens cliquables.

[[Image:Carteediterpays2.jpg|center|452px|thumb|Figure 6c]]

Parmi ces quatre choix de lieux qui vous sont proposés par ce site, choisissez celui qui correspond à celui que vous voulez en cliquant sur 'Utiliser cette valeur'.

La fenêtre de dialogue fait alors apparaître une seul repère rouge placé sur la France, et les coordonnées moyennes en latitude et longitude de la France sont renseignées dans cette fenêtre:

[[Image:Carteediterpays3.jpg|center|452px|thumb|Figure 6d]]

Vous pouvez alors cliquer sur "Sauvegarder". Maintenant, vous aurez une entrée dans votre table des lieux chaque fois que vous cliquerez sur "Sommaire" (cf. figure 6a)

[[Image:Carteediterpays4.jpg|center|452px|thumb|Figure 6e]]

Vous pouvez remarquer que le pays, France, est un lien hypertexte que lequel on peut cliquer. Vous remarquez la présence d'une croix rouge '''X''' en bout de ligne qui indique que vous pouvez supprimer ce lieu si vous le désirez. La suppression est effective si vous cliquez sur cette croix.

Si vous cliquez sur ce lien "France" une fenêtre s'affiche vous indiquant qu'il n'y a aucun lieu à afficher. Celà signifie que les lieux qui constituent la France (les régions, les départements, les villes) n'ont pas encore été renseignés dans le logiciel.

Maintenant vous pouvez entrer la ville de Paris….Il suffit de cliquer sur 'Ajouter un lieu' et de recommencer la procédure indiquée au début de ce paragraphe.

La croix rouge '''X''' a été mentionnée. Au fur et à mesure que vous ajouter des niveaux hiérarchiques aux différents lieux, seules les catégories de lieux enregistrées correspondant au niveau le plus bas dans la hiérarchie des lieux feront apparaître le X. Les lieux qui correspondent à un niveau hiérarchique supérieur ne feront pas apparaître de X, parce qu'il existe des lieux de niveau inférieur qui dépendent de ce niveau supérieur. Si vous voulez supprimer quelque chose en utilisant cette croix rouge '''X''' , vous devrez commencer par détruire le lieu qui se situe au plus bas niveau hiérarchique - supprimer la ville, puis le département, puis la région, puis le pays. En clair, vous ne pourrez pas supprimer par cette méthode un département si vous n'avez pas supprimé l'ensemble des villes du département que vous aurez rentrées dans le logiciel.

===Ajouter des lieux un par un à partir du fichier GEDCOM (non recommandé)===

Cette méthode est expliquée ici afin que ayez une idée sur la façon des les enregistrements de lieux sont écrits dans un fichier GEDCOM. Vous n'avez pas besoin d'utiliser le module Googlemap pour utiliser cette procédure.

Les événements peuvent avoir des lieux qui leur sont "attachés", ainsi vous pouvez ajouter des lieux à des événements manuellement. Cette procédure est délicate et n'est pas conseillée. Ce processus ne permet pas à un lieu qui serait rentré de pouvoir être utilisé par plusieurs événements individuels

Les coordonnées géographiques d'un événement peuvent être ajoutées de manière isolée directement sur un fichier GEDCOM. Pour le faire, il suffit d'ajouter dans le fichier GEDCOM une balise PLAC suivie des informations:
::2 PLAC <Nom du lieu>
::3 MAP (Vérifiez bien que la balise ‘3 MAP’ est placée après la balise PLAC)
::4 LONG <Longitude>
::4 LATI <Latitude>

Les lignes MAP, LONG and LATI doivent être ajoutées directement après la ligne PLAC.

Dans la fenêtre d'édition qui s'affiche, il y a un signe ‘+’ sous le ‘lieu’ où vous pouvez enregistrer le pays, la région, le département et la ville qui existe dans le répertoire ‘places’ de votre logiciel PhpGedView. Celà peut vous éviter des doublons en rentrant une même commune avec des orthographes légèrement différentes. La configuration de PhpGedView vous permet, si vous sélectionnez l'option "découper les lieux" dans le menu administration, d'être guidé lors de la saisie de vos lieux afin d'éviter de tels doublons.

Cette méthode place 4 icônes en relation avec l'événement sur la fiche de l'individu. Ces icônes vous offrent les options d'utilisation des sites de cartographie Mapquest, Google Maps, Multimap ou Terraserver. Vous n'obtenez pas par cette méthode, d'affichage automatique d'onglet "carte".

===Importer les données de votre (ou de vos) fichier(s) GEDCOM===

En important les données de votre fichier GEDCOM, vous peuplez la table des "lieux" (appelée "''placelocation''" en anglais)avec tous les lieux qui sont présents dans votre fichier GEDCOM. MAIS – ces lieux n'auuront pas de coordonnées en LATITUDE / LONGITUDE. Vous aurez besoin de rentrer ces coordonnées pour chacun des lieux existants. Voir plus bas le paragraphe ‘Vous pouvez éditer et supprimer…’.

===Importer à partir d'un fichier===

Cette option vous permet d'importer des données de lieux, en incluant tous les champs nécessaires pour la table des coordonnées en LATITUDE/LONGITUDE, à partir de fichiers préparés à l'avance au format Excel (.csv). Vous pouvez:
* créer votre propre table,
* utiliser celles qui sont fournies dans le répertoire ‘modules/googlemap/extra’,
* utiliser les tables des villes françaises qui ont été spécialement créées par les membres du forum. '''Je vous conseille cete méthode'''. Vous pouvez télécharger ces fichiers sur le [http://forum.fr.phpgedview.free.fr/spip.php?article28 site du forum français de PhpGedView]
Si vous avez un nombre important de pays disponibles sous forme de fichiers Excel (.csv), c'est la méthode la plus rapide et la plus facile pour créer automatiquement vos cartes.

Cependant – il est conseillé de vérifier que les marqueurs PLAC qui sont présents dans votre fichier GEDCOM correspondent très EXACTEMENT aux lieux qui sont présents dans les fichiers au format Excel que vous importez, en respectant la structure et la hiérarchie – c'est à dire, avez-vous chaque ville dans le bon département et/ou la bonne région ?

==Vous pouvez éditer et supprimer les coordonnées…..==

Cette méthode est intuitive. Cliquez sur "Editer les coordonnées du lieu" à partir du menu administration et vous afficherez une fenêtre qui ressemble à celle de la figure 8.

La crois rouge X permet de supprimer l'élément. Si la croix X est grise (ou s'il n'y a pas de croix X), celà indique que l'élément a des lieux de niveau inférieur qui ont été entrées dans la table. Si vous voulez supprimer l'entité de niveau supérieur, vous devez d'abord supprimer les entités de niveaux inférieurs. Lisez le paragraphe technique ci-dessous si vous voulez en savoir plus sur ce point.

[[Image:Editer_un_lieu1.jpg|center|532px|thumb|Figure 8]]

==Paragraphe technique==

Les données de lieux du module GoogleMaps sont placées dans une table à part, distincte de la table des lieux du logiciel PhpGeView. Cette table, appelée "placelocation" a la structure suivante:

<center>Table 1: placelocation</center>

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
!Field!!Def!!Desc
|-
|pl_id||int(11)||Index incrémental
|-
|pl_parent_id||int(11)||Fait référence au niveau hiérarchique ‘parent’
|-
|pl_level||int(11)||Niveau hiérarchique (Le niveau 0 correspond au pays, le niveau 3 à une commune)
|-
|pl_place||varchar(255)||Le nom du lieu
|-
|pl_long||varchar(30)||Coordonnées de Longitude
|-
|pl_lati||varchar(30)||Coordonnées de Latitude
|-
|pl_zoom||int(4)||Niveau de zoom dans Googlemap
|-
|pl_icon||varchar(255)||Indique l'icône qui sera utilisée pour marquer le lieu
|-
|}

Les données sont enregistrées dans une table séparée afin que cette table puisse être utilisée par plusieurs fichiers GEDCOM. Ainsi, lorsque vous supprimez un fichier GEDCOM, les coordonnées des lieux sont conservées et pourront être utilisées lorsque vous réimporterez votre fichier GEDCOM.

===Lieux===

En pratique, tous les ‘lieux’ sont définis par un identifiant qui correspond à ‘Monpays, MaRégion, MonDépartement, MaVille’. Ces identifiants ont un 'niveau' équivalent:

::Pays = niveau 0 
::Région = niveau 1 
::Département = niveau 2 
::Commune = niveau 3 

Lorsque vous recherchez le nom d'un lieu dans la table, le logiciel va rechercher si ce lieu existe dans la table de manière séquentielle en commençant par le niveau le plus haut et en desendant jusqu'au niveau le plus bas, jusqu'à ce qu'il trouve le lieu.

Quand vous créez une définition pour un lieu, vous le spécifiez de la même façon. Pour pointer sur le lieu auquel vous faites référence, vous ajoutez un 'niveau' à l'ensemble de la description du lieu. Ainsi la description de votre lieu ressemble à ceci: "Niveau, Monpays, MaRégion, MonDépartement, MaVille".

Le niveau correspond à la place du lieu que vous voulez définir dans l'ordre hiérarchique des lieux. Ainsi, Monpays correspond au niveau 0, Macommune correspond au niveau 4.

La longitude, la latitude, le niveau de zoom et l'icône sont des valeurs qui sont simplement ajoutées à la fin de l'identifiant du lieu.

Ainsi la description complète d'un lieu aura la forme suivante: 
"Niveau, Monpays, MaRégion, MonDépartement, MaVille, MaLongitude, MaLatitude, Monniveaudezoom, MonIcône".

Vous pouvez omettre une partie de la description du lieu, mais pas le caractère ‘''','''’ qui sépare les différentes composantes de votre description. Vous pouvez ainsi avoir la description suivante (en omettant la région): 
"Niveau, Monpays''',,''' MonDépartement, MaVille, MaLongitude, MaLatitude, Monniveaudezoom, MonIcône". (notez bien les deux virgules qui séparent Mopays et Mondépartement).

Le corollaire de ceci est que vous avez besoin de prendre en considération la séquence de lieux quand vous importez des données d'une source quelconque. Vous devez construire dès le début la séquence des lieux, de manière à obtenir, dans l'ordre: 
‘Niveau, MonPays,,,, MaLongitude, MaLatitude, MonfacteurdeZoom, MonIcône’ 
‘Niveau, MonPays, MaRégion,,, MaLongitude, MaLatitude, MonfacteurdeZoom, MonIcône’ 
‘Niveau, MonPays, MaRégion, MonDépartement,, MaLongitude, MaLatitude, MonfacteurdeZoom, MonIcône’ 
…et ainsi de suite...

La table ‘placelocation’ enregistre les lieux dans 8 champs, qui ont été conçus pour enregistrer chaque lieu une fois pour toutes, avec une référence au lieu de niveau immédiatement supérieur (appelé niveau parent) qui est enregistré dans le champ pl_parent_id. Le champ pl_id auquel le lieu fait référence est un nombre séquentiel généréré automatiquement.

Une structure typique de la table, ressemble donc à ceci:
[Note – some columns have been ignored for display purposes only]

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
!pl_id!!pl_parent_id!!pl_level!!pl-place!!pl_long!! pl_lati
|-
!1!! 0|| 0|| France|| E2.00|| N46.00
|-
!6!! 1|| 1|| Alsace|| E7.3004|| N47.6894
|-
!7!! 6|| 2|| Bas-Rhin|| E7.5421|| N48.5602
|-
!8!! 7|| 3|| Strasbourg 67482|| E7.7500|| N48.5833
|-
|}

Remarquez qu'il y a 9 champs dans la table. Ce nombre est fixé. Si vous avez l'intention de construire un fichier .CSV afin de l'importer, assurez vous de bien avoir 9 champs sur chaque ligne de votre fichier.

==Configuration de Googlemap – signification des différentes rubriques==

Référez-vous à la Figure 4

La première ligne de saisie vous permet d'activer ou non la fonction Googlemap.

La deuxième ligne vous permet d'entrer la clé d'enregistrement API de Googlemap.

La troisième ligne définit le type d'affichage – carte, image satellite, ou une combinaison des deux (hybride).

La quatrième ligne définit la taille de la carte lorsqu'elle est affichée sur l'écran. La taille par défaut (600 x 400 pixels) peut être ajustée à vos desiderata.

La cinquième ligne correspond au niveau de zoom. Le niveau 0 correspond au pays (niveau de détail le plus bas), le niveau maximum correspond au niveau de détail le plus élevé. Remarquez que quelques cartes satellites ne sont pas disponibles pour le niveau de zoom le plus élevé.

Précision: celà détermine le nombre de décimales qui sont utilisés pour les coordonnées des lieux. Un pays a probablement d'une seul décimale, une commune a besoin de 3 décimales. La troisième décimale fait déplacer le pointeur sur la carte par incréments d'environ 110 mètres. La sixième décimale a une précision d'environ 0.1 mètre.

[[en: Add Google maps]]

Comment ajouter une carte Googlemap

2007-09-02T13:00:59Z

Papagolf : /* Lieux */

==Ajouter des cartes à PhpGedView==

Un module additionnel a été développé pour PhpGedView (PGV) afin de permettre aux utilisateurs d'ajouter des cartes aux données de leur famille. Ce module s'appelle Googlemap, et fonctionne avec les versions PGV 3.3.8 et 4.0.x.

['''Note:''' ''Cette carte additionnelle est bien distincte des petites icônes de couleur présentes sur les fiches individuelles qui permettent en cliquant dessus, d'accéder à des cartes sur différents sites web. Ces cartes sont générées à partir des renseignements de longitude et de latitude qui ont été ajoutés dans le fichier GEDCOM.'']

Ce module affiche des informations supplémentaires sur les individus - voir Figure 1. Il y a un onglet supplémentaire sur la fiche de chaque individu qui présente une carte issue de Google Maps.

On peut cliquer sur chacun des marqueurs présents sur cette carte afin d'afficher les données qui sont attachées au lieu pointé par le marqueur. Si plus d'un événement s'est déroulé à l'endroit du marqueur, les événéments supplémentaires sont alors affichés dans des tableaux.

[[Image:Carte googlemap.png|thumb|center|Figure 1]]

===Logiciel===

Vous devrez télécharger le module "googlemap files" nécessaire à l'adresse suivante [http://sourceforge.net/project/showfiles.php?group_id=55456&package_id=88140&release_id=427780]

Soyez bien conscient que ce module est encore en cours de développement et peut évoluer de temps à autre.

Si vous voulez être tenu informé des dernières modifications (ainsi que des derniers développements sur l'ensemble de PhpGedView) je vous conseille de visiter régulièrement cette adresse: [http://sourceforge.net/project/showfiles.php?group_id=55456&package_id=88140&release_id=427780] (évidemment, c'est en anglais !)

Une fois que vous aurez téléchargé ce module, vous obtiendrez les fichiers suivants:

[[Image:Gm2.jpg|center|450px|thumb|Figure 2]]

Le répertoire ‘extra’ n'est pas nécessaire: vous pouvez ou non le télécharger (les fichiers qui appartiennent à ce répertoire sont des listes de lieux que vous pouvez importer au moyen de la fonction "Editer des lieux").

Copiez la totalité des fichiers du module googlemap que venez de télécharger (avec ou sans le répertoire extra. '''N'oubliez pas de télécharger le fichier googlemap.php !''') dans le répertoire "modules" du logiciel PhpGedView que vous avez installé. Modifiez les permissions du répertoire "modules" ainsi que celles de tous les fichiers du répertoire à ‘777’.

De plus, les fichiers suivants doivent aussi être mis à jour:
* le fichier '''admin.php''' qui se situe à la racine du répertoire de votre logiciel PhpGedView a besoin d'être mise à jour. En effet, cette nouvelle version est nécessaire afin de faire apparaître, au bas de la page d'administration du logiciel, la rubrique "configuration googlemap". Pour celà, allez à l'adresse http://phpgedview.svn.sourceforge.net/viewvc/phpgedview/trunk/phpGedView/ et récupérez la dernière version de ce fichier. Téléchargez cette nouvelle version sur votre serveur (dans le répertoire d'installation de votre logiciel PhpGedView) afin de remplacer le fichier admin.php qui y était.
* le fichier '''lang.fr.php''' qui se trouve dans le répertoire 'modules/googlemap/langages' de votre logiciel PhpGedView a également besoin d'être mise à jour. En effet, cette nouvelle version est nécessaire afin de faire apparaître en français la rubrique "configuration googlemap" qui a été ajoutée par la nouvelle version du fichier '''admin.php''' que vous avez téléchargée ci-dessus. Pour celà, allez à l'adresse http://phpgedview.svn.sourceforge.net/viewvc/phpgedview/trunk/phpGedView/modules/googlemap/languages/

Note spéciale pour les utilisateurs de la version PGV3.3.8: allez à la racine de répertoire d'installation de PhpGedView, et renommez le fichier ‘individual.php’ en ‘zindividual.php’ (ou n'importe quel autre nom). Puis copiez le fichier ‘individual-3.3.8.php’ à la place du fichier ‘individual.php’

===La clé d'enregistrement===

Pour permettre une connection au serveur Google Maps, vous devz obtenir une clé d'enregistrement auprès de Google.

Allez à l'adresse suivante http://www.google.com/apis/maps/signup.html. Cette adresse correspond au site Google Map, et vous devrez vous enregistrer en tant que membre de Google pour pouvoir aller à l'étape suivante. Donc, enregistrez-vous. IL n'y a aucun danger.

Une fois que vous avez réalisé votre enregistrement, vous pouvez allors vous connecter avec votre identifiant de membre Google. Google vous demandera alors où se situe votre répertoire d'installation de PhpGedView installation, il vous faut donc rentrer l'URL (l'adresse internet) www.xxxx.yyyy.zz/place de votre répertoire PhpGedView. Choisissez un endroit de votre arborescence qui vous permettra d'utiliser votré clé d'enregistrement pour plusieurs bases de données (si tant est que vous ayez plusieurs bases de données avec votre logiciel PhpGedView).

Une fois que vous avez obtenu votre clé d'enregistrement, gardez en une copie. Sous Windows, surlignez là, faites Ctrl+C - n'essayez pas de copier la clé en recopiant chaque caractère – vous risqueriez de vous tromper! Et, par sécurité, ouvrez Notepad, copiez la clé, et sauvegardez le fichier pour plus tard (au cas où).

===Commencer l'opération===

Vous pouvez maintenant vous connecter en tant qu'administrateur à PhpGedView. Pendant cette opération, le module Googlemap va créer une nouvelle table (‘placelocation’) dans la base de données de votre serveur.

Le menu d'administration s'affiche alors, et en bas de la page vous verrez apparaitre un lien de configuration de Googlemap. Choisissez ‘Configuration Googlemap’. Si l'option de configuration n'apparait pas, vérifiez que vous avez bien le fichier ‘config.php’ que vous avez créé.

[[Image:Config google.png|center|485px|thumb|Figure 3]]

Une nouvelle fenêtre s'ouvre alors:

[[Image:activer googlemap.png|center|690px|thumb|Figure 4]]

Sélectionnez "Activer Googlemap" à ‘Oui’ and et copiez votre clé d'enregistrement Googlemap dans l'emplacement "Clé API Google Maps". Sauvegardez votre configuration. Vous pourrez toujours par la suite revenir à cette page de configuration de Googlemap pour modifier les autres paramètres de cette page lorsque vous aurez acquis plus d'expérience.

A ce stade, déconnectez-vous de PhpGedView. Puis connectez-vous à nouveau, et vérifiez que la page de chaque individu dispose bien d'un onglet "Carte", bien que cet onglet soit grisé en clair. Si tel n'est pas le cas, recommencez l'opération depuis le début.….mais, avant de toute recommencer depuis le début, copiez le fichier defaultconfig.php sur votre serveur, et renommez le config.php (celà signifiera que vous avez les deux fichiers config.php et defaultconfig.php dans le répertoire googlemap). Et vérifiez également la configuration de Googlemap configuration afin de vous assurer que vous n'avez pas égaré votre clé d'enregistrement...

Maintenant, revenez au sommet de la page de configuration et recommencez l'opération...

Vous êtes maintenant près à inclure les données de cartographie dans votre fichier. Avant celà, n'oubliez pas de modifier les droits à permission de votre répertoire "modules" à ‘644’.

==Comment faire apparaître les cartes==

L'étape suivante nécessite quelques explications.

===Obtenir les coordonnées (latitude, longitude) des lieux===

Les coordonnées (latitude, longitude) des lieux peuvent être obtenues de plusieurs façons.

Voici une liste non exhaustive de sites vous permettant d'obtenir ces coordonnées:
* en utilisant le logiciel Google Earth, vous explorez la planète et obtenez instantanément les coordonnées d'un lieu en pointant votre souris
* en utilisant le site de cartographie [http://www.infosports.com/m/map.htm Cartes Googlemap], vous pouvez lire les coordonnées directement en parcourant les cartes
* http://www.beeloop.com/maps/flickr_geotagr.php?language=english, est un autre site qui vous permet également de parcourir les cartes de la planète et d'afficher en instantané les des lieux visités
* sur le [https://sourceforge.net/project/showfiles.php?group_id=55456&package_id=61563&release_id=435146 site officiel de PhpGedView ] vous pouvez téléchargez les fichiers qui contiennent les coordonnées des villes de différents pays (Allemagne, Royaume Uni, Pays Bas, Etats-Unis sont les pays disponibles à la date du 20 mars 2007), et vous pouvez ensuite importer les fichiers à partir du menu de configuration de Googlemap selon la méthode décrite ci-après.

Il n'est pas inutile de vérifier les données que vous avez importées pour vérifier qu'elles respectent les conventions suivantes:

===Coordonnées===

Habituellement, les coordonnées sont rentrées en degrés, minutes (il y a 60 degrés dans une minute) et secondes (il y a 60 secondes dans une minute), et sont écrites selon ce format: 33° 44’ 55”. Dans la plupart des ordinateurs, vous pouvez entrer ces coordonnées sans avoir besoin de saisir les symboles ° ' " - 33 44 55, vous pouvez aussi les rentrer au format décimal: 33.7486 (pour arriver à ce format il suffit de multiplier les minutes par 60, d'ajouter les secondes, puis diviser la somme par 3600. Enfin, il faut ajouter les degrés).

Coordonnées positives et négatives: les coordonnées au Nord et à l'Est sont des nombres positifs, les coordonnées au Sud et à l'Ouest sont des nombres négatifs – ainsi -23.456 144.666 correspond à 23.456S 144.666E

Souvenez-vous que les latitudes ne peuvent pas être supérieures à +/- 90 degrés, et que les longitudes ne peuvent pas être supérieures à 180 degrés

===Lieux===

Les noms de lieux sont définis par ordre d'importance décroissant, d'un point de vue géographique et sont séparés par des virgules. Ainsi, les lieux français sont classés comme suit: Pays, Région, Département, Ville. Vous n'avez besoin de rentrer un lieu particulier une seule fois lorsque vous cliquez sur "éditer un lieu" - le logiciel PhpGedView le réutilisera autant que de besoin.

===Comment ajouter un lieu en utilisant le module Googlemap de PhpGedView (méthode recommandée)===

''Note préliminaire: le module Google Map est conçu pour fonctionner avec des lieux qui sont décrits de manière hiérarchique, d'un pont de vue géographique, un peu comme un arbre. Si nous considérons une ville de la région parisienne, cet arbre aurait la structure suivante 'France, Ile de France, Val d'Oise, Pontoise'. Cette structure hiérarchique vous aidera ainsi à retrouver un ensemble de personnes habitant ou ayant habité la même ville. Et cette structure est conforme aux spécifications du format GEDCOM, utilisé par PhpGedView.''

''Et, AVANT que vous ne commenciez votre travail de cartographie des lieux de vos ancêtres, vérifiez attentivement vos données. Assurez-vous que la structure des lieux est bien correcte et respecte la structure hiérarchique, qu'il n'y a pas de doublons, que les lieux sont bien rangés dans le bon département. Alors, le module Googlemap vous affichera très facilement les cartes correspondant aux données que vous aurez entrées.''

Cette fonctionnalité utilise de nouvelles tables dans votre base de données SQL pour enregistrer les noms et les coordonnées des lieux. Les lieux existants peuvent être importés et les informations relatives aux coordonnées de ces lieux peuvent être ajoutées en faisant appel aux outils graphiques (zoom/clic sur une carte) ou en entrant des coordonnées.

Les informations de localisation sont enregistrées ailleurs que dans le fichier GEDCOM (et peuvent être échangées entre des fichiers GEDCOM au format PhpGedView) et les données de localisation ne sont entrées qu'une seule fois pour un lieu donné. La restauration des données de localisation est possible par un export des nouvelles tables de la base de données SQL au format CSV. Des ajouts de données de localisation peuvent être effectués par un import de fichiers au format CSV (en respectant la structure hiérarchique exacte de description des lieux).

En utilisant la structure en arbre mentionnée plus haut, les données de localisation sont rentrées pour ce qui concerne les lieux français, en commençant par le pays, puis le région, le département et enfin la ville. En fonction des pays, cette description des localisations peut évoluer (il peut y avoir des comtés, des cantons,...). Dans tous les cas, il est impératif que cette structure soit en arbre (ou en poupées russes), en commençant par l'entité géographique la plus large (le pays) et en terminant par l'entité géographique la plus petite (la ville).

En utilisant vos droits d'administrateur, allez dans le menu d'administration et (à la fin de ce menu en bas à droite) cliquez sur "éditer les coordonnées d'un lieu". La partie supérieure gauche de l'écran ressemblera à ceci:

[[Image: Editer_un_lieu.jpg|center|Figure 6a]]

Le mot "Sommaire" qui apparaît sur cette fenêtre représente le niveau le plus haut de l'arbre hiérarchisé des lieux que vous utilisez dans votre logiciel. En règle générale, ce niveau le plus élevé correspond au pays, mais il pourrait correspondre à un continent si vous avez décidé de rentrer tous vos lieux sous la forme [Continent, Pays, Région, Département, Ville].

Cliquez sur 'Ajouter un lieu', et nous allons vous illustrer comment cette saisie de lieu se déroule pour le cas le plus courant où la niveau le plus élevé de l'arbre des lieux est le pays, et nous prendrons comme pays l'exemple de la France.

Une fois que l'on a cliqué sur "Ajouter un lieu", cette nouvelle fenêtre apparaît:

[[Image:Carteediterpays.jpg|center|452px|thumb|Figure 6b]]

Tapez alors 'France' dans la case "lieu", cliquez sur 'Pays' dans la case "précision", puis cliquez sur "Recherche" (Nota: il faut avoir place le curseur de votre souris à l'extérieur de la boite "pays" pour que le lien "Recherche" apparaisse et puisse être cliqué).

Si vous êtes connectés à Internet, le module Googlemap de PhpGedView va alors se connecter sur le site [http://www.geonames.org/ Geonames], qui dispose de l'enregistrement de 2.2 millions de lieux différents sur la planète entière. Si le lieu que vous avez entré a été trouvé par ce site, les détails apparaîtront automatiquement sur cette fenêtre. Vous pouvez toujours visiter le site par vous-même(http://www.geonames.org/).

Ainsi, pour la France, vous voyez alors apparaître sur la carte du monde 4 repères jaunes placés sur la France, l'Ile Maurice, l'Ile de France, et l'arrondissement de Fort de France. Et en dessous de la carte, ces quatre lieux apparaissent sous forme de liens cliquables.

[[Image:Carteediterpays2.jpg|center|452px|thumb|Figure 6c]]

Parmi ces quatre choix de lieux qui vous sont proposés par ce site, choisissez celui qui correspond à celui que vous voulez en cliquant sur 'Utiliser cette valeur'.

La fenêtre de dialogue fait alors apparaître une seul repère rouge placé sur la France, et les coordonnées moyennes en latitude et longitude de la France sont renseignées dans cette fenêtre:

[[Image:Carteediterpays3.jpg|center|452px|thumb|Figure 6d]]

Vous pouvez alors cliquer sur "Sauvegarder". Maintenant, vous aurez une entrée dans votre table des lieux chaque fois que vous cliquerez sur "Sommaire" (cf. figure 6a)

[[Image:Carteediterpays4.jpg|center|452px|thumb|Figure 6e]]

Vous pouvez remarquer que le pays, France, est un lien hypertexte que lequel on peut cliquer. Vous remarquez la présence d'une croix rouge '''X''' en bout de ligne qui indique que vous pouvez supprimer ce lieu si vous le désirez. La suppression est effective si vous cliquez sur cette croix.

Si vous cliquez sur ce lien "France" une fenêtre s'affiche vous indiquant qu'il n'y a aucun lieu à afficher. Celà signifie que les lieux qui constituent la France (les régions, les départements, les villes) n'ont pas encore été renseignés dans le logiciel.

Maintenant vous pouvez entrer la ville de Paris….Il suffit de cliquer sur 'Ajouter un lieu' et de recommencer la procédure indiquée au début de ce paragraphe.

La croix rouge '''X''' a été mentionnée. Au fur et à mesure que vous ajouter des niveaux hiérarchiques aux différents lieux, seules les catégories de lieux enregistrées correspondant au niveau le plus bas dans la hiérarchie des lieux feront apparaître le X. Les lieux qui correspondent à un niveau hiérarchique supérieur ne feront pas apparaître de X, parce qu'il existe des lieux de niveau inférieur qui dépendent de ce niveau supérieur. Si vous voulez supprimer quelque chose en utilisant cette croix rouge '''X''' , vous devrez commencer par détruire le lieu qui se situe au plus bas niveau hiérarchique - supprimer la ville, puis le département, puis la région, puis le pays. En clair, vous ne pourrez pas supprimer par cette méthode un département si vous n'avez pas supprimé l'ensemble des villes du département que vous aurez rentrées dans le logiciel.

===Ajouter des lieux un par un à partir du fichier GEDCOM (non recommandé)===

Cette méthode est expliquée ici afin que ayez une idée sur la façon des les enregistrements de lieux sont écrits dans un fichier GEDCOM. Vous n'avez pas besoin d'utiliser le module Googlemap pour utiliser cette procédure.

Les événements peuvent avoir des lieux qui leur sont "attachés", ainsi vous pouvez ajouter des lieux à des événements manuellement. Cette procédure est délicate et n'est pas conseillée. Ce processus ne permet pas à un lieu qui serait rentré de pouvoir être utilisé par plusieurs événements individuels

Les coordonnées géographiques d'un événement peuvent être ajoutées de manière isolée directement sur un fichier GEDCOM. Pour le faire, il suffit d'ajouter dans le fichier GEDCOM une balise PLAC suivie des informations:
::2 PLAC <Nom du lieu>
::3 MAP (Vérifiez bien que la balise ‘3 MAP’ est placée après la balise PLAC)
::4 LONG <Longitude>
::4 LATI <Latitude>

Les lignes MAP, LONG and LATI doivent être ajoutées directement après la ligne PLAC.

Dans la fenêtre d'édition qui s'affiche, il y a un signe ‘+’ sous le ‘lieu’ où vous pouvez enregistrer le pays, la région, le département et la ville qui existe dans le répertoire ‘places’ de votre logiciel PhpGedView. Celà peut vous éviter des doublons en rentrant une même commune avec des orthographes légèrement différentes. La configuration de PhpGedView vous permet, si vous sélectionnez l'option "découper les lieux" dans le menu administration, d'être guidé lors de la saisie de vos lieux afin d'éviter de tels doublons.

Cette méthode place 4 icônes en relation avec l'événement sur la fiche de l'individu. Ces icônes vous offrent les options d'utilisation des sites de cartographie Mapquest, Google Maps, Multimap ou Terraserver. Vous n'obtenez pas par cette méthode, d'affichage automatique d'onglet "carte".

===Importer les données de votre (ou de vos) fichier(s) GEDCOM===

En important les données de votre fichier GEDCOM, vous peuplez la table des "lieux" (appelée "''placelocation''" en anglais)avec tous les lieux qui sont présents dans votre fichier GEDCOM. MAIS – ces lieux n'auuront pas de coordonnées en LATITUDE / LONGITUDE. Vous aurez besoin de rentrer ces coordonnées pour chacun des lieux existants. Voir plus bas le paragraphe ‘Vous pouvez éditer et supprimer…’.

===Importer à partir d'un fichier===

Cette option vous permet d'importer des données de lieux, en incluant tous les champs nécessaires pour la table des coordonnées en LATITUDE/LONGITUDE, à partir de fichiers préparés à l'avance au format Excel (.csv). Vous pouvez:
* créer votre propre table,
* utiliser celles qui sont fournies dans le répertoire ‘modules/googlemap/extra’,
* utiliser les tables des villes françaises qui ont été spécialement créées par les membres du forum. '''Je vous conseille cete méthode'''. Vous pouvez télécharger ces fichiers sur le [http://forum.fr.phpgedview.free.fr/spip.php?article28 site du forum français de PhpGedView]
Si vous avez un nombre important de pays disponibles sous forme de fichiers Excel (.csv), c'est la méthode la plus rapide et la plus facile pour créer automatiquement vos cartes.

Cependant – il est conseillé de vérifier que les marqueurs PLAC qui sont présents dans votre fichier GEDCOM correspondent très EXACTEMENT aux lieux qui sont présents dans les fichiers au format Excel que vous importez, en respectant la structure et la hiérarchie – c'est à dire, avez-vous chaque ville dans le bon département et/ou la bonne région ?

==Vous pouvez éditer et supprimer les coordonnées…..==

Cette méthode est intuitive. Cliquez sur "Editer les coordonnées du lieu" à partir du menu administration et vous afficherez une fenêtre qui ressemble à celle de la figure 8.

La crois rouge X permet de supprimer l'élément. Si la croix X est grise (ou s'il n'y a pas de croix X), celà indique que l'élément a des lieux de niveau inférieur qui ont été entrées dans la table. Si vous voulez supprimer l'entité de niveau supérieur, vous devez d'abord supprimer les entités de niveaux inférieurs. Lisez le paragraphe technique ci-dessous si vous voulez en savoir plus sur ce point.

[[Image:Editer_un_lieu1.jpg|center|532px|thumb|Figure 8]]

==Paragraphe technique==

Les données de lieux du module GoogleMaps sont placées dans une table à part, distincte de la table des lieux du logiciel PhpGeView. Cette table, appelée "placelocation" a la structure suivante:

<center>Table 1: placelocation</center>

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
!Field!!Def!!Desc
|-
|pl_id||int(11)||Index incrémental
|-
|pl_parent_id||int(11)||Fait référence au niveau hiérarchique ‘parent’
|-
|pl_level||int(11)||Niveau hiérarchique (Le niveau 0 correspond au pays, le niveau 3 à une commune)
|-
|pl_place||varchar(255)||Le nom du lieu
|-
|pl_long||varchar(30)||Coordonnées de Longitude
|-
|pl_lati||varchar(30)||Coordonnées de Latitude
|-
|pl_zoom||int(4)||Niveau de zoom dans Googlemap
|-
|pl_icon||varchar(255)||Indique l'icône qui sera utilisée pour marquer le lieu
|-
|}

Les données sont enregistrées dans une table séparée afin que cette table puisse être utilisée par plusieurs fichiers GEDCOM. Ainsi, lorsque vous supprimez un fichier GEDCOM, les coordonnées des lieux sont conservées et pourront être utilisées lorsque vous réimporterez votre fichier GEDCOM.

===Lieux===

En pratique, tous les ‘lieux’ sont définis par un identifiant qui correspond à ‘Monpays, MaRégion, MonDépartement, MaVille’. Ces identifiants ont un 'niveau' équivalent:

::Pays = niveau 0 
::Région = niveau 1 
::Département = niveau 2 
::Commune = niveau 3 

Lorsque vous recherchez le nom d'un lieu dans la table, le logiciel va rechercher si ce lieu existe dans la table de manière séquentielle en commençant par le niveau le plus haut et en desendant jusqu'au niveau le plus bas, jusqu'à ce qu'il trouve le lieu.

Quand vous créez une définition pour un lieu, vous le spécifiez de la même façon. Pour pointer sur le lieu auquel vous faites référence, vous ajoutez un 'niveau' à l'ensemble de la description du lieu. Ainsi la description de votre lieu ressemble à ceci: "Niveau, Monpays, MaRégion, MonDépartement, MaVille".

Le niveau correspond à la place du lieu que vous voulez définir dans l'ordre hiérarchique des lieux. Ainsi, Monpays correspond au niveau 0, Macommune correspond au niveau 4.

La longitude, la latitude, le niveau de zoom et l'icône sont des valeurs qui sont simplement ajoutées à la fin de l'identifiant du lieu.

Ainsi la description complète d'un lieu aura la forme suivante: 
"Niveau, Monpays, MaRégion, MonDépartement, MaVille, MaLongitude, MaLatitude, Monniveaudezoom, MonIcône".

Vous pouvez omettre une partie de la description du lieu, mais pas le caractère ‘''','''’ qui sépare les différentes composantes de votre description. Vous pouvez ainsi avoir la description suivante (en omettant la région): 
"Niveau, Monpays''',,''' MonDépartement, MaVille, MaLongitude, MaLatitude, Monniveaudezoom, MonIcône". (notez bien les deux virgules qui séparent Mopays et Mondépartement).

Le corollaire de ceci est que vous avez besoin de prendre en considération la séquence de lieux quand vous importez des données d'une source quelconque. Vous devez construire dès le début la séquence des lieux, de manière à obtenir, dans l'ordre: 
‘Niveau, MonPays,,,, MaLongitude, MaLatitude, MonfacteurdeZoom, MonIcône’ 
‘Niveau, MonPays, MaRégion,,, MaLongitude, MaLatitude, MonfacteurdeZoom, MonIcône’ 
‘Niveau, MonPays, MaRégion, MonDépartement,, MaLongitude, MaLatitude, MonfacteurdeZoom, MonIcône’ 
…et ainsi de suite...

La table ‘placelocation’ enregistre les lieux dans 8 champs, qui ont été conçus pour enregistrer chaque lieu une fois pour toutes, avec une référence au lieu de niveau immédiatement supérieur (appelé niveau parent) qui est enregistré dans le champ pl_parent_id. Le champ pl_id auquel le lieu fait référence est un nombre séquentiel généréré automatiquement.

Une structure typique de la table, ressemble donc à ceci:
[Note – some columns have been ignored for display purposes only]

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
!pl_id!!pl_parent_id!!pl_level!!pl-place!!pl_long!! pl_lati
|-
!1!! 0|| 0|| France|| E2.00|| N46.00
|-
!6!! 1|| 1|| Alsace|| E7.3004|| N47.6894
|-
!7!! 6|| 2|| Bas-Rhin|| E7.5421|| N48.5602
|-
!8!! 7|| 3|| Strasbourg 67482|| E7.7500|| N48.5833
|-
|}

Remarquez qu'il y a 9 champs dans la table. Ce nombre est fixé. Si vous avez l'intention de construire un fichier .CSV afin de l'importer, assurez vous de bien avoir 9 champs sur chaque ligne de votre fichier.

==Configuration de Googlemap – signification des différentes rubriques==

Référez-vous à la Figure 4

La première ligne de saisie vous permet d'activer ou non la fonction Googlemap.

La deuxième ligne vous permet d'entrer la clé d'enregistrement API de Googlemap.

La troisième ligne définit le type d'affichage – carte, image satellite, ou une combinaison des deux (hybride).

La quatrième ligne définit la taille de la carte lorsqu'elle est affichée sur l'écran. La taille par défaut (600 x 400 pixels) peut être ajustée à vos desiderata.

La cinquième ligne correspond au niveau de zoom. Le niveau 0 correspond au pays (niveau de détail le plus bas), le niveau maximum correspond au niveau de détail le plus élevé. Remarquez que quelques cartes satellites ne sont pas disponibles pour le niveau de zoom le plus élevé.

Précision: celà détermine le nombre de décimales qui sont utilisés pour les coordonnées des lieux. Un pays a probablement d'une seul décimale, une commune a besoin de 3 décimales. La troisième décimale fait déplacer le pointeur sur la carte par incréments d'environ 110 mètres. La sixième décimale a une précision d'environ 0.1 mètre.

[[en: Add Google maps]]

Comment personnaliser votre thème

2007-09-02T09:12:36Z

Papagolf : /* Personnaliser les menus */

==Introduction==

Ce tutoriel vous aidera à personnaliser l'apparence de votre site PhpGedView qui s'appelle "thème" dans le langage des initiés. Tous les fichiers référencés dans ce tutoriel existent dans le répertoire "themes" de votre installation PhpGedView et ont été conçus afin que vous puissiez effectuer des modifications autant que vous le souhaitez sans créer de dysfonctionnement au programme phpGedView, bien qu'il peut exister quelques codes PHP code inclus dans les fichiers. Une compréhension des feuilles de styles CSS stylesheets aet du langage HTML est nécessaire pour personnaliser les thèmes de votre site. Quelques connaissances de base en PHP peuvent également aider.

==Les différentes étapes à suivre pour personnaliser votre thème==

Les étapes suivantes vous guideront pour construire votre propre thème pour votre site PhpGedView:

1. Effectuez une copie de l'un des sous-répertoires du répertoire "themes" de votre installation PhpGedView, afin de fournir une base à la personnalisation de votre thème. Dans le répertoire "themes" de votre installation PhpGedView, vous avez les sous-répertoires suivants: cloudy, minimal, ocean, simply blue, simply green, simply red, standard, xood et xenea. Vous choisissez le sous-répertoire qui correspond au thème qui se rapproche le plus de celui que vous voulez personnaliser, et vous en faites une copie en lui donnant un nouveau nom, par exemple "mon thème". Ce nom correspondra au thème que vous allez personnaliser.

2. Dans ce sous-répertoire que vous aurez copié et auquel vous aurez donné un autre nom, vous trouverez un fichier dénomme "theme.php". Ouvrez ce fichier avec un éditeur de texte tel que Notepad++ et recherchez dans ce fichier la ligne qui commence par '$theme_name = "nom du thème"'. Ainsi par exemple, cette ligne aura la forme suivante pour le sous-répertoire standard: '$theme_name = "standard"'. Vous remplacez alors le nom du thème qui apparait entre les guillemets (par exemple standard) par le nom que vous voulez donner à votre thème (par exemple '$theme_name = "mon thème"') .Habituellement, vous y mettez le même nom que celui du sous-répertoire que vous avez donné à l'étape 1 à votre nouveau thème.

3. Si vous avez copié le sous-répertoire "Ocean" ou "Standard", il existe un fichier qui s'appelle 'header.jpg' ou 'header.png'. Cette image correspond au sigle de PhpGedView qui apparait en haut à gauche de chaque page. Vous pouvez remplacer ce fichier header.png ou header.jpg par le fichier d'une image qui vous appartient et que vous voulez voir apparaître.

4. Ouvrez le fichier 'style.css' qui se trouve dans ce répertoire avec un éditeur de texte tel que Notepad++, afin de modifier les couleurs et les bordures des différentes pages.

5. Puis ouvrez également avec ce même éditeur de texte les fichiers 'header.html, footer.html, toplinks.html, print_footer.html, print_header.html, et sublinks.html' qui se trouvent dans ce même sous-répertoire afin de modifier l'agencement de la page et la position des différents éléments qui se trouvent sur la page.

6. Ouvrez également le fichier 'theme.php', à la fin de ce fichier, pour ajuster l'agencement des diagrammes d'ascendance et de descendance. of the pedigree and descendancy charts.

7. Pour utiliser vos propres images, effectuez une copie du répertoire "images" qui se trouve dans ce sous-répertoire et donnez-lui un nouveau nom, par exemple "Mes images". Puis éditez le fichier 'theme.php' (en l'ouvrant avec un éditeur de texte tel que Notepad++) et allez à la ligne qui contient cette expression '$PGV_IMAGE_DIR = $THEME_DIR."images"'. A la place de "images", écrivez ici l'emplacement de votre répertoire "images", par exemple "Mes images" si c'est le nom que avez donné au répertoire "images" que vous avez copié. Dans ce cas, à la place de '$PGV_IMAGE_DIR = $THEME_DIR."images"', vous écrirez '$PGV_IMAGE_DIR = $THEME_DIR."Mes images"'. Dans ce répertoire "Mes images", remplacez les images qui s'y trouvent par les images que vous aurez choisies.

==Comment est structurée une page ?==

Une page générée par phpGedView est divisée en 5 sections:

1. L''''en-tête''' - est définie par le fichier '''header.html''' qui se trouve dans le sous-répertoire de chacun des thèmes. Cette section "en-tête" apparait au sommet de chaque page et est la première chose qui est imprimée après la balise <body> qui se trouve dans le code html de la page. Cet en-tête ajoute les options de modification de langue si vous avez autorisé le choix de plusieurs langues dans la configuration de votre logiciel. Elle peut contenir des bannières ou tout type d'information que vous désirez voir apparaitre en haut de chacune des pages de votre site. En mode "aperçu avant impression", l'en-tête est définie par le fichier '''print_header.html''' à la place du fichier header.html.

2. '''Liens de navigation supérieurs''' - ils sont définis par le fichier '''toplinks.html'''. Cette section sera incluse immédiatement après le fichier header.html dans la construction de la page html, et contient les liens de navigation vers les différents endroits du site. Vous pouvez modifier ce fichier pour placer des images différentes ou pour ôter certains liens

3. Le '''corps principal''' de la page html - est défini par la logiciel PhpGedView. Vous ne devez pas modifier le code qui génère cette section de la page à moins que nous le vouliez vraiment.

4. '''Sous liens vers les individus''' - Sur la page de détails d'un individu il existe une section de liens de navigation qui dirige le visiteur vers différentes parties du site en fonction de l'individu qui est actuellement affiché.

5. Le '''Pied de page''' - est défini par le fichier '''footer.html'''. Cette section est incluse dans la page html une fois que le corps principal de la page a été généré par PhpGedView. Par défaut, PhpGedView imprime les liens de contacts. C'est un bon endroit pour y placer des liens vers d'autres sites web ainsi que pour y inscrire un état de copyright. En mode "aperçu avant impression", l'en-tête est définie par le fichier '''print_footer.html''' à la place du fichier footer.html.

6. '''Pied de page requis''' - phpGedView génèrera automatiquement un pied de page avec la mention suivante "Powered By PhpGedView" sous forme d'image ainsi qu'un lien vers la page d'accueil de phpGedView. Il ajoutera aussi un lien d'aperçu avant impression. Je ne peux pas vous empêcher de modifier cette section si vous connaissez le PHP, mais si vous la changez, je vous en prie, au moins, laissez le lien vers la page d'accueil de phpGedView quelque part sur chacune des pages.

Ces sections sont représentées graphiquement dans l'image ci-dessous à partir du thème "standard":

[[image:Capture en tete site commentaires.png]]

 

[[image:Capture pied page site.png]]

==Les feuilles de style CSS==

PhpGedView utilise des feuilles de style CSS sur l'ensemble des pages du site. Ces feuilles de style fonctionnent un peu selon le même principe que les styles qui sont utilisés dans un traitement de texte évolué tel que Microsoft Word ou Open Office Writer. C'est à dire que les feuilles de style permettent de définir pour les différentes zones d'une page web, les tailles de la police, le type de la police de caractère, les fonds de couleur, les bordures, l'alignement des objets,... Ces feuilles de style apportent un grand degré de flexibilité sur le contenu graphique des différentes pages du site.

Toutes les feuilles de styles sont contrôlées par le fichier '''style.css'''. C'est ce fichier sui définit le style de chaque élément de votre page web. Explorez ce fichier et regardez ce que vous pouvez faire. Si vous arrivez à faire quelque chose de créatif, alors partagez-le avec le reste de la communauté.

===Visualiser les paramètres de la feuille de style CSS avec CSSViewer===

Afin de visualiser l'effet produit par une feuille de style CSS, je vous conseille pour ceux qui utilisent Firefox, de télécharger l'extension '''CSSViewer''', que vous pouvez télécharger ici: https://addons.mozilla.org/fr/firefox/addon/2104.
Une fois cet utilitaire installé, affichez une page de votre site et cliquez sur "outils" --> CSSViewer. En parcourant avec votre souris les différentes zones de votre page, vous verrez affichés les différents paramètres de la feuille de style qui agissent sur la zone de la page web sur laquelle vous avez placé votre souris.

Ainsi, avec cette extension, en parcourant votre souris sur la boite de sélection des langues qui se trouve en haut à droite d'une page avec le thème standard, vous voyez ceci:

 

[[Image:Detail_style_header_select.png]]

 

Les informations qui apparaissent dans le rectangle sont relatives au secteur entouré de pointillés rouges, secteur sur lequel pointe la souris.
Ces informations nous disent que la boite de sélection des langues s'appelle ".header-select".
Cette boite a des caractéristiques de police (font & text) qui sont les suivantes:
* la police utilisée est "sans"
* la taille de la police est de 12 pixels
Cette boite a une couleur de fond blanche (backgroundcolor#FFFFFF) et la couleur du texte est noire (color#000000)
Cette boite a les dimensions suivantes: hauteur = 19 pixels et largeur = 175 pixels
La bordure de la boite est un trait d'épaisseur 2 pixels et de couleur #E6E6E6

===Définition des différentes classes de style de la feuille style.css===

Les sections suivantes décrivent à quoi correspond graphiquement sur les différentes pages du site chaque classe de style qui est définie dans le fichier style.css.

Cette image correspond aux diagrammes de descendance et d'ascendance. L'image qui est intitulée ".pedigree_image_portrait" est parfois remplacée par .pedigree_image_portrait_rtl, .pedigree_image_landscape, ou .pedigree_image_landscape_rtl selon la langue utilisée et si la vue est en mode portrait ou paysage. Les zones ".name1" et ".details1" appelées classes, peuvent aussi être remplacées par .namezoom et .detailszoom lorsque l'utilisateur fait un zoom.

 

[[Image: Details_ascendance.png]]

 

Cette image montre les feuilles de style qui sont appliquées à la section '''en-tête''' ('''header''') de la page. Si les langues disponibles sont affichées sous forme de drapeaux alors la classe devrait être '''.flag''' au lieu de '''.header_select'''.

 

[[Image: Detail_header.png]]

 

Cette image montre les feuilles de style qui sont appliquées à la section '''pied de page''' ('''footer''') de la page.

 

[[Image: Detail_footer.png]]

 

Les feuilles de style suivantes sont dans la section "'''liens de navigation supérieurs'''" ('''toplinks.html''') de la page: '''.menuitem''', '''.menuitem_hover''', '''.submenu''', '''.submenuitem''', et '''.submenuitem_hover'''.

Cette image montre les feuilles de style qui sont appliquées par défaut aux liens de navigation supérieurs de chaque page.

 

[[Image: Liens_navigation_superieurs.png]]

 

Cette image montre les feuilles de style des listes ou tables. Les listes ou tables existent pour les individus, les familles, les sources, les lieux et les objets multimedia.

 

[[Image: Liste_individus.png]]

 

Cette image montre les feuilles de style qui sont appliquées aux faits et détails personnels d'un individu. Le label .facts_label sera en fait .facts_labelred si l'événement (fact) a été supprimé. Le .facts_label sera en fait .facts_labelblue si l'événement (fact) a été ajouté/modifié. Le principe est le même pour .facts_value qui est transformé en .facts_valuered ou .facts_valueblue. La feuille de style .source_citations stylesheet est utilisée lorsque les citations des sources apparaissent dans cette fiche.

 

[[Image: Fiche_individu.png]]

 

Cette image montre les feuilles de style qui sont appliquées à la section des proches parents.

 

[[image:Details_parents.png]]

 

La feuille de style '''.error''' s'applique aux messages d'erreur et la feuille de style '''.warning''' s'applique aux messages d'avertissement. Les feuilles de style '''.news_date''' et '''.news_title''' sont utilisées sur la page d'accueil. La feuille de style '''.current_day''' stylesheet est utilisée sur le calendrier des anniversaires dans la vue mensuelle. La feuille de style '''.listlog''' est utilisée lorsque l'on visualise le fichier de log depuis le menu d'administration. La feuille de style '''.label''' est utilisée sur le formulaire de recherche en ajout des autres lieux. La feuille de style '''.formfield''' est utilisée sur le forumaire de login. L'édition du fichier des restrictions d'accès au fichier GEDCOM utilise les feuilles de style '''.facts_label02''', '''.facts_label03''', et '''.facts_value02'''.

The following stylesheets are in the timeline chart: .field, .timeline_table, .person0, .person1, .person2, .person3, .persion4, and .person5.

==Personnaliser les menus==

Chaque thème dispose de menus en forme de liste déroulante. Ce type de menu a été fait pour être flexible et facile à modifier sans que les concepteurs aient besoin de connaitre quoi que ce soit sur le langage javascript et le DHTML qui est à la base de la programmation de ce type de menus. Vous êtes libre de modifier les menus à votre guise, ou d'utiliser votre propre style de menu si vous ne voulez pas utiliser le système de menu existant.

Ce système de menu est construit autour d'une structure de tableau en PHP array que vous avez construite dans la page et que vous avez ensuite transféré à la fonction print_menu(). Ce qui suit est une description de chacun des éléments qui constituent le tableau de menus.

Un tableau de menus basique ressemble à ceci (extrait de la documentation du code de la fonction print_menu):

$menu["label"] = "Diagrammes";
$menu["labelpos"] = "down"; // indique où le texte doit être positionné par rapport aux options de l'image: up, down; left and right (haut, bas, gauche et droite)
$menu["icon"] = "images/pedigree.gif";
$menu["hovericon"] = "images/pedigree2.gif";
$menu["link"] = "pedigree.php";
$menu["class"] = "menuitem";
$menu["hoverclass"] = "menuitem_hover";
$menu["flyout"] = "down"; // les options sont down left and right (bas, gauche et droite)
$menu["items"] = array(); // un tableau des différentes rubriques du menu

La rubrique $menu["label"] du tableau du menu correspond au texte de la rubrique du menu. Dans l'exemple ci-dessus, ce texte est "Diagrammes".

Le $menu["labelpos"] est la position du texte par rapport à l'icône du menu. Les options possibles sont: "up" - le texte est placé au-dessus de l'icône, "down" - le texte est placé en dessous de l'icône, "left" - le texte est placé à gauche de l'icône, "right" le texte est placé à droite de l'icône. L'option par défaut est "down".

$menu["icon"] est l'emplacement relatif de l'image que vous voulez utiliser en tant qu'icône. Si vous laissez cette option non renseignée, aucune icône n'apparaîtra et le menu sera un simple menu texte.

$menu["hovericon"] est l'emplacement relatif de l'image qui sera utilisée quand l'utilisateur passe la souris au-dessus du menu. Cela vous permet de créer des effets lors du passage de la souris dans un secteur particulier de la page.

$menu["link"] est l'adresse url vers laquelle l'utilisateur est dirigé lorsqu'il clique sur le menu.

$menu["class"] est la feuille de style CSS stylesheet qui doit être utilisée pour l'attribut de la classe correspondant au contenu du menu.

$menu["hoverclass"] est la feuille de style CSS stylesheet qui est utilisée quand l'utilisateur passe la souris au-dessus de la rubrique du menu.

$menu["flyout"] est la position de chacun des sous-menus qui apparaissent quand on passe la souris sur une rubrique du menu. Les options sont: "down" - les sous-menus apparaissent en dessous de la rubrique du menu, "right" - les sous-menus apparaissent à droite de la rubrique du menu, et "left" - les sous-menus apparaissent à gauche la rubrique du menu.

$menu["items"] est également un tableau qui contient les tableaux des différentes rubriques du menu. C'est ici que sont mentionnés tous les sous-menus qui apparaissent quand l'utilisateur passe sa souris au-dessus d'une des rubriques du menu.

Un exemple basique est détaillé ci-après pour vous montrer comment créer un menu avec une rubrique à 1 sous-menu. Des exemples de menus plus compliqués se trouvent dans les fichiers toplinks.html pour chacun des thèmes.

$menu = array();

$menu["label"] = "Menu simple";

$menu["class"] = "menuitem";

$menu["items"] = array();

$submenu = array();

$submenu["label"] = "Rubrique 1 du menu";

$submenu["class"] = "submenuitem";

$menu["items"][] = $submenu;

print_menu($menu);

Le $menu array imprimera le texte sur l'écran. Le $submenu array représente la première rubrique qui apparaîtra lorsque l'utilisateur passera sa souris au dessus du texte $menu["label"]. La ligne $menu["items"][] = $submenu; est une construction PHP pour attacher une rubrique à la fin d'un tableau. Ainsi vous pouvez créer autant de nouveaux sous-menus que vous le souhaitez et les ajouter de manière continue au tableau $menu["items"] selon l'ordre dans lequel vous souhaitez qu'ils apparaissent.

Puisqu'une rubrique d'un sous-menu a la même structure en tableau que la rubrique du menu principal, vous pouvez avoir différents niveaux de hiérarchie dans le menu. Il vous suffit simplement d'ajouter un tableau $subsubmenu au tableau des rubriques. $submenu["items"][] = $subsubmenu;

Des hiérarchies multiples n'ont pas été testées par l'équipe de développement de PhpGedView et ne sont donc pas présentes dans les codes qui sont fournis. C'est pourquoi elles doivent être utilisées avec la plus grande prudence.

Comment personnaliser votre thème

2007-09-02T09:08:52Z

Papagolf : /* Définition des différentes classes de style de la feuille style.css */

==Introduction==

Ce tutoriel vous aidera à personnaliser l'apparence de votre site PhpGedView qui s'appelle "thème" dans le langage des initiés. Tous les fichiers référencés dans ce tutoriel existent dans le répertoire "themes" de votre installation PhpGedView et ont été conçus afin que vous puissiez effectuer des modifications autant que vous le souhaitez sans créer de dysfonctionnement au programme phpGedView, bien qu'il peut exister quelques codes PHP code inclus dans les fichiers. Une compréhension des feuilles de styles CSS stylesheets aet du langage HTML est nécessaire pour personnaliser les thèmes de votre site. Quelques connaissances de base en PHP peuvent également aider.

==Les différentes étapes à suivre pour personnaliser votre thème==

Les étapes suivantes vous guideront pour construire votre propre thème pour votre site PhpGedView:

1. Effectuez une copie de l'un des sous-répertoires du répertoire "themes" de votre installation PhpGedView, afin de fournir une base à la personnalisation de votre thème. Dans le répertoire "themes" de votre installation PhpGedView, vous avez les sous-répertoires suivants: cloudy, minimal, ocean, simply blue, simply green, simply red, standard, xood et xenea. Vous choisissez le sous-répertoire qui correspond au thème qui se rapproche le plus de celui que vous voulez personnaliser, et vous en faites une copie en lui donnant un nouveau nom, par exemple "mon thème". Ce nom correspondra au thème que vous allez personnaliser.

2. Dans ce sous-répertoire que vous aurez copié et auquel vous aurez donné un autre nom, vous trouverez un fichier dénomme "theme.php". Ouvrez ce fichier avec un éditeur de texte tel que Notepad++ et recherchez dans ce fichier la ligne qui commence par '$theme_name = "nom du thème"'. Ainsi par exemple, cette ligne aura la forme suivante pour le sous-répertoire standard: '$theme_name = "standard"'. Vous remplacez alors le nom du thème qui apparait entre les guillemets (par exemple standard) par le nom que vous voulez donner à votre thème (par exemple '$theme_name = "mon thème"') .Habituellement, vous y mettez le même nom que celui du sous-répertoire que vous avez donné à l'étape 1 à votre nouveau thème.

3. Si vous avez copié le sous-répertoire "Ocean" ou "Standard", il existe un fichier qui s'appelle 'header.jpg' ou 'header.png'. Cette image correspond au sigle de PhpGedView qui apparait en haut à gauche de chaque page. Vous pouvez remplacer ce fichier header.png ou header.jpg par le fichier d'une image qui vous appartient et que vous voulez voir apparaître.

4. Ouvrez le fichier 'style.css' qui se trouve dans ce répertoire avec un éditeur de texte tel que Notepad++, afin de modifier les couleurs et les bordures des différentes pages.

5. Puis ouvrez également avec ce même éditeur de texte les fichiers 'header.html, footer.html, toplinks.html, print_footer.html, print_header.html, et sublinks.html' qui se trouvent dans ce même sous-répertoire afin de modifier l'agencement de la page et la position des différents éléments qui se trouvent sur la page.

6. Ouvrez également le fichier 'theme.php', à la fin de ce fichier, pour ajuster l'agencement des diagrammes d'ascendance et de descendance. of the pedigree and descendancy charts.

7. Pour utiliser vos propres images, effectuez une copie du répertoire "images" qui se trouve dans ce sous-répertoire et donnez-lui un nouveau nom, par exemple "Mes images". Puis éditez le fichier 'theme.php' (en l'ouvrant avec un éditeur de texte tel que Notepad++) et allez à la ligne qui contient cette expression '$PGV_IMAGE_DIR = $THEME_DIR."images"'. A la place de "images", écrivez ici l'emplacement de votre répertoire "images", par exemple "Mes images" si c'est le nom que avez donné au répertoire "images" que vous avez copié. Dans ce cas, à la place de '$PGV_IMAGE_DIR = $THEME_DIR."images"', vous écrirez '$PGV_IMAGE_DIR = $THEME_DIR."Mes images"'. Dans ce répertoire "Mes images", remplacez les images qui s'y trouvent par les images que vous aurez choisies.

==Comment est structurée une page ?==

Une page générée par phpGedView est divisée en 5 sections:

1. L''''en-tête''' - est définie par le fichier '''header.html''' qui se trouve dans le sous-répertoire de chacun des thèmes. Cette section "en-tête" apparait au sommet de chaque page et est la première chose qui est imprimée après la balise <body> qui se trouve dans le code html de la page. Cet en-tête ajoute les options de modification de langue si vous avez autorisé le choix de plusieurs langues dans la configuration de votre logiciel. Elle peut contenir des bannières ou tout type d'information que vous désirez voir apparaitre en haut de chacune des pages de votre site. En mode "aperçu avant impression", l'en-tête est définie par le fichier '''print_header.html''' à la place du fichier header.html.

2. '''Liens de navigation supérieurs''' - ils sont définis par le fichier '''toplinks.html'''. Cette section sera incluse immédiatement après le fichier header.html dans la construction de la page html, et contient les liens de navigation vers les différents endroits du site. Vous pouvez modifier ce fichier pour placer des images différentes ou pour ôter certains liens

3. Le '''corps principal''' de la page html - est défini par la logiciel PhpGedView. Vous ne devez pas modifier le code qui génère cette section de la page à moins que nous le vouliez vraiment.

4. '''Sous liens vers les individus''' - Sur la page de détails d'un individu il existe une section de liens de navigation qui dirige le visiteur vers différentes parties du site en fonction de l'individu qui est actuellement affiché.

5. Le '''Pied de page''' - est défini par le fichier '''footer.html'''. Cette section est incluse dans la page html une fois que le corps principal de la page a été généré par PhpGedView. Par défaut, PhpGedView imprime les liens de contacts. C'est un bon endroit pour y placer des liens vers d'autres sites web ainsi que pour y inscrire un état de copyright. En mode "aperçu avant impression", l'en-tête est définie par le fichier '''print_footer.html''' à la place du fichier footer.html.

6. '''Pied de page requis''' - phpGedView génèrera automatiquement un pied de page avec la mention suivante "Powered By PhpGedView" sous forme d'image ainsi qu'un lien vers la page d'accueil de phpGedView. Il ajoutera aussi un lien d'aperçu avant impression. Je ne peux pas vous empêcher de modifier cette section si vous connaissez le PHP, mais si vous la changez, je vous en prie, au moins, laissez le lien vers la page d'accueil de phpGedView quelque part sur chacune des pages.

Ces sections sont représentées graphiquement dans l'image ci-dessous à partir du thème "standard":

[[image:Capture en tete site commentaires.png]]

 

[[image:Capture pied page site.png]]

==Les feuilles de style CSS==

PhpGedView utilise des feuilles de style CSS sur l'ensemble des pages du site. Ces feuilles de style fonctionnent un peu selon le même principe que les styles qui sont utilisés dans un traitement de texte évolué tel que Microsoft Word ou Open Office Writer. C'est à dire que les feuilles de style permettent de définir pour les différentes zones d'une page web, les tailles de la police, le type de la police de caractère, les fonds de couleur, les bordures, l'alignement des objets,... Ces feuilles de style apportent un grand degré de flexibilité sur le contenu graphique des différentes pages du site.

Toutes les feuilles de styles sont contrôlées par le fichier '''style.css'''. C'est ce fichier sui définit le style de chaque élément de votre page web. Explorez ce fichier et regardez ce que vous pouvez faire. Si vous arrivez à faire quelque chose de créatif, alors partagez-le avec le reste de la communauté.

===Visualiser les paramètres de la feuille de style CSS avec CSSViewer===

Afin de visualiser l'effet produit par une feuille de style CSS, je vous conseille pour ceux qui utilisent Firefox, de télécharger l'extension '''CSSViewer''', que vous pouvez télécharger ici: https://addons.mozilla.org/fr/firefox/addon/2104.
Une fois cet utilitaire installé, affichez une page de votre site et cliquez sur "outils" --> CSSViewer. En parcourant avec votre souris les différentes zones de votre page, vous verrez affichés les différents paramètres de la feuille de style qui agissent sur la zone de la page web sur laquelle vous avez placé votre souris.

Ainsi, avec cette extension, en parcourant votre souris sur la boite de sélection des langues qui se trouve en haut à droite d'une page avec le thème standard, vous voyez ceci:

 

[[Image:Detail_style_header_select.png]]

 

Les informations qui apparaissent dans le rectangle sont relatives au secteur entouré de pointillés rouges, secteur sur lequel pointe la souris.
Ces informations nous disent que la boite de sélection des langues s'appelle ".header-select".
Cette boite a des caractéristiques de police (font & text) qui sont les suivantes:
* la police utilisée est "sans"
* la taille de la police est de 12 pixels
Cette boite a une couleur de fond blanche (backgroundcolor#FFFFFF) et la couleur du texte est noire (color#000000)
Cette boite a les dimensions suivantes: hauteur = 19 pixels et largeur = 175 pixels
La bordure de la boite est un trait d'épaisseur 2 pixels et de couleur #E6E6E6

===Définition des différentes classes de style de la feuille style.css===

Les sections suivantes décrivent à quoi correspond graphiquement sur les différentes pages du site chaque classe de style qui est définie dans le fichier style.css.

Cette image correspond aux diagrammes de descendance et d'ascendance. L'image qui est intitulée ".pedigree_image_portrait" est parfois remplacée par .pedigree_image_portrait_rtl, .pedigree_image_landscape, ou .pedigree_image_landscape_rtl selon la langue utilisée et si la vue est en mode portrait ou paysage. Les zones ".name1" et ".details1" appelées classes, peuvent aussi être remplacées par .namezoom et .detailszoom lorsque l'utilisateur fait un zoom.

 

[[Image: Details_ascendance.png]]

 

Cette image montre les feuilles de style qui sont appliquées à la section '''en-tête''' ('''header''') de la page. Si les langues disponibles sont affichées sous forme de drapeaux alors la classe devrait être '''.flag''' au lieu de '''.header_select'''.

 

[[Image: Detail_header.png]]

 

Cette image montre les feuilles de style qui sont appliquées à la section '''pied de page''' ('''footer''') de la page.

 

[[Image: Detail_footer.png]]

 

Les feuilles de style suivantes sont dans la section "'''liens de navigation supérieurs'''" ('''toplinks.html''') de la page: '''.menuitem''', '''.menuitem_hover''', '''.submenu''', '''.submenuitem''', et '''.submenuitem_hover'''.

Cette image montre les feuilles de style qui sont appliquées par défaut aux liens de navigation supérieurs de chaque page.

 

[[Image: Liens_navigation_superieurs.png]]

 

Cette image montre les feuilles de style des listes ou tables. Les listes ou tables existent pour les individus, les familles, les sources, les lieux et les objets multimedia.

 

[[Image: Liste_individus.png]]

 

Cette image montre les feuilles de style qui sont appliquées aux faits et détails personnels d'un individu. Le label .facts_label sera en fait .facts_labelred si l'événement (fact) a été supprimé. Le .facts_label sera en fait .facts_labelblue si l'événement (fact) a été ajouté/modifié. Le principe est le même pour .facts_value qui est transformé en .facts_valuered ou .facts_valueblue. La feuille de style .source_citations stylesheet est utilisée lorsque les citations des sources apparaissent dans cette fiche.

 

[[Image: Fiche_individu.png]]

 

Cette image montre les feuilles de style qui sont appliquées à la section des proches parents.

 

[[image:Details_parents.png]]

 

La feuille de style '''.error''' s'applique aux messages d'erreur et la feuille de style '''.warning''' s'applique aux messages d'avertissement. Les feuilles de style '''.news_date''' et '''.news_title''' sont utilisées sur la page d'accueil. La feuille de style '''.current_day''' stylesheet est utilisée sur le calendrier des anniversaires dans la vue mensuelle. La feuille de style '''.listlog''' est utilisée lorsque l'on visualise le fichier de log depuis le menu d'administration. La feuille de style '''.label''' est utilisée sur le formulaire de recherche en ajout des autres lieux. La feuille de style '''.formfield''' est utilisée sur le forumaire de login. L'édition du fichier des restrictions d'accès au fichier GEDCOM utilise les feuilles de style '''.facts_label02''', '''.facts_label03''', et '''.facts_value02'''.

The following stylesheets are in the timeline chart: .field, .timeline_table, .person0, .person1, .person2, .person3, .persion4, and .person5.

==Personnaliser les menus==

Chaque thème dispose de menus en forme de liste déroulante. Ce type de menu a été fait pour être flexible et facile à modifier sans que les concepteurs ieant besoin de connaître quoi que ce soit sur le langage javascript et le DHTML qui est à la base de la programmation de ce type de menus. Vous êtes libre de modifier les menus à votre guise, ou d'utiliser votre propre style de menu si vous ne voulez pas utiliser le système de menu existant.

Ce système de menu est construit autour d'une structure de tableau en PHP array que vous avez construite dans la page et que vous avez ensuite transféré à la fonction print_menu(). Ce qui suit est une description de chacun des éléments qui constituent le tableau de menus.

Un tableau de menus basique ressemble à ceci (extrait de la documentation du code de la fonction print_menu):

$menu["label"] = "Diagrammes";
$menu["labelpos"] = "down"; // indique où le texte doit être positionné par rapport aux options de l'image: up, down; left and right (haut, bas, gauche et droite)
$menu["icon"] = "images/pedigree.gif";
$menu["hovericon"] = "images/pedigree2.gif";
$menu["link"] = "pedigree.php";
$menu["class"] = "menuitem";
$menu["hoverclass"] = "menuitem_hover";
$menu["flyout"] = "down"; // les options sont down left and right (bas, gauche et droite)
$menu["items"] = array(); // un tableau des différentes rubriques du menu

La rubrique $menu["label"] du tableau du menu correspond au texte de la rubrique du menu. Dans l'exemple ci-dessus, ce texte est "Diagrammes".

Le $menu["labelpos"] est la position du texte par rapport à l'icône du menu. Les options possibles sont: "up" - le texte est placé au-dessus de l'icône, "down" - le texte est placé en dessous de l'icône, "left" - le texte est placé à gauche de l'icône, "right" le texte est placé à droite de l'icône. L'option par défaut est "down".

$menu["icon"] est l'emplacement relatif de l'image que vous voulez utiliser en tant qu'icône. Si vous laissez cette option non renseignée, aucune icône n'apparaîtra et le menu sera un simple menu texte.

$menu["hovericon"] est l'emplacement relatif de l'image qui sera utilisée quand l'utilisateur passe la souris au-dessus du menu. Cela vous permet de créer des effets lors du passage de la souris dans un secteur particulier de la page.

$menu["link"] est l'adresse url vers laquelle l'utilisateur est dirigé lorsqu'il clique sur le menu.

$menu["class"] est la feuille de style CSS stylesheet qui doit être utilisée pour l'attribut de la classe correspondant au contenu du menu.

$menu["hoverclass"] est la feuille de style CSS stylesheet qui est utilisée quand l'utilisateur passe la souris au-dessus de la rubrique du menu.

$menu["flyout"] est la position de chacun des sous-menus qui apparaissent quand on passe la souris sur une rubrique du menu. Les options sont: "down" - les sous-menus apparaissent en dessous de la rubrique du menu, "right" - les sous-menus apparaissent à droite de la rubrique du menu, et "left" - les sous-menus apparaissent à gauche la rubrique du menu.

$menu["items"] est également un tableau qui contient les tableaux des différentes rubriques du menu. C'est ici que sont mentionnés tous les sous-menus qui apparaissent quand l'utilisateur passe sa souris au-dessus d'une des rubriques du menu.

Un exemple basique est détaillé ci-après pour vous montrer comment créer un menu avec une rubrique à 1 sous-menu. Des exemples de menus plus compliqués se trouvent dans les fichiers toplinks.html pour chacun des thèmes.

$menu = array();

$menu["label"] = "Menu simple";

$menu["class"] = "menuitem";

$menu["items"] = array();

$submenu = array();

$submenu["label"] = "Rubrique 1 du menu";

$submenu["class"] = "submenuitem";

$menu["items"][] = $submenu;

print_menu($menu);

Le $menu array imprimera le texte sur l'écran. Le $submenu array représente la première rubrique qui apparaîtra lorsque l'utilisateur passera sa souris au dessus du texte $menu["label"]. La ligne $menu["items"][] = $submenu; est une construction PHP pour attacher une rubrique à la fin d'un tableau. Ainsi vous pouvez créer autant de nouveaux sous-menus que vous le souhaitez et les ajouter de manière continue au tableau $menu["items"] selon l'ordre dans lequel vous souhaitez qu'ils apparaissent.

Puisqu'une rubrique d'un sous-menu a la même structure en tableau que la rubrique du menu principal, vous pouvez avoir différents niveaux de hiérarchie dans le menu. Il vous suffit simplement d'ajouter un tableau $subsubmenu au tableau des rubriques. $submenu["items"][] = $subsubmenu;

Des hiérarchies multiples n'ont pas été testées par l'équipe de développement de PhpGedView et ne sont donc pas présentes dans les codes qui sont fournis. C'est pourquoi elles doivent être utilisées avec la plus grande prudence.

Comment personnaliser votre thème

2007-09-02T08:52:40Z

Papagolf : /* Comment est structurée une page ? */

==Introduction==

Ce tutoriel vous aidera à personnaliser l'apparence de votre site PhpGedView qui s'appelle "thème" dans le langage des initiés. Tous les fichiers référencés dans ce tutoriel existent dans le répertoire "themes" de votre installation PhpGedView et ont été conçus afin que vous puissiez effectuer des modifications autant que vous le souhaitez sans créer de dysfonctionnement au programme phpGedView, bien qu'il peut exister quelques codes PHP code inclus dans les fichiers. Une compréhension des feuilles de styles CSS stylesheets aet du langage HTML est nécessaire pour personnaliser les thèmes de votre site. Quelques connaissances de base en PHP peuvent également aider.

==Les différentes étapes à suivre pour personnaliser votre thème==

Les étapes suivantes vous guideront pour construire votre propre thème pour votre site PhpGedView:

1. Effectuez une copie de l'un des sous-répertoires du répertoire "themes" de votre installation PhpGedView, afin de fournir une base à la personnalisation de votre thème. Dans le répertoire "themes" de votre installation PhpGedView, vous avez les sous-répertoires suivants: cloudy, minimal, ocean, simply blue, simply green, simply red, standard, xood et xenea. Vous choisissez le sous-répertoire qui correspond au thème qui se rapproche le plus de celui que vous voulez personnaliser, et vous en faites une copie en lui donnant un nouveau nom, par exemple "mon thème". Ce nom correspondra au thème que vous allez personnaliser.

2. Dans ce sous-répertoire que vous aurez copié et auquel vous aurez donné un autre nom, vous trouverez un fichier dénomme "theme.php". Ouvrez ce fichier avec un éditeur de texte tel que Notepad++ et recherchez dans ce fichier la ligne qui commence par '$theme_name = "nom du thème"'. Ainsi par exemple, cette ligne aura la forme suivante pour le sous-répertoire standard: '$theme_name = "standard"'. Vous remplacez alors le nom du thème qui apparait entre les guillemets (par exemple standard) par le nom que vous voulez donner à votre thème (par exemple '$theme_name = "mon thème"') .Habituellement, vous y mettez le même nom que celui du sous-répertoire que vous avez donné à l'étape 1 à votre nouveau thème.

3. Si vous avez copié le sous-répertoire "Ocean" ou "Standard", il existe un fichier qui s'appelle 'header.jpg' ou 'header.png'. Cette image correspond au sigle de PhpGedView qui apparait en haut à gauche de chaque page. Vous pouvez remplacer ce fichier header.png ou header.jpg par le fichier d'une image qui vous appartient et que vous voulez voir apparaître.

4. Ouvrez le fichier 'style.css' qui se trouve dans ce répertoire avec un éditeur de texte tel que Notepad++, afin de modifier les couleurs et les bordures des différentes pages.

5. Puis ouvrez également avec ce même éditeur de texte les fichiers 'header.html, footer.html, toplinks.html, print_footer.html, print_header.html, et sublinks.html' qui se trouvent dans ce même sous-répertoire afin de modifier l'agencement de la page et la position des différents éléments qui se trouvent sur la page.

6. Ouvrez également le fichier 'theme.php', à la fin de ce fichier, pour ajuster l'agencement des diagrammes d'ascendance et de descendance. of the pedigree and descendancy charts.

7. Pour utiliser vos propres images, effectuez une copie du répertoire "images" qui se trouve dans ce sous-répertoire et donnez-lui un nouveau nom, par exemple "Mes images". Puis éditez le fichier 'theme.php' (en l'ouvrant avec un éditeur de texte tel que Notepad++) et allez à la ligne qui contient cette expression '$PGV_IMAGE_DIR = $THEME_DIR."images"'. A la place de "images", écrivez ici l'emplacement de votre répertoire "images", par exemple "Mes images" si c'est le nom que avez donné au répertoire "images" que vous avez copié. Dans ce cas, à la place de '$PGV_IMAGE_DIR = $THEME_DIR."images"', vous écrirez '$PGV_IMAGE_DIR = $THEME_DIR."Mes images"'. Dans ce répertoire "Mes images", remplacez les images qui s'y trouvent par les images que vous aurez choisies.

==Comment est structurée une page ?==

Une page générée par phpGedView est divisée en 5 sections:

1. L''''en-tête''' - est définie par le fichier '''header.html''' qui se trouve dans le sous-répertoire de chacun des thèmes. Cette section "en-tête" apparait au sommet de chaque page et est la première chose qui est imprimée après la balise <body> qui se trouve dans le code html de la page. Cet en-tête ajoute les options de modification de langue si vous avez autorisé le choix de plusieurs langues dans la configuration de votre logiciel. Elle peut contenir des bannières ou tout type d'information que vous désirez voir apparaitre en haut de chacune des pages de votre site. En mode "aperçu avant impression", l'en-tête est définie par le fichier '''print_header.html''' à la place du fichier header.html.

2. '''Liens de navigation supérieurs''' - ils sont définis par le fichier '''toplinks.html'''. Cette section sera incluse immédiatement après le fichier header.html dans la construction de la page html, et contient les liens de navigation vers les différents endroits du site. Vous pouvez modifier ce fichier pour placer des images différentes ou pour ôter certains liens

3. Le '''corps principal''' de la page html - est défini par la logiciel PhpGedView. Vous ne devez pas modifier le code qui génère cette section de la page à moins que nous le vouliez vraiment.

4. '''Sous liens vers les individus''' - Sur la page de détails d'un individu il existe une section de liens de navigation qui dirige le visiteur vers différentes parties du site en fonction de l'individu qui est actuellement affiché.

5. Le '''Pied de page''' - est défini par le fichier '''footer.html'''. Cette section est incluse dans la page html une fois que le corps principal de la page a été généré par PhpGedView. Par défaut, PhpGedView imprime les liens de contacts. C'est un bon endroit pour y placer des liens vers d'autres sites web ainsi que pour y inscrire un état de copyright. En mode "aperçu avant impression", l'en-tête est définie par le fichier '''print_footer.html''' à la place du fichier footer.html.

6. '''Pied de page requis''' - phpGedView génèrera automatiquement un pied de page avec la mention suivante "Powered By PhpGedView" sous forme d'image ainsi qu'un lien vers la page d'accueil de phpGedView. Il ajoutera aussi un lien d'aperçu avant impression. Je ne peux pas vous empêcher de modifier cette section si vous connaissez le PHP, mais si vous la changez, je vous en prie, au moins, laissez le lien vers la page d'accueil de phpGedView quelque part sur chacune des pages.

Ces sections sont représentées graphiquement dans l'image ci-dessous à partir du thème "standard":

[[image:Capture en tete site commentaires.png]]

 

[[image:Capture pied page site.png]]

==Les feuilles de style CSS==

PhpGedView utilise des feuilles de style CSS sur l'ensemble des pages du site. Ces feuilles de style fonctionnent un peu selon le même principe que les styles qui sont utilisés dans un traitement de texte évolué tel que Microsoft Word ou Open Office Writer. C'est à dire que les feuilles de style permettent de définir pour les différentes zones d'une page web, les tailles de la police, le type de la police de caractère, les fonds de couleur, les bordures, l'alignement des objets,... Ces feuilles de style apportent un grand degré de flexibilité sur le contenu graphique des différentes pages du site.

Toutes les feuilles de styles sont contrôlées par le fichier '''style.css'''. C'est ce fichier sui définit le style de chaque élément de votre page web. Explorez ce fichier et regardez ce que vous pouvez faire. Si vous arrivez à faire quelque chose de créatif, alors partagez-le avec le reste de la communauté.

===Visualiser les paramètres de la feuille de style CSS avec CSSViewer===

Afin de visualiser l'effet produit par une feuille de style CSS, je vous conseille pour ceux qui utilisent Firefox, de télécharger l'extension '''CSSViewer''', que vous pouvez télécharger ici: https://addons.mozilla.org/fr/firefox/addon/2104.
Une fois cet utilitaire installé, affichez une page de votre site et cliquez sur "outils" --> CSSViewer. En parcourant avec votre souris les différentes zones de votre page, vous verrez affichés les différents paramètres de la feuille de style qui agissent sur la zone de la page web sur laquelle vous avez placé votre souris.

Ainsi, avec cette extension, en parcourant votre souris sur la boite de sélection des langues qui se trouve en haut à droite d'une page avec le thème standard, vous voyez ceci:

 

[[Image:Detail_style_header_select.png]]

 

Les informations qui apparaissent dans le rectangle sont relatives au secteur entouré de pointillés rouges, secteur sur lequel pointe la souris.
Ces informations nous disent que la boite de sélection des langues s'appelle ".header-select".
Cette boite a des caractéristiques de police (font & text) qui sont les suivantes:
* la police utilisée est "sans"
* la taille de la police est de 12 pixels
Cette boite a une couleur de fond blanche (backgroundcolor#FFFFFF) et la couleur du texte est noire (color#000000)
Cette boite a les dimensions suivantes: hauteur = 19 pixels et largeur = 175 pixels
La bordure de la boite est un trait d'épaisseur 2 pixels et de couleur #E6E6E6

===Définition des différentes classes de style de la feuille style.css===

Les sections suivantes décrivent à quoi correpond graphiquement sur les différentes pages du site chaque classe de style qui est définie dans le fichier style.css.

Cette image correspond aux diagrammes de descendance et d'ascendance. L'image aui est intitulée ".pedigree_image_portrait" est parfois remplacée par .pedigree_image_portrait_rtl, .pedigree_image_landscape, ou .pedigree_image_landscape_rtl selon la langue utilisée et si la vue est en mode portrait ou paysage. Les zones ".name1" et ".details1" appelées classes, peuvent aussi être remplacées par .namezoom et .detailszoom lorsque l'utilisateur fait un zoom.

 

[[Image: Details_ascendance.png]]

 

Cette image montre les feuilles de style qui sont appliquées à la section '''en-tête''' ('''header''') de la page. Si les langues disponibles sont affichées sous forme de drapeaux alors la classe devrait être '''.flag''' au lieu de '''.header_select'''.

 

[[Image: Detail_header.png]]

 

Cette image montre les feuilles de style qui sont appliquées à la section '''pied de page''' ('''footer''') de la page.

 

[[Image: Detail_footer.png]]

 

Les feuilles de style suivantes sont dans la section "'''liens de navigation supérieurs'''" ('''toplinks.html''') de la page: '''.menuitem''', '''.menuitem_hover''', '''.submenu''', '''.submenuitem''', et '''.submenuitem_hover'''.

Cette image montre les feuilles de style qui sont appliquées par défaut aux liens de navigation supérieurs de chaque page.

 

[[Image: Liens_navigation_superieurs.png]]

 

Cette image montre les feuilles de style des listes ou tables. Les listes ou tables existent pour les individus, les familles, les sources, les lieux et les objets multimedia.

 

[[Image: Liste_individus.png]]

 

Cette image montre les feuilles de style qui sont appliquées aux faits et détails personnels d'un individu. Le label .facts_label sera en fait .facts_labelred si l'événement (fact) a été supprimé. Le .facts_label sera en fait .facts_labelblue si l'événement (fact) a été ajouté/modifié. Le principe est le même pour .facts_value qui est transformé en .facts_valuered ou .facts_valueblue. La feuille de style .source_citations stylesheet est utilisée lorsque les citations des sources apparaissent dans cette fiche.

 

[[Image: Fiche_individu.png]]

 

Cette image montre les feuilles de style qui sont appliquées à la section des proches parents.

 

[[image:Details_parents.png]]

 

La feuille de style '''.error''' s'applique aux messages d'erreur et la feuille de style '''.warning''' s'applique aux messages d'avertissement. Les feuilles de style '''.news_date''' et '''.news_title''' sont utilisées sur la page d'accueil. La feuille de style '''.current_day''' stylesheet est utilisée sur le calendrier des anniversaires dans la vue mensuelle. La feuille de style '''.listlog''' est utilisée lorsque l'on visualise le fichier de log depuis le menu d'administration. La feuille de style '''.label''' est utilisée sur le formulaire de recherche en ajout des autres lieux. La feuille de style '''.formfield''' est utilisée sur le forumaire de login. L'édition du fichier des restrictions d'accès au fichier GEDCOM utilise les feuilles de style '''.facts_label02''', '''.facts_label03''', et '''.facts_value02'''.

The following stylesheets are in the timeline chart: .field, .timeline_table, .person0, .person1, .person2, .person3, .persion4, and .person5.

==Personnaliser les menus==

Chaque thème dispose de menus en forme de liste déroulante. Ce type de menu a été fait pour être flexible et facile à modifier sans que les concepteurs ieant besoin de connaître quoi que ce soit sur le langage javascript et le DHTML qui est à la base de la programmation de ce type de menus. Vous êtes libre de modifier les menus à votre guise, ou d'utiliser votre propre style de menu si vous ne voulez pas utiliser le système de menu existant.

Ce système de menu est construit autour d'une structure de tableau en PHP array que vous avez construite dans la page et que vous avez ensuite transféré à la fonction print_menu(). Ce qui suit est une description de chacun des éléments qui constituent le tableau de menus.

Un tableau de menus basique ressemble à ceci (extrait de la documentation du code de la fonction print_menu):

$menu["label"] = "Diagrammes";
$menu["labelpos"] = "down"; // indique où le texte doit être positionné par rapport aux options de l'image: up, down; left and right (haut, bas, gauche et droite)
$menu["icon"] = "images/pedigree.gif";
$menu["hovericon"] = "images/pedigree2.gif";
$menu["link"] = "pedigree.php";
$menu["class"] = "menuitem";
$menu["hoverclass"] = "menuitem_hover";
$menu["flyout"] = "down"; // les options sont down left and right (bas, gauche et droite)
$menu["items"] = array(); // un tableau des différentes rubriques du menu

La rubrique $menu["label"] du tableau du menu correspond au texte de la rubrique du menu. Dans l'exemple ci-dessus, ce texte est "Diagrammes".

Le $menu["labelpos"] est la position du texte par rapport à l'icône du menu. Les options possibles sont: "up" - le texte est placé au-dessus de l'icône, "down" - le texte est placé en dessous de l'icône, "left" - le texte est placé à gauche de l'icône, "right" le texte est placé à droite de l'icône. L'option par défaut est "down".

$menu["icon"] est l'emplacement relatif de l'image que vous voulez utiliser en tant qu'icône. Si vous laissez cette option non renseignée, aucune icône n'apparaîtra et le menu sera un simple menu texte.

$menu["hovericon"] est l'emplacement relatif de l'image qui sera utilisée quand l'utilisateur passe la souris au-dessus du menu. Cela vous permet de créer des effets lors du passage de la souris dans un secteur particulier de la page.

$menu["link"] est l'adresse url vers laquelle l'utilisateur est dirigé lorsqu'il clique sur le menu.

$menu["class"] est la feuille de style CSS stylesheet qui doit être utilisée pour l'attribut de la classe correspondant au contenu du menu.

$menu["hoverclass"] est la feuille de style CSS stylesheet qui est utilisée quand l'utilisateur passe la souris au-dessus de la rubrique du menu.

$menu["flyout"] est la position de chacun des sous-menus qui apparaissent quand on passe la souris sur une rubrique du menu. Les options sont: "down" - les sous-menus apparaissent en dessous de la rubrique du menu, "right" - les sous-menus apparaissent à droite de la rubrique du menu, et "left" - les sous-menus apparaissent à gauche la rubrique du menu.

$menu["items"] est également un tableau qui contient les tableaux des différentes rubriques du menu. C'est ici que sont mentionnés tous les sous-menus qui apparaissent quand l'utilisateur passe sa souris au-dessus d'une des rubriques du menu.

Un exemple basique est détaillé ci-après pour vous montrer comment créer un menu avec une rubrique à 1 sous-menu. Des exemples de menus plus compliqués se trouvent dans les fichiers toplinks.html pour chacun des thèmes.

$menu = array();

$menu["label"] = "Menu simple";

$menu["class"] = "menuitem";

$menu["items"] = array();

$submenu = array();

$submenu["label"] = "Rubrique 1 du menu";

$submenu["class"] = "submenuitem";

$menu["items"][] = $submenu;

print_menu($menu);

Le $menu array imprimera le texte sur l'écran. Le $submenu array représente la première rubrique qui apparaîtra lorsque l'utilisateur passera sa souris au dessus du texte $menu["label"]. La ligne $menu["items"][] = $submenu; est une construction PHP pour attacher une rubrique à la fin d'un tableau. Ainsi vous pouvez créer autant de nouveaux sous-menus que vous le souhaitez et les ajouter de manière continue au tableau $menu["items"] selon l'ordre dans lequel vous souhaitez qu'ils apparaissent.

Puisqu'une rubrique d'un sous-menu a la même structure en tableau que la rubrique du menu principal, vous pouvez avoir différents niveaux de hiérarchie dans le menu. Il vous suffit simplement d'ajouter un tableau $subsubmenu au tableau des rubriques. $submenu["items"][] = $subsubmenu;

Des hiérarchies multiples n'ont pas été testées par l'équipe de développement de PhpGedView et ne sont donc pas présentes dans les codes qui sont fournis. C'est pourquoi elles doivent être utilisées avec la plus grande prudence.

Guide d'installation

2007-08-30T08:15:37Z

Papagolf : /* Objets Multimedia */

=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 sur le site du fournisseur de votre internet.

* Au moins 20 MB 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 à 2 MB, 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 de 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 transfé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 cela 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 espace, 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 du 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 (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épertoires 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”

[[Image:Filezilla.png|center|450px|thumb|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…”

[[Image:attributs.png|center|300px|thumb|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 copié 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 :

[[Image:Config_phpgedview.png|center|450px|thumb|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.

[[Image:Config_phpgedview1.png|center|375px|thumb|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.

[[Image:Liste_gedcom_chargés.png|center|550px|thumb|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.)

[[Image:Configuration_gedcom.png|center|450px|thumb|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.

[[Image:Familletintin.png|center|450px|thumb|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.

[[Image:Import_gedcom.png|center|550px|thumb|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.

[[Image:Dépassement_temps_exécution.png|center|550px|thumb|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.

[[Image:Import_terminé.png|center|250px|thumb|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 sauvegardé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 support 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'image qui 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 sauvegardez-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 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):

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
| 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:

{| class="wikitable" style="margin: 2em auto 2em auto" table border="1"
<center>pgv_blocks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_dates</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_families</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_favorites</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_individuals</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media_mapping</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_messages</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_names</center>
|-
| 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é
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_news</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_next_id</center>
|-
| ni_id INT(11) ||
|-
| ni_type VARCHAR(30) ||
|-
| ni_gedfile INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_other</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_placelinks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_places</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_remotelinks</center>
|-
| r_gid VARCHAR(255) ||
|-
| r_linkid VARCHAR(255) ||
|-
| r_file INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_sources</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_users</center>
|-
| 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 grande 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:

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
| 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.

==Sauvegarde==

Note: Si vous voulez utiliser la fonction de sauvegarde de l’utilitaire “Upgrade” de PhpGedView vous devez ou bien modifier les permissions du répertoire "phpgedview" en écriture, ou bien créer un répertoire nommé "sauvegarde" en lui donnant des permissions d’écriture. Les permissions d’écriture pour le répertoire "phpgedview" peuvent être remises en lecture seule aussitôt que le répertoire « sauvegarde » est en place et dispose des permissions d’écriture appropriées.

Avec la fonction de sauvegarde dans le menu d’administration, vous pouvez réaliser une sauvegarde de tous les fichiers importants de PhpGedView. Avec cette fonction de sauvegarde, il est possible de reconstruire votre site PhpGedView à l’état qu’il avait au moment de la sauvegarde.

La sauvegarde peut contenir les fichiers suivants, qui peuvent être choisis sur la page de sauvegarde :
- config.php avec tous les paramètres de configuration de votre installation
- tous les fichiers GEDCOM qui étaient présents dans votre installation
- toutes les options GEDCOM et les paramètres de confidentialité pour les fichiers ci-dessus
- les compteurs et les fichiers de log de PhpGedView
- les définitions et les options de l’utilisateur (définitions des blocs, favoris, messages et nouvelles)

Les fichiers peuvent être regroupés dans un fichier ZIP, qui peut être téléchargé en cliquant sur le lien qui se trouve sur la page.

Note: La base de données elle-même ne sera pas incluse dans la sauvegarde, parcequ’elle peut être reconstituée à partir des fichiers qui ont été sauvegardés.

Note: Toutes les modifications en attente (non approuvées ou sur le point d’être rejetées par l’administrateur) seront présentes dans les fichiers GEDCOM mais ne peuvent plus être identifiées comme des modifications. Si la base de données est reconstituée en utilisant ces fichiers GEDCOMs, ces changements ne peuvent plus être rejetés.

Note: Si vous avez installé votre répertoire index à l’extérieur du répertoire racine de votre serveur web, les références à quelques-uns des fichiers du zip incluront des chemins de répertoires de la forme "../". Quelques utilitaires zip (par exemple la capacité native de zip dans Windows XP de Windows Explorer) ne supporte pas ce type de chemin de fichier. Vous pouvez avoir besoin d’un outil qui supporte ce type de chemins. WinRAR est un de ces outils.

La fonction de sauvegarde utilise la bibliothèque PclZip, qui a été écrite par Vincent Blavet et qui peut être trouvée ici : http://www.phpconcept.net/pclzip.

==Intégration de PostNuke et PHPNuke ==

PhpGedView peut s’intégrer avec PostNuke et phpNuke afin que les utilisateurs n’aient pas besoin de s’identifier deux fois.

Une fois que PhpGedView est lancé, vous devez suivre les instructions du fichier readme.txt file qui se trouve dans le répertoire "pgvnuke".

Les fichiers qui rendent cette intégration possible ont été donnés par Jim Carey.

==Langages==

Note: si vous voulez utiliser les fonctions de langues vous devrez établir des permissions d’écriture pour tous les fichiers qui sont presents dans le repertoire "langages”.

PhpGedView a été construit pour pouvoir supporter de multiples langues. PHP ne supporte pas l’unicode (UTF-16). Il supporte l’UTF-8 et ce format est celui qui est recommandé pour encoder les fichiers GEDCOMs avec PhpGedView. Si vous avez des caractères dans votre fichier GEDCOM qui ne sont pas dans l’alphabet standard ASCII, vous devrez probablement utiliser l’encodage UTF-8. Il y a beaucoup de differences entre les formats UTF-8 et UTF-16, mais tout ce que vous encodez au format UTF-16 peut être encodé au format UTF-8. Il est également très facile de convertir de l’Unicode en UTF-8. Il vous suffit d’ouvrir votre fichier Unicode GEDCOM avec Windows Notepad et de choisir "Fichier->Enregistrer sous.." dans le menu et de choisir UTF-8 comme option d’encodage. Vous ne devriez perdre aucun caractère en effectuant cette traduction de format.

Les discussions et les questions sur les multiples fonctionnalités de langages de PhpGedView, traductions comprises, doivent être postées dans le forum “Translations” qui se trouve sur la page web du projet de PhpGedView ici:
http://sourceforge.net/forum/forum.php?forum_id=294245

Pour traduire PhpGedView dans une autre langue qui n'est pas actuellement supportée vous devez d'abord vous connecter à PhpGedView en tant qu' administrateur et aller ensuite à l'utilitaire d'édition des langues en cliquant sur "Administration-> Ajouter fichiers et paramètres pour une nouvelle langue". Choisissez votre nouvelle langue à partir du menu déroulant et cliquez sur le bouton « ajouter une nouvelle langue ».

Une fenêtre popup apparaît alors vous permettant d'éditer les paramètres par défaut de votre nouvelle langue. Chaque paramètre dispose d'une aide en ligne en cliquant sur le "?". Vous pouvez vouloir examiner les paramètres de quelques-uns des autres langages sur la page de configuration des langues, puis en cliquant sur « éditer », pour voir comment ils sont configurés.

Quand vous avez fini de paramétrer votre nouvelle langue, cliquez sur le bouton “sauvegarde”. Cela créera un nouveau fichier lang_settings.php dans le répertoire index. Vous remarquerez que votre nouvelle langue apparaît maintenant dans la liste des langues supportées.

Créez ensuite une copie des fichiers "configure_help.en.php", "facts.en.php", "help_text.en.php", et "lang.en.php" qui se trouvent dans le répertoire "langages" et changez la partie "en" qui est dans le nom de ces fichiers afin d'y mettre à la place les deux lettres du code correspondant à votre nouvelle langue.

Le fichier "facts" contient toutes les traductions des différentes balises (ou tags) du standard GEDCOM telles que BIRT = Birth. Le fichier "lang" contient toutes les différentes langues utilisées par le site. Les fichiers "configure_help.en.php" et "help_text.en.php" fournissent les instructions de configuration et d'aide.

Vous pouvez traduire ces fichiers en utilisant l'utilitaire d'édition de fichiers de traduction, qui est accessible en cliquant sur “Editer le contenu des fichiers de traduction ». Sélectionnez votre langue à partir de la liste déroulante puis choisissez le fichier que vous voulez éditer et cliquez sur le bouton “Editer”. Votre fichier sera comparé au fichier en anglais afin que vous puissiez facilement traduire les fichiers en ligne.

Vous pouvez aussi traduire des fichiers manuellement en les ouvrant avec un éditeur de texte. Si vous éditez manuellement des fichiers, vous devez les sauvegarder au format UTF-8. Quelques éditeurs de texte tels que Windows Notepad ajoutent un marqueur 3-byte Byte-Order-Mark (BOM) aux fichiers qui sont sauvegardés au format UTF-8. PHP n'aime pas les marqueurs BOM et ils doivent être supprimés avant de tester le fonctionnement de ces fichiers dans PhpGedView. La section des outils de traduction de PhpGedView' a un programme utilitaire pour supprimer ces a BOMs.

Vous devez récupérer un drapeau correspondant à votre langue à partir du fichier http://w3f.com/gifs/index.html er le dimensionner pour qu'il ait la même taille que les drapeaux qui sont dans le répertoire images/flags.

Pour aider au support des langues, un fichier log des modifications de langues existe dans le répertoire langages. Ce fichier log est dénommé LANG_CHANGELOG.txt. Toutes les modifications aux fichiers de langue anglaise sont enregistrés ici.

Si vous effectuez une nouvelle traduction de PhpGedView ou si vous mettez à jour une autre traduction, et que vous voulez en faire profiter la communauté, postez vos fichiers de langues ainsi que votre fichier index/lang_settings.php dans la section Patches section du site web du projet SourceForge ici: http://www.sourceforge.net/projects/phpgedview

==Fichiers d'extension de langues==

Les fichiers d'extension de langues sont des fichiers PHP courants que vous pouvez utiliser pour créer vos propres extensions de langue pour PhpGedView. Pour ajouter un fichier d'extension de langue, créez un nouveau fichier PHP dénommé lang.xx.extra.php en remplaçant le "xx" par le code de la langue que vous voulez ajouter. Ces fichiers ne sont pas inclus automatiquement dans le paquet logiciel PhpGedView afin que lorsque vous les mettez à jour, vos extensions ne soient pas écrasées.

Si ce fichier existe pour la langue que vous avez choisie, c'est la dernière chose qui est chargée avant que l'affichage n'apparaisse. Ces fichiers ont été conçus pour être des extensions des fichiers de langue, mais vous pouvez facilement les utiliser pour faire en sorte que les changements de paramètres soient basés sur la langue choisie.

Quelles sont les différentes actions que l'on peut entreprendre avec ces fichiers d'extension de langues?
- Adapter tout ou partie du texte qui apparaît à l'écran,
- Modifier les options de configuration qui sont basées sur la langue,
- Basculer sur un nouveau GEDCOM quand quelqu'un visualise votre site dans une langue différente.

Les seuls paramètres que vous ne devez pas modifier dans ce fichiers sont les paramètres de confidentialité.

Si, par exemple, vous voulez changer le titre du GEDCOM quand vous changer la langue, vous pouvez changer le titre pour chaque langue en ajoutant la ligne suivante dans votre fichier lang.xx.extra.php:
$GEDCOMS["surname.ged"]["title"] = "Titre en chinois";

Dans ce fichier vous pouvez aussi changer le texte sur les boutons:
$pgv_lang["view"]="Montrer";

Avec ce fichier vous pouvez aussi changer le GEDCOM qui apparaît quand la langue est sélectionnée. Supposons que vous avez un GEDCOM qui était en allemand et un autre qui était en anglais. Dans le fichier lang.de.extra.php vous pouvez ajouter les lignes suivantes:
if ($GEDCOM=="english.ged") {
header("Location: $SCRIPT_NAME?$QUERY_STRING&ged=german.ged");
exit;
}

Ces lignes signifient que si nous utilisons des fichiers en langue allemande, mais que nous utilisons le GEDCOM anglais, alors nous devons recharger la page avec le GEDCOM allemand. Vous devez recharger la page afin que les paramètres de configuration du GEDCOM soient chargés. Cela suppose que vous importé les deux fichiers "english.ged" et "german.ged" dans la base de données et que les fichiers english.ged et german.ged contiennent les mêmes personnes, mais dans des langues différentes.

Ainsi I0001 dans le fichier english.ged doit correspondre au même I0001 dans le fichier german.ged.

=PhpGedView pour les plus avancés d'entre vous=

La plupart d'entre nous utilise des versions stables de PhpGedView, annoncées et disponibles sur les pages principales de http://www.SourceForge.net/PhpGedView.

Mais il y a toujours des développements dans le tuyau. Ces développements peuvent prendre deux formes – les patches (et vous y trouverez des correctifs de temps à autres face à des bugs signalés) et des scripts non certifiés – souvent référencés comme des "subversions" - en raccourci, SVN. Et vous trouverez des références aux "revision control", qui est le même concept.

Les “subversions” SVN sont faites pour quiconque est impliqué dans le développement et le test de logiciels libres (open source). La rubrique SVN est le répertoire dans lequel toutes les subversions actuelles sont stockées. Ce sont les éditeurs/éditeurs de scripts/programmeurs/etc qui travaillent sur les modifications, qui sont autorisés à travailler sur ce répertoire. Puis il y a les utilisateurs/testeurs/ « leading edgers », qui ont téléchargé le logiciel depuis ce répertoire dans leur espace de travail.

Cette description de SVN est très succincte – mais est peut-être suffisante pour que vous y manifestiez un intérêt.

==Gérer les SVN==

Une copie exhaustive de PhpGedView contient environ 3300 fichiers. Pour garder ce nombre de fichiers important à jour avec les copies les plus récentes dans le répertoire SVN, il faut de l'assistance. C'est pourquoi il y a quelques outils qui peuvent examiner les fichiers que vous avez déjà, et qui les comparent avec ceux qui sont dans le répertoire SVN. Si des fichiers dans le répertoire SVN sont plus récents que les vôtres, les copies du répertoire sont automatiquement télé chargées sur votre site.

Un des outils les plus faciles à utiliser est Tortoise. Pour les utilisateurs sous Windows, il vous suffit d'aller à http://tortoisesvn.net/ La page de téléchargements est ici http://tortoisesvn.net/downloads. Toutes les instructions sont disponibles ici.

Tortoise SVN est utilisable avec Windows 2000 et Windows XP. Il n'y a pas de besoin de s'identifier sur le site de
SourceForge pour utiliser cette méthode.

==Utiliser SVN==

Le processus SVN utilise quelques petits fichiers de contrôle qui comparent les données que vous avez dans vos fichiers avec ceux du répertoire SVN. S'il n'existe aucun écart, il n'y a alors pas besoin de mise à jour. S'il existe des écarts, il y a alors besoin d'une mise à jour. I

Ces petits fichiers sont installés dans un répertoire (".svn") sur votre système. Mais les répertoires peuvent représenter un inconvénient quand il vient à occuper tout l'espace d'installation de PhpGedView – et a besoin d'être enlevé de cet espace avant d'être téléchargé sur le serveur.

Plutôt que de fournir ici une longue liste, tapez dans Google '.svn delete' ou 'supprimer subversion' et vous trouverez beaucoup de références pour Linux, Mac et Windows.

[[en:Installation Guide]]

Guide d'installation

2007-08-29T14:44:04Z

Papagolf : /* Thèmes */

=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 sur le site du fournisseur de votre internet.

* Au moins 20 MB 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 à 2 MB, 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 de 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 transfé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 cela 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 espace, 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 du 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 (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épertoires 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”

[[Image:Filezilla.png|center|450px|thumb|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…”

[[Image:attributs.png|center|300px|thumb|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 copié 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 :

[[Image:Config_phpgedview.png|center|450px|thumb|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.

[[Image:Config_phpgedview1.png|center|375px|thumb|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.

[[Image:Liste_gedcom_chargés.png|center|550px|thumb|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.)

[[Image:Configuration_gedcom.png|center|450px|thumb|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.

[[Image:Familletintin.png|center|450px|thumb|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.

[[Image:Import_gedcom.png|center|550px|thumb|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.

[[Image:Dépassement_temps_exécution.png|center|550px|thumb|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.

[[Image:Import_terminé.png|center|250px|thumb|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 sauvegardé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 support 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'image qui 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 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):

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
| 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:

{| class="wikitable" style="margin: 2em auto 2em auto" table border="1"
<center>pgv_blocks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_dates</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_families</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_favorites</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_individuals</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media_mapping</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_messages</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_names</center>
|-
| 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é
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_news</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_next_id</center>
|-
| ni_id INT(11) ||
|-
| ni_type VARCHAR(30) ||
|-
| ni_gedfile INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_other</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_placelinks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_places</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_remotelinks</center>
|-
| r_gid VARCHAR(255) ||
|-
| r_linkid VARCHAR(255) ||
|-
| r_file INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_sources</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_users</center>
|-
| 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 grande 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:

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
| 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.

==Sauvegarde==

Note: Si vous voulez utiliser la fonction de sauvegarde de l’utilitaire “Upgrade” de PhpGedView vous devez ou bien modifier les permissions du répertoire "phpgedview" en écriture, ou bien créer un répertoire nommé "sauvegarde" en lui donnant des permissions d’écriture. Les permissions d’écriture pour le répertoire "phpgedview" peuvent être remises en lecture seule aussitôt que le répertoire « sauvegarde » est en place et dispose des permissions d’écriture appropriées.

Avec la fonction de sauvegarde dans le menu d’administration, vous pouvez réaliser une sauvegarde de tous les fichiers importants de PhpGedView. Avec cette fonction de sauvegarde, il est possible de reconstruire votre site PhpGedView à l’état qu’il avait au moment de la sauvegarde.

La sauvegarde peut contenir les fichiers suivants, qui peuvent être choisis sur la page de sauvegarde :
- config.php avec tous les paramètres de configuration de votre installation
- tous les fichiers GEDCOM qui étaient présents dans votre installation
- toutes les options GEDCOM et les paramètres de confidentialité pour les fichiers ci-dessus
- les compteurs et les fichiers de log de PhpGedView
- les définitions et les options de l’utilisateur (définitions des blocs, favoris, messages et nouvelles)

Les fichiers peuvent être regroupés dans un fichier ZIP, qui peut être téléchargé en cliquant sur le lien qui se trouve sur la page.

Note: La base de données elle-même ne sera pas incluse dans la sauvegarde, parcequ’elle peut être reconstituée à partir des fichiers qui ont été sauvegardés.

Note: Toutes les modifications en attente (non approuvées ou sur le point d’être rejetées par l’administrateur) seront présentes dans les fichiers GEDCOM mais ne peuvent plus être identifiées comme des modifications. Si la base de données est reconstituée en utilisant ces fichiers GEDCOMs, ces changements ne peuvent plus être rejetés.

Note: Si vous avez installé votre répertoire index à l’extérieur du répertoire racine de votre serveur web, les références à quelques-uns des fichiers du zip incluront des chemins de répertoires de la forme "../". Quelques utilitaires zip (par exemple la capacité native de zip dans Windows XP de Windows Explorer) ne supporte pas ce type de chemin de fichier. Vous pouvez avoir besoin d’un outil qui supporte ce type de chemins. WinRAR est un de ces outils.

La fonction de sauvegarde utilise la bibliothèque PclZip, qui a été écrite par Vincent Blavet et qui peut être trouvée ici : http://www.phpconcept.net/pclzip.

==Intégration de PostNuke et PHPNuke ==

PhpGedView peut s’intégrer avec PostNuke et phpNuke afin que les utilisateurs n’aient pas besoin de s’identifier deux fois.

Une fois que PhpGedView est lancé, vous devez suivre les instructions du fichier readme.txt file qui se trouve dans le répertoire "pgvnuke".

Les fichiers qui rendent cette intégration possible ont été donnés par Jim Carey.

==Langages==

Note: si vous voulez utiliser les fonctions de langues vous devrez établir des permissions d’écriture pour tous les fichiers qui sont presents dans le repertoire "langages”.

PhpGedView a été construit pour pouvoir supporter de multiples langues. PHP ne supporte pas l’unicode (UTF-16). Il supporte l’UTF-8 et ce format est celui qui est recommandé pour encoder les fichiers GEDCOMs avec PhpGedView. Si vous avez des caractères dans votre fichier GEDCOM qui ne sont pas dans l’alphabet standard ASCII, vous devrez probablement utiliser l’encodage UTF-8. Il y a beaucoup de differences entre les formats UTF-8 et UTF-16, mais tout ce que vous encodez au format UTF-16 peut être encodé au format UTF-8. Il est également très facile de convertir de l’Unicode en UTF-8. Il vous suffit d’ouvrir votre fichier Unicode GEDCOM avec Windows Notepad et de choisir "Fichier->Enregistrer sous.." dans le menu et de choisir UTF-8 comme option d’encodage. Vous ne devriez perdre aucun caractère en effectuant cette traduction de format.

Les discussions et les questions sur les multiples fonctionnalités de langages de PhpGedView, traductions comprises, doivent être postées dans le forum “Translations” qui se trouve sur la page web du projet de PhpGedView ici:
http://sourceforge.net/forum/forum.php?forum_id=294245

Pour traduire PhpGedView dans une autre langue qui n'est pas actuellement supportée vous devez d'abord vous connecter à PhpGedView en tant qu' administrateur et aller ensuite à l'utilitaire d'édition des langues en cliquant sur "Administration-> Ajouter fichiers et paramètres pour une nouvelle langue". Choisissez votre nouvelle langue à partir du menu déroulant et cliquez sur le bouton « ajouter une nouvelle langue ».

Une fenêtre popup apparaît alors vous permettant d'éditer les paramètres par défaut de votre nouvelle langue. Chaque paramètre dispose d'une aide en ligne en cliquant sur le "?". Vous pouvez vouloir examiner les paramètres de quelques-uns des autres langages sur la page de configuration des langues, puis en cliquant sur « éditer », pour voir comment ils sont configurés.

Quand vous avez fini de paramétrer votre nouvelle langue, cliquez sur le bouton “sauvegarde”. Cela créera un nouveau fichier lang_settings.php dans le répertoire index. Vous remarquerez que votre nouvelle langue apparaît maintenant dans la liste des langues supportées.

Créez ensuite une copie des fichiers "configure_help.en.php", "facts.en.php", "help_text.en.php", et "lang.en.php" qui se trouvent dans le répertoire "langages" et changez la partie "en" qui est dans le nom de ces fichiers afin d'y mettre à la place les deux lettres du code correspondant à votre nouvelle langue.

Le fichier "facts" contient toutes les traductions des différentes balises (ou tags) du standard GEDCOM telles que BIRT = Birth. Le fichier "lang" contient toutes les différentes langues utilisées par le site. Les fichiers "configure_help.en.php" et "help_text.en.php" fournissent les instructions de configuration et d'aide.

Vous pouvez traduire ces fichiers en utilisant l'utilitaire d'édition de fichiers de traduction, qui est accessible en cliquant sur “Editer le contenu des fichiers de traduction ». Sélectionnez votre langue à partir de la liste déroulante puis choisissez le fichier que vous voulez éditer et cliquez sur le bouton “Editer”. Votre fichier sera comparé au fichier en anglais afin que vous puissiez facilement traduire les fichiers en ligne.

Vous pouvez aussi traduire des fichiers manuellement en les ouvrant avec un éditeur de texte. Si vous éditez manuellement des fichiers, vous devez les sauvegarder au format UTF-8. Quelques éditeurs de texte tels que Windows Notepad ajoutent un marqueur 3-byte Byte-Order-Mark (BOM) aux fichiers qui sont sauvegardés au format UTF-8. PHP n'aime pas les marqueurs BOM et ils doivent être supprimés avant de tester le fonctionnement de ces fichiers dans PhpGedView. La section des outils de traduction de PhpGedView' a un programme utilitaire pour supprimer ces a BOMs.

Vous devez récupérer un drapeau correspondant à votre langue à partir du fichier http://w3f.com/gifs/index.html er le dimensionner pour qu'il ait la même taille que les drapeaux qui sont dans le répertoire images/flags.

Pour aider au support des langues, un fichier log des modifications de langues existe dans le répertoire langages. Ce fichier log est dénommé LANG_CHANGELOG.txt. Toutes les modifications aux fichiers de langue anglaise sont enregistrés ici.

Si vous effectuez une nouvelle traduction de PhpGedView ou si vous mettez à jour une autre traduction, et que vous voulez en faire profiter la communauté, postez vos fichiers de langues ainsi que votre fichier index/lang_settings.php dans la section Patches section du site web du projet SourceForge ici: http://www.sourceforge.net/projects/phpgedview

==Fichiers d'extension de langues==

Les fichiers d'extension de langues sont des fichiers PHP courants que vous pouvez utiliser pour créer vos propres extensions de langue pour PhpGedView. Pour ajouter un fichier d'extension de langue, créez un nouveau fichier PHP dénommé lang.xx.extra.php en remplaçant le "xx" par le code de la langue que vous voulez ajouter. Ces fichiers ne sont pas inclus automatiquement dans le paquet logiciel PhpGedView afin que lorsque vous les mettez à jour, vos extensions ne soient pas écrasées.

Si ce fichier existe pour la langue que vous avez choisie, c'est la dernière chose qui est chargée avant que l'affichage n'apparaisse. Ces fichiers ont été conçus pour être des extensions des fichiers de langue, mais vous pouvez facilement les utiliser pour faire en sorte que les changements de paramètres soient basés sur la langue choisie.

Quelles sont les différentes actions que l'on peut entreprendre avec ces fichiers d'extension de langues?
- Adapter tout ou partie du texte qui apparaît à l'écran,
- Modifier les options de configuration qui sont basées sur la langue,
- Basculer sur un nouveau GEDCOM quand quelqu'un visualise votre site dans une langue différente.

Les seuls paramètres que vous ne devez pas modifier dans ce fichiers sont les paramètres de confidentialité.

Si, par exemple, vous voulez changer le titre du GEDCOM quand vous changer la langue, vous pouvez changer le titre pour chaque langue en ajoutant la ligne suivante dans votre fichier lang.xx.extra.php:
$GEDCOMS["surname.ged"]["title"] = "Titre en chinois";

Dans ce fichier vous pouvez aussi changer le texte sur les boutons:
$pgv_lang["view"]="Montrer";

Avec ce fichier vous pouvez aussi changer le GEDCOM qui apparaît quand la langue est sélectionnée. Supposons que vous avez un GEDCOM qui était en allemand et un autre qui était en anglais. Dans le fichier lang.de.extra.php vous pouvez ajouter les lignes suivantes:
if ($GEDCOM=="english.ged") {
header("Location: $SCRIPT_NAME?$QUERY_STRING&ged=german.ged");
exit;
}

Ces lignes signifient que si nous utilisons des fichiers en langue allemande, mais que nous utilisons le GEDCOM anglais, alors nous devons recharger la page avec le GEDCOM allemand. Vous devez recharger la page afin que les paramètres de configuration du GEDCOM soient chargés. Cela suppose que vous importé les deux fichiers "english.ged" et "german.ged" dans la base de données et que les fichiers english.ged et german.ged contiennent les mêmes personnes, mais dans des langues différentes.

Ainsi I0001 dans le fichier english.ged doit correspondre au même I0001 dans le fichier german.ged.

=PhpGedView pour les plus avancés d'entre vous=

La plupart d'entre nous utilise des versions stables de PhpGedView, annoncées et disponibles sur les pages principales de http://www.SourceForge.net/PhpGedView.

Mais il y a toujours des développements dans le tuyau. Ces développements peuvent prendre deux formes – les patches (et vous y trouverez des correctifs de temps à autres face à des bugs signalés) et des scripts non certifiés – souvent référencés comme des "subversions" - en raccourci, SVN. Et vous trouverez des références aux "revision control", qui est le même concept.

Les “subversions” SVN sont faites pour quiconque est impliqué dans le développement et le test de logiciels libres (open source). La rubrique SVN est le répertoire dans lequel toutes les subversions actuelles sont stockées. Ce sont les éditeurs/éditeurs de scripts/programmeurs/etc qui travaillent sur les modifications, qui sont autorisés à travailler sur ce répertoire. Puis il y a les utilisateurs/testeurs/ « leading edgers », qui ont téléchargé le logiciel depuis ce répertoire dans leur espace de travail.

Cette description de SVN est très succincte – mais est peut-être suffisante pour que vous y manifestiez un intérêt.

==Gérer les SVN==

Une copie exhaustive de PhpGedView contient environ 3300 fichiers. Pour garder ce nombre de fichiers important à jour avec les copies les plus récentes dans le répertoire SVN, il faut de l'assistance. C'est pourquoi il y a quelques outils qui peuvent examiner les fichiers que vous avez déjà, et qui les comparent avec ceux qui sont dans le répertoire SVN. Si des fichiers dans le répertoire SVN sont plus récents que les vôtres, les copies du répertoire sont automatiquement télé chargées sur votre site.

Un des outils les plus faciles à utiliser est Tortoise. Pour les utilisateurs sous Windows, il vous suffit d'aller à http://tortoisesvn.net/ La page de téléchargements est ici http://tortoisesvn.net/downloads. Toutes les instructions sont disponibles ici.

Tortoise SVN est utilisable avec Windows 2000 et Windows XP. Il n'y a pas de besoin de s'identifier sur le site de
SourceForge pour utiliser cette méthode.

==Utiliser SVN==

Le processus SVN utilise quelques petits fichiers de contrôle qui comparent les données que vous avez dans vos fichiers avec ceux du répertoire SVN. S'il n'existe aucun écart, il n'y a alors pas besoin de mise à jour. S'il existe des écarts, il y a alors besoin d'une mise à jour. I

Ces petits fichiers sont installés dans un répertoire (".svn") sur votre système. Mais les répertoires peuvent représenter un inconvénient quand il vient à occuper tout l'espace d'installation de PhpGedView – et a besoin d'être enlevé de cet espace avant d'être téléchargé sur le serveur.

Plutôt que de fournir ici une longue liste, tapez dans Google '.svn delete' ou 'supprimer subversion' et vous trouverez beaucoup de références pour Linux, Mac et Windows.

[[en:Installation Guide]]

Guide d'installation

2007-08-29T14:42:08Z

Papagolf : /* Sécurité et bonnes pratiques */

=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 sur le site du fournisseur de votre internet.

* Au moins 20 MB 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 à 2 MB, 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 de 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 transfé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 cela 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 espace, 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 du 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 (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épertoires 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”

[[Image:Filezilla.png|center|450px|thumb|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…”

[[Image:attributs.png|center|300px|thumb|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 copié 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 :

[[Image:Config_phpgedview.png|center|450px|thumb|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.

[[Image:Config_phpgedview1.png|center|375px|thumb|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.

[[Image:Liste_gedcom_chargés.png|center|550px|thumb|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.)

[[Image:Configuration_gedcom.png|center|450px|thumb|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.

[[Image:Familletintin.png|center|450px|thumb|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.

[[Image:Import_gedcom.png|center|550px|thumb|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.

[[Image:Dépassement_temps_exécution.png|center|550px|thumb|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.

[[Image:Import_terminé.png|center|250px|thumb|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 sauvegardé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 support 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'image qui 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 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):

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
| 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:

{| class="wikitable" style="margin: 2em auto 2em auto" table border="1"
<center>pgv_blocks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_dates</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_families</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_favorites</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_individuals</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media_mapping</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_messages</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_names</center>
|-
| 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é
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_news</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_next_id</center>
|-
| ni_id INT(11) ||
|-
| ni_type VARCHAR(30) ||
|-
| ni_gedfile INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_other</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_placelinks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_places</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_remotelinks</center>
|-
| r_gid VARCHAR(255) ||
|-
| r_linkid VARCHAR(255) ||
|-
| r_file INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_sources</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_users</center>
|-
| 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:

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
| 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.

==Sauvegarde==

Note: Si vous voulez utiliser la fonction de sauvegarde de l’utilitaire “Upgrade” de PhpGedView vous devez ou bien modifier les permissions du répertoire "phpgedview" en écriture, ou bien créer un répertoire nommé "sauvegarde" en lui donnant des permissions d’écriture. Les permissions d’écriture pour le répertoire "phpgedview" peuvent être remises en lecture seule aussitôt que le répertoire « sauvegarde » est en place et dispose des permissions d’écriture appropriées.

Avec la fonction de sauvegarde dans le menu d’administration, vous pouvez réaliser une sauvegarde de tous les fichiers importants de PhpGedView. Avec cette fonction de sauvegarde, il est possible de reconstruire votre site PhpGedView à l’état qu’il avait au moment de la sauvegarde.

La sauvegarde peut contenir les fichiers suivants, qui peuvent être choisis sur la page de sauvegarde :
- config.php avec tous les paramètres de configuration de votre installation
- tous les fichiers GEDCOM qui étaient présents dans votre installation
- toutes les options GEDCOM et les paramètres de confidentialité pour les fichiers ci-dessus
- les compteurs et les fichiers de log de PhpGedView
- les définitions et les options de l’utilisateur (définitions des blocs, favoris, messages et nouvelles)

Les fichiers peuvent être regroupés dans un fichier ZIP, qui peut être téléchargé en cliquant sur le lien qui se trouve sur la page.

Note: La base de données elle-même ne sera pas incluse dans la sauvegarde, parcequ’elle peut être reconstituée à partir des fichiers qui ont été sauvegardés.

Note: Toutes les modifications en attente (non approuvées ou sur le point d’être rejetées par l’administrateur) seront présentes dans les fichiers GEDCOM mais ne peuvent plus être identifiées comme des modifications. Si la base de données est reconstituée en utilisant ces fichiers GEDCOMs, ces changements ne peuvent plus être rejetés.

Note: Si vous avez installé votre répertoire index à l’extérieur du répertoire racine de votre serveur web, les références à quelques-uns des fichiers du zip incluront des chemins de répertoires de la forme "../". Quelques utilitaires zip (par exemple la capacité native de zip dans Windows XP de Windows Explorer) ne supporte pas ce type de chemin de fichier. Vous pouvez avoir besoin d’un outil qui supporte ce type de chemins. WinRAR est un de ces outils.

La fonction de sauvegarde utilise la bibliothèque PclZip, qui a été écrite par Vincent Blavet et qui peut être trouvée ici : http://www.phpconcept.net/pclzip.

==Intégration de PostNuke et PHPNuke ==

PhpGedView peut s’intégrer avec PostNuke et phpNuke afin que les utilisateurs n’aient pas besoin de s’identifier deux fois.

Une fois que PhpGedView est lancé, vous devez suivre les instructions du fichier readme.txt file qui se trouve dans le répertoire "pgvnuke".

Les fichiers qui rendent cette intégration possible ont été donnés par Jim Carey.

==Langages==

Note: si vous voulez utiliser les fonctions de langues vous devrez établir des permissions d’écriture pour tous les fichiers qui sont presents dans le repertoire "langages”.

PhpGedView a été construit pour pouvoir supporter de multiples langues. PHP ne supporte pas l’unicode (UTF-16). Il supporte l’UTF-8 et ce format est celui qui est recommandé pour encoder les fichiers GEDCOMs avec PhpGedView. Si vous avez des caractères dans votre fichier GEDCOM qui ne sont pas dans l’alphabet standard ASCII, vous devrez probablement utiliser l’encodage UTF-8. Il y a beaucoup de differences entre les formats UTF-8 et UTF-16, mais tout ce que vous encodez au format UTF-16 peut être encodé au format UTF-8. Il est également très facile de convertir de l’Unicode en UTF-8. Il vous suffit d’ouvrir votre fichier Unicode GEDCOM avec Windows Notepad et de choisir "Fichier->Enregistrer sous.." dans le menu et de choisir UTF-8 comme option d’encodage. Vous ne devriez perdre aucun caractère en effectuant cette traduction de format.

Les discussions et les questions sur les multiples fonctionnalités de langages de PhpGedView, traductions comprises, doivent être postées dans le forum “Translations” qui se trouve sur la page web du projet de PhpGedView ici:
http://sourceforge.net/forum/forum.php?forum_id=294245

Pour traduire PhpGedView dans une autre langue qui n'est pas actuellement supportée vous devez d'abord vous connecter à PhpGedView en tant qu' administrateur et aller ensuite à l'utilitaire d'édition des langues en cliquant sur "Administration-> Ajouter fichiers et paramètres pour une nouvelle langue". Choisissez votre nouvelle langue à partir du menu déroulant et cliquez sur le bouton « ajouter une nouvelle langue ».

Une fenêtre popup apparaît alors vous permettant d'éditer les paramètres par défaut de votre nouvelle langue. Chaque paramètre dispose d'une aide en ligne en cliquant sur le "?". Vous pouvez vouloir examiner les paramètres de quelques-uns des autres langages sur la page de configuration des langues, puis en cliquant sur « éditer », pour voir comment ils sont configurés.

Quand vous avez fini de paramétrer votre nouvelle langue, cliquez sur le bouton “sauvegarde”. Cela créera un nouveau fichier lang_settings.php dans le répertoire index. Vous remarquerez que votre nouvelle langue apparaît maintenant dans la liste des langues supportées.

Créez ensuite une copie des fichiers "configure_help.en.php", "facts.en.php", "help_text.en.php", et "lang.en.php" qui se trouvent dans le répertoire "langages" et changez la partie "en" qui est dans le nom de ces fichiers afin d'y mettre à la place les deux lettres du code correspondant à votre nouvelle langue.

Le fichier "facts" contient toutes les traductions des différentes balises (ou tags) du standard GEDCOM telles que BIRT = Birth. Le fichier "lang" contient toutes les différentes langues utilisées par le site. Les fichiers "configure_help.en.php" et "help_text.en.php" fournissent les instructions de configuration et d'aide.

Vous pouvez traduire ces fichiers en utilisant l'utilitaire d'édition de fichiers de traduction, qui est accessible en cliquant sur “Editer le contenu des fichiers de traduction ». Sélectionnez votre langue à partir de la liste déroulante puis choisissez le fichier que vous voulez éditer et cliquez sur le bouton “Editer”. Votre fichier sera comparé au fichier en anglais afin que vous puissiez facilement traduire les fichiers en ligne.

Vous pouvez aussi traduire des fichiers manuellement en les ouvrant avec un éditeur de texte. Si vous éditez manuellement des fichiers, vous devez les sauvegarder au format UTF-8. Quelques éditeurs de texte tels que Windows Notepad ajoutent un marqueur 3-byte Byte-Order-Mark (BOM) aux fichiers qui sont sauvegardés au format UTF-8. PHP n'aime pas les marqueurs BOM et ils doivent être supprimés avant de tester le fonctionnement de ces fichiers dans PhpGedView. La section des outils de traduction de PhpGedView' a un programme utilitaire pour supprimer ces a BOMs.

Vous devez récupérer un drapeau correspondant à votre langue à partir du fichier http://w3f.com/gifs/index.html er le dimensionner pour qu'il ait la même taille que les drapeaux qui sont dans le répertoire images/flags.

Pour aider au support des langues, un fichier log des modifications de langues existe dans le répertoire langages. Ce fichier log est dénommé LANG_CHANGELOG.txt. Toutes les modifications aux fichiers de langue anglaise sont enregistrés ici.

Si vous effectuez une nouvelle traduction de PhpGedView ou si vous mettez à jour une autre traduction, et que vous voulez en faire profiter la communauté, postez vos fichiers de langues ainsi que votre fichier index/lang_settings.php dans la section Patches section du site web du projet SourceForge ici: http://www.sourceforge.net/projects/phpgedview

==Fichiers d'extension de langues==

Les fichiers d'extension de langues sont des fichiers PHP courants que vous pouvez utiliser pour créer vos propres extensions de langue pour PhpGedView. Pour ajouter un fichier d'extension de langue, créez un nouveau fichier PHP dénommé lang.xx.extra.php en remplaçant le "xx" par le code de la langue que vous voulez ajouter. Ces fichiers ne sont pas inclus automatiquement dans le paquet logiciel PhpGedView afin que lorsque vous les mettez à jour, vos extensions ne soient pas écrasées.

Si ce fichier existe pour la langue que vous avez choisie, c'est la dernière chose qui est chargée avant que l'affichage n'apparaisse. Ces fichiers ont été conçus pour être des extensions des fichiers de langue, mais vous pouvez facilement les utiliser pour faire en sorte que les changements de paramètres soient basés sur la langue choisie.

Quelles sont les différentes actions que l'on peut entreprendre avec ces fichiers d'extension de langues?
- Adapter tout ou partie du texte qui apparaît à l'écran,
- Modifier les options de configuration qui sont basées sur la langue,
- Basculer sur un nouveau GEDCOM quand quelqu'un visualise votre site dans une langue différente.

Les seuls paramètres que vous ne devez pas modifier dans ce fichiers sont les paramètres de confidentialité.

Si, par exemple, vous voulez changer le titre du GEDCOM quand vous changer la langue, vous pouvez changer le titre pour chaque langue en ajoutant la ligne suivante dans votre fichier lang.xx.extra.php:
$GEDCOMS["surname.ged"]["title"] = "Titre en chinois";

Dans ce fichier vous pouvez aussi changer le texte sur les boutons:
$pgv_lang["view"]="Montrer";

Avec ce fichier vous pouvez aussi changer le GEDCOM qui apparaît quand la langue est sélectionnée. Supposons que vous avez un GEDCOM qui était en allemand et un autre qui était en anglais. Dans le fichier lang.de.extra.php vous pouvez ajouter les lignes suivantes:
if ($GEDCOM=="english.ged") {
header("Location: $SCRIPT_NAME?$QUERY_STRING&ged=german.ged");
exit;
}

Ces lignes signifient que si nous utilisons des fichiers en langue allemande, mais que nous utilisons le GEDCOM anglais, alors nous devons recharger la page avec le GEDCOM allemand. Vous devez recharger la page afin que les paramètres de configuration du GEDCOM soient chargés. Cela suppose que vous importé les deux fichiers "english.ged" et "german.ged" dans la base de données et que les fichiers english.ged et german.ged contiennent les mêmes personnes, mais dans des langues différentes.

Ainsi I0001 dans le fichier english.ged doit correspondre au même I0001 dans le fichier german.ged.

=PhpGedView pour les plus avancés d'entre vous=

La plupart d'entre nous utilise des versions stables de PhpGedView, annoncées et disponibles sur les pages principales de http://www.SourceForge.net/PhpGedView.

Mais il y a toujours des développements dans le tuyau. Ces développements peuvent prendre deux formes – les patches (et vous y trouverez des correctifs de temps à autres face à des bugs signalés) et des scripts non certifiés – souvent référencés comme des "subversions" - en raccourci, SVN. Et vous trouverez des références aux "revision control", qui est le même concept.

Les “subversions” SVN sont faites pour quiconque est impliqué dans le développement et le test de logiciels libres (open source). La rubrique SVN est le répertoire dans lequel toutes les subversions actuelles sont stockées. Ce sont les éditeurs/éditeurs de scripts/programmeurs/etc qui travaillent sur les modifications, qui sont autorisés à travailler sur ce répertoire. Puis il y a les utilisateurs/testeurs/ « leading edgers », qui ont téléchargé le logiciel depuis ce répertoire dans leur espace de travail.

Cette description de SVN est très succincte – mais est peut-être suffisante pour que vous y manifestiez un intérêt.

==Gérer les SVN==

Une copie exhaustive de PhpGedView contient environ 3300 fichiers. Pour garder ce nombre de fichiers important à jour avec les copies les plus récentes dans le répertoire SVN, il faut de l'assistance. C'est pourquoi il y a quelques outils qui peuvent examiner les fichiers que vous avez déjà, et qui les comparent avec ceux qui sont dans le répertoire SVN. Si des fichiers dans le répertoire SVN sont plus récents que les vôtres, les copies du répertoire sont automatiquement télé chargées sur votre site.

Un des outils les plus faciles à utiliser est Tortoise. Pour les utilisateurs sous Windows, il vous suffit d'aller à http://tortoisesvn.net/ La page de téléchargements est ici http://tortoisesvn.net/downloads. Toutes les instructions sont disponibles ici.

Tortoise SVN est utilisable avec Windows 2000 et Windows XP. Il n'y a pas de besoin de s'identifier sur le site de
SourceForge pour utiliser cette méthode.

==Utiliser SVN==

Le processus SVN utilise quelques petits fichiers de contrôle qui comparent les données que vous avez dans vos fichiers avec ceux du répertoire SVN. S'il n'existe aucun écart, il n'y a alors pas besoin de mise à jour. S'il existe des écarts, il y a alors besoin d'une mise à jour. I

Ces petits fichiers sont installés dans un répertoire (".svn") sur votre système. Mais les répertoires peuvent représenter un inconvénient quand il vient à occuper tout l'espace d'installation de PhpGedView – et a besoin d'être enlevé de cet espace avant d'être téléchargé sur le serveur.

Plutôt que de fournir ici une longue liste, tapez dans Google '.svn delete' ou 'supprimer subversion' et vous trouverez beaucoup de références pour Linux, Mac et Windows.

[[en:Installation Guide]]

Guide d'installation

2007-08-29T13:21:54Z

Papagolf : /* GEDCOMs */

=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 sur le site du fournisseur de votre internet.

* Au moins 20 MB 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 à 2 MB, 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 de 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 transfé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 cela 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 espace, 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 du 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 (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épertoires 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”

[[Image:Filezilla.png|center|450px|thumb|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…”

[[Image:attributs.png|center|300px|thumb|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 copié 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 :

[[Image:Config_phpgedview.png|center|450px|thumb|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.

[[Image:Config_phpgedview1.png|center|375px|thumb|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.

[[Image:Liste_gedcom_chargés.png|center|550px|thumb|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.)

[[Image:Configuration_gedcom.png|center|450px|thumb|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.

[[Image:Familletintin.png|center|450px|thumb|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.

[[Image:Import_gedcom.png|center|550px|thumb|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.

[[Image:Dépassement_temps_exécution.png|center|550px|thumb|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.

[[Image:Import_terminé.png|center|250px|thumb|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 sauvegardé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 support 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'image qui 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):

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
| 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:

{| class="wikitable" style="margin: 2em auto 2em auto" table border="1"
<center>pgv_blocks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_dates</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_families</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_favorites</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_individuals</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media_mapping</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_messages</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_names</center>
|-
| 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é
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_news</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_next_id</center>
|-
| ni_id INT(11) ||
|-
| ni_type VARCHAR(30) ||
|-
| ni_gedfile INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_other</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_placelinks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_places</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_remotelinks</center>
|-
| r_gid VARCHAR(255) ||
|-
| r_linkid VARCHAR(255) ||
|-
| r_file INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_sources</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_users</center>
|-
| 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:

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
| 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.

==Sauvegarde==

Note: Si vous voulez utiliser la fonction de sauvegarde de l’utilitaire “Upgrade” de PhpGedView vous devez ou bien modifier les permissions du répertoire "phpgedview" en écriture, ou bien créer un répertoire nommé "sauvegarde" en lui donnant des permissions d’écriture. Les permissions d’écriture pour le répertoire "phpgedview" peuvent être remises en lecture seule aussitôt que le répertoire « sauvegarde » est en place et dispose des permissions d’écriture appropriées.

Avec la fonction de sauvegarde dans le menu d’administration, vous pouvez réaliser une sauvegarde de tous les fichiers importants de PhpGedView. Avec cette fonction de sauvegarde, il est possible de reconstruire votre site PhpGedView à l’état qu’il avait au moment de la sauvegarde.

La sauvegarde peut contenir les fichiers suivants, qui peuvent être choisis sur la page de sauvegarde :
- config.php avec tous les paramètres de configuration de votre installation
- tous les fichiers GEDCOM qui étaient présents dans votre installation
- toutes les options GEDCOM et les paramètres de confidentialité pour les fichiers ci-dessus
- les compteurs et les fichiers de log de PhpGedView
- les définitions et les options de l’utilisateur (définitions des blocs, favoris, messages et nouvelles)

Les fichiers peuvent être regroupés dans un fichier ZIP, qui peut être téléchargé en cliquant sur le lien qui se trouve sur la page.

Note: La base de données elle-même ne sera pas incluse dans la sauvegarde, parcequ’elle peut être reconstituée à partir des fichiers qui ont été sauvegardés.

Note: Toutes les modifications en attente (non approuvées ou sur le point d’être rejetées par l’administrateur) seront présentes dans les fichiers GEDCOM mais ne peuvent plus être identifiées comme des modifications. Si la base de données est reconstituée en utilisant ces fichiers GEDCOMs, ces changements ne peuvent plus être rejetés.

Note: Si vous avez installé votre répertoire index à l’extérieur du répertoire racine de votre serveur web, les références à quelques-uns des fichiers du zip incluront des chemins de répertoires de la forme "../". Quelques utilitaires zip (par exemple la capacité native de zip dans Windows XP de Windows Explorer) ne supporte pas ce type de chemin de fichier. Vous pouvez avoir besoin d’un outil qui supporte ce type de chemins. WinRAR est un de ces outils.

La fonction de sauvegarde utilise la bibliothèque PclZip, qui a été écrite par Vincent Blavet et qui peut être trouvée ici : http://www.phpconcept.net/pclzip.

==Intégration de PostNuke et PHPNuke ==

PhpGedView peut s’intégrer avec PostNuke et phpNuke afin que les utilisateurs n’aient pas besoin de s’identifier deux fois.

Une fois que PhpGedView est lancé, vous devez suivre les instructions du fichier readme.txt file qui se trouve dans le répertoire "pgvnuke".

Les fichiers qui rendent cette intégration possible ont été donnés par Jim Carey.

==Langages==

Note: si vous voulez utiliser les fonctions de langues vous devrez établir des permissions d’écriture pour tous les fichiers qui sont presents dans le repertoire "langages”.

PhpGedView a été construit pour pouvoir supporter de multiples langues. PHP ne supporte pas l’unicode (UTF-16). Il supporte l’UTF-8 et ce format est celui qui est recommandé pour encoder les fichiers GEDCOMs avec PhpGedView. Si vous avez des caractères dans votre fichier GEDCOM qui ne sont pas dans l’alphabet standard ASCII, vous devrez probablement utiliser l’encodage UTF-8. Il y a beaucoup de differences entre les formats UTF-8 et UTF-16, mais tout ce que vous encodez au format UTF-16 peut être encodé au format UTF-8. Il est également très facile de convertir de l’Unicode en UTF-8. Il vous suffit d’ouvrir votre fichier Unicode GEDCOM avec Windows Notepad et de choisir "Fichier->Enregistrer sous.." dans le menu et de choisir UTF-8 comme option d’encodage. Vous ne devriez perdre aucun caractère en effectuant cette traduction de format.

Les discussions et les questions sur les multiples fonctionnalités de langages de PhpGedView, traductions comprises, doivent être postées dans le forum “Translations” qui se trouve sur la page web du projet de PhpGedView ici:
http://sourceforge.net/forum/forum.php?forum_id=294245

Pour traduire PhpGedView dans une autre langue qui n'est pas actuellement supportée vous devez d'abord vous connecter à PhpGedView en tant qu' administrateur et aller ensuite à l'utilitaire d'édition des langues en cliquant sur "Administration-> Ajouter fichiers et paramètres pour une nouvelle langue". Choisissez votre nouvelle langue à partir du menu déroulant et cliquez sur le bouton « ajouter une nouvelle langue ».

Une fenêtre popup apparaît alors vous permettant d'éditer les paramètres par défaut de votre nouvelle langue. Chaque paramètre dispose d'une aide en ligne en cliquant sur le "?". Vous pouvez vouloir examiner les paramètres de quelques-uns des autres langages sur la page de configuration des langues, puis en cliquant sur « éditer », pour voir comment ils sont configurés.

Quand vous avez fini de paramétrer votre nouvelle langue, cliquez sur le bouton “sauvegarde”. Cela créera un nouveau fichier lang_settings.php dans le répertoire index. Vous remarquerez que votre nouvelle langue apparaît maintenant dans la liste des langues supportées.

Créez ensuite une copie des fichiers "configure_help.en.php", "facts.en.php", "help_text.en.php", et "lang.en.php" qui se trouvent dans le répertoire "langages" et changez la partie "en" qui est dans le nom de ces fichiers afin d'y mettre à la place les deux lettres du code correspondant à votre nouvelle langue.

Le fichier "facts" contient toutes les traductions des différentes balises (ou tags) du standard GEDCOM telles que BIRT = Birth. Le fichier "lang" contient toutes les différentes langues utilisées par le site. Les fichiers "configure_help.en.php" et "help_text.en.php" fournissent les instructions de configuration et d'aide.

Vous pouvez traduire ces fichiers en utilisant l'utilitaire d'édition de fichiers de traduction, qui est accessible en cliquant sur “Editer le contenu des fichiers de traduction ». Sélectionnez votre langue à partir de la liste déroulante puis choisissez le fichier que vous voulez éditer et cliquez sur le bouton “Editer”. Votre fichier sera comparé au fichier en anglais afin que vous puissiez facilement traduire les fichiers en ligne.

Vous pouvez aussi traduire des fichiers manuellement en les ouvrant avec un éditeur de texte. Si vous éditez manuellement des fichiers, vous devez les sauvegarder au format UTF-8. Quelques éditeurs de texte tels que Windows Notepad ajoutent un marqueur 3-byte Byte-Order-Mark (BOM) aux fichiers qui sont sauvegardés au format UTF-8. PHP n'aime pas les marqueurs BOM et ils doivent être supprimés avant de tester le fonctionnement de ces fichiers dans PhpGedView. La section des outils de traduction de PhpGedView' a un programme utilitaire pour supprimer ces a BOMs.

Vous devez récupérer un drapeau correspondant à votre langue à partir du fichier http://w3f.com/gifs/index.html er le dimensionner pour qu'il ait la même taille que les drapeaux qui sont dans le répertoire images/flags.

Pour aider au support des langues, un fichier log des modifications de langues existe dans le répertoire langages. Ce fichier log est dénommé LANG_CHANGELOG.txt. Toutes les modifications aux fichiers de langue anglaise sont enregistrés ici.

Si vous effectuez une nouvelle traduction de PhpGedView ou si vous mettez à jour une autre traduction, et que vous voulez en faire profiter la communauté, postez vos fichiers de langues ainsi que votre fichier index/lang_settings.php dans la section Patches section du site web du projet SourceForge ici: http://www.sourceforge.net/projects/phpgedview

==Fichiers d'extension de langues==

Les fichiers d'extension de langues sont des fichiers PHP courants que vous pouvez utiliser pour créer vos propres extensions de langue pour PhpGedView. Pour ajouter un fichier d'extension de langue, créez un nouveau fichier PHP dénommé lang.xx.extra.php en remplaçant le "xx" par le code de la langue que vous voulez ajouter. Ces fichiers ne sont pas inclus automatiquement dans le paquet logiciel PhpGedView afin que lorsque vous les mettez à jour, vos extensions ne soient pas écrasées.

Si ce fichier existe pour la langue que vous avez choisie, c'est la dernière chose qui est chargée avant que l'affichage n'apparaisse. Ces fichiers ont été conçus pour être des extensions des fichiers de langue, mais vous pouvez facilement les utiliser pour faire en sorte que les changements de paramètres soient basés sur la langue choisie.

Quelles sont les différentes actions que l'on peut entreprendre avec ces fichiers d'extension de langues?
- Adapter tout ou partie du texte qui apparaît à l'écran,
- Modifier les options de configuration qui sont basées sur la langue,
- Basculer sur un nouveau GEDCOM quand quelqu'un visualise votre site dans une langue différente.

Les seuls paramètres que vous ne devez pas modifier dans ce fichiers sont les paramètres de confidentialité.

Si, par exemple, vous voulez changer le titre du GEDCOM quand vous changer la langue, vous pouvez changer le titre pour chaque langue en ajoutant la ligne suivante dans votre fichier lang.xx.extra.php:
$GEDCOMS["surname.ged"]["title"] = "Titre en chinois";

Dans ce fichier vous pouvez aussi changer le texte sur les boutons:
$pgv_lang["view"]="Montrer";

Avec ce fichier vous pouvez aussi changer le GEDCOM qui apparaît quand la langue est sélectionnée. Supposons que vous avez un GEDCOM qui était en allemand et un autre qui était en anglais. Dans le fichier lang.de.extra.php vous pouvez ajouter les lignes suivantes:
if ($GEDCOM=="english.ged") {
header("Location: $SCRIPT_NAME?$QUERY_STRING&ged=german.ged");
exit;
}

Ces lignes signifient que si nous utilisons des fichiers en langue allemande, mais que nous utilisons le GEDCOM anglais, alors nous devons recharger la page avec le GEDCOM allemand. Vous devez recharger la page afin que les paramètres de configuration du GEDCOM soient chargés. Cela suppose que vous importé les deux fichiers "english.ged" et "german.ged" dans la base de données et que les fichiers english.ged et german.ged contiennent les mêmes personnes, mais dans des langues différentes.

Ainsi I0001 dans le fichier english.ged doit correspondre au même I0001 dans le fichier german.ged.

=PhpGedView pour les plus avancés d'entre vous=

La plupart d'entre nous utilise des versions stables de PhpGedView, annoncées et disponibles sur les pages principales de http://www.SourceForge.net/PhpGedView.

Mais il y a toujours des développements dans le tuyau. Ces développements peuvent prendre deux formes – les patches (et vous y trouverez des correctifs de temps à autres face à des bugs signalés) et des scripts non certifiés – souvent référencés comme des "subversions" - en raccourci, SVN. Et vous trouverez des références aux "revision control", qui est le même concept.

Les “subversions” SVN sont faites pour quiconque est impliqué dans le développement et le test de logiciels libres (open source). La rubrique SVN est le répertoire dans lequel toutes les subversions actuelles sont stockées. Ce sont les éditeurs/éditeurs de scripts/programmeurs/etc qui travaillent sur les modifications, qui sont autorisés à travailler sur ce répertoire. Puis il y a les utilisateurs/testeurs/ « leading edgers », qui ont téléchargé le logiciel depuis ce répertoire dans leur espace de travail.

Cette description de SVN est très succincte – mais est peut-être suffisante pour que vous y manifestiez un intérêt.

==Gérer les SVN==

Une copie exhaustive de PhpGedView contient environ 3300 fichiers. Pour garder ce nombre de fichiers important à jour avec les copies les plus récentes dans le répertoire SVN, il faut de l'assistance. C'est pourquoi il y a quelques outils qui peuvent examiner les fichiers que vous avez déjà, et qui les comparent avec ceux qui sont dans le répertoire SVN. Si des fichiers dans le répertoire SVN sont plus récents que les vôtres, les copies du répertoire sont automatiquement télé chargées sur votre site.

Un des outils les plus faciles à utiliser est Tortoise. Pour les utilisateurs sous Windows, il vous suffit d'aller à http://tortoisesvn.net/ La page de téléchargements est ici http://tortoisesvn.net/downloads. Toutes les instructions sont disponibles ici.

Tortoise SVN est utilisable avec Windows 2000 et Windows XP. Il n'y a pas de besoin de s'identifier sur le site de
SourceForge pour utiliser cette méthode.

==Utiliser SVN==

Le processus SVN utilise quelques petits fichiers de contrôle qui comparent les données que vous avez dans vos fichiers avec ceux du répertoire SVN. S'il n'existe aucun écart, il n'y a alors pas besoin de mise à jour. S'il existe des écarts, il y a alors besoin d'une mise à jour. I

Ces petits fichiers sont installés dans un répertoire (".svn") sur votre système. Mais les répertoires peuvent représenter un inconvénient quand il vient à occuper tout l'espace d'installation de PhpGedView – et a besoin d'être enlevé de cet espace avant d'être téléchargé sur le serveur.

Plutôt que de fournir ici une longue liste, tapez dans Google '.svn delete' ou 'supprimer subversion' et vous trouverez beaucoup de références pour Linux, Mac et Windows.

[[en:Installation Guide]]

Guide d'installation

2007-08-29T12:30:56Z

Papagolf : /* Préparation du transfert FTP */

=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 sur le site du fournisseur de votre internet.

* Au moins 20 MB 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 à 2 MB, 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 de 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 transfé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 cela 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 espace, 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 du 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 (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épertoires 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”

[[Image:Filezilla.png|center|450px|thumb|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…”

[[Image:attributs.png|center|300px|thumb|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 copié 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 :

[[Image:Config_phpgedview.png|center|450px|thumb|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.

[[Image:Config_phpgedview1.png|center|375px|thumb|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.

[[Image:Liste_gedcom_chargés.png|center|550px|thumb|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.)

[[Image:Configuration_gedcom.png|center|450px|thumb|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.

[[Image:Familletintin.png|center|450px|thumb|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.

[[Image:Import_gedcom.png|center|550px|thumb|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.

[[Image:Dépassement_temps_exécution.png|center|550px|thumb|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.

[[Image:Import_terminé.png|center|250px|thumb|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".

==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 support 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'image qui 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):

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
| 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:

{| class="wikitable" style="margin: 2em auto 2em auto" table border="1"
<center>pgv_blocks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_dates</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_families</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_favorites</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_individuals</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media_mapping</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_messages</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_names</center>
|-
| 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é
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_news</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_next_id</center>
|-
| ni_id INT(11) ||
|-
| ni_type VARCHAR(30) ||
|-
| ni_gedfile INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_other</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_placelinks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_places</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_remotelinks</center>
|-
| r_gid VARCHAR(255) ||
|-
| r_linkid VARCHAR(255) ||
|-
| r_file INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_sources</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_users</center>
|-
| 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:

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
| 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.

==Sauvegarde==

Note: Si vous voulez utiliser la fonction de sauvegarde de l’utilitaire “Upgrade” de PhpGedView vous devez ou bien modifier les permissions du répertoire "phpgedview" en écriture, ou bien créer un répertoire nommé "sauvegarde" en lui donnant des permissions d’écriture. Les permissions d’écriture pour le répertoire "phpgedview" peuvent être remises en lecture seule aussitôt que le répertoire « sauvegarde » est en place et dispose des permissions d’écriture appropriées.

Avec la fonction de sauvegarde dans le menu d’administration, vous pouvez réaliser une sauvegarde de tous les fichiers importants de PhpGedView. Avec cette fonction de sauvegarde, il est possible de reconstruire votre site PhpGedView à l’état qu’il avait au moment de la sauvegarde.

La sauvegarde peut contenir les fichiers suivants, qui peuvent être choisis sur la page de sauvegarde :
- config.php avec tous les paramètres de configuration de votre installation
- tous les fichiers GEDCOM qui étaient présents dans votre installation
- toutes les options GEDCOM et les paramètres de confidentialité pour les fichiers ci-dessus
- les compteurs et les fichiers de log de PhpGedView
- les définitions et les options de l’utilisateur (définitions des blocs, favoris, messages et nouvelles)

Les fichiers peuvent être regroupés dans un fichier ZIP, qui peut être téléchargé en cliquant sur le lien qui se trouve sur la page.

Note: La base de données elle-même ne sera pas incluse dans la sauvegarde, parcequ’elle peut être reconstituée à partir des fichiers qui ont été sauvegardés.

Note: Toutes les modifications en attente (non approuvées ou sur le point d’être rejetées par l’administrateur) seront présentes dans les fichiers GEDCOM mais ne peuvent plus être identifiées comme des modifications. Si la base de données est reconstituée en utilisant ces fichiers GEDCOMs, ces changements ne peuvent plus être rejetés.

Note: Si vous avez installé votre répertoire index à l’extérieur du répertoire racine de votre serveur web, les références à quelques-uns des fichiers du zip incluront des chemins de répertoires de la forme "../". Quelques utilitaires zip (par exemple la capacité native de zip dans Windows XP de Windows Explorer) ne supporte pas ce type de chemin de fichier. Vous pouvez avoir besoin d’un outil qui supporte ce type de chemins. WinRAR est un de ces outils.

La fonction de sauvegarde utilise la bibliothèque PclZip, qui a été écrite par Vincent Blavet et qui peut être trouvée ici : http://www.phpconcept.net/pclzip.

==Intégration de PostNuke et PHPNuke ==

PhpGedView peut s’intégrer avec PostNuke et phpNuke afin que les utilisateurs n’aient pas besoin de s’identifier deux fois.

Une fois que PhpGedView est lancé, vous devez suivre les instructions du fichier readme.txt file qui se trouve dans le répertoire "pgvnuke".

Les fichiers qui rendent cette intégration possible ont été donnés par Jim Carey.

==Langages==

Note: si vous voulez utiliser les fonctions de langues vous devrez établir des permissions d’écriture pour tous les fichiers qui sont presents dans le repertoire "langages”.

PhpGedView a été construit pour pouvoir supporter de multiples langues. PHP ne supporte pas l’unicode (UTF-16). Il supporte l’UTF-8 et ce format est celui qui est recommandé pour encoder les fichiers GEDCOMs avec PhpGedView. Si vous avez des caractères dans votre fichier GEDCOM qui ne sont pas dans l’alphabet standard ASCII, vous devrez probablement utiliser l’encodage UTF-8. Il y a beaucoup de differences entre les formats UTF-8 et UTF-16, mais tout ce que vous encodez au format UTF-16 peut être encodé au format UTF-8. Il est également très facile de convertir de l’Unicode en UTF-8. Il vous suffit d’ouvrir votre fichier Unicode GEDCOM avec Windows Notepad et de choisir "Fichier->Enregistrer sous.." dans le menu et de choisir UTF-8 comme option d’encodage. Vous ne devriez perdre aucun caractère en effectuant cette traduction de format.

Les discussions et les questions sur les multiples fonctionnalités de langages de PhpGedView, traductions comprises, doivent être postées dans le forum “Translations” qui se trouve sur la page web du projet de PhpGedView ici:
http://sourceforge.net/forum/forum.php?forum_id=294245

Pour traduire PhpGedView dans une autre langue qui n'est pas actuellement supportée vous devez d'abord vous connecter à PhpGedView en tant qu' administrateur et aller ensuite à l'utilitaire d'édition des langues en cliquant sur "Administration-> Ajouter fichiers et paramètres pour une nouvelle langue". Choisissez votre nouvelle langue à partir du menu déroulant et cliquez sur le bouton « ajouter une nouvelle langue ».

Une fenêtre popup apparaît alors vous permettant d'éditer les paramètres par défaut de votre nouvelle langue. Chaque paramètre dispose d'une aide en ligne en cliquant sur le "?". Vous pouvez vouloir examiner les paramètres de quelques-uns des autres langages sur la page de configuration des langues, puis en cliquant sur « éditer », pour voir comment ils sont configurés.

Quand vous avez fini de paramétrer votre nouvelle langue, cliquez sur le bouton “sauvegarde”. Cela créera un nouveau fichier lang_settings.php dans le répertoire index. Vous remarquerez que votre nouvelle langue apparaît maintenant dans la liste des langues supportées.

Créez ensuite une copie des fichiers "configure_help.en.php", "facts.en.php", "help_text.en.php", et "lang.en.php" qui se trouvent dans le répertoire "langages" et changez la partie "en" qui est dans le nom de ces fichiers afin d'y mettre à la place les deux lettres du code correspondant à votre nouvelle langue.

Le fichier "facts" contient toutes les traductions des différentes balises (ou tags) du standard GEDCOM telles que BIRT = Birth. Le fichier "lang" contient toutes les différentes langues utilisées par le site. Les fichiers "configure_help.en.php" et "help_text.en.php" fournissent les instructions de configuration et d'aide.

Vous pouvez traduire ces fichiers en utilisant l'utilitaire d'édition de fichiers de traduction, qui est accessible en cliquant sur “Editer le contenu des fichiers de traduction ». Sélectionnez votre langue à partir de la liste déroulante puis choisissez le fichier que vous voulez éditer et cliquez sur le bouton “Editer”. Votre fichier sera comparé au fichier en anglais afin que vous puissiez facilement traduire les fichiers en ligne.

Vous pouvez aussi traduire des fichiers manuellement en les ouvrant avec un éditeur de texte. Si vous éditez manuellement des fichiers, vous devez les sauvegarder au format UTF-8. Quelques éditeurs de texte tels que Windows Notepad ajoutent un marqueur 3-byte Byte-Order-Mark (BOM) aux fichiers qui sont sauvegardés au format UTF-8. PHP n'aime pas les marqueurs BOM et ils doivent être supprimés avant de tester le fonctionnement de ces fichiers dans PhpGedView. La section des outils de traduction de PhpGedView' a un programme utilitaire pour supprimer ces a BOMs.

Vous devez récupérer un drapeau correspondant à votre langue à partir du fichier http://w3f.com/gifs/index.html er le dimensionner pour qu'il ait la même taille que les drapeaux qui sont dans le répertoire images/flags.

Pour aider au support des langues, un fichier log des modifications de langues existe dans le répertoire langages. Ce fichier log est dénommé LANG_CHANGELOG.txt. Toutes les modifications aux fichiers de langue anglaise sont enregistrés ici.

Si vous effectuez une nouvelle traduction de PhpGedView ou si vous mettez à jour une autre traduction, et que vous voulez en faire profiter la communauté, postez vos fichiers de langues ainsi que votre fichier index/lang_settings.php dans la section Patches section du site web du projet SourceForge ici: http://www.sourceforge.net/projects/phpgedview

==Fichiers d'extension de langues==

Les fichiers d'extension de langues sont des fichiers PHP courants que vous pouvez utiliser pour créer vos propres extensions de langue pour PhpGedView. Pour ajouter un fichier d'extension de langue, créez un nouveau fichier PHP dénommé lang.xx.extra.php en remplaçant le "xx" par le code de la langue que vous voulez ajouter. Ces fichiers ne sont pas inclus automatiquement dans le paquet logiciel PhpGedView afin que lorsque vous les mettez à jour, vos extensions ne soient pas écrasées.

Si ce fichier existe pour la langue que vous avez choisie, c'est la dernière chose qui est chargée avant que l'affichage n'apparaisse. Ces fichiers ont été conçus pour être des extensions des fichiers de langue, mais vous pouvez facilement les utiliser pour faire en sorte que les changements de paramètres soient basés sur la langue choisie.

Quelles sont les différentes actions que l'on peut entreprendre avec ces fichiers d'extension de langues?
- Adapter tout ou partie du texte qui apparaît à l'écran,
- Modifier les options de configuration qui sont basées sur la langue,
- Basculer sur un nouveau GEDCOM quand quelqu'un visualise votre site dans une langue différente.

Les seuls paramètres que vous ne devez pas modifier dans ce fichiers sont les paramètres de confidentialité.

Si, par exemple, vous voulez changer le titre du GEDCOM quand vous changer la langue, vous pouvez changer le titre pour chaque langue en ajoutant la ligne suivante dans votre fichier lang.xx.extra.php:
$GEDCOMS["surname.ged"]["title"] = "Titre en chinois";

Dans ce fichier vous pouvez aussi changer le texte sur les boutons:
$pgv_lang["view"]="Montrer";

Avec ce fichier vous pouvez aussi changer le GEDCOM qui apparaît quand la langue est sélectionnée. Supposons que vous avez un GEDCOM qui était en allemand et un autre qui était en anglais. Dans le fichier lang.de.extra.php vous pouvez ajouter les lignes suivantes:
if ($GEDCOM=="english.ged") {
header("Location: $SCRIPT_NAME?$QUERY_STRING&ged=german.ged");
exit;
}

Ces lignes signifient que si nous utilisons des fichiers en langue allemande, mais que nous utilisons le GEDCOM anglais, alors nous devons recharger la page avec le GEDCOM allemand. Vous devez recharger la page afin que les paramètres de configuration du GEDCOM soient chargés. Cela suppose que vous importé les deux fichiers "english.ged" et "german.ged" dans la base de données et que les fichiers english.ged et german.ged contiennent les mêmes personnes, mais dans des langues différentes.

Ainsi I0001 dans le fichier english.ged doit correspondre au même I0001 dans le fichier german.ged.

=PhpGedView pour les plus avancés d'entre vous=

La plupart d'entre nous utilise des versions stables de PhpGedView, annoncées et disponibles sur les pages principales de http://www.SourceForge.net/PhpGedView.

Mais il y a toujours des développements dans le tuyau. Ces développements peuvent prendre deux formes – les patches (et vous y trouverez des correctifs de temps à autres face à des bugs signalés) et des scripts non certifiés – souvent référencés comme des "subversions" - en raccourci, SVN. Et vous trouverez des références aux "revision control", qui est le même concept.

Les “subversions” SVN sont faites pour quiconque est impliqué dans le développement et le test de logiciels libres (open source). La rubrique SVN est le répertoire dans lequel toutes les subversions actuelles sont stockées. Ce sont les éditeurs/éditeurs de scripts/programmeurs/etc qui travaillent sur les modifications, qui sont autorisés à travailler sur ce répertoire. Puis il y a les utilisateurs/testeurs/ « leading edgers », qui ont téléchargé le logiciel depuis ce répertoire dans leur espace de travail.

Cette description de SVN est très succincte – mais est peut-être suffisante pour que vous y manifestiez un intérêt.

==Gérer les SVN==

Une copie exhaustive de PhpGedView contient environ 3300 fichiers. Pour garder ce nombre de fichiers important à jour avec les copies les plus récentes dans le répertoire SVN, il faut de l'assistance. C'est pourquoi il y a quelques outils qui peuvent examiner les fichiers que vous avez déjà, et qui les comparent avec ceux qui sont dans le répertoire SVN. Si des fichiers dans le répertoire SVN sont plus récents que les vôtres, les copies du répertoire sont automatiquement télé chargées sur votre site.

Un des outils les plus faciles à utiliser est Tortoise. Pour les utilisateurs sous Windows, il vous suffit d'aller à http://tortoisesvn.net/ La page de téléchargements est ici http://tortoisesvn.net/downloads. Toutes les instructions sont disponibles ici.

Tortoise SVN est utilisable avec Windows 2000 et Windows XP. Il n'y a pas de besoin de s'identifier sur le site de
SourceForge pour utiliser cette méthode.

==Utiliser SVN==

Le processus SVN utilise quelques petits fichiers de contrôle qui comparent les données que vous avez dans vos fichiers avec ceux du répertoire SVN. S'il n'existe aucun écart, il n'y a alors pas besoin de mise à jour. S'il existe des écarts, il y a alors besoin d'une mise à jour. I

Ces petits fichiers sont installés dans un répertoire (".svn") sur votre système. Mais les répertoires peuvent représenter un inconvénient quand il vient à occuper tout l'espace d'installation de PhpGedView – et a besoin d'être enlevé de cet espace avant d'être téléchargé sur le serveur.

Plutôt que de fournir ici une longue liste, tapez dans Google '.svn delete' ou 'supprimer subversion' et vous trouverez beaucoup de références pour Linux, Mac et Windows.

[[en:Installation Guide]]

Guide d'installation

2007-08-29T09:26:42Z

Papagolf : /* Objets Multimedia */

=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 sur le site du fournisseur de votre internet.

* Au moins 20 MB 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 à 2 MB, 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 de 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 transfé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 cela 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 du 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 (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épertoires 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”

[[Image:Filezilla.png|center|450px|thumb|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…”

[[Image:attributs.png|center|300px|thumb|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 copié 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 :

[[Image:Config_phpgedview.png|center|450px|thumb|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.

[[Image:Config_phpgedview1.png|center|375px|thumb|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.

[[Image:Liste_gedcom_chargés.png|center|550px|thumb|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.)

[[Image:Configuration_gedcom.png|center|450px|thumb|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.

[[Image:Familletintin.png|center|450px|thumb|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.

[[Image:Import_gedcom.png|center|550px|thumb|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.

[[Image:Dépassement_temps_exécution.png|center|550px|thumb|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.

[[Image:Import_terminé.png|center|250px|thumb|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".

==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 support 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'image qui 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):

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
| 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:

{| class="wikitable" style="margin: 2em auto 2em auto" table border="1"
<center>pgv_blocks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_dates</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_families</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_favorites</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_individuals</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media_mapping</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_messages</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_names</center>
|-
| 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é
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_news</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_next_id</center>
|-
| ni_id INT(11) ||
|-
| ni_type VARCHAR(30) ||
|-
| ni_gedfile INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_other</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_placelinks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_places</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_remotelinks</center>
|-
| r_gid VARCHAR(255) ||
|-
| r_linkid VARCHAR(255) ||
|-
| r_file INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_sources</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_users</center>
|-
| 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:

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
| 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.

==Sauvegarde==

Note: Si vous voulez utiliser la fonction de sauvegarde de l’utilitaire “Upgrade” de PhpGedView vous devez ou bien modifier les permissions du répertoire "phpgedview" en écriture, ou bien créer un répertoire nommé "sauvegarde" en lui donnant des permissions d’écriture. Les permissions d’écriture pour le répertoire "phpgedview" peuvent être remises en lecture seule aussitôt que le répertoire « sauvegarde » est en place et dispose des permissions d’écriture appropriées.

Avec la fonction de sauvegarde dans le menu d’administration, vous pouvez réaliser une sauvegarde de tous les fichiers importants de PhpGedView. Avec cette fonction de sauvegarde, il est possible de reconstruire votre site PhpGedView à l’état qu’il avait au moment de la sauvegarde.

La sauvegarde peut contenir les fichiers suivants, qui peuvent être choisis sur la page de sauvegarde :
- config.php avec tous les paramètres de configuration de votre installation
- tous les fichiers GEDCOM qui étaient présents dans votre installation
- toutes les options GEDCOM et les paramètres de confidentialité pour les fichiers ci-dessus
- les compteurs et les fichiers de log de PhpGedView
- les définitions et les options de l’utilisateur (définitions des blocs, favoris, messages et nouvelles)

Les fichiers peuvent être regroupés dans un fichier ZIP, qui peut être téléchargé en cliquant sur le lien qui se trouve sur la page.

Note: La base de données elle-même ne sera pas incluse dans la sauvegarde, parcequ’elle peut être reconstituée à partir des fichiers qui ont été sauvegardés.

Note: Toutes les modifications en attente (non approuvées ou sur le point d’être rejetées par l’administrateur) seront présentes dans les fichiers GEDCOM mais ne peuvent plus être identifiées comme des modifications. Si la base de données est reconstituée en utilisant ces fichiers GEDCOMs, ces changements ne peuvent plus être rejetés.

Note: Si vous avez installé votre répertoire index à l’extérieur du répertoire racine de votre serveur web, les références à quelques-uns des fichiers du zip incluront des chemins de répertoires de la forme "../". Quelques utilitaires zip (par exemple la capacité native de zip dans Windows XP de Windows Explorer) ne supporte pas ce type de chemin de fichier. Vous pouvez avoir besoin d’un outil qui supporte ce type de chemins. WinRAR est un de ces outils.

La fonction de sauvegarde utilise la bibliothèque PclZip, qui a été écrite par Vincent Blavet et qui peut être trouvée ici : http://www.phpconcept.net/pclzip.

==Intégration de PostNuke et PHPNuke ==

PhpGedView peut s’intégrer avec PostNuke et phpNuke afin que les utilisateurs n’aient pas besoin de s’identifier deux fois.

Une fois que PhpGedView est lancé, vous devez suivre les instructions du fichier readme.txt file qui se trouve dans le répertoire "pgvnuke".

Les fichiers qui rendent cette intégration possible ont été donnés par Jim Carey.

==Langages==

Note: si vous voulez utiliser les fonctions de langues vous devrez établir des permissions d’écriture pour tous les fichiers qui sont presents dans le repertoire "langages”.

PhpGedView a été construit pour pouvoir supporter de multiples langues. PHP ne supporte pas l’unicode (UTF-16). Il supporte l’UTF-8 et ce format est celui qui est recommandé pour encoder les fichiers GEDCOMs avec PhpGedView. Si vous avez des caractères dans votre fichier GEDCOM qui ne sont pas dans l’alphabet standard ASCII, vous devrez probablement utiliser l’encodage UTF-8. Il y a beaucoup de differences entre les formats UTF-8 et UTF-16, mais tout ce que vous encodez au format UTF-16 peut être encodé au format UTF-8. Il est également très facile de convertir de l’Unicode en UTF-8. Il vous suffit d’ouvrir votre fichier Unicode GEDCOM avec Windows Notepad et de choisir "Fichier->Enregistrer sous.." dans le menu et de choisir UTF-8 comme option d’encodage. Vous ne devriez perdre aucun caractère en effectuant cette traduction de format.

Les discussions et les questions sur les multiples fonctionnalités de langages de PhpGedView, traductions comprises, doivent être postées dans le forum “Translations” qui se trouve sur la page web du projet de PhpGedView ici:
http://sourceforge.net/forum/forum.php?forum_id=294245

Pour traduire PhpGedView dans une autre langue qui n'est pas actuellement supportée vous devez d'abord vous connecter à PhpGedView en tant qu' administrateur et aller ensuite à l'utilitaire d'édition des langues en cliquant sur "Administration-> Ajouter fichiers et paramètres pour une nouvelle langue". Choisissez votre nouvelle langue à partir du menu déroulant et cliquez sur le bouton « ajouter une nouvelle langue ».

Une fenêtre popup apparaît alors vous permettant d'éditer les paramètres par défaut de votre nouvelle langue. Chaque paramètre dispose d'une aide en ligne en cliquant sur le "?". Vous pouvez vouloir examiner les paramètres de quelques-uns des autres langages sur la page de configuration des langues, puis en cliquant sur « éditer », pour voir comment ils sont configurés.

Quand vous avez fini de paramétrer votre nouvelle langue, cliquez sur le bouton “sauvegarde”. Cela créera un nouveau fichier lang_settings.php dans le répertoire index. Vous remarquerez que votre nouvelle langue apparaît maintenant dans la liste des langues supportées.

Créez ensuite une copie des fichiers "configure_help.en.php", "facts.en.php", "help_text.en.php", et "lang.en.php" qui se trouvent dans le répertoire "langages" et changez la partie "en" qui est dans le nom de ces fichiers afin d'y mettre à la place les deux lettres du code correspondant à votre nouvelle langue.

Le fichier "facts" contient toutes les traductions des différentes balises (ou tags) du standard GEDCOM telles que BIRT = Birth. Le fichier "lang" contient toutes les différentes langues utilisées par le site. Les fichiers "configure_help.en.php" et "help_text.en.php" fournissent les instructions de configuration et d'aide.

Vous pouvez traduire ces fichiers en utilisant l'utilitaire d'édition de fichiers de traduction, qui est accessible en cliquant sur “Editer le contenu des fichiers de traduction ». Sélectionnez votre langue à partir de la liste déroulante puis choisissez le fichier que vous voulez éditer et cliquez sur le bouton “Editer”. Votre fichier sera comparé au fichier en anglais afin que vous puissiez facilement traduire les fichiers en ligne.

Vous pouvez aussi traduire des fichiers manuellement en les ouvrant avec un éditeur de texte. Si vous éditez manuellement des fichiers, vous devez les sauvegarder au format UTF-8. Quelques éditeurs de texte tels que Windows Notepad ajoutent un marqueur 3-byte Byte-Order-Mark (BOM) aux fichiers qui sont sauvegardés au format UTF-8. PHP n'aime pas les marqueurs BOM et ils doivent être supprimés avant de tester le fonctionnement de ces fichiers dans PhpGedView. La section des outils de traduction de PhpGedView' a un programme utilitaire pour supprimer ces a BOMs.

Vous devez récupérer un drapeau correspondant à votre langue à partir du fichier http://w3f.com/gifs/index.html er le dimensionner pour qu'il ait la même taille que les drapeaux qui sont dans le répertoire images/flags.

Pour aider au support des langues, un fichier log des modifications de langues existe dans le répertoire langages. Ce fichier log est dénommé LANG_CHANGELOG.txt. Toutes les modifications aux fichiers de langue anglaise sont enregistrés ici.

Si vous effectuez une nouvelle traduction de PhpGedView ou si vous mettez à jour une autre traduction, et que vous voulez en faire profiter la communauté, postez vos fichiers de langues ainsi que votre fichier index/lang_settings.php dans la section Patches section du site web du projet SourceForge ici: http://www.sourceforge.net/projects/phpgedview

==Fichiers d'extension de langues==

Les fichiers d'extension de langues sont des fichiers PHP courants que vous pouvez utiliser pour créer vos propres extensions de langue pour PhpGedView. Pour ajouter un fichier d'extension de langue, créez un nouveau fichier PHP dénommé lang.xx.extra.php en remplaçant le "xx" par le code de la langue que vous voulez ajouter. Ces fichiers ne sont pas inclus automatiquement dans le paquet logiciel PhpGedView afin que lorsque vous les mettez à jour, vos extensions ne soient pas écrasées.

Si ce fichier existe pour la langue que vous avez choisie, c'est la dernière chose qui est chargée avant que l'affichage n'apparaisse. Ces fichiers ont été conçus pour être des extensions des fichiers de langue, mais vous pouvez facilement les utiliser pour faire en sorte que les changements de paramètres soient basés sur la langue choisie.

Quelles sont les différentes actions que l'on peut entreprendre avec ces fichiers d'extension de langues?
- Adapter tout ou partie du texte qui apparaît à l'écran,
- Modifier les options de configuration qui sont basées sur la langue,
- Basculer sur un nouveau GEDCOM quand quelqu'un visualise votre site dans une langue différente.

Les seuls paramètres que vous ne devez pas modifier dans ce fichiers sont les paramètres de confidentialité.

Si, par exemple, vous voulez changer le titre du GEDCOM quand vous changer la langue, vous pouvez changer le titre pour chaque langue en ajoutant la ligne suivante dans votre fichier lang.xx.extra.php:
$GEDCOMS["surname.ged"]["title"] = "Titre en chinois";

Dans ce fichier vous pouvez aussi changer le texte sur les boutons:
$pgv_lang["view"]="Montrer";

Avec ce fichier vous pouvez aussi changer le GEDCOM qui apparaît quand la langue est sélectionnée. Supposons que vous avez un GEDCOM qui était en allemand et un autre qui était en anglais. Dans le fichier lang.de.extra.php vous pouvez ajouter les lignes suivantes:
if ($GEDCOM=="english.ged") {
header("Location: $SCRIPT_NAME?$QUERY_STRING&ged=german.ged");
exit;
}

Ces lignes signifient que si nous utilisons des fichiers en langue allemande, mais que nous utilisons le GEDCOM anglais, alors nous devons recharger la page avec le GEDCOM allemand. Vous devez recharger la page afin que les paramètres de configuration du GEDCOM soient chargés. Cela suppose que vous importé les deux fichiers "english.ged" et "german.ged" dans la base de données et que les fichiers english.ged et german.ged contiennent les mêmes personnes, mais dans des langues différentes.

Ainsi I0001 dans le fichier english.ged doit correspondre au même I0001 dans le fichier german.ged.

=PhpGedView pour les plus avancés d'entre vous=

La plupart d'entre nous utilise des versions stables de PhpGedView, annoncées et disponibles sur les pages principales de http://www.SourceForge.net/PhpGedView.

Mais il y a toujours des développements dans le tuyau. Ces développements peuvent prendre deux formes – les patches (et vous y trouverez des correctifs de temps à autres face à des bugs signalés) et des scripts non certifiés – souvent référencés comme des "subversions" - en raccourci, SVN. Et vous trouverez des références aux "revision control", qui est le même concept.

Les “subversions” SVN sont faites pour quiconque est impliqué dans le développement et le test de logiciels libres (open source). La rubrique SVN est le répertoire dans lequel toutes les subversions actuelles sont stockées. Ce sont les éditeurs/éditeurs de scripts/programmeurs/etc qui travaillent sur les modifications, qui sont autorisés à travailler sur ce répertoire. Puis il y a les utilisateurs/testeurs/ « leading edgers », qui ont téléchargé le logiciel depuis ce répertoire dans leur espace de travail.

Cette description de SVN est très succincte – mais est peut-être suffisante pour que vous y manifestiez un intérêt.

==Gérer les SVN==

Une copie exhaustive de PhpGedView contient environ 3300 fichiers. Pour garder ce nombre de fichiers important à jour avec les copies les plus récentes dans le répertoire SVN, il faut de l'assistance. C'est pourquoi il y a quelques outils qui peuvent examiner les fichiers que vous avez déjà, et qui les comparent avec ceux qui sont dans le répertoire SVN. Si des fichiers dans le répertoire SVN sont plus récents que les vôtres, les copies du répertoire sont automatiquement télé chargées sur votre site.

Un des outils les plus faciles à utiliser est Tortoise. Pour les utilisateurs sous Windows, il vous suffit d'aller à http://tortoisesvn.net/ La page de téléchargements est ici http://tortoisesvn.net/downloads. Toutes les instructions sont disponibles ici.

Tortoise SVN est utilisable avec Windows 2000 et Windows XP. Il n'y a pas de besoin de s'identifier sur le site de
SourceForge pour utiliser cette méthode.

==Utiliser SVN==

Le processus SVN utilise quelques petits fichiers de contrôle qui comparent les données que vous avez dans vos fichiers avec ceux du répertoire SVN. S'il n'existe aucun écart, il n'y a alors pas besoin de mise à jour. S'il existe des écarts, il y a alors besoin d'une mise à jour. I

Ces petits fichiers sont installés dans un répertoire (".svn") sur votre système. Mais les répertoires peuvent représenter un inconvénient quand il vient à occuper tout l'espace d'installation de PhpGedView – et a besoin d'être enlevé de cet espace avant d'être téléchargé sur le serveur.

Plutôt que de fournir ici une longue liste, tapez dans Google '.svn delete' ou 'supprimer subversion' et vous trouverez beaucoup de références pour Linux, Mac et Windows.

[[en:Installation Guide]]

Guide d'installation

2007-08-29T09:26:35Z

Papagolf : /* Objets Multimedia */

=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 sur le site du fournisseur de votre internet.

* Au moins 20 MB 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 à 2 MB, 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 de 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 transfé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 cela 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 du 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 (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épertoires 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”

[[Image:Filezilla.png|center|450px|thumb|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…”

[[Image:attributs.png|center|300px|thumb|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 copié 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 :

[[Image:Config_phpgedview.png|center|450px|thumb|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.

[[Image:Config_phpgedview1.png|center|375px|thumb|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.

[[Image:Liste_gedcom_chargés.png|center|550px|thumb|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.)

[[Image:Configuration_gedcom.png|center|450px|thumb|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.

[[Image:Familletintin.png|center|450px|thumb|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.

[[Image:Import_gedcom.png|center|550px|thumb|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.

[[Image:Dépassement_temps_exécution.png|center|550px|thumb|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.

[[Image:Import_terminé.png|center|250px|thumb|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".

==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 support 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):

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
| 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:

{| class="wikitable" style="margin: 2em auto 2em auto" table border="1"
<center>pgv_blocks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_dates</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_families</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_favorites</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_individuals</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media_mapping</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_messages</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_names</center>
|-
| 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é
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_news</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_next_id</center>
|-
| ni_id INT(11) ||
|-
| ni_type VARCHAR(30) ||
|-
| ni_gedfile INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_other</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_placelinks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_places</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_remotelinks</center>
|-
| r_gid VARCHAR(255) ||
|-
| r_linkid VARCHAR(255) ||
|-
| r_file INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_sources</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_users</center>
|-
| 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:

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
| 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.

==Sauvegarde==

Note: Si vous voulez utiliser la fonction de sauvegarde de l’utilitaire “Upgrade” de PhpGedView vous devez ou bien modifier les permissions du répertoire "phpgedview" en écriture, ou bien créer un répertoire nommé "sauvegarde" en lui donnant des permissions d’écriture. Les permissions d’écriture pour le répertoire "phpgedview" peuvent être remises en lecture seule aussitôt que le répertoire « sauvegarde » est en place et dispose des permissions d’écriture appropriées.

Avec la fonction de sauvegarde dans le menu d’administration, vous pouvez réaliser une sauvegarde de tous les fichiers importants de PhpGedView. Avec cette fonction de sauvegarde, il est possible de reconstruire votre site PhpGedView à l’état qu’il avait au moment de la sauvegarde.

La sauvegarde peut contenir les fichiers suivants, qui peuvent être choisis sur la page de sauvegarde :
- config.php avec tous les paramètres de configuration de votre installation
- tous les fichiers GEDCOM qui étaient présents dans votre installation
- toutes les options GEDCOM et les paramètres de confidentialité pour les fichiers ci-dessus
- les compteurs et les fichiers de log de PhpGedView
- les définitions et les options de l’utilisateur (définitions des blocs, favoris, messages et nouvelles)

Les fichiers peuvent être regroupés dans un fichier ZIP, qui peut être téléchargé en cliquant sur le lien qui se trouve sur la page.

Note: La base de données elle-même ne sera pas incluse dans la sauvegarde, parcequ’elle peut être reconstituée à partir des fichiers qui ont été sauvegardés.

Note: Toutes les modifications en attente (non approuvées ou sur le point d’être rejetées par l’administrateur) seront présentes dans les fichiers GEDCOM mais ne peuvent plus être identifiées comme des modifications. Si la base de données est reconstituée en utilisant ces fichiers GEDCOMs, ces changements ne peuvent plus être rejetés.

Note: Si vous avez installé votre répertoire index à l’extérieur du répertoire racine de votre serveur web, les références à quelques-uns des fichiers du zip incluront des chemins de répertoires de la forme "../". Quelques utilitaires zip (par exemple la capacité native de zip dans Windows XP de Windows Explorer) ne supporte pas ce type de chemin de fichier. Vous pouvez avoir besoin d’un outil qui supporte ce type de chemins. WinRAR est un de ces outils.

La fonction de sauvegarde utilise la bibliothèque PclZip, qui a été écrite par Vincent Blavet et qui peut être trouvée ici : http://www.phpconcept.net/pclzip.

==Intégration de PostNuke et PHPNuke ==

PhpGedView peut s’intégrer avec PostNuke et phpNuke afin que les utilisateurs n’aient pas besoin de s’identifier deux fois.

Une fois que PhpGedView est lancé, vous devez suivre les instructions du fichier readme.txt file qui se trouve dans le répertoire "pgvnuke".

Les fichiers qui rendent cette intégration possible ont été donnés par Jim Carey.

==Langages==

Note: si vous voulez utiliser les fonctions de langues vous devrez établir des permissions d’écriture pour tous les fichiers qui sont presents dans le repertoire "langages”.

PhpGedView a été construit pour pouvoir supporter de multiples langues. PHP ne supporte pas l’unicode (UTF-16). Il supporte l’UTF-8 et ce format est celui qui est recommandé pour encoder les fichiers GEDCOMs avec PhpGedView. Si vous avez des caractères dans votre fichier GEDCOM qui ne sont pas dans l’alphabet standard ASCII, vous devrez probablement utiliser l’encodage UTF-8. Il y a beaucoup de differences entre les formats UTF-8 et UTF-16, mais tout ce que vous encodez au format UTF-16 peut être encodé au format UTF-8. Il est également très facile de convertir de l’Unicode en UTF-8. Il vous suffit d’ouvrir votre fichier Unicode GEDCOM avec Windows Notepad et de choisir "Fichier->Enregistrer sous.." dans le menu et de choisir UTF-8 comme option d’encodage. Vous ne devriez perdre aucun caractère en effectuant cette traduction de format.

Les discussions et les questions sur les multiples fonctionnalités de langages de PhpGedView, traductions comprises, doivent être postées dans le forum “Translations” qui se trouve sur la page web du projet de PhpGedView ici:
http://sourceforge.net/forum/forum.php?forum_id=294245

Pour traduire PhpGedView dans une autre langue qui n'est pas actuellement supportée vous devez d'abord vous connecter à PhpGedView en tant qu' administrateur et aller ensuite à l'utilitaire d'édition des langues en cliquant sur "Administration-> Ajouter fichiers et paramètres pour une nouvelle langue". Choisissez votre nouvelle langue à partir du menu déroulant et cliquez sur le bouton « ajouter une nouvelle langue ».

Une fenêtre popup apparaît alors vous permettant d'éditer les paramètres par défaut de votre nouvelle langue. Chaque paramètre dispose d'une aide en ligne en cliquant sur le "?". Vous pouvez vouloir examiner les paramètres de quelques-uns des autres langages sur la page de configuration des langues, puis en cliquant sur « éditer », pour voir comment ils sont configurés.

Quand vous avez fini de paramétrer votre nouvelle langue, cliquez sur le bouton “sauvegarde”. Cela créera un nouveau fichier lang_settings.php dans le répertoire index. Vous remarquerez que votre nouvelle langue apparaît maintenant dans la liste des langues supportées.

Créez ensuite une copie des fichiers "configure_help.en.php", "facts.en.php", "help_text.en.php", et "lang.en.php" qui se trouvent dans le répertoire "langages" et changez la partie "en" qui est dans le nom de ces fichiers afin d'y mettre à la place les deux lettres du code correspondant à votre nouvelle langue.

Le fichier "facts" contient toutes les traductions des différentes balises (ou tags) du standard GEDCOM telles que BIRT = Birth. Le fichier "lang" contient toutes les différentes langues utilisées par le site. Les fichiers "configure_help.en.php" et "help_text.en.php" fournissent les instructions de configuration et d'aide.

Vous pouvez traduire ces fichiers en utilisant l'utilitaire d'édition de fichiers de traduction, qui est accessible en cliquant sur “Editer le contenu des fichiers de traduction ». Sélectionnez votre langue à partir de la liste déroulante puis choisissez le fichier que vous voulez éditer et cliquez sur le bouton “Editer”. Votre fichier sera comparé au fichier en anglais afin que vous puissiez facilement traduire les fichiers en ligne.

Vous pouvez aussi traduire des fichiers manuellement en les ouvrant avec un éditeur de texte. Si vous éditez manuellement des fichiers, vous devez les sauvegarder au format UTF-8. Quelques éditeurs de texte tels que Windows Notepad ajoutent un marqueur 3-byte Byte-Order-Mark (BOM) aux fichiers qui sont sauvegardés au format UTF-8. PHP n'aime pas les marqueurs BOM et ils doivent être supprimés avant de tester le fonctionnement de ces fichiers dans PhpGedView. La section des outils de traduction de PhpGedView' a un programme utilitaire pour supprimer ces a BOMs.

Vous devez récupérer un drapeau correspondant à votre langue à partir du fichier http://w3f.com/gifs/index.html er le dimensionner pour qu'il ait la même taille que les drapeaux qui sont dans le répertoire images/flags.

Pour aider au support des langues, un fichier log des modifications de langues existe dans le répertoire langages. Ce fichier log est dénommé LANG_CHANGELOG.txt. Toutes les modifications aux fichiers de langue anglaise sont enregistrés ici.

Si vous effectuez une nouvelle traduction de PhpGedView ou si vous mettez à jour une autre traduction, et que vous voulez en faire profiter la communauté, postez vos fichiers de langues ainsi que votre fichier index/lang_settings.php dans la section Patches section du site web du projet SourceForge ici: http://www.sourceforge.net/projects/phpgedview

==Fichiers d'extension de langues==

Les fichiers d'extension de langues sont des fichiers PHP courants que vous pouvez utiliser pour créer vos propres extensions de langue pour PhpGedView. Pour ajouter un fichier d'extension de langue, créez un nouveau fichier PHP dénommé lang.xx.extra.php en remplaçant le "xx" par le code de la langue que vous voulez ajouter. Ces fichiers ne sont pas inclus automatiquement dans le paquet logiciel PhpGedView afin que lorsque vous les mettez à jour, vos extensions ne soient pas écrasées.

Si ce fichier existe pour la langue que vous avez choisie, c'est la dernière chose qui est chargée avant que l'affichage n'apparaisse. Ces fichiers ont été conçus pour être des extensions des fichiers de langue, mais vous pouvez facilement les utiliser pour faire en sorte que les changements de paramètres soient basés sur la langue choisie.

Quelles sont les différentes actions que l'on peut entreprendre avec ces fichiers d'extension de langues?
- Adapter tout ou partie du texte qui apparaît à l'écran,
- Modifier les options de configuration qui sont basées sur la langue,
- Basculer sur un nouveau GEDCOM quand quelqu'un visualise votre site dans une langue différente.

Les seuls paramètres que vous ne devez pas modifier dans ce fichiers sont les paramètres de confidentialité.

Si, par exemple, vous voulez changer le titre du GEDCOM quand vous changer la langue, vous pouvez changer le titre pour chaque langue en ajoutant la ligne suivante dans votre fichier lang.xx.extra.php:
$GEDCOMS["surname.ged"]["title"] = "Titre en chinois";

Dans ce fichier vous pouvez aussi changer le texte sur les boutons:
$pgv_lang["view"]="Montrer";

Avec ce fichier vous pouvez aussi changer le GEDCOM qui apparaît quand la langue est sélectionnée. Supposons que vous avez un GEDCOM qui était en allemand et un autre qui était en anglais. Dans le fichier lang.de.extra.php vous pouvez ajouter les lignes suivantes:
if ($GEDCOM=="english.ged") {
header("Location: $SCRIPT_NAME?$QUERY_STRING&ged=german.ged");
exit;
}

Ces lignes signifient que si nous utilisons des fichiers en langue allemande, mais que nous utilisons le GEDCOM anglais, alors nous devons recharger la page avec le GEDCOM allemand. Vous devez recharger la page afin que les paramètres de configuration du GEDCOM soient chargés. Cela suppose que vous importé les deux fichiers "english.ged" et "german.ged" dans la base de données et que les fichiers english.ged et german.ged contiennent les mêmes personnes, mais dans des langues différentes.

Ainsi I0001 dans le fichier english.ged doit correspondre au même I0001 dans le fichier german.ged.

=PhpGedView pour les plus avancés d'entre vous=

La plupart d'entre nous utilise des versions stables de PhpGedView, annoncées et disponibles sur les pages principales de http://www.SourceForge.net/PhpGedView.

Mais il y a toujours des développements dans le tuyau. Ces développements peuvent prendre deux formes – les patches (et vous y trouverez des correctifs de temps à autres face à des bugs signalés) et des scripts non certifiés – souvent référencés comme des "subversions" - en raccourci, SVN. Et vous trouverez des références aux "revision control", qui est le même concept.

Les “subversions” SVN sont faites pour quiconque est impliqué dans le développement et le test de logiciels libres (open source). La rubrique SVN est le répertoire dans lequel toutes les subversions actuelles sont stockées. Ce sont les éditeurs/éditeurs de scripts/programmeurs/etc qui travaillent sur les modifications, qui sont autorisés à travailler sur ce répertoire. Puis il y a les utilisateurs/testeurs/ « leading edgers », qui ont téléchargé le logiciel depuis ce répertoire dans leur espace de travail.

Cette description de SVN est très succincte – mais est peut-être suffisante pour que vous y manifestiez un intérêt.

==Gérer les SVN==

Une copie exhaustive de PhpGedView contient environ 3300 fichiers. Pour garder ce nombre de fichiers important à jour avec les copies les plus récentes dans le répertoire SVN, il faut de l'assistance. C'est pourquoi il y a quelques outils qui peuvent examiner les fichiers que vous avez déjà, et qui les comparent avec ceux qui sont dans le répertoire SVN. Si des fichiers dans le répertoire SVN sont plus récents que les vôtres, les copies du répertoire sont automatiquement télé chargées sur votre site.

Un des outils les plus faciles à utiliser est Tortoise. Pour les utilisateurs sous Windows, il vous suffit d'aller à http://tortoisesvn.net/ La page de téléchargements est ici http://tortoisesvn.net/downloads. Toutes les instructions sont disponibles ici.

Tortoise SVN est utilisable avec Windows 2000 et Windows XP. Il n'y a pas de besoin de s'identifier sur le site de
SourceForge pour utiliser cette méthode.

==Utiliser SVN==

Le processus SVN utilise quelques petits fichiers de contrôle qui comparent les données que vous avez dans vos fichiers avec ceux du répertoire SVN. S'il n'existe aucun écart, il n'y a alors pas besoin de mise à jour. S'il existe des écarts, il y a alors besoin d'une mise à jour. I

Ces petits fichiers sont installés dans un répertoire (".svn") sur votre système. Mais les répertoires peuvent représenter un inconvénient quand il vient à occuper tout l'espace d'installation de PhpGedView – et a besoin d'être enlevé de cet espace avant d'être téléchargé sur le serveur.

Plutôt que de fournir ici une longue liste, tapez dans Google '.svn delete' ou 'supprimer subversion' et vous trouverez beaucoup de références pour Linux, Mac et Windows.

[[en:Installation Guide]]

Guide d'installation

2007-08-29T08:32:22Z

Papagolf : /* Transfert du fichier GEDCOM */

=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 sur le site du fournisseur de votre internet.

* Au moins 20 MB 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 à 2 MB, 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 de 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 transfé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 cela 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 du 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 (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épertoires 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”

[[Image:Filezilla.png|center|450px|thumb|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…”

[[Image:attributs.png|center|300px|thumb|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 copié 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 :

[[Image:Config_phpgedview.png|center|450px|thumb|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.

[[Image:Config_phpgedview1.png|center|375px|thumb|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.

[[Image:Liste_gedcom_chargés.png|center|550px|thumb|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.)

[[Image:Configuration_gedcom.png|center|450px|thumb|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.

[[Image:Familletintin.png|center|450px|thumb|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.

[[Image:Import_gedcom.png|center|550px|thumb|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.

[[Image:Dépassement_temps_exécution.png|center|550px|thumb|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.

[[Image:Import_terminé.png|center|250px|thumb|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".

==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):

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
| 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:

{| class="wikitable" style="margin: 2em auto 2em auto" table border="1"
<center>pgv_blocks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_dates</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_families</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_favorites</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_individuals</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media_mapping</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_messages</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_names</center>
|-
| 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é
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_news</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_next_id</center>
|-
| ni_id INT(11) ||
|-
| ni_type VARCHAR(30) ||
|-
| ni_gedfile INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_other</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_placelinks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_places</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_remotelinks</center>
|-
| r_gid VARCHAR(255) ||
|-
| r_linkid VARCHAR(255) ||
|-
| r_file INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_sources</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_users</center>
|-
| 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:

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
| 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.

==Sauvegarde==

Note: Si vous voulez utiliser la fonction de sauvegarde de l’utilitaire “Upgrade” de PhpGedView vous devez ou bien modifier les permissions du répertoire "phpgedview" en écriture, ou bien créer un répertoire nommé "sauvegarde" en lui donnant des permissions d’écriture. Les permissions d’écriture pour le répertoire "phpgedview" peuvent être remises en lecture seule aussitôt que le répertoire « sauvegarde » est en place et dispose des permissions d’écriture appropriées.

Avec la fonction de sauvegarde dans le menu d’administration, vous pouvez réaliser une sauvegarde de tous les fichiers importants de PhpGedView. Avec cette fonction de sauvegarde, il est possible de reconstruire votre site PhpGedView à l’état qu’il avait au moment de la sauvegarde.

La sauvegarde peut contenir les fichiers suivants, qui peuvent être choisis sur la page de sauvegarde :
- config.php avec tous les paramètres de configuration de votre installation
- tous les fichiers GEDCOM qui étaient présents dans votre installation
- toutes les options GEDCOM et les paramètres de confidentialité pour les fichiers ci-dessus
- les compteurs et les fichiers de log de PhpGedView
- les définitions et les options de l’utilisateur (définitions des blocs, favoris, messages et nouvelles)

Les fichiers peuvent être regroupés dans un fichier ZIP, qui peut être téléchargé en cliquant sur le lien qui se trouve sur la page.

Note: La base de données elle-même ne sera pas incluse dans la sauvegarde, parcequ’elle peut être reconstituée à partir des fichiers qui ont été sauvegardés.

Note: Toutes les modifications en attente (non approuvées ou sur le point d’être rejetées par l’administrateur) seront présentes dans les fichiers GEDCOM mais ne peuvent plus être identifiées comme des modifications. Si la base de données est reconstituée en utilisant ces fichiers GEDCOMs, ces changements ne peuvent plus être rejetés.

Note: Si vous avez installé votre répertoire index à l’extérieur du répertoire racine de votre serveur web, les références à quelques-uns des fichiers du zip incluront des chemins de répertoires de la forme "../". Quelques utilitaires zip (par exemple la capacité native de zip dans Windows XP de Windows Explorer) ne supporte pas ce type de chemin de fichier. Vous pouvez avoir besoin d’un outil qui supporte ce type de chemins. WinRAR est un de ces outils.

La fonction de sauvegarde utilise la bibliothèque PclZip, qui a été écrite par Vincent Blavet et qui peut être trouvée ici : http://www.phpconcept.net/pclzip.

==Intégration de PostNuke et PHPNuke ==

PhpGedView peut s’intégrer avec PostNuke et phpNuke afin que les utilisateurs n’aient pas besoin de s’identifier deux fois.

Une fois que PhpGedView est lancé, vous devez suivre les instructions du fichier readme.txt file qui se trouve dans le répertoire "pgvnuke".

Les fichiers qui rendent cette intégration possible ont été donnés par Jim Carey.

==Langages==

Note: si vous voulez utiliser les fonctions de langues vous devrez établir des permissions d’écriture pour tous les fichiers qui sont presents dans le repertoire "langages”.

PhpGedView a été construit pour pouvoir supporter de multiples langues. PHP ne supporte pas l’unicode (UTF-16). Il supporte l’UTF-8 et ce format est celui qui est recommandé pour encoder les fichiers GEDCOMs avec PhpGedView. Si vous avez des caractères dans votre fichier GEDCOM qui ne sont pas dans l’alphabet standard ASCII, vous devrez probablement utiliser l’encodage UTF-8. Il y a beaucoup de differences entre les formats UTF-8 et UTF-16, mais tout ce que vous encodez au format UTF-16 peut être encodé au format UTF-8. Il est également très facile de convertir de l’Unicode en UTF-8. Il vous suffit d’ouvrir votre fichier Unicode GEDCOM avec Windows Notepad et de choisir "Fichier->Enregistrer sous.." dans le menu et de choisir UTF-8 comme option d’encodage. Vous ne devriez perdre aucun caractère en effectuant cette traduction de format.

Les discussions et les questions sur les multiples fonctionnalités de langages de PhpGedView, traductions comprises, doivent être postées dans le forum “Translations” qui se trouve sur la page web du projet de PhpGedView ici:
http://sourceforge.net/forum/forum.php?forum_id=294245

Pour traduire PhpGedView dans une autre langue qui n'est pas actuellement supportée vous devez d'abord vous connecter à PhpGedView en tant qu' administrateur et aller ensuite à l'utilitaire d'édition des langues en cliquant sur "Administration-> Ajouter fichiers et paramètres pour une nouvelle langue". Choisissez votre nouvelle langue à partir du menu déroulant et cliquez sur le bouton « ajouter une nouvelle langue ».

Une fenêtre popup apparaît alors vous permettant d'éditer les paramètres par défaut de votre nouvelle langue. Chaque paramètre dispose d'une aide en ligne en cliquant sur le "?". Vous pouvez vouloir examiner les paramètres de quelques-uns des autres langages sur la page de configuration des langues, puis en cliquant sur « éditer », pour voir comment ils sont configurés.

Quand vous avez fini de paramétrer votre nouvelle langue, cliquez sur le bouton “sauvegarde”. Cela créera un nouveau fichier lang_settings.php dans le répertoire index. Vous remarquerez que votre nouvelle langue apparaît maintenant dans la liste des langues supportées.

Créez ensuite une copie des fichiers "configure_help.en.php", "facts.en.php", "help_text.en.php", et "lang.en.php" qui se trouvent dans le répertoire "langages" et changez la partie "en" qui est dans le nom de ces fichiers afin d'y mettre à la place les deux lettres du code correspondant à votre nouvelle langue.

Le fichier "facts" contient toutes les traductions des différentes balises (ou tags) du standard GEDCOM telles que BIRT = Birth. Le fichier "lang" contient toutes les différentes langues utilisées par le site. Les fichiers "configure_help.en.php" et "help_text.en.php" fournissent les instructions de configuration et d'aide.

Vous pouvez traduire ces fichiers en utilisant l'utilitaire d'édition de fichiers de traduction, qui est accessible en cliquant sur “Editer le contenu des fichiers de traduction ». Sélectionnez votre langue à partir de la liste déroulante puis choisissez le fichier que vous voulez éditer et cliquez sur le bouton “Editer”. Votre fichier sera comparé au fichier en anglais afin que vous puissiez facilement traduire les fichiers en ligne.

Vous pouvez aussi traduire des fichiers manuellement en les ouvrant avec un éditeur de texte. Si vous éditez manuellement des fichiers, vous devez les sauvegarder au format UTF-8. Quelques éditeurs de texte tels que Windows Notepad ajoutent un marqueur 3-byte Byte-Order-Mark (BOM) aux fichiers qui sont sauvegardés au format UTF-8. PHP n'aime pas les marqueurs BOM et ils doivent être supprimés avant de tester le fonctionnement de ces fichiers dans PhpGedView. La section des outils de traduction de PhpGedView' a un programme utilitaire pour supprimer ces a BOMs.

Vous devez récupérer un drapeau correspondant à votre langue à partir du fichier http://w3f.com/gifs/index.html er le dimensionner pour qu'il ait la même taille que les drapeaux qui sont dans le répertoire images/flags.

Pour aider au support des langues, un fichier log des modifications de langues existe dans le répertoire langages. Ce fichier log est dénommé LANG_CHANGELOG.txt. Toutes les modifications aux fichiers de langue anglaise sont enregistrés ici.

Si vous effectuez une nouvelle traduction de PhpGedView ou si vous mettez à jour une autre traduction, et que vous voulez en faire profiter la communauté, postez vos fichiers de langues ainsi que votre fichier index/lang_settings.php dans la section Patches section du site web du projet SourceForge ici: http://www.sourceforge.net/projects/phpgedview

==Fichiers d'extension de langues==

Les fichiers d'extension de langues sont des fichiers PHP courants que vous pouvez utiliser pour créer vos propres extensions de langue pour PhpGedView. Pour ajouter un fichier d'extension de langue, créez un nouveau fichier PHP dénommé lang.xx.extra.php en remplaçant le "xx" par le code de la langue que vous voulez ajouter. Ces fichiers ne sont pas inclus automatiquement dans le paquet logiciel PhpGedView afin que lorsque vous les mettez à jour, vos extensions ne soient pas écrasées.

Si ce fichier existe pour la langue que vous avez choisie, c'est la dernière chose qui est chargée avant que l'affichage n'apparaisse. Ces fichiers ont été conçus pour être des extensions des fichiers de langue, mais vous pouvez facilement les utiliser pour faire en sorte que les changements de paramètres soient basés sur la langue choisie.

Quelles sont les différentes actions que l'on peut entreprendre avec ces fichiers d'extension de langues?
- Adapter tout ou partie du texte qui apparaît à l'écran,
- Modifier les options de configuration qui sont basées sur la langue,
- Basculer sur un nouveau GEDCOM quand quelqu'un visualise votre site dans une langue différente.

Les seuls paramètres que vous ne devez pas modifier dans ce fichiers sont les paramètres de confidentialité.

Si, par exemple, vous voulez changer le titre du GEDCOM quand vous changer la langue, vous pouvez changer le titre pour chaque langue en ajoutant la ligne suivante dans votre fichier lang.xx.extra.php:
$GEDCOMS["surname.ged"]["title"] = "Titre en chinois";

Dans ce fichier vous pouvez aussi changer le texte sur les boutons:
$pgv_lang["view"]="Montrer";

Avec ce fichier vous pouvez aussi changer le GEDCOM qui apparaît quand la langue est sélectionnée. Supposons que vous avez un GEDCOM qui était en allemand et un autre qui était en anglais. Dans le fichier lang.de.extra.php vous pouvez ajouter les lignes suivantes:
if ($GEDCOM=="english.ged") {
header("Location: $SCRIPT_NAME?$QUERY_STRING&ged=german.ged");
exit;
}

Ces lignes signifient que si nous utilisons des fichiers en langue allemande, mais que nous utilisons le GEDCOM anglais, alors nous devons recharger la page avec le GEDCOM allemand. Vous devez recharger la page afin que les paramètres de configuration du GEDCOM soient chargés. Cela suppose que vous importé les deux fichiers "english.ged" et "german.ged" dans la base de données et que les fichiers english.ged et german.ged contiennent les mêmes personnes, mais dans des langues différentes.

Ainsi I0001 dans le fichier english.ged doit correspondre au même I0001 dans le fichier german.ged.

=PhpGedView pour les plus avancés d'entre vous=

La plupart d'entre nous utilise des versions stables de PhpGedView, annoncées et disponibles sur les pages principales de http://www.SourceForge.net/PhpGedView.

Mais il y a toujours des développements dans le tuyau. Ces développements peuvent prendre deux formes – les patches (et vous y trouverez des correctifs de temps à autres face à des bugs signalés) et des scripts non certifiés – souvent référencés comme des "subversions" - en raccourci, SVN. Et vous trouverez des références aux "revision control", qui est le même concept.

Les “subversions” SVN sont faites pour quiconque est impliqué dans le développement et le test de logiciels libres (open source). La rubrique SVN est le répertoire dans lequel toutes les subversions actuelles sont stockées. Ce sont les éditeurs/éditeurs de scripts/programmeurs/etc qui travaillent sur les modifications, qui sont autorisés à travailler sur ce répertoire. Puis il y a les utilisateurs/testeurs/ « leading edgers », qui ont téléchargé le logiciel depuis ce répertoire dans leur espace de travail.

Cette description de SVN est très succincte – mais est peut-être suffisante pour que vous y manifestiez un intérêt.

==Gérer les SVN==

Une copie exhaustive de PhpGedView contient environ 3300 fichiers. Pour garder ce nombre de fichiers important à jour avec les copies les plus récentes dans le répertoire SVN, il faut de l'assistance. C'est pourquoi il y a quelques outils qui peuvent examiner les fichiers que vous avez déjà, et qui les comparent avec ceux qui sont dans le répertoire SVN. Si des fichiers dans le répertoire SVN sont plus récents que les vôtres, les copies du répertoire sont automatiquement télé chargées sur votre site.

Un des outils les plus faciles à utiliser est Tortoise. Pour les utilisateurs sous Windows, il vous suffit d'aller à http://tortoisesvn.net/ La page de téléchargements est ici http://tortoisesvn.net/downloads. Toutes les instructions sont disponibles ici.

Tortoise SVN est utilisable avec Windows 2000 et Windows XP. Il n'y a pas de besoin de s'identifier sur le site de
SourceForge pour utiliser cette méthode.

==Utiliser SVN==

Le processus SVN utilise quelques petits fichiers de contrôle qui comparent les données que vous avez dans vos fichiers avec ceux du répertoire SVN. S'il n'existe aucun écart, il n'y a alors pas besoin de mise à jour. S'il existe des écarts, il y a alors besoin d'une mise à jour. I

Ces petits fichiers sont installés dans un répertoire (".svn") sur votre système. Mais les répertoires peuvent représenter un inconvénient quand il vient à occuper tout l'espace d'installation de PhpGedView – et a besoin d'être enlevé de cet espace avant d'être téléchargé sur le serveur.

Plutôt que de fournir ici une longue liste, tapez dans Google '.svn delete' ou 'supprimer subversion' et vous trouverez beaucoup de références pour Linux, Mac et Windows.

[[en:Installation Guide]]

Guide d'installation

2007-08-29T07:54:00Z

Papagolf : /* Installation de PhpGedView */

=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 sur le site du fournisseur de votre internet.

* Au moins 20 MB 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 à 2 MB, 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 de 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 transfé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 cela 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 du 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 (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épertoires 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”

[[Image:Filezilla.png|center|450px|thumb|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…”

[[Image:attributs.png|center|300px|thumb|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 :

[[Image:Config_phpgedview.png|center|450px|thumb|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.

[[Image:Config_phpgedview1.png|center|375px|thumb|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.

[[Image:Liste_gedcom_chargés.png|center|550px|thumb|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.)

[[Image:Configuration_gedcom.png|center|450px|thumb|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.

[[Image:Familletintin.png|center|450px|thumb|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.

[[Image:Import_gedcom.png|center|550px|thumb|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.

[[Image:Dépassement_temps_exécution.png|center|550px|thumb|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.

[[Image:Import_terminé.png|center|250px|thumb|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".

==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):

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
| 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:

{| class="wikitable" style="margin: 2em auto 2em auto" table border="1"
<center>pgv_blocks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_dates</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_families</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_favorites</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_individuals</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media_mapping</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_messages</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_names</center>
|-
| 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é
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_news</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_next_id</center>
|-
| ni_id INT(11) ||
|-
| ni_type VARCHAR(30) ||
|-
| ni_gedfile INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_other</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_placelinks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_places</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_remotelinks</center>
|-
| r_gid VARCHAR(255) ||
|-
| r_linkid VARCHAR(255) ||
|-
| r_file INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_sources</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_users</center>
|-
| 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:

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
| 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.

==Sauvegarde==

Note: Si vous voulez utiliser la fonction de sauvegarde de l’utilitaire “Upgrade” de PhpGedView vous devez ou bien modifier les permissions du répertoire "phpgedview" en écriture, ou bien créer un répertoire nommé "sauvegarde" en lui donnant des permissions d’écriture. Les permissions d’écriture pour le répertoire "phpgedview" peuvent être remises en lecture seule aussitôt que le répertoire « sauvegarde » est en place et dispose des permissions d’écriture appropriées.

Avec la fonction de sauvegarde dans le menu d’administration, vous pouvez réaliser une sauvegarde de tous les fichiers importants de PhpGedView. Avec cette fonction de sauvegarde, il est possible de reconstruire votre site PhpGedView à l’état qu’il avait au moment de la sauvegarde.

La sauvegarde peut contenir les fichiers suivants, qui peuvent être choisis sur la page de sauvegarde :
- config.php avec tous les paramètres de configuration de votre installation
- tous les fichiers GEDCOM qui étaient présents dans votre installation
- toutes les options GEDCOM et les paramètres de confidentialité pour les fichiers ci-dessus
- les compteurs et les fichiers de log de PhpGedView
- les définitions et les options de l’utilisateur (définitions des blocs, favoris, messages et nouvelles)

Les fichiers peuvent être regroupés dans un fichier ZIP, qui peut être téléchargé en cliquant sur le lien qui se trouve sur la page.

Note: La base de données elle-même ne sera pas incluse dans la sauvegarde, parcequ’elle peut être reconstituée à partir des fichiers qui ont été sauvegardés.

Note: Toutes les modifications en attente (non approuvées ou sur le point d’être rejetées par l’administrateur) seront présentes dans les fichiers GEDCOM mais ne peuvent plus être identifiées comme des modifications. Si la base de données est reconstituée en utilisant ces fichiers GEDCOMs, ces changements ne peuvent plus être rejetés.

Note: Si vous avez installé votre répertoire index à l’extérieur du répertoire racine de votre serveur web, les références à quelques-uns des fichiers du zip incluront des chemins de répertoires de la forme "../". Quelques utilitaires zip (par exemple la capacité native de zip dans Windows XP de Windows Explorer) ne supporte pas ce type de chemin de fichier. Vous pouvez avoir besoin d’un outil qui supporte ce type de chemins. WinRAR est un de ces outils.

La fonction de sauvegarde utilise la bibliothèque PclZip, qui a été écrite par Vincent Blavet et qui peut être trouvée ici : http://www.phpconcept.net/pclzip.

==Intégration de PostNuke et PHPNuke ==

PhpGedView peut s’intégrer avec PostNuke et phpNuke afin que les utilisateurs n’aient pas besoin de s’identifier deux fois.

Une fois que PhpGedView est lancé, vous devez suivre les instructions du fichier readme.txt file qui se trouve dans le répertoire "pgvnuke".

Les fichiers qui rendent cette intégration possible ont été donnés par Jim Carey.

==Langages==

Note: si vous voulez utiliser les fonctions de langues vous devrez établir des permissions d’écriture pour tous les fichiers qui sont presents dans le repertoire "langages”.

PhpGedView a été construit pour pouvoir supporter de multiples langues. PHP ne supporte pas l’unicode (UTF-16). Il supporte l’UTF-8 et ce format est celui qui est recommandé pour encoder les fichiers GEDCOMs avec PhpGedView. Si vous avez des caractères dans votre fichier GEDCOM qui ne sont pas dans l’alphabet standard ASCII, vous devrez probablement utiliser l’encodage UTF-8. Il y a beaucoup de differences entre les formats UTF-8 et UTF-16, mais tout ce que vous encodez au format UTF-16 peut être encodé au format UTF-8. Il est également très facile de convertir de l’Unicode en UTF-8. Il vous suffit d’ouvrir votre fichier Unicode GEDCOM avec Windows Notepad et de choisir "Fichier->Enregistrer sous.." dans le menu et de choisir UTF-8 comme option d’encodage. Vous ne devriez perdre aucun caractère en effectuant cette traduction de format.

Les discussions et les questions sur les multiples fonctionnalités de langages de PhpGedView, traductions comprises, doivent être postées dans le forum “Translations” qui se trouve sur la page web du projet de PhpGedView ici:
http://sourceforge.net/forum/forum.php?forum_id=294245

Pour traduire PhpGedView dans une autre langue qui n'est pas actuellement supportée vous devez d'abord vous connecter à PhpGedView en tant qu' administrateur et aller ensuite à l'utilitaire d'édition des langues en cliquant sur "Administration-> Ajouter fichiers et paramètres pour une nouvelle langue". Choisissez votre nouvelle langue à partir du menu déroulant et cliquez sur le bouton « ajouter une nouvelle langue ».

Une fenêtre popup apparaît alors vous permettant d'éditer les paramètres par défaut de votre nouvelle langue. Chaque paramètre dispose d'une aide en ligne en cliquant sur le "?". Vous pouvez vouloir examiner les paramètres de quelques-uns des autres langages sur la page de configuration des langues, puis en cliquant sur « éditer », pour voir comment ils sont configurés.

Quand vous avez fini de paramétrer votre nouvelle langue, cliquez sur le bouton “sauvegarde”. Cela créera un nouveau fichier lang_settings.php dans le répertoire index. Vous remarquerez que votre nouvelle langue apparaît maintenant dans la liste des langues supportées.

Créez ensuite une copie des fichiers "configure_help.en.php", "facts.en.php", "help_text.en.php", et "lang.en.php" qui se trouvent dans le répertoire "langages" et changez la partie "en" qui est dans le nom de ces fichiers afin d'y mettre à la place les deux lettres du code correspondant à votre nouvelle langue.

Le fichier "facts" contient toutes les traductions des différentes balises (ou tags) du standard GEDCOM telles que BIRT = Birth. Le fichier "lang" contient toutes les différentes langues utilisées par le site. Les fichiers "configure_help.en.php" et "help_text.en.php" fournissent les instructions de configuration et d'aide.

Vous pouvez traduire ces fichiers en utilisant l'utilitaire d'édition de fichiers de traduction, qui est accessible en cliquant sur “Editer le contenu des fichiers de traduction ». Sélectionnez votre langue à partir de la liste déroulante puis choisissez le fichier que vous voulez éditer et cliquez sur le bouton “Editer”. Votre fichier sera comparé au fichier en anglais afin que vous puissiez facilement traduire les fichiers en ligne.

Vous pouvez aussi traduire des fichiers manuellement en les ouvrant avec un éditeur de texte. Si vous éditez manuellement des fichiers, vous devez les sauvegarder au format UTF-8. Quelques éditeurs de texte tels que Windows Notepad ajoutent un marqueur 3-byte Byte-Order-Mark (BOM) aux fichiers qui sont sauvegardés au format UTF-8. PHP n'aime pas les marqueurs BOM et ils doivent être supprimés avant de tester le fonctionnement de ces fichiers dans PhpGedView. La section des outils de traduction de PhpGedView' a un programme utilitaire pour supprimer ces a BOMs.

Vous devez récupérer un drapeau correspondant à votre langue à partir du fichier http://w3f.com/gifs/index.html er le dimensionner pour qu'il ait la même taille que les drapeaux qui sont dans le répertoire images/flags.

Pour aider au support des langues, un fichier log des modifications de langues existe dans le répertoire langages. Ce fichier log est dénommé LANG_CHANGELOG.txt. Toutes les modifications aux fichiers de langue anglaise sont enregistrés ici.

Si vous effectuez une nouvelle traduction de PhpGedView ou si vous mettez à jour une autre traduction, et que vous voulez en faire profiter la communauté, postez vos fichiers de langues ainsi que votre fichier index/lang_settings.php dans la section Patches section du site web du projet SourceForge ici: http://www.sourceforge.net/projects/phpgedview

==Fichiers d'extension de langues==

Les fichiers d'extension de langues sont des fichiers PHP courants que vous pouvez utiliser pour créer vos propres extensions de langue pour PhpGedView. Pour ajouter un fichier d'extension de langue, créez un nouveau fichier PHP dénommé lang.xx.extra.php en remplaçant le "xx" par le code de la langue que vous voulez ajouter. Ces fichiers ne sont pas inclus automatiquement dans le paquet logiciel PhpGedView afin que lorsque vous les mettez à jour, vos extensions ne soient pas écrasées.

Si ce fichier existe pour la langue que vous avez choisie, c'est la dernière chose qui est chargée avant que l'affichage n'apparaisse. Ces fichiers ont été conçus pour être des extensions des fichiers de langue, mais vous pouvez facilement les utiliser pour faire en sorte que les changements de paramètres soient basés sur la langue choisie.

Quelles sont les différentes actions que l'on peut entreprendre avec ces fichiers d'extension de langues?
- Adapter tout ou partie du texte qui apparaît à l'écran,
- Modifier les options de configuration qui sont basées sur la langue,
- Basculer sur un nouveau GEDCOM quand quelqu'un visualise votre site dans une langue différente.

Les seuls paramètres que vous ne devez pas modifier dans ce fichiers sont les paramètres de confidentialité.

Si, par exemple, vous voulez changer le titre du GEDCOM quand vous changer la langue, vous pouvez changer le titre pour chaque langue en ajoutant la ligne suivante dans votre fichier lang.xx.extra.php:
$GEDCOMS["surname.ged"]["title"] = "Titre en chinois";

Dans ce fichier vous pouvez aussi changer le texte sur les boutons:
$pgv_lang["view"]="Montrer";

Avec ce fichier vous pouvez aussi changer le GEDCOM qui apparaît quand la langue est sélectionnée. Supposons que vous avez un GEDCOM qui était en allemand et un autre qui était en anglais. Dans le fichier lang.de.extra.php vous pouvez ajouter les lignes suivantes:
if ($GEDCOM=="english.ged") {
header("Location: $SCRIPT_NAME?$QUERY_STRING&ged=german.ged");
exit;
}

Ces lignes signifient que si nous utilisons des fichiers en langue allemande, mais que nous utilisons le GEDCOM anglais, alors nous devons recharger la page avec le GEDCOM allemand. Vous devez recharger la page afin que les paramètres de configuration du GEDCOM soient chargés. Cela suppose que vous importé les deux fichiers "english.ged" et "german.ged" dans la base de données et que les fichiers english.ged et german.ged contiennent les mêmes personnes, mais dans des langues différentes.

Ainsi I0001 dans le fichier english.ged doit correspondre au même I0001 dans le fichier german.ged.

=PhpGedView pour les plus avancés d'entre vous=

La plupart d'entre nous utilise des versions stables de PhpGedView, annoncées et disponibles sur les pages principales de http://www.SourceForge.net/PhpGedView.

Mais il y a toujours des développements dans le tuyau. Ces développements peuvent prendre deux formes – les patches (et vous y trouverez des correctifs de temps à autres face à des bugs signalés) et des scripts non certifiés – souvent référencés comme des "subversions" - en raccourci, SVN. Et vous trouverez des références aux "revision control", qui est le même concept.

Les “subversions” SVN sont faites pour quiconque est impliqué dans le développement et le test de logiciels libres (open source). La rubrique SVN est le répertoire dans lequel toutes les subversions actuelles sont stockées. Ce sont les éditeurs/éditeurs de scripts/programmeurs/etc qui travaillent sur les modifications, qui sont autorisés à travailler sur ce répertoire. Puis il y a les utilisateurs/testeurs/ « leading edgers », qui ont téléchargé le logiciel depuis ce répertoire dans leur espace de travail.

Cette description de SVN est très succincte – mais est peut-être suffisante pour que vous y manifestiez un intérêt.

==Gérer les SVN==

Une copie exhaustive de PhpGedView contient environ 3300 fichiers. Pour garder ce nombre de fichiers important à jour avec les copies les plus récentes dans le répertoire SVN, il faut de l'assistance. C'est pourquoi il y a quelques outils qui peuvent examiner les fichiers que vous avez déjà, et qui les comparent avec ceux qui sont dans le répertoire SVN. Si des fichiers dans le répertoire SVN sont plus récents que les vôtres, les copies du répertoire sont automatiquement télé chargées sur votre site.

Un des outils les plus faciles à utiliser est Tortoise. Pour les utilisateurs sous Windows, il vous suffit d'aller à http://tortoisesvn.net/ La page de téléchargements est ici http://tortoisesvn.net/downloads. Toutes les instructions sont disponibles ici.

Tortoise SVN est utilisable avec Windows 2000 et Windows XP. Il n'y a pas de besoin de s'identifier sur le site de
SourceForge pour utiliser cette méthode.

==Utiliser SVN==

Le processus SVN utilise quelques petits fichiers de contrôle qui comparent les données que vous avez dans vos fichiers avec ceux du répertoire SVN. S'il n'existe aucun écart, il n'y a alors pas besoin de mise à jour. S'il existe des écarts, il y a alors besoin d'une mise à jour. I

Ces petits fichiers sont installés dans un répertoire (".svn") sur votre système. Mais les répertoires peuvent représenter un inconvénient quand il vient à occuper tout l'espace d'installation de PhpGedView – et a besoin d'être enlevé de cet espace avant d'être téléchargé sur le serveur.

Plutôt que de fournir ici une longue liste, tapez dans Google '.svn delete' ou 'supprimer subversion' et vous trouverez beaucoup de références pour Linux, Mac et Windows.

[[en:Installation Guide]]

Guide d'installation

2007-08-29T07:42:23Z

Papagolf : /* Préparation de PhpGedView */

=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 sur le site du fournisseur de votre internet.

* Au moins 20 MB 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 à 2 MB, 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 de 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 transfé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 cela 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 du 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 (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”

[[Image:Filezilla.png|center|450px|thumb|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…”

[[Image:attributs.png|center|300px|thumb|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 :

[[Image:Config_phpgedview.png|center|450px|thumb|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.

[[Image:Config_phpgedview1.png|center|375px|thumb|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.

[[Image:Liste_gedcom_chargés.png|center|550px|thumb|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.)

[[Image:Configuration_gedcom.png|center|450px|thumb|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.

[[Image:Familletintin.png|center|450px|thumb|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.

[[Image:Import_gedcom.png|center|550px|thumb|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.

[[Image:Dépassement_temps_exécution.png|center|550px|thumb|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.

[[Image:Import_terminé.png|center|250px|thumb|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".

==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):

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
| 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:

{| class="wikitable" style="margin: 2em auto 2em auto" table border="1"
<center>pgv_blocks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_dates</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_families</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_favorites</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_individuals</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media_mapping</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_messages</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_names</center>
|-
| 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é
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_news</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_next_id</center>
|-
| ni_id INT(11) ||
|-
| ni_type VARCHAR(30) ||
|-
| ni_gedfile INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_other</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_placelinks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_places</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_remotelinks</center>
|-
| r_gid VARCHAR(255) ||
|-
| r_linkid VARCHAR(255) ||
|-
| r_file INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_sources</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_users</center>
|-
| 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:

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
| 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.

==Sauvegarde==

Note: Si vous voulez utiliser la fonction de sauvegarde de l’utilitaire “Upgrade” de PhpGedView vous devez ou bien modifier les permissions du répertoire "phpgedview" en écriture, ou bien créer un répertoire nommé "sauvegarde" en lui donnant des permissions d’écriture. Les permissions d’écriture pour le répertoire "phpgedview" peuvent être remises en lecture seule aussitôt que le répertoire « sauvegarde » est en place et dispose des permissions d’écriture appropriées.

Avec la fonction de sauvegarde dans le menu d’administration, vous pouvez réaliser une sauvegarde de tous les fichiers importants de PhpGedView. Avec cette fonction de sauvegarde, il est possible de reconstruire votre site PhpGedView à l’état qu’il avait au moment de la sauvegarde.

La sauvegarde peut contenir les fichiers suivants, qui peuvent être choisis sur la page de sauvegarde :
- config.php avec tous les paramètres de configuration de votre installation
- tous les fichiers GEDCOM qui étaient présents dans votre installation
- toutes les options GEDCOM et les paramètres de confidentialité pour les fichiers ci-dessus
- les compteurs et les fichiers de log de PhpGedView
- les définitions et les options de l’utilisateur (définitions des blocs, favoris, messages et nouvelles)

Les fichiers peuvent être regroupés dans un fichier ZIP, qui peut être téléchargé en cliquant sur le lien qui se trouve sur la page.

Note: La base de données elle-même ne sera pas incluse dans la sauvegarde, parcequ’elle peut être reconstituée à partir des fichiers qui ont été sauvegardés.

Note: Toutes les modifications en attente (non approuvées ou sur le point d’être rejetées par l’administrateur) seront présentes dans les fichiers GEDCOM mais ne peuvent plus être identifiées comme des modifications. Si la base de données est reconstituée en utilisant ces fichiers GEDCOMs, ces changements ne peuvent plus être rejetés.

Note: Si vous avez installé votre répertoire index à l’extérieur du répertoire racine de votre serveur web, les références à quelques-uns des fichiers du zip incluront des chemins de répertoires de la forme "../". Quelques utilitaires zip (par exemple la capacité native de zip dans Windows XP de Windows Explorer) ne supporte pas ce type de chemin de fichier. Vous pouvez avoir besoin d’un outil qui supporte ce type de chemins. WinRAR est un de ces outils.

La fonction de sauvegarde utilise la bibliothèque PclZip, qui a été écrite par Vincent Blavet et qui peut être trouvée ici : http://www.phpconcept.net/pclzip.

==Intégration de PostNuke et PHPNuke ==

PhpGedView peut s’intégrer avec PostNuke et phpNuke afin que les utilisateurs n’aient pas besoin de s’identifier deux fois.

Une fois que PhpGedView est lancé, vous devez suivre les instructions du fichier readme.txt file qui se trouve dans le répertoire "pgvnuke".

Les fichiers qui rendent cette intégration possible ont été donnés par Jim Carey.

==Langages==

Note: si vous voulez utiliser les fonctions de langues vous devrez établir des permissions d’écriture pour tous les fichiers qui sont presents dans le repertoire "langages”.

PhpGedView a été construit pour pouvoir supporter de multiples langues. PHP ne supporte pas l’unicode (UTF-16). Il supporte l’UTF-8 et ce format est celui qui est recommandé pour encoder les fichiers GEDCOMs avec PhpGedView. Si vous avez des caractères dans votre fichier GEDCOM qui ne sont pas dans l’alphabet standard ASCII, vous devrez probablement utiliser l’encodage UTF-8. Il y a beaucoup de differences entre les formats UTF-8 et UTF-16, mais tout ce que vous encodez au format UTF-16 peut être encodé au format UTF-8. Il est également très facile de convertir de l’Unicode en UTF-8. Il vous suffit d’ouvrir votre fichier Unicode GEDCOM avec Windows Notepad et de choisir "Fichier->Enregistrer sous.." dans le menu et de choisir UTF-8 comme option d’encodage. Vous ne devriez perdre aucun caractère en effectuant cette traduction de format.

Les discussions et les questions sur les multiples fonctionnalités de langages de PhpGedView, traductions comprises, doivent être postées dans le forum “Translations” qui se trouve sur la page web du projet de PhpGedView ici:
http://sourceforge.net/forum/forum.php?forum_id=294245

Pour traduire PhpGedView dans une autre langue qui n'est pas actuellement supportée vous devez d'abord vous connecter à PhpGedView en tant qu' administrateur et aller ensuite à l'utilitaire d'édition des langues en cliquant sur "Administration-> Ajouter fichiers et paramètres pour une nouvelle langue". Choisissez votre nouvelle langue à partir du menu déroulant et cliquez sur le bouton « ajouter une nouvelle langue ».

Une fenêtre popup apparaît alors vous permettant d'éditer les paramètres par défaut de votre nouvelle langue. Chaque paramètre dispose d'une aide en ligne en cliquant sur le "?". Vous pouvez vouloir examiner les paramètres de quelques-uns des autres langages sur la page de configuration des langues, puis en cliquant sur « éditer », pour voir comment ils sont configurés.

Quand vous avez fini de paramétrer votre nouvelle langue, cliquez sur le bouton “sauvegarde”. Cela créera un nouveau fichier lang_settings.php dans le répertoire index. Vous remarquerez que votre nouvelle langue apparaît maintenant dans la liste des langues supportées.

Créez ensuite une copie des fichiers "configure_help.en.php", "facts.en.php", "help_text.en.php", et "lang.en.php" qui se trouvent dans le répertoire "langages" et changez la partie "en" qui est dans le nom de ces fichiers afin d'y mettre à la place les deux lettres du code correspondant à votre nouvelle langue.

Le fichier "facts" contient toutes les traductions des différentes balises (ou tags) du standard GEDCOM telles que BIRT = Birth. Le fichier "lang" contient toutes les différentes langues utilisées par le site. Les fichiers "configure_help.en.php" et "help_text.en.php" fournissent les instructions de configuration et d'aide.

Vous pouvez traduire ces fichiers en utilisant l'utilitaire d'édition de fichiers de traduction, qui est accessible en cliquant sur “Editer le contenu des fichiers de traduction ». Sélectionnez votre langue à partir de la liste déroulante puis choisissez le fichier que vous voulez éditer et cliquez sur le bouton “Editer”. Votre fichier sera comparé au fichier en anglais afin que vous puissiez facilement traduire les fichiers en ligne.

Vous pouvez aussi traduire des fichiers manuellement en les ouvrant avec un éditeur de texte. Si vous éditez manuellement des fichiers, vous devez les sauvegarder au format UTF-8. Quelques éditeurs de texte tels que Windows Notepad ajoutent un marqueur 3-byte Byte-Order-Mark (BOM) aux fichiers qui sont sauvegardés au format UTF-8. PHP n'aime pas les marqueurs BOM et ils doivent être supprimés avant de tester le fonctionnement de ces fichiers dans PhpGedView. La section des outils de traduction de PhpGedView' a un programme utilitaire pour supprimer ces a BOMs.

Vous devez récupérer un drapeau correspondant à votre langue à partir du fichier http://w3f.com/gifs/index.html er le dimensionner pour qu'il ait la même taille que les drapeaux qui sont dans le répertoire images/flags.

Pour aider au support des langues, un fichier log des modifications de langues existe dans le répertoire langages. Ce fichier log est dénommé LANG_CHANGELOG.txt. Toutes les modifications aux fichiers de langue anglaise sont enregistrés ici.

Si vous effectuez une nouvelle traduction de PhpGedView ou si vous mettez à jour une autre traduction, et que vous voulez en faire profiter la communauté, postez vos fichiers de langues ainsi que votre fichier index/lang_settings.php dans la section Patches section du site web du projet SourceForge ici: http://www.sourceforge.net/projects/phpgedview

==Fichiers d'extension de langues==

Les fichiers d'extension de langues sont des fichiers PHP courants que vous pouvez utiliser pour créer vos propres extensions de langue pour PhpGedView. Pour ajouter un fichier d'extension de langue, créez un nouveau fichier PHP dénommé lang.xx.extra.php en remplaçant le "xx" par le code de la langue que vous voulez ajouter. Ces fichiers ne sont pas inclus automatiquement dans le paquet logiciel PhpGedView afin que lorsque vous les mettez à jour, vos extensions ne soient pas écrasées.

Si ce fichier existe pour la langue que vous avez choisie, c'est la dernière chose qui est chargée avant que l'affichage n'apparaisse. Ces fichiers ont été conçus pour être des extensions des fichiers de langue, mais vous pouvez facilement les utiliser pour faire en sorte que les changements de paramètres soient basés sur la langue choisie.

Quelles sont les différentes actions que l'on peut entreprendre avec ces fichiers d'extension de langues?
- Adapter tout ou partie du texte qui apparaît à l'écran,
- Modifier les options de configuration qui sont basées sur la langue,
- Basculer sur un nouveau GEDCOM quand quelqu'un visualise votre site dans une langue différente.

Les seuls paramètres que vous ne devez pas modifier dans ce fichiers sont les paramètres de confidentialité.

Si, par exemple, vous voulez changer le titre du GEDCOM quand vous changer la langue, vous pouvez changer le titre pour chaque langue en ajoutant la ligne suivante dans votre fichier lang.xx.extra.php:
$GEDCOMS["surname.ged"]["title"] = "Titre en chinois";

Dans ce fichier vous pouvez aussi changer le texte sur les boutons:
$pgv_lang["view"]="Montrer";

Avec ce fichier vous pouvez aussi changer le GEDCOM qui apparaît quand la langue est sélectionnée. Supposons que vous avez un GEDCOM qui était en allemand et un autre qui était en anglais. Dans le fichier lang.de.extra.php vous pouvez ajouter les lignes suivantes:
if ($GEDCOM=="english.ged") {
header("Location: $SCRIPT_NAME?$QUERY_STRING&ged=german.ged");
exit;
}

Ces lignes signifient que si nous utilisons des fichiers en langue allemande, mais que nous utilisons le GEDCOM anglais, alors nous devons recharger la page avec le GEDCOM allemand. Vous devez recharger la page afin que les paramètres de configuration du GEDCOM soient chargés. Cela suppose que vous importé les deux fichiers "english.ged" et "german.ged" dans la base de données et que les fichiers english.ged et german.ged contiennent les mêmes personnes, mais dans des langues différentes.

Ainsi I0001 dans le fichier english.ged doit correspondre au même I0001 dans le fichier german.ged.

=PhpGedView pour les plus avancés d'entre vous=

La plupart d'entre nous utilise des versions stables de PhpGedView, annoncées et disponibles sur les pages principales de http://www.SourceForge.net/PhpGedView.

Mais il y a toujours des développements dans le tuyau. Ces développements peuvent prendre deux formes – les patches (et vous y trouverez des correctifs de temps à autres face à des bugs signalés) et des scripts non certifiés – souvent référencés comme des "subversions" - en raccourci, SVN. Et vous trouverez des références aux "revision control", qui est le même concept.

Les “subversions” SVN sont faites pour quiconque est impliqué dans le développement et le test de logiciels libres (open source). La rubrique SVN est le répertoire dans lequel toutes les subversions actuelles sont stockées. Ce sont les éditeurs/éditeurs de scripts/programmeurs/etc qui travaillent sur les modifications, qui sont autorisés à travailler sur ce répertoire. Puis il y a les utilisateurs/testeurs/ « leading edgers », qui ont téléchargé le logiciel depuis ce répertoire dans leur espace de travail.

Cette description de SVN est très succincte – mais est peut-être suffisante pour que vous y manifestiez un intérêt.

==Gérer les SVN==

Une copie exhaustive de PhpGedView contient environ 3300 fichiers. Pour garder ce nombre de fichiers important à jour avec les copies les plus récentes dans le répertoire SVN, il faut de l'assistance. C'est pourquoi il y a quelques outils qui peuvent examiner les fichiers que vous avez déjà, et qui les comparent avec ceux qui sont dans le répertoire SVN. Si des fichiers dans le répertoire SVN sont plus récents que les vôtres, les copies du répertoire sont automatiquement télé chargées sur votre site.

Un des outils les plus faciles à utiliser est Tortoise. Pour les utilisateurs sous Windows, il vous suffit d'aller à http://tortoisesvn.net/ La page de téléchargements est ici http://tortoisesvn.net/downloads. Toutes les instructions sont disponibles ici.

Tortoise SVN est utilisable avec Windows 2000 et Windows XP. Il n'y a pas de besoin de s'identifier sur le site de
SourceForge pour utiliser cette méthode.

==Utiliser SVN==

Le processus SVN utilise quelques petits fichiers de contrôle qui comparent les données que vous avez dans vos fichiers avec ceux du répertoire SVN. S'il n'existe aucun écart, il n'y a alors pas besoin de mise à jour. S'il existe des écarts, il y a alors besoin d'une mise à jour. I

Ces petits fichiers sont installés dans un répertoire (".svn") sur votre système. Mais les répertoires peuvent représenter un inconvénient quand il vient à occuper tout l'espace d'installation de PhpGedView – et a besoin d'être enlevé de cet espace avant d'être téléchargé sur le serveur.

Plutôt que de fournir ici une longue liste, tapez dans Google '.svn delete' ou 'supprimer subversion' et vous trouverez beaucoup de références pour Linux, Mac et Windows.

[[en:Installation Guide]]

Guide d'installation

2007-08-29T07:41:38Z

Papagolf : /* Préparation de PhpGedView */

=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 sur le site du fournisseur de votre internet.

* Au moins 20 MB 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 à 2 MB, 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 de 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 transfé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 cela 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 (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”

[[Image:Filezilla.png|center|450px|thumb|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…”

[[Image:attributs.png|center|300px|thumb|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 :

[[Image:Config_phpgedview.png|center|450px|thumb|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.

[[Image:Config_phpgedview1.png|center|375px|thumb|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.

[[Image:Liste_gedcom_chargés.png|center|550px|thumb|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.)

[[Image:Configuration_gedcom.png|center|450px|thumb|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.

[[Image:Familletintin.png|center|450px|thumb|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.

[[Image:Import_gedcom.png|center|550px|thumb|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.

[[Image:Dépassement_temps_exécution.png|center|550px|thumb|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.

[[Image:Import_terminé.png|center|250px|thumb|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".

==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):

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
| 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:

{| class="wikitable" style="margin: 2em auto 2em auto" table border="1"
<center>pgv_blocks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_dates</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_families</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_favorites</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_individuals</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media_mapping</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_messages</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_names</center>
|-
| 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é
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_news</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_next_id</center>
|-
| ni_id INT(11) ||
|-
| ni_type VARCHAR(30) ||
|-
| ni_gedfile INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_other</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_placelinks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_places</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_remotelinks</center>
|-
| r_gid VARCHAR(255) ||
|-
| r_linkid VARCHAR(255) ||
|-
| r_file INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_sources</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_users</center>
|-
| 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:

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
| 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.

==Sauvegarde==

Note: Si vous voulez utiliser la fonction de sauvegarde de l’utilitaire “Upgrade” de PhpGedView vous devez ou bien modifier les permissions du répertoire "phpgedview" en écriture, ou bien créer un répertoire nommé "sauvegarde" en lui donnant des permissions d’écriture. Les permissions d’écriture pour le répertoire "phpgedview" peuvent être remises en lecture seule aussitôt que le répertoire « sauvegarde » est en place et dispose des permissions d’écriture appropriées.

Avec la fonction de sauvegarde dans le menu d’administration, vous pouvez réaliser une sauvegarde de tous les fichiers importants de PhpGedView. Avec cette fonction de sauvegarde, il est possible de reconstruire votre site PhpGedView à l’état qu’il avait au moment de la sauvegarde.

La sauvegarde peut contenir les fichiers suivants, qui peuvent être choisis sur la page de sauvegarde :
- config.php avec tous les paramètres de configuration de votre installation
- tous les fichiers GEDCOM qui étaient présents dans votre installation
- toutes les options GEDCOM et les paramètres de confidentialité pour les fichiers ci-dessus
- les compteurs et les fichiers de log de PhpGedView
- les définitions et les options de l’utilisateur (définitions des blocs, favoris, messages et nouvelles)

Les fichiers peuvent être regroupés dans un fichier ZIP, qui peut être téléchargé en cliquant sur le lien qui se trouve sur la page.

Note: La base de données elle-même ne sera pas incluse dans la sauvegarde, parcequ’elle peut être reconstituée à partir des fichiers qui ont été sauvegardés.

Note: Toutes les modifications en attente (non approuvées ou sur le point d’être rejetées par l’administrateur) seront présentes dans les fichiers GEDCOM mais ne peuvent plus être identifiées comme des modifications. Si la base de données est reconstituée en utilisant ces fichiers GEDCOMs, ces changements ne peuvent plus être rejetés.

Note: Si vous avez installé votre répertoire index à l’extérieur du répertoire racine de votre serveur web, les références à quelques-uns des fichiers du zip incluront des chemins de répertoires de la forme "../". Quelques utilitaires zip (par exemple la capacité native de zip dans Windows XP de Windows Explorer) ne supporte pas ce type de chemin de fichier. Vous pouvez avoir besoin d’un outil qui supporte ce type de chemins. WinRAR est un de ces outils.

La fonction de sauvegarde utilise la bibliothèque PclZip, qui a été écrite par Vincent Blavet et qui peut être trouvée ici : http://www.phpconcept.net/pclzip.

==Intégration de PostNuke et PHPNuke ==

PhpGedView peut s’intégrer avec PostNuke et phpNuke afin que les utilisateurs n’aient pas besoin de s’identifier deux fois.

Une fois que PhpGedView est lancé, vous devez suivre les instructions du fichier readme.txt file qui se trouve dans le répertoire "pgvnuke".

Les fichiers qui rendent cette intégration possible ont été donnés par Jim Carey.

==Langages==

Note: si vous voulez utiliser les fonctions de langues vous devrez établir des permissions d’écriture pour tous les fichiers qui sont presents dans le repertoire "langages”.

PhpGedView a été construit pour pouvoir supporter de multiples langues. PHP ne supporte pas l’unicode (UTF-16). Il supporte l’UTF-8 et ce format est celui qui est recommandé pour encoder les fichiers GEDCOMs avec PhpGedView. Si vous avez des caractères dans votre fichier GEDCOM qui ne sont pas dans l’alphabet standard ASCII, vous devrez probablement utiliser l’encodage UTF-8. Il y a beaucoup de differences entre les formats UTF-8 et UTF-16, mais tout ce que vous encodez au format UTF-16 peut être encodé au format UTF-8. Il est également très facile de convertir de l’Unicode en UTF-8. Il vous suffit d’ouvrir votre fichier Unicode GEDCOM avec Windows Notepad et de choisir "Fichier->Enregistrer sous.." dans le menu et de choisir UTF-8 comme option d’encodage. Vous ne devriez perdre aucun caractère en effectuant cette traduction de format.

Les discussions et les questions sur les multiples fonctionnalités de langages de PhpGedView, traductions comprises, doivent être postées dans le forum “Translations” qui se trouve sur la page web du projet de PhpGedView ici:
http://sourceforge.net/forum/forum.php?forum_id=294245

Pour traduire PhpGedView dans une autre langue qui n'est pas actuellement supportée vous devez d'abord vous connecter à PhpGedView en tant qu' administrateur et aller ensuite à l'utilitaire d'édition des langues en cliquant sur "Administration-> Ajouter fichiers et paramètres pour une nouvelle langue". Choisissez votre nouvelle langue à partir du menu déroulant et cliquez sur le bouton « ajouter une nouvelle langue ».

Une fenêtre popup apparaît alors vous permettant d'éditer les paramètres par défaut de votre nouvelle langue. Chaque paramètre dispose d'une aide en ligne en cliquant sur le "?". Vous pouvez vouloir examiner les paramètres de quelques-uns des autres langages sur la page de configuration des langues, puis en cliquant sur « éditer », pour voir comment ils sont configurés.

Quand vous avez fini de paramétrer votre nouvelle langue, cliquez sur le bouton “sauvegarde”. Cela créera un nouveau fichier lang_settings.php dans le répertoire index. Vous remarquerez que votre nouvelle langue apparaît maintenant dans la liste des langues supportées.

Créez ensuite une copie des fichiers "configure_help.en.php", "facts.en.php", "help_text.en.php", et "lang.en.php" qui se trouvent dans le répertoire "langages" et changez la partie "en" qui est dans le nom de ces fichiers afin d'y mettre à la place les deux lettres du code correspondant à votre nouvelle langue.

Le fichier "facts" contient toutes les traductions des différentes balises (ou tags) du standard GEDCOM telles que BIRT = Birth. Le fichier "lang" contient toutes les différentes langues utilisées par le site. Les fichiers "configure_help.en.php" et "help_text.en.php" fournissent les instructions de configuration et d'aide.

Vous pouvez traduire ces fichiers en utilisant l'utilitaire d'édition de fichiers de traduction, qui est accessible en cliquant sur “Editer le contenu des fichiers de traduction ». Sélectionnez votre langue à partir de la liste déroulante puis choisissez le fichier que vous voulez éditer et cliquez sur le bouton “Editer”. Votre fichier sera comparé au fichier en anglais afin que vous puissiez facilement traduire les fichiers en ligne.

Vous pouvez aussi traduire des fichiers manuellement en les ouvrant avec un éditeur de texte. Si vous éditez manuellement des fichiers, vous devez les sauvegarder au format UTF-8. Quelques éditeurs de texte tels que Windows Notepad ajoutent un marqueur 3-byte Byte-Order-Mark (BOM) aux fichiers qui sont sauvegardés au format UTF-8. PHP n'aime pas les marqueurs BOM et ils doivent être supprimés avant de tester le fonctionnement de ces fichiers dans PhpGedView. La section des outils de traduction de PhpGedView' a un programme utilitaire pour supprimer ces a BOMs.

Vous devez récupérer un drapeau correspondant à votre langue à partir du fichier http://w3f.com/gifs/index.html er le dimensionner pour qu'il ait la même taille que les drapeaux qui sont dans le répertoire images/flags.

Pour aider au support des langues, un fichier log des modifications de langues existe dans le répertoire langages. Ce fichier log est dénommé LANG_CHANGELOG.txt. Toutes les modifications aux fichiers de langue anglaise sont enregistrés ici.

Si vous effectuez une nouvelle traduction de PhpGedView ou si vous mettez à jour une autre traduction, et que vous voulez en faire profiter la communauté, postez vos fichiers de langues ainsi que votre fichier index/lang_settings.php dans la section Patches section du site web du projet SourceForge ici: http://www.sourceforge.net/projects/phpgedview

==Fichiers d'extension de langues==

Les fichiers d'extension de langues sont des fichiers PHP courants que vous pouvez utiliser pour créer vos propres extensions de langue pour PhpGedView. Pour ajouter un fichier d'extension de langue, créez un nouveau fichier PHP dénommé lang.xx.extra.php en remplaçant le "xx" par le code de la langue que vous voulez ajouter. Ces fichiers ne sont pas inclus automatiquement dans le paquet logiciel PhpGedView afin que lorsque vous les mettez à jour, vos extensions ne soient pas écrasées.

Si ce fichier existe pour la langue que vous avez choisie, c'est la dernière chose qui est chargée avant que l'affichage n'apparaisse. Ces fichiers ont été conçus pour être des extensions des fichiers de langue, mais vous pouvez facilement les utiliser pour faire en sorte que les changements de paramètres soient basés sur la langue choisie.

Quelles sont les différentes actions que l'on peut entreprendre avec ces fichiers d'extension de langues?
- Adapter tout ou partie du texte qui apparaît à l'écran,
- Modifier les options de configuration qui sont basées sur la langue,
- Basculer sur un nouveau GEDCOM quand quelqu'un visualise votre site dans une langue différente.

Les seuls paramètres que vous ne devez pas modifier dans ce fichiers sont les paramètres de confidentialité.

Si, par exemple, vous voulez changer le titre du GEDCOM quand vous changer la langue, vous pouvez changer le titre pour chaque langue en ajoutant la ligne suivante dans votre fichier lang.xx.extra.php:
$GEDCOMS["surname.ged"]["title"] = "Titre en chinois";

Dans ce fichier vous pouvez aussi changer le texte sur les boutons:
$pgv_lang["view"]="Montrer";

Avec ce fichier vous pouvez aussi changer le GEDCOM qui apparaît quand la langue est sélectionnée. Supposons que vous avez un GEDCOM qui était en allemand et un autre qui était en anglais. Dans le fichier lang.de.extra.php vous pouvez ajouter les lignes suivantes:
if ($GEDCOM=="english.ged") {
header("Location: $SCRIPT_NAME?$QUERY_STRING&ged=german.ged");
exit;
}

Ces lignes signifient que si nous utilisons des fichiers en langue allemande, mais que nous utilisons le GEDCOM anglais, alors nous devons recharger la page avec le GEDCOM allemand. Vous devez recharger la page afin que les paramètres de configuration du GEDCOM soient chargés. Cela suppose que vous importé les deux fichiers "english.ged" et "german.ged" dans la base de données et que les fichiers english.ged et german.ged contiennent les mêmes personnes, mais dans des langues différentes.

Ainsi I0001 dans le fichier english.ged doit correspondre au même I0001 dans le fichier german.ged.

=PhpGedView pour les plus avancés d'entre vous=

La plupart d'entre nous utilise des versions stables de PhpGedView, annoncées et disponibles sur les pages principales de http://www.SourceForge.net/PhpGedView.

Mais il y a toujours des développements dans le tuyau. Ces développements peuvent prendre deux formes – les patches (et vous y trouverez des correctifs de temps à autres face à des bugs signalés) et des scripts non certifiés – souvent référencés comme des "subversions" - en raccourci, SVN. Et vous trouverez des références aux "revision control", qui est le même concept.

Les “subversions” SVN sont faites pour quiconque est impliqué dans le développement et le test de logiciels libres (open source). La rubrique SVN est le répertoire dans lequel toutes les subversions actuelles sont stockées. Ce sont les éditeurs/éditeurs de scripts/programmeurs/etc qui travaillent sur les modifications, qui sont autorisés à travailler sur ce répertoire. Puis il y a les utilisateurs/testeurs/ « leading edgers », qui ont téléchargé le logiciel depuis ce répertoire dans leur espace de travail.

Cette description de SVN est très succincte – mais est peut-être suffisante pour que vous y manifestiez un intérêt.

==Gérer les SVN==

Une copie exhaustive de PhpGedView contient environ 3300 fichiers. Pour garder ce nombre de fichiers important à jour avec les copies les plus récentes dans le répertoire SVN, il faut de l'assistance. C'est pourquoi il y a quelques outils qui peuvent examiner les fichiers que vous avez déjà, et qui les comparent avec ceux qui sont dans le répertoire SVN. Si des fichiers dans le répertoire SVN sont plus récents que les vôtres, les copies du répertoire sont automatiquement télé chargées sur votre site.

Un des outils les plus faciles à utiliser est Tortoise. Pour les utilisateurs sous Windows, il vous suffit d'aller à http://tortoisesvn.net/ La page de téléchargements est ici http://tortoisesvn.net/downloads. Toutes les instructions sont disponibles ici.

Tortoise SVN est utilisable avec Windows 2000 et Windows XP. Il n'y a pas de besoin de s'identifier sur le site de
SourceForge pour utiliser cette méthode.

==Utiliser SVN==

Le processus SVN utilise quelques petits fichiers de contrôle qui comparent les données que vous avez dans vos fichiers avec ceux du répertoire SVN. S'il n'existe aucun écart, il n'y a alors pas besoin de mise à jour. S'il existe des écarts, il y a alors besoin d'une mise à jour. I

Ces petits fichiers sont installés dans un répertoire (".svn") sur votre système. Mais les répertoires peuvent représenter un inconvénient quand il vient à occuper tout l'espace d'installation de PhpGedView – et a besoin d'être enlevé de cet espace avant d'être téléchargé sur le serveur.

Plutôt que de fournir ici une longue liste, tapez dans Google '.svn delete' ou 'supprimer subversion' et vous trouverez beaucoup de références pour Linux, Mac et Windows.

[[en:Installation Guide]]

Guide d'installation

2007-08-29T07:40:03Z

Papagolf : /* Préparation du transfert FTP */

=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 sur le site du fournisseur de votre internet.

* Au moins 20 MB 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 à 2 MB, 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 de 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 transfé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 cela 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”

[[Image:Filezilla.png|center|450px|thumb|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…”

[[Image:attributs.png|center|300px|thumb|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 :

[[Image:Config_phpgedview.png|center|450px|thumb|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.

[[Image:Config_phpgedview1.png|center|375px|thumb|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.

[[Image:Liste_gedcom_chargés.png|center|550px|thumb|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.)

[[Image:Configuration_gedcom.png|center|450px|thumb|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.

[[Image:Familletintin.png|center|450px|thumb|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.

[[Image:Import_gedcom.png|center|550px|thumb|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.

[[Image:Dépassement_temps_exécution.png|center|550px|thumb|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.

[[Image:Import_terminé.png|center|250px|thumb|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".

==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):

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
| 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:

{| class="wikitable" style="margin: 2em auto 2em auto" table border="1"
<center>pgv_blocks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_dates</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_families</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_favorites</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_individuals</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media_mapping</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_messages</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_names</center>
|-
| 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é
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_news</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_next_id</center>
|-
| ni_id INT(11) ||
|-
| ni_type VARCHAR(30) ||
|-
| ni_gedfile INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_other</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_placelinks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_places</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_remotelinks</center>
|-
| r_gid VARCHAR(255) ||
|-
| r_linkid VARCHAR(255) ||
|-
| r_file INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_sources</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_users</center>
|-
| 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:

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
| 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.

==Sauvegarde==

Note: Si vous voulez utiliser la fonction de sauvegarde de l’utilitaire “Upgrade” de PhpGedView vous devez ou bien modifier les permissions du répertoire "phpgedview" en écriture, ou bien créer un répertoire nommé "sauvegarde" en lui donnant des permissions d’écriture. Les permissions d’écriture pour le répertoire "phpgedview" peuvent être remises en lecture seule aussitôt que le répertoire « sauvegarde » est en place et dispose des permissions d’écriture appropriées.

Avec la fonction de sauvegarde dans le menu d’administration, vous pouvez réaliser une sauvegarde de tous les fichiers importants de PhpGedView. Avec cette fonction de sauvegarde, il est possible de reconstruire votre site PhpGedView à l’état qu’il avait au moment de la sauvegarde.

La sauvegarde peut contenir les fichiers suivants, qui peuvent être choisis sur la page de sauvegarde :
- config.php avec tous les paramètres de configuration de votre installation
- tous les fichiers GEDCOM qui étaient présents dans votre installation
- toutes les options GEDCOM et les paramètres de confidentialité pour les fichiers ci-dessus
- les compteurs et les fichiers de log de PhpGedView
- les définitions et les options de l’utilisateur (définitions des blocs, favoris, messages et nouvelles)

Les fichiers peuvent être regroupés dans un fichier ZIP, qui peut être téléchargé en cliquant sur le lien qui se trouve sur la page.

Note: La base de données elle-même ne sera pas incluse dans la sauvegarde, parcequ’elle peut être reconstituée à partir des fichiers qui ont été sauvegardés.

Note: Toutes les modifications en attente (non approuvées ou sur le point d’être rejetées par l’administrateur) seront présentes dans les fichiers GEDCOM mais ne peuvent plus être identifiées comme des modifications. Si la base de données est reconstituée en utilisant ces fichiers GEDCOMs, ces changements ne peuvent plus être rejetés.

Note: Si vous avez installé votre répertoire index à l’extérieur du répertoire racine de votre serveur web, les références à quelques-uns des fichiers du zip incluront des chemins de répertoires de la forme "../". Quelques utilitaires zip (par exemple la capacité native de zip dans Windows XP de Windows Explorer) ne supporte pas ce type de chemin de fichier. Vous pouvez avoir besoin d’un outil qui supporte ce type de chemins. WinRAR est un de ces outils.

La fonction de sauvegarde utilise la bibliothèque PclZip, qui a été écrite par Vincent Blavet et qui peut être trouvée ici : http://www.phpconcept.net/pclzip.

==Intégration de PostNuke et PHPNuke ==

PhpGedView peut s’intégrer avec PostNuke et phpNuke afin que les utilisateurs n’aient pas besoin de s’identifier deux fois.

Une fois que PhpGedView est lancé, vous devez suivre les instructions du fichier readme.txt file qui se trouve dans le répertoire "pgvnuke".

Les fichiers qui rendent cette intégration possible ont été donnés par Jim Carey.

==Langages==

Note: si vous voulez utiliser les fonctions de langues vous devrez établir des permissions d’écriture pour tous les fichiers qui sont presents dans le repertoire "langages”.

PhpGedView a été construit pour pouvoir supporter de multiples langues. PHP ne supporte pas l’unicode (UTF-16). Il supporte l’UTF-8 et ce format est celui qui est recommandé pour encoder les fichiers GEDCOMs avec PhpGedView. Si vous avez des caractères dans votre fichier GEDCOM qui ne sont pas dans l’alphabet standard ASCII, vous devrez probablement utiliser l’encodage UTF-8. Il y a beaucoup de differences entre les formats UTF-8 et UTF-16, mais tout ce que vous encodez au format UTF-16 peut être encodé au format UTF-8. Il est également très facile de convertir de l’Unicode en UTF-8. Il vous suffit d’ouvrir votre fichier Unicode GEDCOM avec Windows Notepad et de choisir "Fichier->Enregistrer sous.." dans le menu et de choisir UTF-8 comme option d’encodage. Vous ne devriez perdre aucun caractère en effectuant cette traduction de format.

Les discussions et les questions sur les multiples fonctionnalités de langages de PhpGedView, traductions comprises, doivent être postées dans le forum “Translations” qui se trouve sur la page web du projet de PhpGedView ici:
http://sourceforge.net/forum/forum.php?forum_id=294245

Pour traduire PhpGedView dans une autre langue qui n'est pas actuellement supportée vous devez d'abord vous connecter à PhpGedView en tant qu' administrateur et aller ensuite à l'utilitaire d'édition des langues en cliquant sur "Administration-> Ajouter fichiers et paramètres pour une nouvelle langue". Choisissez votre nouvelle langue à partir du menu déroulant et cliquez sur le bouton « ajouter une nouvelle langue ».

Une fenêtre popup apparaît alors vous permettant d'éditer les paramètres par défaut de votre nouvelle langue. Chaque paramètre dispose d'une aide en ligne en cliquant sur le "?". Vous pouvez vouloir examiner les paramètres de quelques-uns des autres langages sur la page de configuration des langues, puis en cliquant sur « éditer », pour voir comment ils sont configurés.

Quand vous avez fini de paramétrer votre nouvelle langue, cliquez sur le bouton “sauvegarde”. Cela créera un nouveau fichier lang_settings.php dans le répertoire index. Vous remarquerez que votre nouvelle langue apparaît maintenant dans la liste des langues supportées.

Créez ensuite une copie des fichiers "configure_help.en.php", "facts.en.php", "help_text.en.php", et "lang.en.php" qui se trouvent dans le répertoire "langages" et changez la partie "en" qui est dans le nom de ces fichiers afin d'y mettre à la place les deux lettres du code correspondant à votre nouvelle langue.

Le fichier "facts" contient toutes les traductions des différentes balises (ou tags) du standard GEDCOM telles que BIRT = Birth. Le fichier "lang" contient toutes les différentes langues utilisées par le site. Les fichiers "configure_help.en.php" et "help_text.en.php" fournissent les instructions de configuration et d'aide.

Vous pouvez traduire ces fichiers en utilisant l'utilitaire d'édition de fichiers de traduction, qui est accessible en cliquant sur “Editer le contenu des fichiers de traduction ». Sélectionnez votre langue à partir de la liste déroulante puis choisissez le fichier que vous voulez éditer et cliquez sur le bouton “Editer”. Votre fichier sera comparé au fichier en anglais afin que vous puissiez facilement traduire les fichiers en ligne.

Vous pouvez aussi traduire des fichiers manuellement en les ouvrant avec un éditeur de texte. Si vous éditez manuellement des fichiers, vous devez les sauvegarder au format UTF-8. Quelques éditeurs de texte tels que Windows Notepad ajoutent un marqueur 3-byte Byte-Order-Mark (BOM) aux fichiers qui sont sauvegardés au format UTF-8. PHP n'aime pas les marqueurs BOM et ils doivent être supprimés avant de tester le fonctionnement de ces fichiers dans PhpGedView. La section des outils de traduction de PhpGedView' a un programme utilitaire pour supprimer ces a BOMs.

Vous devez récupérer un drapeau correspondant à votre langue à partir du fichier http://w3f.com/gifs/index.html er le dimensionner pour qu'il ait la même taille que les drapeaux qui sont dans le répertoire images/flags.

Pour aider au support des langues, un fichier log des modifications de langues existe dans le répertoire langages. Ce fichier log est dénommé LANG_CHANGELOG.txt. Toutes les modifications aux fichiers de langue anglaise sont enregistrés ici.

Si vous effectuez une nouvelle traduction de PhpGedView ou si vous mettez à jour une autre traduction, et que vous voulez en faire profiter la communauté, postez vos fichiers de langues ainsi que votre fichier index/lang_settings.php dans la section Patches section du site web du projet SourceForge ici: http://www.sourceforge.net/projects/phpgedview

==Fichiers d'extension de langues==

Les fichiers d'extension de langues sont des fichiers PHP courants que vous pouvez utiliser pour créer vos propres extensions de langue pour PhpGedView. Pour ajouter un fichier d'extension de langue, créez un nouveau fichier PHP dénommé lang.xx.extra.php en remplaçant le "xx" par le code de la langue que vous voulez ajouter. Ces fichiers ne sont pas inclus automatiquement dans le paquet logiciel PhpGedView afin que lorsque vous les mettez à jour, vos extensions ne soient pas écrasées.

Si ce fichier existe pour la langue que vous avez choisie, c'est la dernière chose qui est chargée avant que l'affichage n'apparaisse. Ces fichiers ont été conçus pour être des extensions des fichiers de langue, mais vous pouvez facilement les utiliser pour faire en sorte que les changements de paramètres soient basés sur la langue choisie.

Quelles sont les différentes actions que l'on peut entreprendre avec ces fichiers d'extension de langues?
- Adapter tout ou partie du texte qui apparaît à l'écran,
- Modifier les options de configuration qui sont basées sur la langue,
- Basculer sur un nouveau GEDCOM quand quelqu'un visualise votre site dans une langue différente.

Les seuls paramètres que vous ne devez pas modifier dans ce fichiers sont les paramètres de confidentialité.

Si, par exemple, vous voulez changer le titre du GEDCOM quand vous changer la langue, vous pouvez changer le titre pour chaque langue en ajoutant la ligne suivante dans votre fichier lang.xx.extra.php:
$GEDCOMS["surname.ged"]["title"] = "Titre en chinois";

Dans ce fichier vous pouvez aussi changer le texte sur les boutons:
$pgv_lang["view"]="Montrer";

Avec ce fichier vous pouvez aussi changer le GEDCOM qui apparaît quand la langue est sélectionnée. Supposons que vous avez un GEDCOM qui était en allemand et un autre qui était en anglais. Dans le fichier lang.de.extra.php vous pouvez ajouter les lignes suivantes:
if ($GEDCOM=="english.ged") {
header("Location: $SCRIPT_NAME?$QUERY_STRING&ged=german.ged");
exit;
}

Ces lignes signifient que si nous utilisons des fichiers en langue allemande, mais que nous utilisons le GEDCOM anglais, alors nous devons recharger la page avec le GEDCOM allemand. Vous devez recharger la page afin que les paramètres de configuration du GEDCOM soient chargés. Cela suppose que vous importé les deux fichiers "english.ged" et "german.ged" dans la base de données et que les fichiers english.ged et german.ged contiennent les mêmes personnes, mais dans des langues différentes.

Ainsi I0001 dans le fichier english.ged doit correspondre au même I0001 dans le fichier german.ged.

=PhpGedView pour les plus avancés d'entre vous=

La plupart d'entre nous utilise des versions stables de PhpGedView, annoncées et disponibles sur les pages principales de http://www.SourceForge.net/PhpGedView.

Mais il y a toujours des développements dans le tuyau. Ces développements peuvent prendre deux formes – les patches (et vous y trouverez des correctifs de temps à autres face à des bugs signalés) et des scripts non certifiés – souvent référencés comme des "subversions" - en raccourci, SVN. Et vous trouverez des références aux "revision control", qui est le même concept.

Les “subversions” SVN sont faites pour quiconque est impliqué dans le développement et le test de logiciels libres (open source). La rubrique SVN est le répertoire dans lequel toutes les subversions actuelles sont stockées. Ce sont les éditeurs/éditeurs de scripts/programmeurs/etc qui travaillent sur les modifications, qui sont autorisés à travailler sur ce répertoire. Puis il y a les utilisateurs/testeurs/ « leading edgers », qui ont téléchargé le logiciel depuis ce répertoire dans leur espace de travail.

Cette description de SVN est très succincte – mais est peut-être suffisante pour que vous y manifestiez un intérêt.

==Gérer les SVN==

Une copie exhaustive de PhpGedView contient environ 3300 fichiers. Pour garder ce nombre de fichiers important à jour avec les copies les plus récentes dans le répertoire SVN, il faut de l'assistance. C'est pourquoi il y a quelques outils qui peuvent examiner les fichiers que vous avez déjà, et qui les comparent avec ceux qui sont dans le répertoire SVN. Si des fichiers dans le répertoire SVN sont plus récents que les vôtres, les copies du répertoire sont automatiquement télé chargées sur votre site.

Un des outils les plus faciles à utiliser est Tortoise. Pour les utilisateurs sous Windows, il vous suffit d'aller à http://tortoisesvn.net/ La page de téléchargements est ici http://tortoisesvn.net/downloads. Toutes les instructions sont disponibles ici.

Tortoise SVN est utilisable avec Windows 2000 et Windows XP. Il n'y a pas de besoin de s'identifier sur le site de
SourceForge pour utiliser cette méthode.

==Utiliser SVN==

Le processus SVN utilise quelques petits fichiers de contrôle qui comparent les données que vous avez dans vos fichiers avec ceux du répertoire SVN. S'il n'existe aucun écart, il n'y a alors pas besoin de mise à jour. S'il existe des écarts, il y a alors besoin d'une mise à jour. I

Ces petits fichiers sont installés dans un répertoire (".svn") sur votre système. Mais les répertoires peuvent représenter un inconvénient quand il vient à occuper tout l'espace d'installation de PhpGedView – et a besoin d'être enlevé de cet espace avant d'être téléchargé sur le serveur.

Plutôt que de fournir ici une longue liste, tapez dans Google '.svn delete' ou 'supprimer subversion' et vous trouverez beaucoup de références pour Linux, Mac et Windows.

[[en:Installation Guide]]

Guide d'installation

2007-08-29T07:38:41Z

Papagolf : /* Taille maximum du fichier GEDCOM */

=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 sur le site du fournisseur de votre internet.

* Au moins 20 MB 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 à 2 MB, 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 de 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”

[[Image:Filezilla.png|center|450px|thumb|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…”

[[Image:attributs.png|center|300px|thumb|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 :

[[Image:Config_phpgedview.png|center|450px|thumb|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.

[[Image:Config_phpgedview1.png|center|375px|thumb|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.

[[Image:Liste_gedcom_chargés.png|center|550px|thumb|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.)

[[Image:Configuration_gedcom.png|center|450px|thumb|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.

[[Image:Familletintin.png|center|450px|thumb|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.

[[Image:Import_gedcom.png|center|550px|thumb|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.

[[Image:Dépassement_temps_exécution.png|center|550px|thumb|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.

[[Image:Import_terminé.png|center|250px|thumb|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".

==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):

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
| 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:

{| class="wikitable" style="margin: 2em auto 2em auto" table border="1"
<center>pgv_blocks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_dates</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_families</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_favorites</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_individuals</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media_mapping</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_messages</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_names</center>
|-
| 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é
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_news</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_next_id</center>
|-
| ni_id INT(11) ||
|-
| ni_type VARCHAR(30) ||
|-
| ni_gedfile INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_other</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_placelinks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_places</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_remotelinks</center>
|-
| r_gid VARCHAR(255) ||
|-
| r_linkid VARCHAR(255) ||
|-
| r_file INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_sources</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_users</center>
|-
| 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:

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
| 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.

==Sauvegarde==

Note: Si vous voulez utiliser la fonction de sauvegarde de l’utilitaire “Upgrade” de PhpGedView vous devez ou bien modifier les permissions du répertoire "phpgedview" en écriture, ou bien créer un répertoire nommé "sauvegarde" en lui donnant des permissions d’écriture. Les permissions d’écriture pour le répertoire "phpgedview" peuvent être remises en lecture seule aussitôt que le répertoire « sauvegarde » est en place et dispose des permissions d’écriture appropriées.

Avec la fonction de sauvegarde dans le menu d’administration, vous pouvez réaliser une sauvegarde de tous les fichiers importants de PhpGedView. Avec cette fonction de sauvegarde, il est possible de reconstruire votre site PhpGedView à l’état qu’il avait au moment de la sauvegarde.

La sauvegarde peut contenir les fichiers suivants, qui peuvent être choisis sur la page de sauvegarde :
- config.php avec tous les paramètres de configuration de votre installation
- tous les fichiers GEDCOM qui étaient présents dans votre installation
- toutes les options GEDCOM et les paramètres de confidentialité pour les fichiers ci-dessus
- les compteurs et les fichiers de log de PhpGedView
- les définitions et les options de l’utilisateur (définitions des blocs, favoris, messages et nouvelles)

Les fichiers peuvent être regroupés dans un fichier ZIP, qui peut être téléchargé en cliquant sur le lien qui se trouve sur la page.

Note: La base de données elle-même ne sera pas incluse dans la sauvegarde, parcequ’elle peut être reconstituée à partir des fichiers qui ont été sauvegardés.

Note: Toutes les modifications en attente (non approuvées ou sur le point d’être rejetées par l’administrateur) seront présentes dans les fichiers GEDCOM mais ne peuvent plus être identifiées comme des modifications. Si la base de données est reconstituée en utilisant ces fichiers GEDCOMs, ces changements ne peuvent plus être rejetés.

Note: Si vous avez installé votre répertoire index à l’extérieur du répertoire racine de votre serveur web, les références à quelques-uns des fichiers du zip incluront des chemins de répertoires de la forme "../". Quelques utilitaires zip (par exemple la capacité native de zip dans Windows XP de Windows Explorer) ne supporte pas ce type de chemin de fichier. Vous pouvez avoir besoin d’un outil qui supporte ce type de chemins. WinRAR est un de ces outils.

La fonction de sauvegarde utilise la bibliothèque PclZip, qui a été écrite par Vincent Blavet et qui peut être trouvée ici : http://www.phpconcept.net/pclzip.

==Intégration de PostNuke et PHPNuke ==

PhpGedView peut s’intégrer avec PostNuke et phpNuke afin que les utilisateurs n’aient pas besoin de s’identifier deux fois.

Une fois que PhpGedView est lancé, vous devez suivre les instructions du fichier readme.txt file qui se trouve dans le répertoire "pgvnuke".

Les fichiers qui rendent cette intégration possible ont été donnés par Jim Carey.

==Langages==

Note: si vous voulez utiliser les fonctions de langues vous devrez établir des permissions d’écriture pour tous les fichiers qui sont presents dans le repertoire "langages”.

PhpGedView a été construit pour pouvoir supporter de multiples langues. PHP ne supporte pas l’unicode (UTF-16). Il supporte l’UTF-8 et ce format est celui qui est recommandé pour encoder les fichiers GEDCOMs avec PhpGedView. Si vous avez des caractères dans votre fichier GEDCOM qui ne sont pas dans l’alphabet standard ASCII, vous devrez probablement utiliser l’encodage UTF-8. Il y a beaucoup de differences entre les formats UTF-8 et UTF-16, mais tout ce que vous encodez au format UTF-16 peut être encodé au format UTF-8. Il est également très facile de convertir de l’Unicode en UTF-8. Il vous suffit d’ouvrir votre fichier Unicode GEDCOM avec Windows Notepad et de choisir "Fichier->Enregistrer sous.." dans le menu et de choisir UTF-8 comme option d’encodage. Vous ne devriez perdre aucun caractère en effectuant cette traduction de format.

Les discussions et les questions sur les multiples fonctionnalités de langages de PhpGedView, traductions comprises, doivent être postées dans le forum “Translations” qui se trouve sur la page web du projet de PhpGedView ici:
http://sourceforge.net/forum/forum.php?forum_id=294245

Pour traduire PhpGedView dans une autre langue qui n'est pas actuellement supportée vous devez d'abord vous connecter à PhpGedView en tant qu' administrateur et aller ensuite à l'utilitaire d'édition des langues en cliquant sur "Administration-> Ajouter fichiers et paramètres pour une nouvelle langue". Choisissez votre nouvelle langue à partir du menu déroulant et cliquez sur le bouton « ajouter une nouvelle langue ».

Une fenêtre popup apparaît alors vous permettant d'éditer les paramètres par défaut de votre nouvelle langue. Chaque paramètre dispose d'une aide en ligne en cliquant sur le "?". Vous pouvez vouloir examiner les paramètres de quelques-uns des autres langages sur la page de configuration des langues, puis en cliquant sur « éditer », pour voir comment ils sont configurés.

Quand vous avez fini de paramétrer votre nouvelle langue, cliquez sur le bouton “sauvegarde”. Cela créera un nouveau fichier lang_settings.php dans le répertoire index. Vous remarquerez que votre nouvelle langue apparaît maintenant dans la liste des langues supportées.

Créez ensuite une copie des fichiers "configure_help.en.php", "facts.en.php", "help_text.en.php", et "lang.en.php" qui se trouvent dans le répertoire "langages" et changez la partie "en" qui est dans le nom de ces fichiers afin d'y mettre à la place les deux lettres du code correspondant à votre nouvelle langue.

Le fichier "facts" contient toutes les traductions des différentes balises (ou tags) du standard GEDCOM telles que BIRT = Birth. Le fichier "lang" contient toutes les différentes langues utilisées par le site. Les fichiers "configure_help.en.php" et "help_text.en.php" fournissent les instructions de configuration et d'aide.

Vous pouvez traduire ces fichiers en utilisant l'utilitaire d'édition de fichiers de traduction, qui est accessible en cliquant sur “Editer le contenu des fichiers de traduction ». Sélectionnez votre langue à partir de la liste déroulante puis choisissez le fichier que vous voulez éditer et cliquez sur le bouton “Editer”. Votre fichier sera comparé au fichier en anglais afin que vous puissiez facilement traduire les fichiers en ligne.

Vous pouvez aussi traduire des fichiers manuellement en les ouvrant avec un éditeur de texte. Si vous éditez manuellement des fichiers, vous devez les sauvegarder au format UTF-8. Quelques éditeurs de texte tels que Windows Notepad ajoutent un marqueur 3-byte Byte-Order-Mark (BOM) aux fichiers qui sont sauvegardés au format UTF-8. PHP n'aime pas les marqueurs BOM et ils doivent être supprimés avant de tester le fonctionnement de ces fichiers dans PhpGedView. La section des outils de traduction de PhpGedView' a un programme utilitaire pour supprimer ces a BOMs.

Vous devez récupérer un drapeau correspondant à votre langue à partir du fichier http://w3f.com/gifs/index.html er le dimensionner pour qu'il ait la même taille que les drapeaux qui sont dans le répertoire images/flags.

Pour aider au support des langues, un fichier log des modifications de langues existe dans le répertoire langages. Ce fichier log est dénommé LANG_CHANGELOG.txt. Toutes les modifications aux fichiers de langue anglaise sont enregistrés ici.

Si vous effectuez une nouvelle traduction de PhpGedView ou si vous mettez à jour une autre traduction, et que vous voulez en faire profiter la communauté, postez vos fichiers de langues ainsi que votre fichier index/lang_settings.php dans la section Patches section du site web du projet SourceForge ici: http://www.sourceforge.net/projects/phpgedview

==Fichiers d'extension de langues==

Les fichiers d'extension de langues sont des fichiers PHP courants que vous pouvez utiliser pour créer vos propres extensions de langue pour PhpGedView. Pour ajouter un fichier d'extension de langue, créez un nouveau fichier PHP dénommé lang.xx.extra.php en remplaçant le "xx" par le code de la langue que vous voulez ajouter. Ces fichiers ne sont pas inclus automatiquement dans le paquet logiciel PhpGedView afin que lorsque vous les mettez à jour, vos extensions ne soient pas écrasées.

Si ce fichier existe pour la langue que vous avez choisie, c'est la dernière chose qui est chargée avant que l'affichage n'apparaisse. Ces fichiers ont été conçus pour être des extensions des fichiers de langue, mais vous pouvez facilement les utiliser pour faire en sorte que les changements de paramètres soient basés sur la langue choisie.

Quelles sont les différentes actions que l'on peut entreprendre avec ces fichiers d'extension de langues?
- Adapter tout ou partie du texte qui apparaît à l'écran,
- Modifier les options de configuration qui sont basées sur la langue,
- Basculer sur un nouveau GEDCOM quand quelqu'un visualise votre site dans une langue différente.

Les seuls paramètres que vous ne devez pas modifier dans ce fichiers sont les paramètres de confidentialité.

Si, par exemple, vous voulez changer le titre du GEDCOM quand vous changer la langue, vous pouvez changer le titre pour chaque langue en ajoutant la ligne suivante dans votre fichier lang.xx.extra.php:
$GEDCOMS["surname.ged"]["title"] = "Titre en chinois";

Dans ce fichier vous pouvez aussi changer le texte sur les boutons:
$pgv_lang["view"]="Montrer";

Avec ce fichier vous pouvez aussi changer le GEDCOM qui apparaît quand la langue est sélectionnée. Supposons que vous avez un GEDCOM qui était en allemand et un autre qui était en anglais. Dans le fichier lang.de.extra.php vous pouvez ajouter les lignes suivantes:
if ($GEDCOM=="english.ged") {
header("Location: $SCRIPT_NAME?$QUERY_STRING&ged=german.ged");
exit;
}

Ces lignes signifient que si nous utilisons des fichiers en langue allemande, mais que nous utilisons le GEDCOM anglais, alors nous devons recharger la page avec le GEDCOM allemand. Vous devez recharger la page afin que les paramètres de configuration du GEDCOM soient chargés. Cela suppose que vous importé les deux fichiers "english.ged" et "german.ged" dans la base de données et que les fichiers english.ged et german.ged contiennent les mêmes personnes, mais dans des langues différentes.

Ainsi I0001 dans le fichier english.ged doit correspondre au même I0001 dans le fichier german.ged.

=PhpGedView pour les plus avancés d'entre vous=

La plupart d'entre nous utilise des versions stables de PhpGedView, annoncées et disponibles sur les pages principales de http://www.SourceForge.net/PhpGedView.

Mais il y a toujours des développements dans le tuyau. Ces développements peuvent prendre deux formes – les patches (et vous y trouverez des correctifs de temps à autres face à des bugs signalés) et des scripts non certifiés – souvent référencés comme des "subversions" - en raccourci, SVN. Et vous trouverez des références aux "revision control", qui est le même concept.

Les “subversions” SVN sont faites pour quiconque est impliqué dans le développement et le test de logiciels libres (open source). La rubrique SVN est le répertoire dans lequel toutes les subversions actuelles sont stockées. Ce sont les éditeurs/éditeurs de scripts/programmeurs/etc qui travaillent sur les modifications, qui sont autorisés à travailler sur ce répertoire. Puis il y a les utilisateurs/testeurs/ « leading edgers », qui ont téléchargé le logiciel depuis ce répertoire dans leur espace de travail.

Cette description de SVN est très succincte – mais est peut-être suffisante pour que vous y manifestiez un intérêt.

==Gérer les SVN==

Une copie exhaustive de PhpGedView contient environ 3300 fichiers. Pour garder ce nombre de fichiers important à jour avec les copies les plus récentes dans le répertoire SVN, il faut de l'assistance. C'est pourquoi il y a quelques outils qui peuvent examiner les fichiers que vous avez déjà, et qui les comparent avec ceux qui sont dans le répertoire SVN. Si des fichiers dans le répertoire SVN sont plus récents que les vôtres, les copies du répertoire sont automatiquement télé chargées sur votre site.

Un des outils les plus faciles à utiliser est Tortoise. Pour les utilisateurs sous Windows, il vous suffit d'aller à http://tortoisesvn.net/ La page de téléchargements est ici http://tortoisesvn.net/downloads. Toutes les instructions sont disponibles ici.

Tortoise SVN est utilisable avec Windows 2000 et Windows XP. Il n'y a pas de besoin de s'identifier sur le site de
SourceForge pour utiliser cette méthode.

==Utiliser SVN==

Le processus SVN utilise quelques petits fichiers de contrôle qui comparent les données que vous avez dans vos fichiers avec ceux du répertoire SVN. S'il n'existe aucun écart, il n'y a alors pas besoin de mise à jour. S'il existe des écarts, il y a alors besoin d'une mise à jour. I

Ces petits fichiers sont installés dans un répertoire (".svn") sur votre système. Mais les répertoires peuvent représenter un inconvénient quand il vient à occuper tout l'espace d'installation de PhpGedView – et a besoin d'être enlevé de cet espace avant d'être téléchargé sur le serveur.

Plutôt que de fournir ici une longue liste, tapez dans Google '.svn delete' ou 'supprimer subversion' et vous trouverez beaucoup de références pour Linux, Mac et Windows.

[[en:Installation Guide]]

Guide d'installation

2007-08-29T07:37:43Z

Papagolf : /* Ce dont vous aurez besoin */

=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 sur le site du fournisseur de votre internet.

* Au moins 20 MB 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”

[[Image:Filezilla.png|center|450px|thumb|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…”

[[Image:attributs.png|center|300px|thumb|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 :

[[Image:Config_phpgedview.png|center|450px|thumb|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.

[[Image:Config_phpgedview1.png|center|375px|thumb|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.

[[Image:Liste_gedcom_chargés.png|center|550px|thumb|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.)

[[Image:Configuration_gedcom.png|center|450px|thumb|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.

[[Image:Familletintin.png|center|450px|thumb|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.

[[Image:Import_gedcom.png|center|550px|thumb|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.

[[Image:Dépassement_temps_exécution.png|center|550px|thumb|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.

[[Image:Import_terminé.png|center|250px|thumb|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".

==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):

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
| 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:

{| class="wikitable" style="margin: 2em auto 2em auto" table border="1"
<center>pgv_blocks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_dates</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_families</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_favorites</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_individuals</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media_mapping</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_messages</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_names</center>
|-
| 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é
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_news</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_next_id</center>
|-
| ni_id INT(11) ||
|-
| ni_type VARCHAR(30) ||
|-
| ni_gedfile INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_other</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_placelinks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_places</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_remotelinks</center>
|-
| r_gid VARCHAR(255) ||
|-
| r_linkid VARCHAR(255) ||
|-
| r_file INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_sources</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_users</center>
|-
| 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:

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
| 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.

==Sauvegarde==

Note: Si vous voulez utiliser la fonction de sauvegarde de l’utilitaire “Upgrade” de PhpGedView vous devez ou bien modifier les permissions du répertoire "phpgedview" en écriture, ou bien créer un répertoire nommé "sauvegarde" en lui donnant des permissions d’écriture. Les permissions d’écriture pour le répertoire "phpgedview" peuvent être remises en lecture seule aussitôt que le répertoire « sauvegarde » est en place et dispose des permissions d’écriture appropriées.

Avec la fonction de sauvegarde dans le menu d’administration, vous pouvez réaliser une sauvegarde de tous les fichiers importants de PhpGedView. Avec cette fonction de sauvegarde, il est possible de reconstruire votre site PhpGedView à l’état qu’il avait au moment de la sauvegarde.

La sauvegarde peut contenir les fichiers suivants, qui peuvent être choisis sur la page de sauvegarde :
- config.php avec tous les paramètres de configuration de votre installation
- tous les fichiers GEDCOM qui étaient présents dans votre installation
- toutes les options GEDCOM et les paramètres de confidentialité pour les fichiers ci-dessus
- les compteurs et les fichiers de log de PhpGedView
- les définitions et les options de l’utilisateur (définitions des blocs, favoris, messages et nouvelles)

Les fichiers peuvent être regroupés dans un fichier ZIP, qui peut être téléchargé en cliquant sur le lien qui se trouve sur la page.

Note: La base de données elle-même ne sera pas incluse dans la sauvegarde, parcequ’elle peut être reconstituée à partir des fichiers qui ont été sauvegardés.

Note: Toutes les modifications en attente (non approuvées ou sur le point d’être rejetées par l’administrateur) seront présentes dans les fichiers GEDCOM mais ne peuvent plus être identifiées comme des modifications. Si la base de données est reconstituée en utilisant ces fichiers GEDCOMs, ces changements ne peuvent plus être rejetés.

Note: Si vous avez installé votre répertoire index à l’extérieur du répertoire racine de votre serveur web, les références à quelques-uns des fichiers du zip incluront des chemins de répertoires de la forme "../". Quelques utilitaires zip (par exemple la capacité native de zip dans Windows XP de Windows Explorer) ne supporte pas ce type de chemin de fichier. Vous pouvez avoir besoin d’un outil qui supporte ce type de chemins. WinRAR est un de ces outils.

La fonction de sauvegarde utilise la bibliothèque PclZip, qui a été écrite par Vincent Blavet et qui peut être trouvée ici : http://www.phpconcept.net/pclzip.

==Intégration de PostNuke et PHPNuke ==

PhpGedView peut s’intégrer avec PostNuke et phpNuke afin que les utilisateurs n’aient pas besoin de s’identifier deux fois.

Une fois que PhpGedView est lancé, vous devez suivre les instructions du fichier readme.txt file qui se trouve dans le répertoire "pgvnuke".

Les fichiers qui rendent cette intégration possible ont été donnés par Jim Carey.

==Langages==

Note: si vous voulez utiliser les fonctions de langues vous devrez établir des permissions d’écriture pour tous les fichiers qui sont presents dans le repertoire "langages”.

PhpGedView a été construit pour pouvoir supporter de multiples langues. PHP ne supporte pas l’unicode (UTF-16). Il supporte l’UTF-8 et ce format est celui qui est recommandé pour encoder les fichiers GEDCOMs avec PhpGedView. Si vous avez des caractères dans votre fichier GEDCOM qui ne sont pas dans l’alphabet standard ASCII, vous devrez probablement utiliser l’encodage UTF-8. Il y a beaucoup de differences entre les formats UTF-8 et UTF-16, mais tout ce que vous encodez au format UTF-16 peut être encodé au format UTF-8. Il est également très facile de convertir de l’Unicode en UTF-8. Il vous suffit d’ouvrir votre fichier Unicode GEDCOM avec Windows Notepad et de choisir "Fichier->Enregistrer sous.." dans le menu et de choisir UTF-8 comme option d’encodage. Vous ne devriez perdre aucun caractère en effectuant cette traduction de format.

Les discussions et les questions sur les multiples fonctionnalités de langages de PhpGedView, traductions comprises, doivent être postées dans le forum “Translations” qui se trouve sur la page web du projet de PhpGedView ici:
http://sourceforge.net/forum/forum.php?forum_id=294245

Pour traduire PhpGedView dans une autre langue qui n'est pas actuellement supportée vous devez d'abord vous connecter à PhpGedView en tant qu' administrateur et aller ensuite à l'utilitaire d'édition des langues en cliquant sur "Administration-> Ajouter fichiers et paramètres pour une nouvelle langue". Choisissez votre nouvelle langue à partir du menu déroulant et cliquez sur le bouton « ajouter une nouvelle langue ».

Une fenêtre popup apparaît alors vous permettant d'éditer les paramètres par défaut de votre nouvelle langue. Chaque paramètre dispose d'une aide en ligne en cliquant sur le "?". Vous pouvez vouloir examiner les paramètres de quelques-uns des autres langages sur la page de configuration des langues, puis en cliquant sur « éditer », pour voir comment ils sont configurés.

Quand vous avez fini de paramétrer votre nouvelle langue, cliquez sur le bouton “sauvegarde”. Cela créera un nouveau fichier lang_settings.php dans le répertoire index. Vous remarquerez que votre nouvelle langue apparaît maintenant dans la liste des langues supportées.

Créez ensuite une copie des fichiers "configure_help.en.php", "facts.en.php", "help_text.en.php", et "lang.en.php" qui se trouvent dans le répertoire "langages" et changez la partie "en" qui est dans le nom de ces fichiers afin d'y mettre à la place les deux lettres du code correspondant à votre nouvelle langue.

Le fichier "facts" contient toutes les traductions des différentes balises (ou tags) du standard GEDCOM telles que BIRT = Birth. Le fichier "lang" contient toutes les différentes langues utilisées par le site. Les fichiers "configure_help.en.php" et "help_text.en.php" fournissent les instructions de configuration et d'aide.

Vous pouvez traduire ces fichiers en utilisant l'utilitaire d'édition de fichiers de traduction, qui est accessible en cliquant sur “Editer le contenu des fichiers de traduction ». Sélectionnez votre langue à partir de la liste déroulante puis choisissez le fichier que vous voulez éditer et cliquez sur le bouton “Editer”. Votre fichier sera comparé au fichier en anglais afin que vous puissiez facilement traduire les fichiers en ligne.

Vous pouvez aussi traduire des fichiers manuellement en les ouvrant avec un éditeur de texte. Si vous éditez manuellement des fichiers, vous devez les sauvegarder au format UTF-8. Quelques éditeurs de texte tels que Windows Notepad ajoutent un marqueur 3-byte Byte-Order-Mark (BOM) aux fichiers qui sont sauvegardés au format UTF-8. PHP n'aime pas les marqueurs BOM et ils doivent être supprimés avant de tester le fonctionnement de ces fichiers dans PhpGedView. La section des outils de traduction de PhpGedView' a un programme utilitaire pour supprimer ces a BOMs.

Vous devez récupérer un drapeau correspondant à votre langue à partir du fichier http://w3f.com/gifs/index.html er le dimensionner pour qu'il ait la même taille que les drapeaux qui sont dans le répertoire images/flags.

Pour aider au support des langues, un fichier log des modifications de langues existe dans le répertoire langages. Ce fichier log est dénommé LANG_CHANGELOG.txt. Toutes les modifications aux fichiers de langue anglaise sont enregistrés ici.

Si vous effectuez une nouvelle traduction de PhpGedView ou si vous mettez à jour une autre traduction, et que vous voulez en faire profiter la communauté, postez vos fichiers de langues ainsi que votre fichier index/lang_settings.php dans la section Patches section du site web du projet SourceForge ici: http://www.sourceforge.net/projects/phpgedview

==Fichiers d'extension de langues==

Les fichiers d'extension de langues sont des fichiers PHP courants que vous pouvez utiliser pour créer vos propres extensions de langue pour PhpGedView. Pour ajouter un fichier d'extension de langue, créez un nouveau fichier PHP dénommé lang.xx.extra.php en remplaçant le "xx" par le code de la langue que vous voulez ajouter. Ces fichiers ne sont pas inclus automatiquement dans le paquet logiciel PhpGedView afin que lorsque vous les mettez à jour, vos extensions ne soient pas écrasées.

Si ce fichier existe pour la langue que vous avez choisie, c'est la dernière chose qui est chargée avant que l'affichage n'apparaisse. Ces fichiers ont été conçus pour être des extensions des fichiers de langue, mais vous pouvez facilement les utiliser pour faire en sorte que les changements de paramètres soient basés sur la langue choisie.

Quelles sont les différentes actions que l'on peut entreprendre avec ces fichiers d'extension de langues?
- Adapter tout ou partie du texte qui apparaît à l'écran,
- Modifier les options de configuration qui sont basées sur la langue,
- Basculer sur un nouveau GEDCOM quand quelqu'un visualise votre site dans une langue différente.

Les seuls paramètres que vous ne devez pas modifier dans ce fichiers sont les paramètres de confidentialité.

Si, par exemple, vous voulez changer le titre du GEDCOM quand vous changer la langue, vous pouvez changer le titre pour chaque langue en ajoutant la ligne suivante dans votre fichier lang.xx.extra.php:
$GEDCOMS["surname.ged"]["title"] = "Titre en chinois";

Dans ce fichier vous pouvez aussi changer le texte sur les boutons:
$pgv_lang["view"]="Montrer";

Avec ce fichier vous pouvez aussi changer le GEDCOM qui apparaît quand la langue est sélectionnée. Supposons que vous avez un GEDCOM qui était en allemand et un autre qui était en anglais. Dans le fichier lang.de.extra.php vous pouvez ajouter les lignes suivantes:
if ($GEDCOM=="english.ged") {
header("Location: $SCRIPT_NAME?$QUERY_STRING&ged=german.ged");
exit;
}

Ces lignes signifient que si nous utilisons des fichiers en langue allemande, mais que nous utilisons le GEDCOM anglais, alors nous devons recharger la page avec le GEDCOM allemand. Vous devez recharger la page afin que les paramètres de configuration du GEDCOM soient chargés. Cela suppose que vous importé les deux fichiers "english.ged" et "german.ged" dans la base de données et que les fichiers english.ged et german.ged contiennent les mêmes personnes, mais dans des langues différentes.

Ainsi I0001 dans le fichier english.ged doit correspondre au même I0001 dans le fichier german.ged.

=PhpGedView pour les plus avancés d'entre vous=

La plupart d'entre nous utilise des versions stables de PhpGedView, annoncées et disponibles sur les pages principales de http://www.SourceForge.net/PhpGedView.

Mais il y a toujours des développements dans le tuyau. Ces développements peuvent prendre deux formes – les patches (et vous y trouverez des correctifs de temps à autres face à des bugs signalés) et des scripts non certifiés – souvent référencés comme des "subversions" - en raccourci, SVN. Et vous trouverez des références aux "revision control", qui est le même concept.

Les “subversions” SVN sont faites pour quiconque est impliqué dans le développement et le test de logiciels libres (open source). La rubrique SVN est le répertoire dans lequel toutes les subversions actuelles sont stockées. Ce sont les éditeurs/éditeurs de scripts/programmeurs/etc qui travaillent sur les modifications, qui sont autorisés à travailler sur ce répertoire. Puis il y a les utilisateurs/testeurs/ « leading edgers », qui ont téléchargé le logiciel depuis ce répertoire dans leur espace de travail.

Cette description de SVN est très succincte – mais est peut-être suffisante pour que vous y manifestiez un intérêt.

==Gérer les SVN==

Une copie exhaustive de PhpGedView contient environ 3300 fichiers. Pour garder ce nombre de fichiers important à jour avec les copies les plus récentes dans le répertoire SVN, il faut de l'assistance. C'est pourquoi il y a quelques outils qui peuvent examiner les fichiers que vous avez déjà, et qui les comparent avec ceux qui sont dans le répertoire SVN. Si des fichiers dans le répertoire SVN sont plus récents que les vôtres, les copies du répertoire sont automatiquement télé chargées sur votre site.

Un des outils les plus faciles à utiliser est Tortoise. Pour les utilisateurs sous Windows, il vous suffit d'aller à http://tortoisesvn.net/ La page de téléchargements est ici http://tortoisesvn.net/downloads. Toutes les instructions sont disponibles ici.

Tortoise SVN est utilisable avec Windows 2000 et Windows XP. Il n'y a pas de besoin de s'identifier sur le site de
SourceForge pour utiliser cette méthode.

==Utiliser SVN==

Le processus SVN utilise quelques petits fichiers de contrôle qui comparent les données que vous avez dans vos fichiers avec ceux du répertoire SVN. S'il n'existe aucun écart, il n'y a alors pas besoin de mise à jour. S'il existe des écarts, il y a alors besoin d'une mise à jour. I

Ces petits fichiers sont installés dans un répertoire (".svn") sur votre système. Mais les répertoires peuvent représenter un inconvénient quand il vient à occuper tout l'espace d'installation de PhpGedView – et a besoin d'être enlevé de cet espace avant d'être téléchargé sur le serveur.

Plutôt que de fournir ici une longue liste, tapez dans Google '.svn delete' ou 'supprimer subversion' et vous trouverez beaucoup de références pour Linux, Mac et Windows.

[[en:Installation Guide]]

Guide d'installation

2007-08-29T07:36:55Z

Papagolf : /* Ce dont vous aurez besoin */

=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 sur 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”

[[Image:Filezilla.png|center|450px|thumb|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…”

[[Image:attributs.png|center|300px|thumb|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 :

[[Image:Config_phpgedview.png|center|450px|thumb|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.

[[Image:Config_phpgedview1.png|center|375px|thumb|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.

[[Image:Liste_gedcom_chargés.png|center|550px|thumb|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.)

[[Image:Configuration_gedcom.png|center|450px|thumb|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.

[[Image:Familletintin.png|center|450px|thumb|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.

[[Image:Import_gedcom.png|center|550px|thumb|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.

[[Image:Dépassement_temps_exécution.png|center|550px|thumb|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.

[[Image:Import_terminé.png|center|250px|thumb|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".

==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):

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
|-
| 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:

{| class="wikitable" style="margin: 2em auto 2em auto" table border="1"
<center>pgv_blocks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_dates</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_families</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_favorites</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_individuals</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_media_mapping</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_messages</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_names</center>
|-
| 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é
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_news</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_next_id</center>
|-
| ni_id INT(11) ||
|-
| ni_type VARCHAR(30) ||
|-
| ni_gedfile INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_other</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_placelinks</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_places</center>
|-
| 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
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_remotelinks</center>
|-
| r_gid VARCHAR(255) ||
|-
| r_linkid VARCHAR(255) ||
|-
| r_file INT(11) ||
|}
{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_sources</center>
|-
| 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
|}

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
<center>pgv_users</center>
|-
| 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:

{| class="wikitable" style="margin: 1em auto 1em auto" table border="1"
| 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.

==Sauvegarde==

Note: Si vous voulez utiliser la fonction de sauvegarde de l’utilitaire “Upgrade” de PhpGedView vous devez ou bien modifier les permissions du répertoire "phpgedview" en écriture, ou bien créer un répertoire nommé "sauvegarde" en lui donnant des permissions d’écriture. Les permissions d’écriture pour le répertoire "phpgedview" peuvent être remises en lecture seule aussitôt que le répertoire « sauvegarde » est en place et dispose des permissions d’écriture appropriées.

Avec la fonction de sauvegarde dans le menu d’administration, vous pouvez réaliser une sauvegarde de tous les fichiers importants de PhpGedView. Avec cette fonction de sauvegarde, il est possible de reconstruire votre site PhpGedView à l’état qu’il avait au moment de la sauvegarde.

La sauvegarde peut contenir les fichiers suivants, qui peuvent être choisis sur la page de sauvegarde :
- config.php avec tous les paramètres de configuration de votre installation
- tous les fichiers GEDCOM qui étaient présents dans votre installation
- toutes les options GEDCOM et les paramètres de confidentialité pour les fichiers ci-dessus
- les compteurs et les fichiers de log de PhpGedView
- les définitions et les options de l’utilisateur (définitions des blocs, favoris, messages et nouvelles)

Les fichiers peuvent être regroupés dans un fichier ZIP, qui peut être téléchargé en cliquant sur le lien qui se trouve sur la page.

Note: La base de données elle-même ne sera pas incluse dans la sauvegarde, parcequ’elle peut être reconstituée à partir des fichiers qui ont été sauvegardés.

Note: Toutes les modifications en attente (non approuvées ou sur le point d’être rejetées par l’administrateur) seront présentes dans les fichiers GEDCOM mais ne peuvent plus être identifiées comme des modifications. Si la base de données est reconstituée en utilisant ces fichiers GEDCOMs, ces changements ne peuvent plus être rejetés.

Note: Si vous avez installé votre répertoire index à l’extérieur du répertoire racine de votre serveur web, les références à quelques-uns des fichiers du zip incluront des chemins de répertoires de la forme "../". Quelques utilitaires zip (par exemple la capacité native de zip dans Windows XP de Windows Explorer) ne supporte pas ce type de chemin de fichier. Vous pouvez avoir besoin d’un outil qui supporte ce type de chemins. WinRAR est un de ces outils.

La fonction de sauvegarde utilise la bibliothèque PclZip, qui a été écrite par Vincent Blavet et qui peut être trouvée ici : http://www.phpconcept.net/pclzip.

==Intégration de PostNuke et PHPNuke ==

PhpGedView peut s’intégrer avec PostNuke et phpNuke afin que les utilisateurs n’aient pas besoin de s’identifier deux fois.

Une fois que PhpGedView est lancé, vous devez suivre les instructions du fichier readme.txt file qui se trouve dans le répertoire "pgvnuke".

Les fichiers qui rendent cette intégration possible ont été donnés par Jim Carey.

==Langages==

Note: si vous voulez utiliser les fonctions de langues vous devrez établir des permissions d’écriture pour tous les fichiers qui sont presents dans le repertoire "langages”.

PhpGedView a été construit pour pouvoir supporter de multiples langues. PHP ne supporte pas l’unicode (UTF-16). Il supporte l’UTF-8 et ce format est celui qui est recommandé pour encoder les fichiers GEDCOMs avec PhpGedView. Si vous avez des caractères dans votre fichier GEDCOM qui ne sont pas dans l’alphabet standard ASCII, vous devrez probablement utiliser l’encodage UTF-8. Il y a beaucoup de differences entre les formats UTF-8 et UTF-16, mais tout ce que vous encodez au format UTF-16 peut être encodé au format UTF-8. Il est également très facile de convertir de l’Unicode en UTF-8. Il vous suffit d’ouvrir votre fichier Unicode GEDCOM avec Windows Notepad et de choisir "Fichier->Enregistrer sous.." dans le menu et de choisir UTF-8 comme option d’encodage. Vous ne devriez perdre aucun caractère en effectuant cette traduction de format.

Les discussions et les questions sur les multiples fonctionnalités de langages de PhpGedView, traductions comprises, doivent être postées dans le forum “Translations” qui se trouve sur la page web du projet de PhpGedView ici:
http://sourceforge.net/forum/forum.php?forum_id=294245

Pour traduire PhpGedView dans une autre langue qui n'est pas actuellement supportée vous devez d'abord vous connecter à PhpGedView en tant qu' administrateur et aller ensuite à l'utilitaire d'édition des langues en cliquant sur "Administration-> Ajouter fichiers et paramètres pour une nouvelle langue". Choisissez votre nouvelle langue à partir du menu déroulant et cliquez sur le bouton « ajouter une nouvelle langue ».

Une fenêtre popup apparaît alors vous permettant d'éditer les paramètres par défaut de votre nouvelle langue. Chaque paramètre dispose d'une aide en ligne en cliquant sur le "?". Vous pouvez vouloir examiner les paramètres de quelques-uns des autres langages sur la page de configuration des langues, puis en cliquant sur « éditer », pour voir comment ils sont configurés.

Quand vous avez fini de paramétrer votre nouvelle langue, cliquez sur le bouton “sauvegarde”. Cela créera un nouveau fichier lang_settings.php dans le répertoire index. Vous remarquerez que votre nouvelle langue apparaît maintenant dans la liste des langues supportées.

Créez ensuite une copie des fichiers "configure_help.en.php", "facts.en.php", "help_text.en.php", et "lang.en.php" qui se trouvent dans le répertoire "langages" et changez la partie "en" qui est dans le nom de ces fichiers afin d'y mettre à la place les deux lettres du code correspondant à votre nouvelle langue.

Le fichier "facts" contient toutes les traductions des différentes balises (ou tags) du standard GEDCOM telles que BIRT = Birth. Le fichier "lang" contient toutes les différentes langues utilisées par le site. Les fichiers "configure_help.en.php" et "help_text.en.php" fournissent les instructions de configuration et d'aide.

Vous pouvez traduire ces fichiers en utilisant l'utilitaire d'édition de fichiers de traduction, qui est accessible en cliquant sur “Editer le contenu des fichiers de traduction ». Sélectionnez votre langue à partir de la liste déroulante puis choisissez le fichier que vous voulez éditer et cliquez sur le bouton “Editer”. Votre fichier sera comparé au fichier en anglais afin que vous puissiez facilement traduire les fichiers en ligne.

Vous pouvez aussi traduire des fichiers manuellement en les ouvrant avec un éditeur de texte. Si vous éditez manuellement des fichiers, vous devez les sauvegarder au format UTF-8. Quelques éditeurs de texte tels que Windows Notepad ajoutent un marqueur 3-byte Byte-Order-Mark (BOM) aux fichiers qui sont sauvegardés au format UTF-8. PHP n'aime pas les marqueurs BOM et ils doivent être supprimés avant de tester le fonctionnement de ces fichiers dans PhpGedView. La section des outils de traduction de PhpGedView' a un programme utilitaire pour supprimer ces a BOMs.

Vous devez récupérer un drapeau correspondant à votre langue à partir du fichier http://w3f.com/gifs/index.html er le dimensionner pour qu'il ait la même taille que les drapeaux qui sont dans le répertoire images/flags.

Pour aider au support des langues, un fichier log des modifications de langues existe dans le répertoire langages. Ce fichier log est dénommé LANG_CHANGELOG.txt. Toutes les modifications aux fichiers de langue anglaise sont enregistrés ici.

Si vous effectuez une nouvelle traduction de PhpGedView ou si vous mettez à jour une autre traduction, et que vous voulez en faire profiter la communauté, postez vos fichiers de langues ainsi que votre fichier index/lang_settings.php dans la section Patches section du site web du projet SourceForge ici: http://www.sourceforge.net/projects/phpgedview

==Fichiers d'extension de langues==

Les fichiers d'extension de langues sont des fichiers PHP courants que vous pouvez utiliser pour créer vos propres extensions de langue pour PhpGedView. Pour ajouter un fichier d'extension de langue, créez un nouveau fichier PHP dénommé lang.xx.extra.php en remplaçant le "xx" par le code de la langue que vous voulez ajouter. Ces fichiers ne sont pas inclus automatiquement dans le paquet logiciel PhpGedView afin que lorsque vous les mettez à jour, vos extensions ne soient pas écrasées.

Si ce fichier existe pour la langue que vous avez choisie, c'est la dernière chose qui est chargée avant que l'affichage n'apparaisse. Ces fichiers ont été conçus pour être des extensions des fichiers de langue, mais vous pouvez facilement les utiliser pour faire en sorte que les changements de paramètres soient basés sur la langue choisie.

Quelles sont les différentes actions que l'on peut entreprendre avec ces fichiers d'extension de langues?
- Adapter tout ou partie du texte qui apparaît à l'écran,
- Modifier les options de configuration qui sont basées sur la langue,
- Basculer sur un nouveau GEDCOM quand quelqu'un visualise votre site dans une langue différente.

Les seuls paramètres que vous ne devez pas modifier dans ce fichiers sont les paramètres de confidentialité.

Si, par exemple, vous voulez changer le titre du GEDCOM quand vous changer la langue, vous pouvez changer le titre pour chaque langue en ajoutant la ligne suivante dans votre fichier lang.xx.extra.php:
$GEDCOMS["surname.ged"]["title"] = "Titre en chinois";

Dans ce fichier vous pouvez aussi changer le texte sur les boutons:
$pgv_lang["view"]="Montrer";

Avec ce fichier vous pouvez aussi changer le GEDCOM qui apparaît quand la langue est sélectionnée. Supposons que vous avez un GEDCOM qui était en allemand et un autre qui était en anglais. Dans le fichier lang.de.extra.php vous pouvez ajouter les lignes suivantes:
if ($GEDCOM=="english.ged") {
header("Location: $SCRIPT_NAME?$QUERY_STRING&ged=german.ged");
exit;
}

Ces lignes signifient que si nous utilisons des fichiers en langue allemande, mais que nous utilisons le GEDCOM anglais, alors nous devons recharger la page avec le GEDCOM allemand. Vous devez recharger la page afin que les paramètres de configuration du GEDCOM soient chargés. Cela suppose que vous importé les deux fichiers "english.ged" et "german.ged" dans la base de données et que les fichiers english.ged et german.ged contiennent les mêmes personnes, mais dans des langues différentes.

Ainsi I0001 dans le fichier english.ged doit correspondre au même I0001 dans le fichier german.ged.

=PhpGedView pour les plus avancés d'entre vous=

La plupart d'entre nous utilise des versions stables de PhpGedView, annoncées et disponibles sur les pages principales de http://www.SourceForge.net/PhpGedView.

Mais il y a toujours des développements dans le tuyau. Ces développements peuvent prendre deux formes – les patches (et vous y trouverez des correctifs de temps à autres face à des bugs signalés) et des scripts non certifiés – souvent référencés comme des "subversions" - en raccourci, SVN. Et vous trouverez des références aux "revision control", qui est le même concept.

Les “subversions” SVN sont faites pour quiconque est impliqué dans le développement et le test de logiciels libres (open source). La rubrique SVN est le répertoire dans lequel toutes les subversions actuelles sont stockées. Ce sont les éditeurs/éditeurs de scripts/programmeurs/etc qui travaillent sur les modifications, qui sont autorisés à travailler sur ce répertoire. Puis il y a les utilisateurs/testeurs/ « leading edgers », qui ont téléchargé le logiciel depuis ce répertoire dans leur espace de travail.

Cette description de SVN est très succincte – mais est peut-être suffisante pour que vous y manifestiez un intérêt.

==Gérer les SVN==

Une copie exhaustive de PhpGedView contient environ 3300 fichiers. Pour garder ce nombre de fichiers important à jour avec les copies les plus récentes dans le répertoire SVN, il faut de l'assistance. C'est pourquoi il y a quelques outils qui peuvent examiner les fichiers que vous avez déjà, et qui les comparent avec ceux qui sont dans le répertoire SVN. Si des fichiers dans le répertoire SVN sont plus récents que les vôtres, les copies du répertoire sont automatiquement télé chargées sur votre site.

Un des outils les plus faciles à utiliser est Tortoise. Pour les utilisateurs sous Windows, il vous suffit d'aller à http://tortoisesvn.net/ La page de téléchargements est ici http://tortoisesvn.net/downloads. Toutes les instructions sont disponibles ici.

Tortoise SVN est utilisable avec Windows 2000 et Windows XP. Il n'y a pas de besoin de s'identifier sur le site de
SourceForge pour utiliser cette méthode.

==Utiliser SVN==

Le processus SVN utilise quelques petits fichiers de contrôle qui comparent les données que vous avez dans vos fichiers avec ceux du répertoire SVN. S'il n'existe aucun écart, il n'y a alors pas besoin de mise à jour. S'il existe des écarts, il y a alors besoin d'une mise à jour. I

Ces petits fichiers sont installés dans un répertoire (".svn") sur votre système. Mais les répertoires peuvent représenter un inconvénient quand il vient à occuper tout l'espace d'installation de PhpGedView – et a besoin d'être enlevé de cet espace avant d'être téléchargé sur le serveur.

Plutôt que de fournir ici une longue liste, tapez dans Google '.svn delete' ou 'supprimer subversion' et vous trouverez beaucoup de références pour Linux, Mac et Windows.

[[en:Installation Guide]]