Atelier Drupal Pratique : «La bibliothèque des drup-a-liens» Benigno Delgado docip www.docip.org Table des matières Présentation...2 Actions...2 0-Préliminaires...2 A-Installation...2 B-Connexion...3 Drupa-liens...3 1-Importer vocabulaire...3 A-Activer le module Taxonomie CSV import / export...3 B-Importation du vocabulaire choisi dans la Taxonomie...4 2-Travail avec les types de contenus personnalisés (lien)...6 A-Activer le module Link...6 B-Création du nouveau Type de contenu...6 C-Création de contenu (ajout de fiches-liens)...10 3-Affichage personnalisé (Views)...10 A-Création de la vue en tableau...10 B-Améliorer l'affichage. Créer un outil de recherche par domaine...12 C-Activer une entrée de menu dans le menu principal pour cette vue...15 D-Grouper des éléments d'un champ (pour aller plus loin)...16 1
Présentation Nous allons procéder en trois étapes principales, qui nous permettront de nous familiariser avec trois modules essentiels de Drupal : Taxonomie, Types de contenu et Views (ou Vues). Notre but est de : importer un vocabulaire existant (cela pourrait être un thésaurus utilisée dans les bibliothèques par exemple), afin de l'employer pour indexer -ou dans le cas présent, classifier les liens présents dans l'annuaire de liens utiles que nous allons créer pour notre bibliothèque ou centre de documentation. Il s'agira ensuite de gérer la manière dont les liens seront présentés, ainsi que de faciliter la recherche de liens par domaine. Rappel : l'interface d'administration de Drupal, avec ses différentes sections, est accessible dans le bord supérieur de la page dès que vous êtes connectés.elle se présente ainsi : Actions 0-Préliminaires A-Installation Si vous n'avez pas besoin de faire l installation (et allez donc travailler sur l'installation en ligne proposée, ce qui serait plus pratique), passez directement au point B. Télécharger le fichier zip contenant l installation prête pour ce tutoriel et suivre les instructions du fichier«lisez_moi_epfl_install.txt»:http://libre.militant.ch/drupal_10oct.zip ou Installer Drupal 7 soi-même (cf. https://drupal.org/documentation/install )et y intégrer les modules suivants (cf. https://drupal.org/documentation/install/modulesthemes/modules-7) : Chaos tool suite (ctools) : https://drupal.org/project/ctools Views (+ Views UI): https://drupal.org/project/views Taxonomy CSV Import Export : https://drupal.org/project/taxonomy_csv Location : https://drupal.org/project/location Link :https://drupal.org/project/link Date (+Date, Date All Day, Date API, Date Popup) : https://drupal.org/project/date Calendar : https://drupal.org/project/calendar Wysiwig : https://drupal.org/project/wysiwyg 2
B-Connexion 1.Se rendre à l adresse de l installation Drupal dans le navigateur (si vous l avez installé vousmême, se connecter sur sa propre machine, sinon utiliser les données ci-dessous). Installation prête en ligne (conseillée pour l'exercice): http://libre.militant.ch/drupal12 (remplacer 12 par votre chiffre attribué par le prof - de 1 à 20) ou Installation EPFL interne : Suivre les instructions internes 2.Se connecter dans l interface d'administration (utiliser les données ci-dessous ou les créer soimême lors de l installation) Utilisateur : participant Mot de passe : participant1 Drupa-liens 1-Importer vocabulaire A-Activer le module Taxonomie CSV import / export 1. Allez dans Modules. Activez, en cochant la case d'activation, le module Taxonomy CSV import / export (s'il est déjà coché, passez à l'étape suivante) 2. Cliquez sur Enregistrer la configuration 3
B-Importation du vocabulaire choisi dans la Taxonomie 1. Allez dans Structure->Taxonomie. 2. Cliquez sur l'onglet CSV Import. Nous allons maintenant choisir la source des données (le vocabulaire à importer) et paramétrer la manière dont l'importation aura lieu. a) Dans la 1ère étape, représentée par la question : «What do you want to import?» nous allons choisir Structure como type d'import et Simple tree comme type de structure. (c'est une structure qui convient au termes structurés en «parents-enfant»). b) Dans la 2ème étape : «Where are items to import?» nous allons choisir local file. En cliquant sur Parcourir, sélectionnez le fichier dewey_epfl.csv qui se trouve en principe l'espace créé à cette fin par l'epfl (et que vous placerez sur votre bureau avant de l'importer). 4
c) Pour la 3ème étape : «How is your source formated?» il faut choisir «comma (,)» comme signe de séparation («value delimiter») et guillemets () comme «value enclosure». Ne touchez pas les autres éléments. d) 4ème étape : «Which vocabulary do you want to import into?». Choisissez autocreate (nous allons en créer un nouveau). e) On ne touchera pas au point 5. Pour le point 6, qui donne essentiellement des renseignements sur le processus d'importation, mais que consomme des ressources côté serveur, nous allons choisir only first warning or notice. 3. Une fois vos paramètres définis, vous pouvez cliquer sur Importer. 4. Une fois l'importation achevée, retournez aux vocabulaires. Dans la ligne du nouveau vocabulaire créé (dewey pour epfl), cliquez sur lister les termes. Vous constaterez que votre vocabulaire a été bien importé, en conservant la structure hiérarchique. Vous pouvez à tout moment modifier, rajouter ou éliminer un terme, rentrer une description, etc. 5. Finalement, choisissez les informations à recevoir concernant le processus d'importation. Certaines information demandent plus de temps et de mémoire que d'autres. Faite comme sur la capture d'écran 5
6. Cliquez sur «Importer» 7. Une fois l'importation finie, cliquez sur «Lister les termes» afin de vérifier la réussite de l'importation Le format.csv permet d'importer des données tout en conservant leur structure. Dans le cas présent, le fichier.csv de la Dewey (une sélection très restreinte de celle-ci) se base sur un tableur dont la première colonne équivaut au niveau supérieur de la hiérarchie (les classes principales de la Dewey - ex : 100 -Philosophie -psychologie), la deuxième au deuxième niveau (ex : 110 Métaphysique), etc. Le résultat, une fois l'importation effectuée, est celui que vous voyez en cliquant sur «lister les termes». 2-Travail avec les types de contenus personnalisés (lien) A-Activer le module Link Nous allons créer un nouveau type de contenu nommé «Fiche lien», avec des champs adaptés à la description des liens. Cela nous permettra de décrire de manière précise les liens qui feront partie de notre base ou annuaire de liens, et d'en exploiter l'affichage par la suite. 1. Allez dans Modules->Fields. 2. Activez, en cochant la case d'activation, le module Link. Enregistrez la configuration. B-Création du nouveau Type de contenu 1. Allez à Structure->Types de contenu. 2. Cliquez sur Ajouter un type de contenu. 3. Donnez un nom au type de contenu (Fiche de liens, Liens, ou autre nom en rapport avec 6
l'utilisation qu'on va en faire). Vous pouvez en rajouter une description pour expliciter aux autres rédacteurs à quoi ce type de contenu est destiné. 4. On va ensuite définir des éléments aussi bien concernant l'affichage que le comportement du type de contenu en question. Paramètres du formulaire de contribution : Vous pouvez modifier le libellé du champ «Titre», ainsi que définir si l'aperçu avant soumission sera facultatif ou obligatoire. Un texte à destination des contributeurs pourra y être rajouté. Mettez «Titre» et laisser l'aperçu comme facultatif. Vous pourrez rajouter un texte par la suite. Options de publication par défaut : Nous allons cocher «Publié». Les autres options permettent d'afficher par défaut chaque nouveau contenu dans la page d'accueil ou /et de l'afficher en haut des listes (en haut de la page) ainsi que de créer des révisions. Comme on ne travaillera qu'en français, nous n'activerons pas la gestion multilingue. Paramètres d'affichage : Gardez coché «Afficher l'auteur et la date». Si on veut faire apparaître les contenus de manière anonyme, ou ajouter le nom de l'auteur d'une autre manière, on peut décocher cette option. Paramètres des commentaires : Nous permettrons aux visiteurs d'écrire des commentaires («ouvert») et définirons le nombre de commentaires affichés sous chaque fiche de lien. 7
Paramètres du menu : On peut choisir dans le(s)quel(s) des menus possibles, un lien menant vers le contenu en question peut être créé. Pour l'instant nous ne cocherons aucune option. b 5. Cliquez sur Enregistrer et ajouter les champs 6. Ajoutez un nouveau champ de type Lien que vous nommerez «Lien»:-) Comme vous le voyez il existe un grand nombre de «types de champs», ce qui offre des possibilités très étendues au moment de créer des types de contenus. 7. Enregistrez. Vous allez maintenant définir les paramètres du champ. 8
8. En choisissant «Optional title» il vous suffit de rajouter l'adresse web -le lien hypertexte correspondant c'est ce qui s'affichera à côté de l'intitulé «Lien». Cochez cette option pour l'instant. 9. Cochez «Allow the user to enter a link 'title' attribute» afin de respecter les normes d'accessibilité 10. Cliquez sur «Enregistrer les paramètres». Nous allons maintenant incorporer en tant que tant que champ le vocabulaire contrôlé qui nous servira pour l'indexation (bien qu'il s'agisse, dans cet exemple d'un extrait de la Dewey -l'important c'est de comprendre le principe) 11. Ajoutez donc un nouveau champ, nommé «Domaines» ou «Thèmes». Comme type de données, choisissez «Référence à un terme» et comme élément du formulaire, «Liste de sélection». 12. Enregistrez. 13.Dans Paramètres du champ choisissez dans la liste déroulante le vocabulaire précédemment importé («Dewey_...») 14. Enregistrez. 15. Dans «Paramètres du champ» nous allons notamment cocher le champ comme «requis». Le nombre de valeurs restera à «un» car nous plutôt effectuer une «classification» des liens. S'il s'agissait vraiment d'une indexation, nous pourrions définir le nombre de descripteurs possibles à 4, 5 ou «illimité» (bien que pas raisonnable) 9
16. Enregistrez. C-Création de contenu (ajout de fiches-liens) 1. Cliquez dans «ajouter du contenu». 2. Créez quelques fiches de liens, selon les sujets présents dans notre sélection de la Dewey (allez sur Internet et choisissez 4 ou 5 sites qui y correspondent). 3-Affichage personnalisé (Views) A-Création de la vue en tableau Nous allons créer un affichage des liens en forme de tableau, tout en permettant la recherche par domaine. 1. Allez dans Structure->Views 2. Cliquez sur «Add new view». Remplissez comme sur l'image : donne z un nom à la vue, avec éventuellement une description de son but ; choisissez Afficher Contenu de Type Fiche liens (le type que vous avez créé) organisé par ordre chronologique inversé («Newest first»). 3. Ensuite choisissez le format «Tableau» (il y a plusieurs options, tel «liste HTML» ou «calendrier», mais nous voulons obtenir un tableau) 10
4. Cliquez sur Continue & edit. 5. Premièrement nous allons ajouter des champs au tableau. Cliquez dans «Ajouter», à droite de Fields. Nous y ajouterons les suivants : Contenu :domaine et Contenu : lien (vérifiez chaque fois qu'il s'agit de ceux présent dans Fiche_liens «Appears in...»). 6. Configuration du champ «Domaine» : 11
7. Cliquez sur «Apply». 8. Faites la même opération pour «Lien». 9. Cliquez sur «Apply» 10. Cliquez ensuite sur «Enregistrer». 11. Pour visualiser ce que vous avez créé, cliquez sur «view page». B-Améliorer l'affichage. Créer un outil de recherche par domaine Nous allons créer ou outil de recherche basique, qui permettra aux visiteurs du site de chercher tous les liens concernant un domaine en particulier. Cela grâce à une liste déroulante qui s'ouvrira dans 12
un champ de recherche affiché sur notre tableau de liens. Pour cela nous allons créer un «exposed filter» basé sur le champ «Domaines». Faites comme suit : 1. Dans la page de notre «view» (tableau de liens), cliquez sur «Modifier». 2. Allez dans «Filter criteria» et cliquez sur «Ajouter». Choisissez «Contenu:Domaine». 3. Configurez les Critères de filtrage comme montré dans les captures d'écran : Ensuite 13
Pour modifier le texte sur le bouton de recherche, etc. : 4. Déployez l'onglet «Advanced» (à droite du panneau Page details de la«view»). 5. Cliquez sur «Paramètres» dans Exposed form style. 5. Sous Submit button text tapez, par exemple «Lancer la recherche» - cela changera l'affichage du texte original qui est en anglais. 6. Cliquez sur «Apply». 7. Sauvegardez. 14
C-Activer une entrée de menu dans le menu principal pour cette vue 1. Dans Page settings, cliquez sur «Menu» 2. Cochez «Normal menu entry» sous Type. Donnez un titre au lien et, dans la liste déroulante de Menu, choisissez «Menu principal». Quant au Poids, plus le chiffre est petit plus il se placera à gauche dans un menu horizontal ou en haut dans un menu vertical. 3. Sauvegardez en cliquant sur «Apply». 4. Sauvegardez encore en cliquant sur Enregistrer 5. Pour visualiser votre lien dans le menu, cliquez sur «Bonjour [votre nom d'utilisateur]» en haut à droite de votre site. Cela vous mènera à l'interface publique de celui-ci (visible par tous) 15
D-Grouper des éléments d'un champ (pour aller plus loin) Si nous souhaitons, par exemple, que les liens (ou les notices, ou les articles, etc.) qui possèdent un même mot-clé ou un même auteur apparaissent groupés sous celui-ci, vous pouvez le faire en choisissant «Grouping field». 1. Une fois dans la page des vues, cherchez la vue à modifier, ensuite, dans Formats, cliquez sur Paramètres 2. Dans Page :Style options, regardez dans Grouping field N 1, choisissez dans la liste déroulante le champ souhaité (cela peut être «Domaine» dans votre cas). 3. Cochez «Use rendered output to group rows» 4. Cliquez sur Apply... 5. Sauvegardez Bon travail! 16