Ce guide couvre les espaces membres, l’administration du site et la démonstration. Les liens « Démonstration » et « Guide d’utilisation » se trouvent dans GFam, dans la liste des extensions, dans les espaces personnels et dans le pied de page.
Un ZIP à installer dans WordPress
- Connectez-vous à l’administration WordPress avec un compte administrateur.
- Ouvrez Extensions → Ajouter une extension → Téléverser une extension.
- Sélectionnez gfam-genealogie-1.1.0.zip, sans le décompresser.
- Cliquez sur Installer maintenant, puis Activer.
- Dans le nouveau menu GFam, cliquez sur Voir l’accueil ou Ouvrir l’administration en front-end.
Prérequis : WordPress 6.4 ou supérieur, PHP 8.0 ou supérieur, API REST accessible et tables InnoDB. Le code du plugin est inclus dans le ZIP ; aucune compilation ni clé API n’est nécessaire.
Mettre à jour une version déjà installée
Téléversez le nouveau ZIP depuis Extensions → Ajouter une extension. Lorsque WordPress reconnaît GFam, choisissez Remplacer l’extension actuelle par celle téléversée. Les arbres et les comptes sont conservés. Une sauvegarde normale du site permet de revenir en arrière si nécessaire.
Un espace prêt à accueillir les familles
| Page créée | Fonction | Shortcode |
|---|---|---|
| Accueil famille | Présentation et accès à la création du compte | [gfam_home] |
| Mon espace | Tableau de bord et navigation personnelle | [gfam_dashboard] |
| Mon arbre généalogique | Ouverture directe de l’arbre interactif | [gfam_tree] |
| À propos | Présentation et informations de confidentialité | [gfam_about] |
| Connexion | Connexion et mot de passe oublié | [gfam_login] |
| Créer un compte | Inscription des membres | [gfam_register] |
| Administration familles | Gestion du site et des membres | [gfam_admin] |
Le menu GFam — Navigation contient Accueil, Mon arbre et À propos. L’icône du compte ouvre les liens de connexion, d’inscription ou de l’espace personnel.
L’accueil principal et les menus existants de votre site sont conservés. Pour utiliser GFam comme accueil principal, ouvrez Réglages → Lecture et choisissez Accueil famille. Pour modifier le menu, ouvrez Apparence → Menus ; avec un thème de blocs, utilisez au besoin l’écran classique /wp-admin/nav-menus.php.
Pour intégrer un écran dans une autre page, ajoutez son shortcode. Utilisez un seul écran GFam par page. Le cadre complet des pages automatiques peut être désactivé dans les réglages GFam afin d’utiliser votre thème.
Chaque membre retrouve son arbre
- Depuis l’accueil, cliquez sur Commencer mon arbre, ou utilisez l’icône du compte.
- Renseignez le nom affiché, l’e-mail et un mot de passe d’au moins 10 caractères.
- Validez l’information sur la conservation des données, puis créez le compte.
- Le membre est connecté et arrive dans son espace personnel. Le compte WordPress créé est un abonné.
À chaque reconnexion depuis la page GFam, le membre revient à son tableau de bord. Le plugin utilise les comptes WordPress ; un compte WordPress existant peut également se connecter.
Commencez par vous, puis reliez les générations
- Cliquez sur Créer ma première fiche. La première personne devient la référence Moi.
- Renseignez au minimum le prénom. Les noms, dates, lieux et notes peuvent être complétés ensuite.
- Ouvrez la fiche et utilisez Père, Mère, Conjoint(e), Fils ou Fille.
- Depuis la fiche d’un parent, ajoutez ses propres parents pour remonter les générations.
- Depuis un enfant, ajoutez son conjoint et ses enfants pour développer les descendants.
Relier une personne déjà présente
Ouvrez une fiche puis cliquez sur Relier une fiche existante. Choisissez l’autre personne et son rôle. Pour un enfant ayant deux parents, créez les deux liens séparément. Une même personne n’a qu’une fiche, même si plusieurs branches se rejoignent.
Frères, sœurs et cousins
Reliez les frères et sœurs aux mêmes parents. Pour les oncles et tantes, ajoutez les autres enfants des grands-parents. Ajoutez ensuite leurs enfants : les cousins apparaissent automatiquement dans Mes cousins lorsqu’un ancêtre commun est connu.
Le calcul porte sur les liens enregistrés, par rapport à la fiche Moi. Le degré est généalogique : cousin germain = degré 1 ; ce n’est pas un degré juridique de parenté. Les conjoints et les frères/sœurs ne sont pas classés comme cousins.
Plusieurs unions et autres parents
Vous pouvez enregistrer plusieurs unions, une ancienne union et plusieurs liens génériques Parent. Les rôles Père et Mère sont chacun uniques par enfant ; pour une autre situation de filiation, utilisez Parent. La v1 ne distingue pas encore la filiation biologique, adoptive et tutélaire.
Un grand arbre reste navigable
| Commande | Utilisation |
|---|---|
| Clic sur une personne | Ouvrir sa fiche, son histoire et ses liens. |
| Déplacer le schéma | Cliquer-glisser avec la souris ou faire glisser au doigt. |
| Zoom | Utiliser + / −, la molette ou le pincement sur un écran tactile. |
| Adapter à l’écran | Recentrer et réduire le dessin pour afficher la vue complète. |
| Vue | Toute la famille, mes ancêtres ou mes descendants. |
| Profondeur | Nombre de générations autour de Moi. 0 affiche tout. Les unions ne comptent pas comme une génération. |
| Petit − sous une fiche | Replier ses descendants ; le + permet de les retrouver. |
| Déplier toutes les branches | Annuler tous les replis de la vue. |
| Recherche | Mettre en évidence une personne dans la vue actuelle. |
| Plein écran | Agrandir la zone de l’arbre si le navigateur le permet. |
Au clavier, les fiches sont accessibles avec Tab puis Entrée ou Espace. Dans la zone du schéma, + / − contrôlent le zoom, 0 recentre et les flèches déplacent la vue.
Le plugin ne fixe aucun plafond de générations. Cette version charge l’ensemble de l’arbre : les ressources du serveur, la mémoire du navigateur et le nombre de fiches déterminent la taille réellement exploitable.
Gérez les membres depuis le front-end
Connectez-vous avec votre compte administrateur WordPress, puis ouvrez Administration familles depuis l’icône de compte ou depuis le menu GFam de WordPress. Le droit manage_options est requis ; aucun compte administrateur supplémentaire n’est créé.
- Membres : recherche, liste paginée, compte, arbre et nombre de personnes.
- Créer un membre : nom, e-mail et mot de passe initial ; aucun e-mail n’est envoyé automatiquement.
- Modifier : nom et e-mail d’un membre GFam.
- Suspendre : ferme ses sessions WordPress et bloque son accès GFam, sans supprimer l’arbre.
- Réactiver : rétablit l’accès.
- Réglages : nom du site, phrase d’accueil, ouverture des inscriptions et présentation complète GFam.
Les comptes administrateurs sont protégés et ne se modifient pas depuis cette liste. La page d’administration montre les informations de gestion et les compteurs ; elle ne propose pas de consulter les fiches familiales des autres utilisateurs.
Exports, confidentialité et sauvegardes
JSON : export des personnes, des liens et des paramètres de l’arbre. SVG : export du dessin de la vue affichée, ouvrable dans un navigateur ou un logiciel vectoriel. Les notes sont dans le JSON ; le SVG contient les informations visibles sur les cartes.
Cette première version ne propose pas de réimportation du JSON, d’import GEDCOM, de photographies, de PDF intégré ni d’édition partagée entre comptes. Effectuez également des sauvegardes normales de la base WordPress.
Les arbres sont privés dans l’application. Les responsables techniques et l’hébergeur peuvent accéder aux données du site ; GFam ne chiffre pas séparément les fiches. Obtenez l’accord approprié pour les informations sur les personnes vivantes et adaptez la politique de confidentialité du site.
Les outils WordPress Outils → Exporter les données et Outils → Effacer les données incluent les données familiales détenues par le compte associé à l’e-mail demandé. Une personne figurant dans la généalogie sans être titulaire du compte doit adresser sa demande au responsable du site, qui pourra retirer les fiches concernées.
La suppression d’un compte WordPress efface son arbre lorsque GFam est actif. La désactivation et la désinstallation du plugin conservent les arbres, les pages et les comptes. Gardez GFam actif lorsque vous utilisez ses outils d’effacement.
Les points à vérifier à l’installation
- HTTPS : activez le certificat du site.
- Cache : excluez toutes les pages GFam,
admin-post.phpet les routesgfam/v1des caches de page, de serveur et de CDN. Une page servie avant l’exécution de WordPress peut contourner les en-têtes anti-cache du plugin. - E-mails : configurez l’envoi WordPress pour le lien « Mot de passe oublié ».
- API REST : autorisez les routes
gfam/v1dans les éventuels plugins de sécurité. Les permaliens simples et personnalisés sont pris en charge. - InnoDB : les trois tables GFam doivent prendre en charge les transactions.
- Multisite : l’activation réseau est refusée ; installez le plugin séparément sur chaque site. La suppression réseau des utilisateurs n’est pas couverte par cette v1.
Si l’espace ne se charge pas
Rechargez la page pour renouveler la session. Vérifiez les exclusions de cache et l’accès à l’API REST. Si le formulaire d’inscription a expiré, rechargez la page avant de le remplir. Après trop de connexions échouées, attendez 15 minutes ; après trop d’inscriptions depuis la même adresse IP, attendez une heure.
Essayez GFam avant de créer votre arbre
La démonstration fournit une famille fictive sur cinq générations. Elle reprend les écrans du plugin : tableau de bord, arbre, fiches, proches, cousins, profil et administration.
- Ouvrez GFam → Démonstration depuis la liste des extensions ou les liens d’aide du plugin.
- Dans Espace membre, ouvrez « Mon arbre généalogique », zoomez et cliquez sur Marie, ses parents ou ses descendants.
- Utilisez Ajouter un proche, modifiez une fiche ou reliez une fiche existante. Retrouvez les cousins dans la rubrique dédiée.
- Choisissez Administration · simulation pour essayer la recherche, la création d’un membre fictif, la suspension et les réglages.
- Cliquez sur Réinitialiser la démo pour retrouver la famille d’origine.
Aucun compte WordPress réel n’est créé. Les données de la démonstration sont enregistrées uniquement dans le stockage local de ce navigateur lorsque celui-ci l’autorise. Elles sont séparées de vos arbres WordPress. En navigation privée ou si ce stockage est bloqué, les essais peuvent rester limités à la session.
Utilisez des noms, e-mails et mots de passe fictifs. Le bouton de réinitialisation efface seulement les essais de la démonstration. Les exports portent un nom contenant demo.
Le fichier demo.html fonctionne également hors ligne : téléchargez-le puis ouvrez-le dans un navigateur. Il contient l’interface, les exemples et une copie de ce guide. Sur le site installé, les ressources sont disponibles dans le dossier de GFam, sans connexion membre nécessaire.
Les réponses pour vos premiers essais
Où sont les nouveaux liens ?
Dans WordPress : Extensions → Extensions installées → GFam ou le menu GFam. Dans les espaces membres et administrateur : liens Démonstration et Guide d’utilisation sous la navigation. Sur les pages publiques : pied de page et boutons de l’accueil.
La démo exige-t-elle une inscription ?
Non. Le profil Marie et l’administration sont des simulations. L’inscription et la connexion réelles se testent sur les pages du plugin installé dans WordPress.
Je ne vois plus une personne dans l’arbre.
Sélectionnez « Toute la famille », remettez la profondeur à 0 et cliquez sur « Déplier toutes les branches », puis sur « Adapter à l’écran ». Une recherche peut aussi atténuer certaines cartes : effacez son contenu.
Comment corriger une filiation ?
Ouvrez la fiche, retirez le mauvais lien avec la petite croix, puis utilisez « Relier une fiche existante ». Les personnes ne sont pas supprimées lorsque vous retirez seulement un lien.
Comment lire le guide sans connexion ?
Ouvrez le fichier GUIDE.html téléchargé dans votre navigateur. Le bouton « Imprimer / PDF » utilise l’impression du navigateur, qui propose généralement « Enregistrer au format PDF ».
Que reste-t-il à ajouter dans de prochaines versions ?
Les photographies, l’import GEDCOM/JSON, le partage d’un arbre entre plusieurs comptes et des fonctions de collaboration ne font pas encore partie de cette version.
WordPress, sans dépendance distante
GFam s’appuie sur les comptes, les cookies de connexion, les nonces et les autorisations WordPress. Les ressources de l’interface sont embarquées dans le plugin.
Documentation officielle — authentification de l’API REST
Documentation officielle — tables d’un plugin
La version initiale est destinée à être testée sur votre installation avant son ouverture aux membres. Les changements futurs pourront compléter l’import, les médias et le partage familial.