PROJET DE SYNTHESE Sujet n 7 Site Web du pôle multimédia de l'iut de Bayonne Pays Basque Manuel d installation et de maintenance (Document 4/5) Loïc ARMAND Tuteurs : Kevin LEVRON Grégory BIANCO Philippe ROOSE Julien DEJEAN Guillaume JOLY Frédéric RAZAKARIVONY Année Universitaire 2007-200
Objet du document : Rapport d installation et maintenance Tuteurs : Kevin LEVRON, Philippe ROOSE Dernière mise à jour : 25 mai 2008 Indice de révision du document : 03 Version de l application : V1 Version de l application Indice de révision Date Objet V1 01 16 mai 2008 Création du document 02 17 mai 2008 03 25 mai 2008 Rédaction du document et Mise en page Finalisation du document 2
SOMMAIRE INSTALLATION 4 I Configuration nécessaire 5 1 ) Serveur 5 2 ) Poste client 5 II Déploiement du CMS 5 1 ) Installation de Drupal 5.6 5 2 ) Mise en place du Multi-sites 6 3 ) Création du thème 8 4 ) Mise en place des modules additionnels 9 II Arborescence 10 MAINTENANCE 12 I. Modules 13 1 ) Les actualités 13 2 ) Offre de stages et d emplois 13 3 ) Prêt de matériel 14 4 ) Galerie de travaux 15 5 ) Consultation de cours 15 6 ) LDAP 16 7 ) Trombinoscope 16 8 ) Menus et bandeaux «flash» 19 II. Rôles des utilisateurs 22 1 ) Ajout d un rôle 22 2 ) Attribution des droits d accès aux rôles : 22 3 ) Suppression d un rôle 23 4 ) Attribuer un rôle à un utilisateur 23 3
INSTALLATION 4
I Configuration nécessaire 1 ) Serveur Le site nécessite d être déployé sur un serveur Web Apache sous Unix. Le php version 4 et plus doit être installé sur le serveur afin que le CMS (Système de Gestion de Contenu) Drupal puisse être exploité. Un système de gestion de base de données MySQL doit être disponible pour l installation et le fonctionnement du CMS. Toutefois, d autres combinaisons peuvent être possibles mais peuvent engendrer des erreurs de compatibilités lors d ajout de modules additionnels. 2 ) Poste client Le site est optimisé pour les navigateurs Web Internet Explorer 7.0 et Mozilla Firefox 2.0. II Déploiement du CMS 1 ) Installation de Drupal 5.6 Après téléchargement du CMS (disponible à l adresse http://drupal.org/node/208594 ), décompresser l archive et mettre le contenu sur le serveur Web. Utiliser l installeur (fichier install.php) qui s exécute en ligne. 5
Manipulations (exemple réalisé dans le cadre de notre projet ): - Saisie du type de Base de données : «MySQL». - Saisie du nom de la base de données : «projl087» (base de données créée au préalable). - Saisie du nom de l utilisateur : «projl087». - Saisie du mot de passe : «projl087». Après la validation, l'installeur va créer les tables dans la base de données, et remplir automatiquement les paramètres de départ. 2 ) Mise en place du Multi-sites Pour mettre en place un système de Multi-sites avec Drupal, des manipulations doivent être effectuées avant d exécuter l installeur. Ainsi : a) Se rendre dans le dossier «sites» et créer des sous dossiers sur la base du répertoire «default» Ces sous dossiers correspondront aux sous-sites et doivent porter une nomenclature spécifique : Syntaxe du nom des sous dossiers : - Préfixe : iparla.iutbayonne.univ-pau.fr.~projl087.*** - Suffixe : DUT_INFO ou LP_SIL b) Modifier le fichier «setting.php» de chaque sous dossiers afin de spécifier les tables qui seront partagées par tous les sous sites. Manipulations : Modifier la variable de connexion à la base de données : On remplace «$db_url = 'mysql://username:password@localhost/databasename';» par «$db_url = 'mysql://projl087: projl087@localhost/projl087 ;» Modifier la variable contenant les préfixes des tables suivant la nomenclature : - shared_ : pour les tables partagées ; - «nomsousdossier _» : pour les tables propre à chaque site. 6
Aspect du setting.php pour la page d accueil : «$db_url = 'mysql://projl087:projl087@localhost/projl087'; $db_prefix = array( 'default' => 'ACCUEIL_', 'stage' => 'shared_', 'emploi' => 'shared_', 'entreprise' => 'shared_', 'ldapauth' => 'shared_', 'users' => 'shared_', 'sessions' => 'shared_', 'role' => 'shared_', 'authmap' => 'shared_', 'sequences' => 'shared_', 'profile_fields' => 'shared_', 'profile_values' => 'shared_', 'users_roles' => 'shared_', 'vocabulary' => 'shared_', 'view_argument' => 'shared_', 'view_exposed_filter' => 'shared_', 'view_filter' => 'shared_', 'view_sort' => 'shared_', 'view_tablefield' => 'shared_', 'view_view' => 'shared_', );» c) Créer les liens symboliques qui pointent sur les différents sous sites. Commande : «ln-s drupal-5.6 ACCUEIL» et réitérer pour chaque sous site. 7
3 ) Création du thème Les thèmes sont situés dans le répertoire /themes de l installation Drupal. Pour sa création, partir d un thème existant à modifier. Thème de base pour le portail du «pôle multimédia des formations en informatique» : Bluemarine.Faire une copie du répertoire bluemarine et la renommer : ACCUEIL pour le portail. Puis modifier les fichiers liés au thème : block.tpl.php : template pour afficher un bloc box.tpl.php : template pour afficher une boîte comment.tpl.php : template pour afficher un commentaire logo.png : image correspondant au logo node.tpl.php : template pour afficher un node page.tpl.php : template pour afficher une page screenshot.png : image correspondant à l'aperçu du thème visible sur «administer themes» style.css : feuille de styles CSS ATTENTION : Réitérer ces manipulations pour chaque sous site. Le but est d avoir un thème spécifique à chaque sous site (code couleur ). 8
4 ) Mise en place des modules additionnels a) LDAPIntegration Module gérant les connexions aux annuaires LDAP. Manipulation : Décompressé le module dans le répertoire «module» du dossier d installation de Drupal. Editer et configurer le module via la console d administration en ligne : «Administrer» -> «Modules» -> cocher «LDAP» b) Meta Tags : Module aidant au référencement du site.* Manipulation : Décompressé le module dans le répertoire «module» du dossier d installation de Drupal. Editer et configurer le module via la console d administration en ligne : «Administrer» -> «Modules» -> cocher «Meta Tags» Une fois activé, on saisit la liste des mots clés qui seront insérés dans les balises < meta>. c) Shared Sign-on : Module permettant la mise en place d un SSO simplifié (une seule authentification pour les différents sites). Manipulation : Décompressé le module dans le répertoire «module» du dossier d installation de Drupal. Editer et configurer le module via la console d administration en ligne : «Administrer» -> «Modules» -> cocher «Shared Sign-on» 9
II Arborescence Le dossier bandeaux : Il contient les bandeaux Flash, spécifique à chaque sous site. Le dossier includes : Il contient les fichiers php ou autres appelés par Drupal. Il contient également les différentes fonctionnalités que nous avons développées. Le dossier modules : Il contient les modules utilisés par Drupal. C est ici que sont déposés les modules additionnels. Un module est une fonctionnalité prête à l emploi pour aider le développement du site. Ex : module LDAP, module de recherche. Le dossier sites : Il contient les sous-sites créés. Contenu du dossier «sites» du pôle multimédia des formations en informatique : 10
11
MAINTENANCE 12
I. Modules 1 ) Les actualités a) But Diffuser des informations concernant le pôle multimédia des formations en informatique. La dernière information postée est visible sur le portail et les sous-sites de chaque formation. Au clique sur le titre de cette dernière, un récapitulatif de toutes les actualités est visible. Ce module comprend également une fonctionnalité d ajout et de suppression d actualités. Seuls l administrateur, les responsables de communication et les responsables de formation, ont les droits d ajout et de suppression. //capture du bandeau b) Mise en place Ce module utilise une table nommée «shared_actu» située dans la base de données du site. Cette table est composée des champs suivants : - «num_actu» : clef primaire de la table, qui est unique et s auto-incrémente. C est à partir de cet attribut que l on réalise les tris (affichage de la dernière actualité postée). - «titre_actu» : c est à partir de cet attribut que l on établit le lien sur le récapitulatif des actualités. - «contenu_actu» : attribut contenant l information. Rappel : Les tables préfixées par «shared_» sont celles partagées par tous les sous-sites. c) Conditions d ajout et de suppression Seuls l administrateur, les responsables de communication et les responsables de formation, ont les droits d ajout et de suppression. L ajout ou la suppression d une actualité se fait via un formulaire. Ces rubriques sont accessibles dans le sous-menu de l accueil, après l authentification des ayants droit. 2 ) Offre de stages et d emplois a) But Permettre aux entreprises de proposer des offres de stages et d emplois. Rendre les offres consultables par tous les utilisateurs authentifiés. b) Mise en place Ce module utilise trois tables de la base de données du site : 13
- La table «shared_emploi» qui recence tous les emplois postés. Elle est composée de : `num_emp`, `descriptif_emp`, `type_emp`, `date_emp`(debut), `sujet_emp`, `entreprise_emp`. - La table «shared_stage» qui recence tous les stages postés. Elle est composée de : `num_st`, `descriptif_st`, `aspect_st` (gestion de projet ), `environnement_st` (logiciels ), `sujet_st`, `entreprise_st`. - La table «shared_entreprise» qui recence toutes les entreprises. Elle est composée de : `num_ent`, `adresse_ent`, `codepostal_ent`, `ville_ent`, `activite_ent`, `effectif_ent`, `telephone_ent`, `mail_ent`, `siret_ent`, `nom_ent`. c) Conditions d ajout d offres de stage et d emplois Après s être enregistrée, une entreprise a la possibilité dans une deuxième étape, de poster des stages et/ou des emplois. Le lien entre ces différentes tables, se fait par rapport au nom de l entreprise. Une fois les ajouts postés (formulaire soumis), un e-mail est envoyé aux responsables de formation et à l administrateur. De plus les offres sont directement consultables sur le site. Ainsi les responsables de formation et à l administrateur snt prévenus de tout ajout et suppriment en conséquent les offres inintéressantes. d) Conditions de suppression d entreprises, de stages et d emplois Seuls l administrateur, les responsables de communication et les responsables de formation, ont les droits de supprimer des entreprises, des stages et des emplois. Lors de la suppression d une entreprise, les stages et les emplois postés par celle-ci seront aussi supprimés de la base de données. Les ayants droit ont la possibilité de supprimer individuellement un stage ou un emploi. 3 ) Prêt de matériel a) But Permettre à un étudiant authentifié de faire une demande de prêt de matériel. Envoyer un e-mail formaté aux responsables de formation. Cet e-mail contient le nom du demandeur, le type de matériel et le but de la demande. b) Conditions de demande Le demandeur doit être un membre authentifié. c) Mise en place Ce module envoie un e-mail et enregistre les informations dans une table nommée «shared_pret_mat». 14
L enregistrement dans la table est une prévision des évolutions futures de ce module. Il pourrait par exemple gérer le suivi d un prêt («en cours», «matériel rendu» ). 4 ) Galerie de travaux a) But Permettre à un internaute de visualiser les travaux réalisés par les élèves de chaque formation. b) Mise en place Fonctionnement : Les travaux se présentent sous forme de vignettes. Au clic, le projet sélectionné s ouvre sous forme de diaporama. Pour cela, nous utilisons le Framework JQuery (librairie JavaScript) et le module «thick box». Une partie descriptive en bas de la vignette présente le projet. Un bouton suivant permet de faire défiler les différentes captures d'écran du projet. Les différents projets réalisés sont stockés dans des répertoires hiérarchisés. Grâce à une fonction de parcours de dossier en PHP, un menu dynamique est généré, listant les sous dossiers. Fonctions utilisées : -fonction parcours_dossier_local() : prend en paramètre un tableau à deux colonnes : Colonne Menu : sur le parcours d un dossier, si un sous-dossier est rencontré, la fonction va stocker (sous forme de lien) le nom du sous-dossier dans cette colonne. Colonne Contenu : sur le parcours d un dossier, si un fichier est rencontré, la fonction parcours_dossier_local() appelle la fonction getimage (), puis stocke le résultat retourné par celle-ci dans la colonne contenu. - fonction getimage() : crée une liste des images rencontrées dans le dossier avec les paramètres utilisés par la «thickbox». 5 ) Consultation de cours a) But Permettre aux membres authentifiés de consulter les supports cours. Afin de tenir à jour ce module les enseignants doivent déposer les nouveaux cours dans un répertoire spécifique à l Unité d Enseignement. b) Mise en place Fonctionnement : 15
Les cours se présentent sous forme de vignettes (icônes spécifiques aux extensions des fichiers cibles). Au clic, le support de cours sélectionné s ouvre dans un nouvel onglet du navigateur ou peut être téléchargé (clic droit/enregistrer la cible du lien). Les différents cours sont stockés dans des répertoires hiérarchisés. Grâce à une fonction de parcours de dossier en PHP, un menu dynamique est généré, listant les sous dossiers. Fonctions utilisées : - fonction extension() : retourne une icône spécifique à l extension du fichier passé en paramètre. Cette icône servira de lien pour consulter ou télécharger les cours. -fonction parcours_dossier_local() : prend en paramètre un tableau à deux colonnes : Colonne Menu : sur le parcours d un dossier, si un sous-dossier est rencontré, la fonction va stocker (sous forme de lien) le nom du sous-dossier dans cette colonne. Colonne Contenu : sur le parcours d un dossier, si un fichier est rencontré, la fonction parcours_dossier_local() appelle la fonction extension(), puis stocke le résultat retourné par celle-ci dans la colonne contenu. 6 ) LDAP a) But Permettre l authentification des membres de l UPPA. b) Mise en place Utilisation du module «LDAP Integration» de Drupal. La documentation de ce module est disponible à l adresse suivante : http://drupal.org/node/62217. Fonctionnement : Lorsqu une personne s identifie, le CMS Drupal spécifie dans la tables «shared_users» si l identification est liée à un protocole LDAP ou via une Base de données. Ainsi le CMS enregistre les informations concernant l utilisateur identifié, dans sa base de données. 7 ) Trombinoscope a) But Permettre la visualisation d'informations concernant les étudiant actuels et anciens. 16
b) Mise en place Drupal va chercher les fichiers php du trombinoscope dans \\iguzki\projets\projl087\www- PERSONNEL\ACCUEIL\includes\trombi. Ces fichiers exploitent 4 tables de la base de données. Arborescence du dossier trombi: --- images -------------- ------- fiche ------- liste_etudiants --- photo --- 1_menu_secondaire_DU_ASR.php --- 1_menu_secondaire_DU_TIC.php --- 1_menu_secondaire_DUT_INFO.php --- 1_menu_secondaire_LP_SIL.php --- 2_contenu.php --- 3_fiche_etudiant.php --- enregistrement_du_asr.php --- enregistrement_du_tic.php --- enregistrement_dut_info.php --- enregistrement_lp_sil.php --- style.css Base de données: TROMBI_duasr TROMBI_dutic TROMBI_dutinfo TROMBI_lpsil 1 id id id id 2 promo promo promo promo 3 fichier fichier fichier fichier 4 nom nom nom nom 5 prenom prenom prenom prenom 6 datenaissance datenaissance datenaissance datenaissance 7 adresse adresse adresse adresse 17
8 codepostal codepostal codepostal codepostal 9 ville ville ville ville 10 profilperso profilperso profilperso profilperso 11 atperso atperso atperso atperso 12 atpro atpro atpro atpro 13 liensiteperso liensiteperso liensiteperso liensiteperso 14 lienentreprise lienentreprise lienentreprise lienentreprise 15 typeformation typeformation typeformation 16 profil 17 specialite Fonctionnement : Le dossier «images» stocke les éléments graphiques du module trombinoscope. Le dossier «photo» contient les photos uploader depuis le site par les anciens étudiants. 1_menu_secondaire_....php Ces fichiers sont appelés respectivement par chacun des sous-sites des formations. Par exemple, le sous-site de la Licence Professionnelle SIL va appeler le fichier menu_secondaire_lp_sil.php ).Ce fichier se connecte à la base de données de Drupal et parcours la table TROMBI_lpsil à la recherche du champs promo, la requête correspondante les range par ordre croissant (SELECT promo FROM TROMBI_lpsil ORDER BY promo). Si au moins un ancien étudiant d'une promotion quelconque a rempli le formulaire traité dans enregistrement_lp_sil.php, sa promotion sera présente dans la liste affichée par le fichier. Chaque promotion de la liste est un lien pointant vers le même fichier: 2_contenu.php. L'adresse du lien est accompagnée de deux variables qui indiqueront les traitements à faire dans le fichier 2_contenu.php ( exemple d'adresse: monsite.fr/2_contenu.php?var1=2007&var2=lpsil ). Le fichier 2_contenu.php Ce fichier reçoit deux variables par la méthode GET: la variable 1: var1 contient la promotion et la variable 2: var2 contient le nom de la formation. 18
En fonction de ces variables le système va se connecter à la base de données de Drupal et parcourir la table spécifiée dans var2 à la recherche du champs nom où le champs promo correspond à var1, la requête correspondante les range par ordre alphabétique (SELECT * FROM $table WHERE promo=$promo ORDER BY nom ). Ainsi nous affichons la liste des étudiants pour une promotion spécifique par ordre alphabétique. Chaque paire de Nom Prénom affichée est un lien vers une fiche individuelle de l'étudiant générée par le fichier 3_fiche_etudiant.php. Cette paire est accompagnée,entre paranthèse, de la spécialité en sortie de formation pour les étudiants qui appartiennent à la promotion 2008 et plus. L'adresse du lien est accompagnée de trois variables qui indiqueront les traitements à faire dans le fichier 3_fiche_etudiant.php ( exemple d'adresse: monsite.fr/3_fiche_etudiant.phpvar1=7001&var2=lpsil&var3=2007 ). Le fichier 3_fiche_etudiant.php Ce fichier reçoit trois variables par la méthode GET: la variable 1: var1 contient l'identifiant de l'étudiant, la variable 2: var2 contient le nom de la formation. et la variable 3: var3 contient le nom de la promotion. En fonction de ces variables, dans un premier temps, le système va se connecter à la base de données de Drupal et parcourir la table spécifié dans var2. Il récupère tous les champs où le champs promo correspond à var3 et la requête correspondante les range par ordre alphabétique (SELECT * FROM `$table` WHERE promo='$promo' ORDER BY `nom` ). Cette requète nous permet grâce à une boucle de récupérer l'identifiant des étudiants précédent et suivant par ordre alphabétique.nous pourrons utiliser ces identifiants pour faire les liens précédent et suivant de la fiche. Dans le fichier le code correspondant se trouve dans la rubrique bdd 1 et html 1 et html 4. Dans un deuxième temps, le système va parcourir la table spécifiée et récupérer les informations de l'étudiant grâce à la variable 1: var1 qui contient l'identifiant de l'étudiant (SELECT * FROM $table WHERE id=$id ). Toutes ces informations sont ensuite traitées pour être affichées sous forme textuelle ou sous forme de lien. Dans le fichier, le code correspondant se trouve dans la rubrique bdd 2 et html 2 et html 4. 8 ) Menus et bandeaux «flash» a) But Permettre une navigation originale au portail afin d'accéder aux sous-sites des diverses formations. 19
b) Mise en place Tous les menus et les bandeaux sont identiques à l'exception du bandeau d'accueil qui est doté d'une animation spéciale. Tous ces fichiers se trouvent dans un dossier appelé FLASH. A Les menus 1) Bibliothèque «activity» contient le clip d'attente de chargement. «conteneur» est un clip vide permettant le chargement du bandeau. «fond_accueil» contient le fond du menu composé d'un bandeau au couleur de la formation ainsi que l'ombre portée. Menu accueil: ce dossier contient tous les éléments graphiques et les clips de l'animation du menu. 2) La timeline 5 calques sont présents sur la timeline: as: contient l'actionscript permettant d'afficher le menu et le bandeau une fois que chaque élément est chargé individuellement. L'animation «activity» est lue tant que le chargement n'est pas effectué en totalité. Menu: contient l'animation du menu. conteneur_bandeau: contient un clip vide où sera appelé le bandeau correspondant. activity: animation pour l'attente du chargement du bandeau dans conteneur. 20
B Les bandeaux 1. Bibliothèque Photo_diaporama: contient le diaporama des 4 photos. Photo1,2,3,4: photos du diaporama. Photo1_c,2_c,3_c,4_c: clip contenant une des photos. Rectangle: clip contenant un rectangle. Rectangle_a: clip contentant une animation de deux clips rectangle. 2. Timeline La timeline est composée de deux calques. Le premier clip : rectangle contient le clip rectangle_a. Le deuxième calque: diaporama contient le clip photo-diaporama. 21
II. Rôles des utilisateurs 1 ) Ajout d un rôle Une fois authentifié en tant qu administrateur, faire : Administrer Gestion des utilisateurs Rôles: complétez le nom du nouveau rôle et confirmez 2 ) Attribution des droits d accès aux rôles : Administrer Gestion des utilisateurs Contrôle d'accès. 22
Cette section offre la possibilité de définir les droits d accès de chaque rôle utilisateur créé, en cochant les fonctionnalités que l on souhaite lui rendre visible. 3 ) Suppression d un rôle Administrer Gestion des utilisateurs Rôles: éditez le rôle puis supprimer. 4 ) Attribuer un rôle à un utilisateur Administrer Gestion des utilisateurs Utilisateurs : cochez l utilisateur déterminé puis cliquez sur modification et lui attribuer le rôle souhaité grâce à la liste déroulante. 23