Intégration dans un CMS

De PGVWiki
Aller à : navigation, rechercher

Système de gestion de contenu (ou CMS: Content Management Systems)

PhpGedView a été intégré dans divers Content Management Systems (CMS). Wikipedia nous dit ce qu'est un système_de_gestion_de_contenu. Il est possible d'intégrer PhpGedView dans ce type de système assez facilement. Il existe par ailleurs de nombreux paquets CMS disponibles.

CMS offre la possibilité de créer facilement un site web sans avoir besoin de connaître avec précision le language html. Les CMS sont conçus pour faciliter l'intégration d'autres morceaux de logiciels afin de fournir un site web modularisé - vous ajoutez ce que vous voulez. Les premiers facteurs à prendre en compte pour une intégration dans un CMS sont l'authentification de l'utilisateur (login et processus d'enregistrement) et l'intégration d'un thème/maquette. Les paquets CMS peuvent utiliser des sélectionneurs de thèmes/maquettes, similaires à ceux utilisés par PGV, qui permettent une modification rapide de l'esthétique de votre site web tout en conservant le contenu inchangé.

Cette page contient les informations sur "comment" intégrer PGV dans un CMS et fournit des liens vers des sites qui utilisent des logiciels adéquats.

Joomla!

Joomla est un rejeton du projet original [Mambo] et les deux produits sont très similaires.

Joomla! utilise des composants et des modules qui permettent d'éjouter un site web. Beaucoup de composants et de modules ont été écrits pour pouvoir être ajoutés sur les composants de base de Joomla. Ils s'ajoutent à votre site Joomla! par l'intermédiaire d'un système de menu qui rend très facile la modification de votre site. Joomla! possède un certain nombre de composants/modules qui font partie intégrante du logiciel. Vous pouvez choisir de ne pas les utiliser mais il est conseillé de ne PAS supprimer les composants/modules par défaut du système car une réinstallation complète de Joomla sera alors nécessaire pour les restaurer - cela inclut la suppression de votre base de données MYSQL et donc le contenu de votre site à moins que vous ne soyez familier avec MYSQL (prenez garde à l'experience).


Modifier le thème de PGV pour une intégration dans Joomla

Depuis la version 4 de PhpGedView, les rubriques de la barre de menu items sont appelées par le fichier header.html qui est localisé dans votre répertoire PhpGedView/theme. Lorsque vous décidez d'intégrer PhpGedView dans un système de management de contenu (CMS) vous souhaitez en règle générale que les rubriques du menu n'apparaissent que si la personne s'est authentifiée. Celà s'applique en particulier à phpGedView. Cette option est tout à fait réalisable si vous décidez d'intégrer PhpGedView dans Joomla, en utilisant les composants développés par Ron Fields pour PGV. Il suffit d'utiliser les lignes de code suivantes dans le fichier header.html ou le fichier header.php dans la partie de ce fichier qui concerne la rubrique du menu pour laquelle vous ne souhaitez un accès qu'aux seuls les utilisateurs authentifiés dans Joomla:-

  $uname = getUserName();
    if (! empty($uname)) {
     la rubrique du menu se trouve à cet endroit
    }

La ligne commençant par $uname n'a besoin d'être présente qu'une seule fois si vous choisissez de l'utiliser pour plusieurs rubriques du menu. Même si une personne se rend directement sur PGV, http://votresite.exemple/phpgedview les rubriques du menu ne s'afficheront pas.

La rubrique du menu ne s'affichera que si la personne s'est authentifiée dans Joomla.

Ce qui est décrit précédemment n'a pas été testé avec d'autres intégrations mais je ne vois pas pourquoi cela ne fonctionnerait pas.

Composants/Modules

Composant PhpGedView

Il exsite un composant com_gedview qui a été développé pour intégrer PhpGedview avec Joomla!. Ce composant a été développé par Ron Field et Veit Olschinski. La dernière version 1.3 se trouve ici.

Le composant com_gedview permettra uax utilisateurs authentifiés d'être automatiquement enregistrés dans phpGedView (en fonction des paramètres définis par l'administrateur de PhpGedView).

Pour que le composant com_gedview puisse fonctionner, vous devez tout d'abord installer PhpGedView dans un répertoire qui se trouve dans le même domaine que Joomla et le configurer pour votre système. Pour intégrer PhpGedView à Joomla vous devez installer ensuite le composant par l'intermédiaire du menu et le configurer en fonction des paramètres de votre système.

Erreur lors de la création de la miniature : Fichier manquant
Cliquez pour agrandir l'image de la configuration du composant

Testé avec Joomla! 1.5.5, PhpGedView 4.1.5 et com_gedview 1.3.

Procédure pratique d'installation

Voici de manière détaillée, le processus d'installation décrit par un membre du forum francophone de PhpGedView (http://courbois.phpnet.org/phpBB3/viewtopic.php?f=37&t=530&p=3147&hilit=joomla#p3147)

Coupler Joomla & PhpGedView
+ Version:
Joomla - Version Joomla_1.5.7-Stable-Full_Package-French.v2
PhpGedView - Version 4.1.5
mod_jbgedview - Version mod_jbgedview_3.0_j15
com_gedview - Version com_gedview_1.3.zip
+ Nécessaire:
Joomla_1.5.7-Stable-Full_Package-French.v2.zip
PhpGedView-all-4.1.5.zip
mod_jbgedview_3.0_j15
com_gedview_1.3.zip
+ Installation:
1- Installer Joomla (www/joomla)
2- Installer PhpGedView (http://www.joomla/phpgedview)
3- Dans Joomla, connecté en tant administrateur:
+ Aller dans "Extensions > Installer/Désinstaller"
- Installer "mod_jbgedview"
- Installer "com_gedview"
+ Aller dans "Extensions > Gestion des modules"
>> Ajout du module MENU
- Cliquer sur "Nouveau"
- Sélectionner "Menu"
- Cliquer sur "Suivant"
- Donner un "Titre"
- Cliquer sur "Sauver"
>> Ajout du module JbGedView
- Cliquer sur "Nouveau"
- Sélectionner "jbgedview"
- Cliquer sur "Suivant"
- Donner un "Titre"
- Compléter "Paramètres du module" (Nom de la base, Nom de l'utilisateur, Mot de passe, Adresse de la base)
- Cliquer sur "Sauver"
>> Ajout du module Connexion
- Cliquer sur "Nouveau"
- Sélectionner "Connexion"
- Donner un "Titre"
- Cliquer sur "Sauver"
+ Aller dans "Menu > Gestion des menus"
- Cliquer sur l'icône "Modifier Eléments de menu"
- Cliquer sur "Nouveau"
- Sélectionner "phpGedView"
- Cliquer sur "Suivant"
- Donner un "Titre". Ex: Généalogie
- Donner un "Alias". Ex: genealogie
- Renseigner "GEDCOM Name": Nom du fichier GEDCOM configuré dans PhpGedView lors de l'installation. Ex: nomfamille.ged
- Renseigner "Individual ID": I1 (créer par défaut)
- Renseigner "CTYPE": Utilisateur (GEDCOM = Page PhpGedView avec l'utilisateur non connecté)
- Paramétrer "Hauteur automatique" sur Oui
- Cliquer sur "Sauver"
+ Aller dans "Composants > PhpGedView > Configure"
- Compléter l'adresse relative (ici Joomla/phpgedview/)
- Is User allowed to Admin? No
- Is user allowed to Edit? No
- Is user visible to other users? Yes
- Have user pre-verified? Yes
- Pre-verified by Admin? Yes
- Create Users turned on? Yes
- Default Gedcom file: Nom du fichier GEDCOM configuré dans PhpGedView lors de l'installation. Ex: nomfamille.ged
- Secret key: TRES IMPORTANT !! 
- Entrer un code, ce que vous voulez, 32 caractères maximun. Ex: JOOMLA_PHPGEDVIEW_CODE
- Aller dans le répertoire PhpGedView
- Modifier le fichier config.php avec un bloc note
- Ajouter une ligne $PGV_CMS_SECRET_KEY = "JOOMLA_PHPGEDVIEW_CODE";
- Enregistrer
- Cliquer sur "Sauver"
4- Dans PhpGedView, connecté en tant administrateur:
+ Aller dans "Mon Portail > Gérer les fichiers GEDCOM"
- Modifier "Fichier de configuration"
- Cliquer sur "Restriction d'accès"
- Paramétrer "Authentification obligatoire" sur Non
- Paramétrer "Texte de bienvenue sur la page de connexion" sur Aucun texte par défaut
- Cliquer sur "Sauvegarder la configuration"
Maintenant les utilisateurs que vous ajouterez seront automatiquement ajoutés à PhpGedView. Et lorsqu'ils se connecteront via Joomla et 
qu'ils cliqueront sur le menu "Généalogie", PhpGedView s'ouvrira et l'utilisateur sera logué.
Gallery 2

Gallery est un album photo électronique. Les composants/Mmodules qui doivent être intégrés dans Joomla ont été écrits et sont disponibles. Il exsite un composant qui permet l'integration de Gallery2 dans Joomla et actuellement, il existe deux modules – un module Sidebar (pour contrôler les actions de l'album et la navigation lorsque vous utilisez le composant Gallery 2) et un module Image aléatoire (qui permet d'afficher une image aléatoire de votre module Gallery 2 sur votre page d'accueil).

Pour la version de Joomla 1.5 les composants, modules, et plugins suivants sont disponibles (à la date d'octobre 2008) à partir du site joomlacode.org. Il faut noter qu'il s'agit de versions ALPHA:

  • com_g2bridge - le composant principal
  • mod_g2bridge_sidebar
  • mod_g2bridge_imageblock
  • plg_g2bridge_search
  • plg_g2bridge_user
  • plgcb_g2bridge_cb

Après avoir installé le composant Gallery2 Bridge vous devrez le configurer à partir du menu Composants -> Gallery 2 Bridge:

  • Gallery 2 Path: le chemin complet et le nom complet du fichier de Gallery 2 embed.php. Par exemple: /var/www/gallery2/embed.php
  • Gallery 2 URI: L'URI de l'installation native de Gallery 2. Par exemple: http://www.monsite.net/gallery2/
  • Login Redirect: L'URL pour afficher la page de login de Joomla login. Par exemple: /index.php?option=com_login
Dépots des Document/Fichiers

Ces modules vous permettront de partager et d'accepter des fichiers avec d'autres personnes. Cela peut vous aider dans vos recherches généalogiques etc... Exemples de ce type de module:

Livres d'or

Le livre d'or permet aux visiteurs de votre site de faire part de leurs impressions. Cette partie du site est victime du spamming, c'est pourquoi il est recommandé d'utiliser un composant qui fait appel à un processus de sécurité comme par exemple l'identification d'une image. Voici quelques exemples de ce type de composant:-

Accès des groupes

Une des limitations que j'ai trouvées avec Joomla est le nombre de groupes pouvant être créés pour restreindre/donner accès aux utilisateurs. Cette limitation va apparemment être modifiée lors d'une version ultérieure. Il y a des informations dont je veux restreindre l'accès aux seules personnes authentifiées (par exemple: rubriques du menu / blog personnel). J'ai été capable de limiter cet accès en utilisant un composant appelé "Accès des groupes". Ce composant eest accessible ici:

Group Access Download et my web site (il y a deux parties: un composant et un module; assurez-vous d'avoir téléchargé ces deux parties !).

Liste des composants

Un utilisateur Joomla a listé et catégorisé quelques composants/modules qui sont disponibles. Vous les trouverez ici

Exemples de sites utilisant Joomla et PhpGedView

Tous ces sites utilisent le même CMS mais utilisent différents modèles.

Le CMS CPG-Nuke Dragonflycms

Un module très basique permettant d'installer PhpGedView dans le CMS Dragonfly est disponible ici http://dragonflycms.org/Downloads_9x/details/id=284.html

Vous pouvez consulter un site web utilisant ce CMS et PhpGedView ici http://pretzy.dnsalias.com Ce module peut également être téléchargé depuis la rubrique Downloads de ce site.

Une deuxième version de ce module est en cours de développement qui intégrera un dispositif de single sign on.

PhpNuke et PostNuke

Avec la distribution PGV, il existe un répertoire pgvnuke pour intégrer PGV avec phpNuke et PostNuke. Il suffit de suivre les instructions qui sont dans le fichier postged-readme.txt pour obtenir plus d'informations.

Xoops

Séparé, mais suivant de près le projet PGV, PGVXooops est une version modifiée de PGV qui permet l'utilisation de sites web basés sur Xoops. Ce projet est disponible à phpGedView pour Xoops et permet d'intégrer PGV 3.3.8 dans Xoops 2.0.* en tant que module. L'integration originelle a été faite par Patrick Kellum pui a été ressucitée par Steve Kenow.

  • Il y a principalement deux avantages à utiliser cette intégration:
    1. L'utilisateur de la base de données est partagé entre les deux programmes.
      • Vous n'avez besoin que d'un seul login pour les deux programmes.
    2. PhpGedView n'est pas affiché à l'intérieur d'un Iframe.
      • Cela permet une meilleure indexation du moteur de recherche.
      • Il vous permet également de créer des signets des pages de PhpGedview.

Cependant, il exsite certains conflits. Cette intégration inclut les modifications de thèmes de PGV afin d'éliminer beaucoup de conflits avec les sélecteurs html et css de Xoops. Assurez-vous de bien utiliser les thèmes qui sont inclus.

Notes:

* ATTENTION! le module d'intégration de PGV dans Xoops n'est disponible que pour la version 3.3.8 ! la dernière mise à jour date du 10 
  novembre 2006 ! ce module ne fonctionnera donc pas avec les versions 4.1 de PGV !

Wordpress

Voir comment intégrer PhpGedView avec Wordpress

PGV avec un nouveau Menu

Vous pouvez aussi construire un nouveau menu pour afficher ce que vous souhaitez à l'intérieur de votre site, la méthode est expliquée dans ce tutoriel.