Atelier. Créer un site internet avec un CMS pas comme les autres Deuxième édition. Cyprien Roudet

Transcription

1 1 Atelier Créer un site internet avec un CMS pas comme les autres Deuxième édition Cyprien Roudet

2 2 Remerciements Flavie ROUDET, Delphine HERVE, Fabrice VIALE, Daniel CAILLIBAUD, Alexandre, Vincent CAILLEREZ, Yoran BRAULT. Drupal est une marque déposée de Dries Buytaert Copyright 2009 Cyprien Roudet Maquette, design et couverture : Pix N Graph -

3 3 SOMMAIRE Introduction Partie I - Démarrage rapide Installation rapide sous Windows Installation de WampServer Téléchargement et accès à l installateur de Drupal Installation de la langue française Installation de la base de données Configuration du site Installation rapide sous Linux Installation d une solution LAMP Téléchargement et accès à l installateur de Drupal Installation de la langue française Droits d accès Installation de la base de données Configuration du site A la découverte de Drupal Le contenu Les menus Ajout d un bloc Les modules Gestion des permissions Modification de l apparence de Drupal Partie II - Utiliser Drupal Administrer Drupal La page Administrer Le tableau de bord Les paramètres du site Les modules Activation et découverte d un module Rechercher un module sur drupal.org Installer un module

4 4 6. Le contenu Les types de contenu Les formats d entrées BBCode : Ajout d un format d entrée PHP filter : Ajout de code Php dans votre contenu NicEdit + Wysiwyg : Installer un éditeur Wysiwyg Inline : Ajoutez des images à votre contenu Attacher des fichiers à vos contenus grâce au module Upload Organiser le contenu La taxonomie Organiser votre site Path : L Alias d URLs Les blocs Les menus Trigger : Effectuez des actions lorsque des événements se produisent Le travail collaboratif sous Drupal Ajout d utilisateurs Les rôles des utilisateurs Les droits d accès liés aux modules Partie III - Administration système de Drupal Configuration de Apache - PHP - MySQL Configuration de Apache Configuration de Php Configuration de MySQL Choisir l hébergeur de votre site Web Configuration de votre serveur pour l envoi de mail Gérer ses différents sites Drupal Sauvegarde/restauration d un site Drupal Créer un site de test Transfert du site de production vers le site de test Configuration avancée de Drupal Update Status : Mettre à jour Drupal Le cron Partie IV - Modifier l apparence de votre site Organisation des thèmes Activation et découverte du thème Bluemarine Modifier le logo et l icône du site Création d un nouveau thème à partir de BlueMarine Les fichiers du thème BlueMarine Composition d un fichier template

5 5 13. Modifier un thème par CSS Modifier par CSS Utiliser Firebug Quelques exemples de modifications Entourer un bloc Afficher l auteur et la date d une contribution sans l heure Modifier le pied de page Le thème Zen Installation de Zen Créer un nouveau thème à partir de Zen Les fichiers de Zen Partie V - Les modules CCK et Views CCK : Créez des types de contenu personnalisés Présentation de CCK Modification des paramètres des champs et des types de contenu Ajout d un champ Texte à choix multiple Node Reference : Créer un lien vers une autre Node field : Ajoutez un champ à votre type de contenu ImageField : Ajoutez un champ image à votre type de contenu La taxonomie et CCK Modification de l apparence des champs CCK Views : Organisez vos données Découverte de quelques vues par défaut Création d une nouvelle vue Sélection des champs à afficher (Fields) Filtres Critères de tri Affichage des données (Display) Configuration de l affichage Page Configuration de l affichage Bloc Configuration de l affichage Fichier attaché Insert View : Insérer une vue dans un contenu Partie VI - Description des modules utiles de Drupal Administration Backup and Migrate - Sauvegardez votre base de données Google Analytics : Mesurez l audience de votre site Poormanscron : Lancer le cron automatiquement Editeurs NiceEdit : Un éditeur Wysiwyg simple FCKeditor : Un éditeur Wysiwyg complet XStandard WYSIWYG Editor : Un éditeur Wysiwyg coté client

6 6 20. Formats d entrées BBCode : Ajoutez des balises de mises en forme Footnotes : Ajoutez des notes de bas de page à vos contenus GeSHi Filter : Colorisation syntaxique de code Inline : Ajoutez des images à vos contenus Video Filter : Ajoutez des liens vers vos vidéos Organisation du contenu Pathauto : Automatisez la création de vos Alias Search : Un moteur de recherche pour votre site CAPTCHA : Evitez les robots malveillants CAPTCHA Pack : Ajoutez de nouveaux types de tests ImageCache : Manipulez vos images avant de les afficher Administrer Drupal Administration Menu : Navigation facile dans l administration Administration theme : Utiliser un thème spécifique pour administrer CSS Injector : Appliquez des styles CSS à certaines pages Site coopératif Profile : Ajoutez des champs aux profils de vos utilisateurs pour mieux les connaître Forum : Créez un lieu d échange pour vos utilisateurs Blog : Donnez la possibilité à vos utilisateurs de posséder un blog Book : Créez des livres coopératifs Date : Ajoutez un champ Date à votre type de contenu Calendar : Ajoutez un calendrier à votre site Webform : Créez des formulaires Simplenews : Créez des bulletins d informations Blocs et menus Taxonomy menu : Affichez vos vocabulaires dans des menus DHTML Menu: Améliorez la navigation dans votre site Nice Menus : Rendez vos menus dynamiques Menu Block : Divisez, liez et organisez vos blocs Ubercart : créez un site e-commerce Store : Installation de la boutique Product : Créez les produits de voter boutique Catalog : Créez un catalogue pour vos produits Cart : Créez le panier de votre site Order : Validation du panier Création d un compte Paypal SandBox Payment : Permettez un paiement en ligne

7 7

8 Introduction 8 Introduction Introduction Un CMS (Content Management System Système de Gestion de Contenu) permet de créer un site Web dynamique, permettant à plusieurs utilisateurs d enrichir son contenu sans connaissance particulière. Drupal est un logiciel OpenSource écrit en Php de la famille des CMS. Il permet de créer rapidement : Un site de nouvelles Des forums Des articles contenant des images, des vidéos, des liens vers d autres articles, etc. Des blogs pour chacun des utilisateurs Etc. Drupal est aujourd hui un logiciel éprouvé : il a été créé par le Belge Dries Buytaert en Drupal a la particularité d offrir une riche interface de programmation qui lui vaut parfois l appellation de CMF (Content management Framework Plateforme de Gestionnaire de Contenu). C est grâce à cette interface que Drupal a attiré un grand nombre de développeurs qui participent à son évolution en créant et partageant un grand nombre de modules. Drupal est souvent considéré comme étant une alternative à Joomla! le plus populaire des CMS aujourd hui. Drupal a la réputation d être plus difficile à prendre en main que Joomla! mais plus évolutif et personnalisable ensuite. Le but de cet ouvrage est justement de vous faciliter la prise en main de ce logiciel. Si vous ne connaissez pas Drupal, si vous ne savez pas exactement à quoi il sert ou si vous êtes impatient de le voir fonctionner, la partie I de ce livre est faite spécialement pour vous : elle vous permettra d installer Drupal et de découvrir un grand nombre de fonctionnalités en quelques heures seulement. La partie II détaille les fonctionnalités importantes de Drupal et revient plus précisément sur certain sujets abordés dans la partie I. Grâce à la partie III vous saurez sauvegarder votre site, configurer votre serveur et sécuriser vos données. Ensuite, vous apprendrez dans la partie IV à personnaliser graphiquement votre site créé avec Drupal. La partie V détaille deux modules particuliers et très utilisés avec Drupal : CCK et Views. Ils permettent de créer des types de contenus particuliers et de les ordonner. La partie VI décrit des modules qui permettent d ajouter des fonctionnalités à Drupal.

9 9 Notes à propos de ce livre : Ce livre est écrit comme un tutoriel, et comporte de nombreux exemples pratiques. Il peut se lire devant un ordinateur en effectuant les actions décrites, mais il est aussi possible de le lire sans ordinateur, grâce au grand nombre d illustrations montrant les actions proposées. Conventions utilisées dans ce livre Action à exécuter par le lecteur Renvoie vers un module en rapport avec le sujet traité Information complémentaire Astuce Versions alpha, beta et stables : Lors de l écriture de ce livre, certains modules étaient en cours de développement pour Drupal 6 et n étaient pas publiés en version stable. Il convient donc de bien vérifier avant la mise en production de votre site si la stabilité des modules utilisés ne le mettent pas en péril. Site internet : Vous pouvez téléchargez les fichiers illustrant les exemples traités dans ce livre sur le site internet dédié à cet ouvrage : Deuxième édition : Cette deuxième édition de Atelier Drupal a tout d abord été sortie pour mettre à jour les chapitres traitant de modules ayant évolués (En particulier CCK et Views qui sont sortis entre-temps en version stable). De nouveaux modules sont également expliqués, un nouveau chapitre sur les menus et les blocs a été ajouté ainsi que le chapitre traitant de Ubercart, la solution e-commerce de Drupal.

10 10 Introduction

11 Partie I - Démarrage rapide 11

12 I - Démarrage rapide 12 I - Démarrage rapide Le but de cette première partie est de découvrir Drupal par l exemple. Elle vous explique comment installer Drupal, accéder à l interface d administration et créer vos premiers contenus. Ainsi, après avoir lu cette partie, vous saurez ce que Drupal peut faire et à quoi il peut servir. Bien que Drupal puisse fonctionner sur différents serveurs web et bases de données, les explications de ce livre se limiteront au très classique quatuor Apache (serveur Web) - PHP (Langage de programmation) - MySQL (Logiciel de base de données) - PhpMyAdmin (Logiciel facultatif permettant de gérer MySQL via une interface Web). Cette partie vous présente deux manières classiques d installer Drupal sur Windows et sur Linux : Le premier chapitre décrit l installation sur Windows (logiciel WampServer) Le deuxième chapitre décrit l installation sur Linux (distribution Ubuntu). Vous pouvez également vous rendre sur le site et y découvrir des guides permettant d installer Drupal sur Free et OVH en serveur mutualisé. Le troisième chapitre de l ouvrage vous accompagne dans la découverte de Drupal et vous explique comment créer, gérer et afficher vos premiers contenus de publication, en l occurrence quelques recettes de cuisine. Si les deux manières décrites d installer Drupal ne vous conviennent pas, le tableau suivant résume les principales variantes d installation pour vous aider à choisir celle qui convient le mieux à votre usage : Méthode d installation Systèmes Avantages Inconvénients Conclusion Paquetage BitNami.org Windows ou Linux - Très facile et rapide à installer - Difficile à maintenir - Fichiers de configuration non standards Parfait si vous voulez savoir immédiatement à quoi ressemble Drupal Wamp + Drupal depuis les sources Windows - Assez facile à installer - Méthode décrite pas à pas dans ce livre - Possibilité de transfert vers un serveur de production - Deux systèmes différents (Windows pour le site de test, Linux pour le serveur de production) Très bonne solution pour découvrir Drupal et aller un peu plus loin. Vous ne serez pas dépaysé si vous avez déjà utilisé EasyPhp LAMP + Drupal depuis les sources Linux - Assez facile à installer - Même système pour le serveur de test et de production - Méthode décrite pas à pas dans ce livre - Si vous ne connaissez pas Linux, il peut être difficile de débuter avec Drupal sur un nouveau système La meilleure des solutions si vous connaissez Linux et s habituer à administrer un serveur dédié Windows + virtualisation de Linux Windows + Linux - Vous pouvez utiliser tous les outils de développement web non disponibles sous Linux - Vous avez un serveur local sous Linux - Un peu difficile à mettre en œuvre - Ressources nécessaires pour faire tourner deux systèmes sur une machine Très bonne solution pour les habitués de Windows qui veulent découvrir Linux Linux + virtualisation Windows Linux + Windows - Vous pouvez utiliser tous les outils de développement web dédiés à Windows - Vous avez un serveur local tournant sous Linux - Un peu difficile à mettre en œuvre - Ressources nécessaires pour faire tourner deux systèmes sur une machine Bonne solution pour les utilisateurs désirant passer à Linux en douceur

13 1 - Installation rapide sous Windows Installation rapide sous Windows La méthode décrite dans ce livre pour l installation de Drupal utilise le logiciel WampServer2 qui regroupe Apache, PHP, MySQL et phpmyadmin. Si vous avez l habitude d une autre solution WAMP (easyphp ou autre), ne la perdez pas! Cela devrait également fonctionner moyennant quelques modifications Installation de WampServer Sur le site web WampServer ( allez dans la section Download. Téléchargez et exécutez le fichier.exe (Version utilisée pour ce livre : wampserver2.0f.exe). Dans ce livre, il sera considéré que Wampserver est installé dans le répertoire c:\wamp (Répertoire par défault). A la fin de l installation, une icône apparaît dans la zone de notification (à coté de l heure). Passez WampServer en français en faisant un clic droit sur l icône Language - french. Lancez un navigateur internet et entrez l adresse locale : Vous devriez voir s afficher la page d accueil WampServer. WampServer fonctionne! 1.2. Téléchargement et accès à l installateur de Drupal Vous allez maintenant installer Drupal à partir de ses fichiers sources. Il faut les télécharger et les copier au bon endroit dans votre arborescence. h h Rendez-vous à la section Download (télécharger) du site web Drupal ( ou cliquez sur le lien Latest release (Dernière version) et téléchargez la dernière version de Drupal (Version utilisée pour ce livre : Drupal 6.8).

14 14 I - Démarrage rapide Page d accueil de drupal.org Si vous ne pouvez pas décompresser votre archive.tar.gz, utilisez le logiciel libre 7zip : Décompressez l archive Drupal dans le répertoire www où vous avez installé WampServer (par défault c:\wamp\www). Renommez le répertoire créé en Drupal. Vous devriez obtenir l arborescence suivante : c:\wamp\ www\drupal. Rendez-vous à l adresse La page d accueil Drupal doit apparaître. Drupal est prêt à être installé!

15 1 - Installation rapide sous Windows Installation de la langue française La priorité est maintenant d installer Drupal en Français : Cliquez sur le lien Learn how to install Drupal in other languages (Apprenez comment installer Drupal dans d autres langues) de la page Cliquez sur Determine if a translation of this Drupal version is available (Déterminez si une traduction pour cette version de Drupal existe), ce qui doit vous envoyer vers la section Translations (Traductions) du site internet Drupal ( Téléchargez alors la version 6.x (version utilisée pour ce livre : 6.x-1.x-dev du 2008-Aug-29) du fichier French translation (Traduction en Français). Copiez les fichiers de cette archive dans le répertoire Drupal (par défault c:\wamp\www\drupal\). Retournez à l adresse Vous devriez avoir le choix de la langue. Vous êtes maintenant prêt à installer Drupal. Drupal est prêt à être installé... en francais! Choose Language (Choix de la langue) : Bien sûr, sélectionnez French (Français) et cliquez sur le bouton Select language pour passer à l étape suivante. Une erreur apparaît car le fichier./sites/default/settings.php n existe pas. Il faut créer le fichier settings.php

16 16 I - Démarrage rapide Faites une copie du fichier./sites/default/default.settings.php dans son propre répertoire. Renommez cette copie pour obtenir un fichier./sites/default/settings.php. Cliquez sur le lien recommencez, vous devriez passer cette fois à l étape suivante Installation de la base de données Une base de données est un ensemble de données organisées nécessaires au fonctionnement d une application. Lorsque l application a besoin d exploiter sa base, elle interroge alors le gestionnaire de base de données (ici MySQL) qui lui-même effectuera les actions nécessaires dans la base (ajout, modification, suppression de données, etc.). Ce programme est optimisé pour utiliser efficacement de grandes quantités de données. Vous allez utiliser phpmyadmin pour créer et configurer la base de données de Drupal. Lancez un autre navigateur internet (ou un nouvel onglet) et entrez l adresse locale : Vous devriez alors voir apparaître la page d accueil de phpmyadmin que WampServer a installé : En dessous de la ligne Créer une base de données, entrez le nom de la base, par exemple drupal. Création de la base de données MySQL pour Drupal grâce à phpmyadmin Cliquez ensuite sur le bouton Créer.

17 1 - Installation rapide sous Windows 17 Vous allez maintenant indiquer à l installateur Drupal le nom de la base que vous venez de créer et comment s y connecter. Par défaut, WampServer ne protège pas MySQL et il est possible de s y connecter sans mot de passe avec l utilisateur root. Vous verrez au chapitre 9.3. Configuration de MySQL comment protéger une base de données. Retournez maintenant sur l installateur Drupal et complétez les champs suivants : Nom de la base de données : drupal. Nom d utilisateur : root. Mot de passe : vide. Installation de la base de données par l installateur Drupal Cliquez sur le bouton Sauvegarder et poursuivre Configuration du site Maintenant que la base existe, vous allez entrer les paramètres qui permettront à Drupal de créer le premier utilisateur : l administrateur. Complétez les champs de la manière suivante : Nom du site : Mes recettes. Adresse du site : contact@monadresse.com (Entrez une adresse valide). Nom d utilisateur : admin. Adresse contact@monadresse.com (Entrez une adresse valide). h h Mot de passe : Entrez ici votre mot de passe - pour ce livre le mot de passe utilisé sera atelierdrupal.

18 18 I - Démarrage rapide Cliquez sur Sauvegarder et poursuivre. Cliquez sur le lien votre nouveau site. Paramètres de création du premier utilisateur L installation sous Windows est terminée! Le prochain chapitre explique comment installer Drupal sous Linux, si vous désirez utiliser Drupal uniquement sous Windows, rendez-vous directement au chapitre 3. A la découverte de Drupal.

19 2 - Installation rapide sous Linux Installation rapide sous Linux L installation d une solution LAMP (Linux, Apache, MySQL, Php) sous Linux est toujours très bien documentée quelque soit la distribution utilisée. Dans ce livre, la distribution Ubuntu a été choisie car elle est la distribution grand public la plus utilisée en ce moment Installation d une solution LAMP Pour installer les quatre logiciels dont vous avez besoin, tapez la ligne de commande suivante dans un terminal (avec Ubuntu : Applications - Accessoires - Terminal) : sudo apt-get install apache2 apache2-doc mysql-server php5 libapache2-mod-php5 php5-mysql phpmyadmin php5-gd Il vous sera demandé durant l installation un mot de passe pour MySQL - pour ce livre le mot de passe utilisé sera atelierdrupal. Confirmez à nouveau le mot de passe. Configuration de MySQL h h A la question Serveur web à reconfigurer automatiquement, choisissez apache2 en appuyant sur la barre d espace.

20 20 I - Démarrage rapide Configuration de phpmyadmin A la fin de l installation, pour vérifier si votre serveur web fonctionne, lancez un navigateur internet et entrez l adresse locale : Vous devriez voir apparaître la page d accueil apache. Vérifiez si phpmyadmin fonctionne en entrant l adresse : Vous devriez voir apparaître la page d accueil phpmyadmin. Votre solution LAMP est installée, phpmyadmin fonctionne

21 2 - Installation rapide sous Linux Téléchargement et accès à l installateur de Drupal Vous allez maintenant installer Drupal à partir de ses fichiers source. Il faut donc les télécharger et les copier au bon endroit dans votre arborescence de fichiers. Il est préférable d installer Drupal dans votre répertoire personnel (/home/utilisateur) pour faciliter l édition et l ajout de fichiers dans Drupal. Toutefois, sachez qu il est possible pour vous de l installer dans un autre répertoire (classiquement /var/www). Rendez-vous à la section Download du site web Drupal ( ou cliquez sur le lien Latest release et téléchargez la dernière version de Drupal (version utilisée pour ce livre : Drupal 6.8). Page d accueil de drupal.org Décompressez votre archive dans votre répertoire personnel. Renommez ce répertoire en drupal. Vous devriez obtenir une arborescence du type /home/utilisateur/drupal.

22 22 I - Démarrage rapide Créez maintenant un lien symbolique entre le répertoire de apache et votre répertoire drupal cd /var/www sudo ln -s /home/utilisateur/drupal La commande ln -s permet de créer un lien symbolique entre le répertoire /var/www et le répertoire drupal de votre répertoire personnel. Cela est très pratique car vous pourrez alors modifier facilement les fichiers de Drupal sans entrer le mot de passe super utilisateur. Toutefois, sachez que cela peut nuire aux performances de votre système car il doit, à chaque requête, résoudre ce lien. Lancez un navigateur internet et entrez l adresse locale : Vous devriez voir apparaître la page d accueil de Drupal. Drupal est prêt à être installé! 2.3. Installation de la langue française La priorité est maintenant d installer Drupal en Français : Cliquez sur le lien Learn how to install Drupal in other languages de la page Cliquez sur Determine if a translation of this Drupal version is available, ce qui doit vous rediriger vers la section Translations (Traductions) du site internet Drupal ( Téléchargez alors le fichier French translation pour la version 6.x de Drupal (version utilisée pour ce livre : 6.x-1.x-dev du 2008-Aug-29). Décompressez ce fichier dans votre répertoire drupal /home/utilisateur/drupal Allez à nouveau à l adresse Vous devriez alors avoir le choix de la langue.

23 2 - Installation rapide sous Linux 23 Voilà! Vous êtes prêts à installer Drupal! Drupal est prêt à être installé... en francais! Choose Language (Choix de la langue) : Bien sûr, sélectionnez Français pour passer à l étape suivante Droits d accès Un message apparaît alors, signalant plusieurs erreurs. Drupal demande des droits en écriture! Le fichier./sites/default/settings.php n existe pas et l installateur Drupal doit avoir les droits en écriture sur le répertoire /home/utilisateur/sites/default. Faites une copie du fichier./sites/default/default.settings.php dans son propre répertoire. Renommez cette copie pour obtenir un fichier./sites/default/settings.php.

24 24 I - Démarrage rapide Il faut ensuite donner les droits d accès en écriture sur le répertoire./sites/default et sur le fichier settings.php nouvellement créé durant le processus d installation : sudo chmod -R a+w /var/www/drupal/sites/default Cliquez sur le lien recommencez pour faire disparaître le message Installation de la base de données Pour que Drupal fonctionne correctement, il faut lui créer une base de données. Vous allez utiliser phpmyadmin pour la créer et la configurer. Lancez un autre navigateur internet (ou un nouvel onglet) et entrez l adresse locale : Connectez-vous avec le login root et le mot de passe que vous avez entré lors de l installation (atelierdrupal si vous avez suivi ce livre). En dessous de la ligne Créer une base de données, entrez «drupal». Création de la base de données MySQL pour Drupal avec phpmyadmin

25 2 - Installation rapide sous Linux 25 Puis cliquez sur le bouton Créer. Retournez maintenant à votre installation de Drupal et complétez les champs suivants : Nom de la base de données : drupal. Nom d utilisateur : root. Mot de passe : le mot de passe que vous avez entré lors de l installation de MySQL - atelierdrupal si vous avez suivi les conseils de ce livre. Installation de la base de données par l installateur Drupal Cliquez sur le bouton Sauvegarder et poursuivre. Supprimez les droits d accès en écriture sur le répertoire./sites/default pour sécuriser à nouveau votre site : sudo chmod a-w /var/www/drupal/sites/default Drupal doit avoir accès en écriture au répertoire /var/www/drupal/sites/default/sites sudo chmod a+w -R /var/www/drupal/sites/default/files 2.6. Configuration du site Maintenant que la base est créée, vous allez entrer les paramètres qui permettront à Drupal de créer le premier utilisateur : l administrateur. Complétez les champs de la manière suivante : Nom du site : Recettes! Adresse du site : contact@mondomaine.com (Entrez une adresse valide) Nom d utilisateur : admin Adresse contact@mondomaine.com (Entrez une adresse valide)

26 26 I - Démarrage rapide Mot de passe : atelierdrupal Puis cliquez sur Sauvegarder et poursuivre. Cliquez sur le lien votre nouveau site. Paramètres pour la création du premier utilisateur L installation sous Linux est terminée!

27 3 - A la découverte de Drupal A la découverte de Drupal Vous avez installé un système, un serveur web supportant php, un logiciel de base de données et Drupal. Maintenant, vous pouvez partir à la découverte de ce logiciel en y ajoutant du contenu, en modifiant son interface, en ajoutant des fonctionnalités et bien d autres choses encore Le contenu Ajouter du contenu Drupal est un CMS : Content Managment Système (En francais, Système de gestion de contenu). Vous allez donc commencer par y entrer du contenu. Comme vous le verrez plus en détail dans le chapitre 6. Le contenu et le chapitre 15.CCK : Créez des types de contenu personnalisés, les contenus dans Drupal peuvent être de différents types. Par défaut, vous avez le choix entre les types Article et Page. Dans la colonne de gauche, cliquez sur le lien Créer un contenu. Puis choisissez Article comme type de contenu. Copiez les deux recettes suivantes comme nouveau contenu à votre site (texte disponible sur atelierdrupal.net) : Titre : Recette de la soupe japonaise Corps : Ingrédients : Une côte de porc ou un morceau de filet de 100g Un oignon Un poireau ou un chou chinois Une 1/2 carotte De la sauce soja Un sachet de dashi ou 1/2 cube de bouillon de légumes Des nouilles japonaises Préparation : Emincer la carotte, l oignon, le porc et le poireau Faire chauffer un fond d huile dans une cocotte Faire revenir l oignon à feu vif pendant 2 min. Ajouter ensuite le porc pendant encore 2 min. Puis ajouter les carottes et le poireaux pendant encore 3 min. Mouiller avec 1/2 litre d eau Ajouter le 1/2 cube de bouillon de volaille ou le Dashi et 2 cas de sauce soja Couvrir et laisser cuire 20 min. Ajouter les nouilles 4 min. avant la fin de la cuisson

28 28 I - Démarrage rapide Votre premier Article Descendez tout en bas de la page et cliquez sur le bouton Enregistrer. Créez un nouvel article pour la recette de la mousse au chocolat : Titre : Cliquez à nouveau sur Créer un contenu - Article : Mousse au chocolat Corps : Ingrédients : 200 g de chocolat noir 4 oeufs 120 g de sucre glace 50 g de sucre blanc 1 c.a.s. de crème fraîche Préparation : Faire fondre le chocolat au bain marie avec la crème fraîche Séparer les blancs des jaunes Blanchir les jaunes avec le sucre blanc et 100 g de sucre glace Incorporer le chocolat fondu à la préparation Dans un autre plat, monter les blancs en neige avec le sucre glace restant et une pincée de sel Mélanger 1/4 des blancs à la préparation chocolatée avec vigueur Puis, incorporer doucement le reste des blancs Mettez la mousse au réfrigérateur pendant 3 heures minimum. Cliquez sur le bouton Enregistrer.

29 3 - A la découverte de Drupal 29 Retournez sur la page d accueil en cliquant sur le logo Drupal ou sur le titre de votre site Mes recettes! Votre page d accueil avec vos 2 recettes Vous verrez dans le chapitre 6. Le contenu comment vos visiteurs peuvent personnaliser leur contenu en mettant le texte en forme, en ajoutant des images et bien d autres choses encore. Ajout d un commentaire Avec Drupal, les visiteurs peuvent commenter les articles. Vous allez maintenant ajouter un commentaire à l une de vos recettes. Affichez votre article de la soupe japonaise en cliquant sur son titre Recette de la soupe japonaise. Cliquez en bas sur Ajouter un commentaire. Ajoutez le commentaire comme sur l illustration suivante : Ajout d un commentaire

30 30 I - Démarrage rapide Cliquez sur Aperçu puis sur Enregistrer. Ajoutez d autres commentaires pour cette recette et pour la mousse au chocolat. Edition d un contenu et création d un résumé Une partie seulement de la recette s affiche en page d accueil. Le rédacteur de l article a la possibilité de modifier la taille de cette partie en créant un résumé. Vous allez modifier la recette de la soupe japonaise de façon à créer un résumé qui s affichera sur la page d accueil de votre site : Cliquez à nouveau sur Recette de la soupe japonaise pour l afficher. Editez votre article en cliquant sur le lien Modifier. Placez votre curseur à la fin de la liste des ingrédients, après Des nouilles japonaises Cliquez sur le bouton Créer un résumé à partir du curseur. Cliquez sur Enregistrer. Création d un résumé pour la page d accueil Retournez sur la page d accueil en cliquant sur le logo, vous avez maintenant seulement un résumé qui présente la recette. Refaites la manipulation pour la Mousse au chocolat Les menus Ajout d un menu Vos deux recettes sont accessibles depuis la page d accueil, vous allez créer des menus dans l entête du site pour les rendre plus visibles.

31 3 - A la découverte de Drupal 31 Editez à nouveau votre recette de la soupe japonaise. Cliquez sur la section Paramètres du menu. Dans le champ Titre du lien dans le menu, entrez Soupe japonaise. Paramètres menu Cliquez sur Enregistrer en bas de la page, un menu de raccourci vers la recette apparaît en haut à droite. Répétez l opération pour la Mousse au chocolat. Les deux entrées du menus primaire sont créés Organisation des menus Voici les deux entrées de menus créés. Drupal propose ensuite un outil particulièrement pratique pour organiser les menus.

32 32 I - Démarrage rapide Dans le menu d administration à gauche de la page, cliquez sur Administrer - Construction du site - Menus - Liens primaires. Vous pouvez dans cette page configurer l ensemble de vos liens primaires. Page d organisation des menus Par exemple, placez la Soupe Japonaise avant la Mousse au chocolat : Cliquez pour cela sur le symbole de la soupe japonaise et remontez le par glisser/déposer au-dessus de la mousse au chocolat. Cliquez sur Enregistrer la configuration et observez le résultat : vos deux menus sont inversés. Dans Drupal 6, vous retrouverez régulièrement cet outil pour organiser votre site. Une explication plus approfondie des menus est développée au chapitre 7.3. Menus Ajout d un bloc Les blocs sont des boîtes que vous pouvez cacher ou faire apparaître là où vous le désirez sur votre page de Drupal. Vous connaissez déjà le bloc de l administrateur qui se situe dans la barre de gauche et qui permet de naviguer parmi les pages d administration de Drupal. Vous allez maintenant ajouter un bloc qui permet de lister les derniers commentaires ajoutés à votre site. Rendez vous maintenant sur Administrer - Construction du site - Blocs. h h Dans la section Désactivé (en bas de la page), choisissez la région Barre de gauche pour le bloc Commentaires récents.

33 3 - A la découverte de Drupal 33 Cliquez sur Enregistrer les blocs. Page d administration des blocs Vous voyez alors apparaître le bloc Commentaires récents sur la partie gauche de la page. Le bloc Commentaires récents dans la région Barre de gauche Essayez maintenant de mettre le bloc Commentaires récents en haut de la colonne de gauche (au dessus de la partie admin) en utilisant l outil. Lorsque vous êtes sur la page Administrer - Construction du site - Blocs, vous pouvez constater que les régions apparaissent entourées d un trait discontinu, cela permet de mieux savoir où va se situer un Bloc. Testez différentes positions pour votre bloc Commentaires récents. Vous en saurez plus sur les blocs en lisant le chapitre 7.2. Blocs.

34 34 I - Démarrage rapide 3.4. Les modules Activer un module Les Modules sont des briques de programme qui permettent d étendre les fonctionnalités de Drupal. Vous allez maintenant en activer un qui permet de réaliser des sondages. vous créerez ensuite un sondage qui permettra à vos visiteurs de voter pour leur recette favorite. Cliquez sur Administrer - Construction du site - Modules. Cochez la case activé du module Poll (Sondage). Cliquez sur Enregistrer la configuration. En activant ce module, vous avez accès à un nouveau type de contenu Sondage. Cliquez sur Créer un contenu - Sondage et créez un nouveau sondage comme sur l illustration suivante. Ajout d un Sondage h h Ajoutez à ce sondage une entrée dans le menu primaire comme pour les articles à la section Paramètres du menu.

35 3 - A la découverte de Drupal 35 Ajout d un menu pour le sondage Dans la section Options de publication, décochez l option Promu en page d accueil. Ainsi, le sondage n apparaîtra pas dans la page d accueil au milieu des articles. Cliquez sur Enregistrer. Les options de publication Testez maintenant votre sondage en cliquant sur le menu primaire Votre sondage fonctionne!!!

36 36 I - Démarrage rapide Un module peut étendre les fonctionnalités de Drupal de beaucoup de façons différentes. Ici, en activant le module Poll (Sondage), vous avez accès à un nouveau type de contenu, et, si vous retournez sur la page Administrer - Construction du site - Blocs, vous verrez qu un nouveau bloc Sondage le plus récent est aussi disponible. Installation d un module externe Les modules les plus utiles sont installés par défaut avec Drupal. Mais un très grand nombre de modules sont téléchargeables sur le site officiel de Drupal (plus de 1000 pour la version 6.x). Une des grandes forces de Drupal réside dans le fait qu il est facile, pour les personnes connaissant le Php, de développer de nouveaux modules. Vous allez maintenant télécharger et installer le module Tribune qui permet de créer un espace de communication libre sur votre site. Créez le répertoire votre_repertoire_drupal/sites/all/modules. C est là qu il faudra extraire le module téléchargé. Allez dans la section Download (Télécharger) du site web Drupal ( Choisissez la section Modules. Choisissez ensuite la catégorie Community. Recherchez le module Tribune dans la page. Le module Tribune sur drupal.org Téléchargez l archive en cliquant sur le lien Download (Version utilisée pour ce livre 6.x-1.8) Extrayez le contenu de l archive dans le répertoire modules précédemment créé. Vous devez donc avoir un répertoire : votre_repertoire_drupal/sites/all/modules/tribune contenant tous les fichiers du module tribune. sous Windows : C:\wamp\www\drupal\sites\all\modules\tribune sous Linux : /home/nom_utilisateur/drupal/sites/all/modules/tribune Allez dans Administrer - Construction du site - Modules. Cochez la case activé du module Tribune.

37 3 - A la découverte de Drupal 37 Activation du module tribune Cliquez sur le bouton Enregistrer la configuration. Vous allez maintenant créer une conversation : Cliquez sur le lien Tribune sur la partie gauche de l écran. Entrez ensuite le début d une conversation dans la zone de texte. Cliquez sur le bouton Post pour publier la phrase dans la tribune. Le module tribune en action! Vous en saurez plus sur l installation et la configuration des modules en lisant le chapitre 5. Les modules. La Partie VI - Description des modules utiles de Drupal de cet ouvrage est également réservée à la description de modules ajoutant diverses fonctionnalités à Drupal Gestion des permissions Après une installation simple de Drupal, deux utilisateurs sont créés : l Administrateur, qui peut faire tout ce qu il veut sur le site et l utilisateur Anonyme, qui a des droits restreints. Vous pourrez constater qu il est possible d autoriser ou d interdire des actions de chaque module de Drupal selon les profils d utilisateur. Dans cet exemple vous allez permettre aux utilisateurs anonymes de participer aux conversations de la tribune.

38 38 I - Démarrage rapide Cliquez sur Se déconnecter dans le bloc admin. En vous déconnectant, vous êtes considéré comme utilisateur anonyme par Drupal. Comme vous pouvez le constater le menu Tribune n est plus disponible : l utilisateur anonyme ne possède pas les droits pour accéder à cette fonctionnalité. Pour le vérifier, allez sur le lien direct : vous avez un accès refusé. L utilisateur anonyme se voit refuser l accès à la Tribune Vous allez maintenant modifier les droits d accès pour que les utilisateurs anonymes puissent utiliser la tribune. Reconnectez vous en administrateur avec le login/mot de passe admin/atelierdrupal. Cliquez sur Administrer - Gestion des utilisateurs - Droits d accès. Rendez vous à la section module tribune. Dans la colonne utilisateur anonyme, cochez access tribune history qui autorise l accès à l historique de la tribune. Cochez aussi access tribune qui autorise la consultation des messages échangés dans la tribune. Enfin, cochez post tribune qui autorise l ajout de nouveaux messages dans la tribune. La gestion des droits sur le module Tribune

39 3 - A la découverte de Drupal 39 Cliquez sur Enregistrer les droits d accès Cliquez à nouveau sur Se déconnecter dans le bloc admin. Le menu Tribune est maintenant accessible aux utilisateurs anonymes. Les anonymes peuvent discuter à la Tribune! 3.6. Modification de l apparence de Drupal Un thème dans Drupal est un ensemble de fichiers qui constitue l apparence graphique de votre site. Vous aurez peut-être l envie de personnaliser l aspect de Drupal. Cela est tout à fait possible, mais, suivant votre niveau d exigence, ce peut être une tâche très simple à réaliser ou très compliquée. La réalisation et la modification des thèmes sont abordés dans la Partie IV - Modifier l apparence de votre site de ce livre. Ici, le but est d avoir un aperçu des possibilités de Drupal, vous allez donc d abord personnaliser le thème par défault (Garland) grâce à l interface de Drupal, puis, vous activerez d autres thèmes présents par défaut dans Drupal et enfin, vous téléchargerez et installerez, comme pour les modules, un thème depuis internet. Configuration du thème par défault L interface d administration de Drupal permet de modifier quelques paramètres du thème. Reconnectez vous en admin/atelierdrupal. Allez sur Administrer - Construction du site - Thèmes. Comme vous pouvez le constater le thème activé par défaut est Garland.

40 40 I - Démarrage rapide La page d administration des thèmes Cliquez sur l opération configurer en face de ce thème. Essayez alors de changer les couleurs du thème. Garland change de couleur! Essayez également d autres thèmes très différents de Garland comme PushButton ou Marvin et voyez comme il est possible de modifier l apparence de Drupal en profondeur.

41 3 - A la découverte de Drupal 41 La sobriété du thème Marvin Installation d un thème externe Comme pour les modules, il existe quelques thèmes installés par défaut sur Drupal, d ailleurs souvent sélectionnés pour leur coté technique, et un grand nombre à télécharger sur internet. Vous allez maintenant télécharger et installer un thème de drupal.org. Créez le répertoire votre_repertoire_drupal/sites/all/themes : Comme pour les modules, c est dans ce répertoire qu il faudra extraire les thèmes téléchargés. sous Windows : C:\wamp\www\drupal\sites\all\themes sous Linux : /home/nom_utilisateur/drupal/sites/all/themes Allez dans la section Download du site web Drupal ( et choisissez la section Thèmes. Recherchez le thème Four Seasons et téléchargez la dernière archive pour la version 6.x de Drupal (version utilisée pour ce livre fourseasons-6.x-1.20). Extrayez le contenu de l archive dans le répertoire précédemment créé. Chaque thème doit avoir son répertoire propre. Retournez dans Administrer - Construction du site - Thèmes. Vous devez voir apparaître le nouveau thème 4 Seasons.

42 42 I - Démarrage rapide Cochez la case Activé et l option Par défaut. Le thème 4 Seasons est disponible Cliquez sur le bouton Enregistrer la configuration. Changez de couleur et de taille de police grâce aux options en haut à gauche de la page. L interface de configuration originale de 4 Seasons Cette découverte de Drupal touche à sa fin. Vous savez maintenant mieux ce qu est Drupal et à quoi il peut servir.

43 3 - A la découverte de Drupal 43 Partie II - Utiliser Drupal

44 Utiliser Drupal Tout 44 I - Démarrage rapide Vous avez découvert un grand nombre de fonctionnalités de Drupal dans la première partie. Le but de cette deuxième partie est d approfondir ces découvertes. - d abord vous apprendrez comment surveiller votre installation et en modifier les paramètres principaux en lisant le chapitre 4. Administrer Drupal. Après la lecture du chapitre 5. Les modules, la recherche et l installation des modules n auront plus aucun secret pour vous. C est en installant d autres modules au chapitre 6. Le contenu que vous pourrez proposer une interface riche à vos utilisateurs pour qu ils puissent ajouter facilement du contenu à votre site. Au chapitre 7. Organiser son site, vous apprendrez à organiser ce contenu pour que votre site garde une cohérence lorsqu il prendra de l importance. Enfin, c est au chapitre 8. Le travail collaboratif sous Drupal que vous découvrirez comment permettre à de nouveaux utilisateurs d enrichir votre site en leur accordant les droits d accès adéquats. 4. Administrer Drupal Vous découvrirez, dans ce chapitre, trois pages essentielles à Drupal : La page Administrer qui peut s apparenter à une porte d entrée pour l administrateur de Drupal. La page Tableau de bord qui vous informe sur l état de fonctionnement de Drupal. La page Paramètres du site qui permet de régler les paramètres généraux du site La page Administrer Rendez vous maintenant sur la page administrer de Drupal en cliquant sur le lien Administrer de la colonne de gauche. Elle présente l ensemble des fonctionnalités qui permettent d administrer graphiquement votre site. La liste des fonctionnalités d administration est longue, mais vous disposez de deux modes d affichage, par tâche ou par module, pour vous faciliter l appropriation de l interface.

45 4 - Administrer Drupal 45 La page Administrer L affichage par tâche Il regroupe les fonctions d administration en 5 ensembles : Gestion du contenu : Classer, lister, approuver tous les contenus de Drupal. Gestion des utilisateurs : Gérer les utilisateurs de votre site, les groupes et les droits d accès aux fonctionnalités. Rapports : Surveiller l activité de votre site et les éventuels problèmes rencontrés par les visiteurs. Construction du site : Contrôler et organiser l affichage de Drupal. Configuration du site : Ajuster la configuration du site et des modules ajoutés. Lors de la découverte, l option afficher les descriptions vous aide à comprendre les fonctions de chaque module. Ultérieurement, vous pourrez les masquer pour rendre cette page plus succincte et lisible

46 46 I - Démarrage rapide L affichage par tâche sans description L affichage par module Elle regroupe les fonctions d administration par module en permettant l accès direct aux différentes pages de configuration pour chaque module. L affichage par module La classification par module peut être utile lorsque vous installez un nouveau module et que vous recherchez ses pages de configuration.

47 4 - Administrer Drupal 47 La page Administration signale dans un encadré si des problèmes existent sur votre installation. Si le message est entouré de vert, c est un conseil. S il est en rouge, c est une recommandation importante. Rendez vous alors dans le Tableau de bord pour gérer l anomalie Administration Menu : Navigation facile dans l administration Si vous ne savez pas encore comment installer ces modules, vous l apprendrez au chapitre 5. Les modules Le tableau de bord Le tableau de bord vous informe sur l état de santé et les performances de votre installation Drupal. Allez sur la page du tableau de bord : Administrer - Rapports - Tableau de bord Une partie du tableau de bord où quelques problèmes sont signalés Ce tableau détaille la configuration de Drupal, signale les problèmes et donne des recommandations : les mises à jour disponibles du cœur de Drupal ou des modules installés, les versions de programmes Apache ou Php, les librairies, les droits d accès aux systèmes de fichiers, etc. Dans l illustration ci-dessus, un problème critique de mise à jour est signalé sur fond rouge ainsi qu un problème de mémoire alloué à Php sur fond jaune.

48 48 I - Démarrage rapide Sections du tableau de bord : Drupal Accès au fichier update.php Base de données MySQL Etat de mise à jour de Drupal core Fichier de configuration Librairie GD Librairie Unicode Mise à jour de la base de données PHP PHP register globals Plafond mémoire de PHP Serveur web Version de Drupal Normalement, ce fichier est protégé. update.php est un script qui permet de mettre à jour Drupal (voir chapitre Update Status : Mettre à jour de Drupal). Version de MySQL. Si vous cliquez sur le lien, une page affiche des informations supplémentaires (Compteurs et performances). Indique si une nouvelle version de Drupal est disponible Ce fichier doit être protégé car settings.php contient des informations sensibles sur votre installation (mot de passe MySQL). Ensemble de fonctionnalités qui permettent de manipuler des images. Drupal peut fonctionner sans, mais elle est nécessaire à de nombreux modules. Ensemble de fonctionnalités permettant d afficher les caractères de différentes langues. Lorsque vous mettez à jour Drupal ou des modules installés sur Drupal, il peut être nécessaire de modifier la structure de votre base de données. Dans ce cas, un message apparaîtra ici (voir chapitre Update Status : Mettre à jour de Drupal). Version de PHP. Si vous cliquez sur le lien, la page phpinfo() s affiche. Indique s il est possible de partager des variables avec d autres applications. Mémoire allouée par le système à PHP (voir chapitre 9.2. Configuration de Php). Nom et version du serveur web sur lequel Drupal est installé. Statut de mise à jour des modules et thèmes Notifie si de nouvelles versions de vos modules et thèmes externes existent. Système de fichiers Tâches de maintenance cron Indique si votre répertoire sites/default/files est accessible en écriture. Date de la dernière exécution de Cron (voir chapitre Le cron) Update Status : Mettre à jour de Drupal 4.3. Les paramètres du site Informations de base Rendez-vous sur la page Administrer - Configuration du site - Informations de base

49 4 - Administrer Drupal 49 Les informations de base de votre site Vous pouvez changer ici les paramètres principaux du site : Nom Adresse Slogan Objectifs Message de pied de page Page de garde par défaut Nom du site qui apparaît dans l entête. Adresse mail de l administrateur du site. Cette adresse est aussi celle qui sera utilisée pour l envoi des mails, par exemple lorsqu un nouvel utilisateur est créé. S affiche à coté du nom du site. S affiche en page d accueil. S affiche en bas de la page. Entrez ici le chemin de la page d accueil de votre site, soit avec une URL simplifiée, soit avec une URL complète.

50 50 I - Démarrage rapide La position des paramètres de base de votre site sur la page d accueil Connaître l ensemble de ces paramètres et leur incidence est nécessaire lorsque vous modifiez ou personnalisez l affichage de Drupal. Par exemple, ajouter un Slogan dans l en-tête sans utiliser cette page peut s avérer fastidieux. Il est possible d afficher ou de cacher ces champs : h h Allez pour cela sur la page de configuration des thèmes : Administration - Construction du site - Thèmes puis Configurer - Paramètres globaux.

51 4 - Administrer Drupal 51 Les paramètres globaux Modifier le logo et l icône du site Gestion des erreurs Pour mieux connaître les difficultés rencontrées par vos utilisateurs lors de leur visite sur votre site, il existe 2 pages de rapports d erreurs. Retrouvez la liste de ces erreurs sur les pages Administrer - Rapports - Principales erreurs de type accès refusé et Administrer - Rapports - Principales erreurs de type page non trouvée :

52 52 I - Démarrage rapide Les fichiers non trouvés dans votre site Pour modifier le texte des pages Accès Refusé ou Page non trouvée, rendez-vous sur la page Administrer - Configuration du site - Rapports d erreurs 5. Les modules Personnalisation des pages d erreurs Les modules sont des petits programmes qui permettent d ajouter des fonctionnalités à Drupal. Dans le chapitre 3.4. Les modules, vous avez découvert comment Drupal fonctionnait avec des modules : vous avez activé le module Poll et installé le module Tribune.

53 5 - Les modules 53 Dans ce chapitre, vous allez tout d abord en activer un nouveau : le module «livre», présent dans le corps de Drupal. Vous découvrirez ensuite les fonctionnalités ajoutées par ce module. Puis, vous apprendrez à optimiser vos recherches de modules sur le site drupal.org. Enfin, vous installerez le module Administration Menu préalablement téléchargé sur drupal.org Activation et découverte d un module Les modules les plus utiles sont installés par défaut dans Drupal, mais tous ne sont pas activés. Le module Book, qui permet de créer des livres coopérativement, fait partie des modules installés par défaut. Vous allez activer ce module et découvrir les fonctionnalités qu il apporte à Drupal. Activation du module Book Rendez-vous dans Administration - Construction du site - Modules. Vous obtenez la liste de tous les modules installés sur votre site. Ceux qui ont la case cochée sont activés, les autres ne le sont pas. Activez le module Book. La page d administration des modules Cliquez sur le bouton Enregistrer la configuration Certains modules peuvent nécessiter d autres modules pour fonctionner. Ces informations sur les dépendances des modules sont indiqués sur cette page grâce aux mentions Dépend de et Requis par

54 54 I - Démarrage rapide Découverte du module Book Le module Book est maintenant activé. Vous allez le découvrir en créant un Livre de test qui contiendra 3 pages hiérarchisées : Livre de test Chapitre 1 Chapitre 2 Chapitre 2.1 Cliquez sur Créer un contenu : vous avez maintenant accès à un nouveau type de contenu : Page de livre. Créez une nouvelle page qui a pour Titre Livre de test. Dans la section Structure du livre, choisissez <créer un nouveau livre>. Cliquez sur le bouton Enregistrer. La première page de votre livre Votre Livre de test est maintenant créé. Vous allez y ajouter la page Chapitre 1 : Cliquez sur le lien Ajouter une page enfant. Donnez à cette page le Titre Chapitre 1. Cliquez sur le bouton Enregistrer. Ajoutez la page Chapitre 2 : Cliquez à nouveau sur Créer un contenu. Ajoutez une nouvelle Page de livre avec en Titre Chapitre 2. Dans la section Structure du livre, choisissez Livre de test.

55 5 - Les modules 55 Dans la section Elément parent choisissez également Livre de test. Cliquez sur le bouton Enregistrer. Ajouter une page et la positionner dans le livre Créez votre dernière page en cliquant sur Ajouter une page enfant à la page Chapitre 2 Mettez en Titre Chapitre 2.1. Cliquez sur le bouton Enregistrer. Les trois pages sont maintenant créées, voyez comment elles sont organisées : Allez sur la page Administrer. Choisissez le tri Par module. La section Book regroupe tous les liens qui permettent de configurer le module Book Vous pouvez constater qu une nouvelle section Book a été ajoutée. Cliquez sur le lien Livres de cette section.

56 56 I - Démarrage rapide La page de configuration des livres Vous retrouvez ici la liste des livres de votre site. Le livre Livre de test que vous venez de créer est donc le seul présent dans cette liste. Cliquez sur le lien modifier l ordre et les titres. Constatez comme il est facile d organiser les différentes pages créées grâce à l outil La page de configuration qui permet d organiser les livres Vous avez maintenant découvert quelques fonctionnalités du module Book de Drupal et notamment ses pages d administrations et sa section de configuration qui apparaît lors de la création d une page. Vous découvrirez encore d autres fonctionnalités au fur et à mesure de la lecture de ce chapitre. Le module Book est présent par défaut lorsque vous installez Drupal, il suffit de l activer pour y avoir accès. Vous allez maintenant installer un nouveau module téléchargé depuis internet Rechercher un module sur drupal.org Le site de référence pour télécharger de nouveaux modules pour Drupal est le site officiel Il est entièrement en Anglais mais bien organisé. Vous allez ici découvrir l interface du site web de drupal. org, comment l utiliser et trouver la traduction des liens les plus couramment rencontrés. Rendez vous sur le site Cliquez ensuite sur le lien Download puis Modules ou sur l image

57 5 - Les modules 57 Si vous êtes un utilisateur enregistré, ce qui est conseillé si vous pensez vous rendre régulièrement sur ce site, vous pouvez afficher uniquement les modules compatibles avec votre version de Drupal. Etant donné qu il y a plus de 1000 modules disponible pour la version 6 de Drupal, c est déjà ça de gagné pour faciliter votre recherche! Le tri des modules par version Recherche de modules La page du projet d un module est toujours de la forme Si vous ne connaissez pas le nom exact du module, vous pouvez rechercher vos modules sur le site de quatre façons différentes : Grâce au champ de recherche (Search downloads) Par catégorie (Browse by category) Par nom (Browse by name) Par date (Browse by date) Champ à ne pas confondre avec le champ Search de drupal.org qui permet de rechercher sur l ensemble du site (y compris dans les forums, la documentation, etc.) A utiliser si vous voulez lister tous les modules existants pour une tâche précise. Sachez qu un module peut appartenir à plusieurs catégories. Liste tous les modules par ordre alphabétique sur plusieurs pages. Liste les modules en fonction de leur date de dernière mise à jour. Cette classification permet de savoir quels sont les derniers modules sortis. Allez maintenant sur la page du module AdministrationMenu (

58 58 I - Démarrage rapide La page du module s affiche alors : Le module Administration menu sur drupal.org La page d un module sur drupal.org Description du module : Tout d abord un texte décrit le module. Il est éventuellement accompagné d une copie d écran. Releases : Ensuite, vous avez la liste des versions disponibles du module. Ici, il existe des versions stables pour les versions 4.7.x, 5.x et 6.x de Drupal et des versions de développement pour les versions 5.x, 6.x et 7.x de Drupal. Pour plus de renseignements sur les différentes versions du module, vous pouvez cliquer sur le lien View all releases. S afficheront alors les anciennes versions du module. Les différentes version du module

59 5 - Les modules 59 Ressources : C est dans cette section que vous trouverez les liens éventuels vers la documentation du module (Read documentation) et éventuellement un lien vers un site de démonstration (Try out a demonstration). La section liens du module Support : C est ici que les utilisateurs du module peuvent échanger avec les développeurs du module. View open issue or create one View all issues View all support requests View pending feature requests Search issues Report a security issue Voir toutes les questions ouvertes ou en poser une nouvelle Voir toutes les questions sur le module Voir toutes les demandes de support Voir les demandes de fonctionnalités en suspend Rechercher dans les questions Rapporter un problème de sécurité La page de suivi sur drupal.org Lorsque vous cliquez sur l un de ces liens, vous arrivez à la page Issues (Questions) du module. La page de suivi du module SimpleMenu

60 60 I - Démarrage rapide Vous pouvez alors régler les paramètres de quatre listes déroulantes : Project Status Category Priority Nom du projet Statut de la demande (Demande en cours, déjà demandée, terminée, corrigée, etc.) Type de demande (rapport de bug, demande d ajout de fonctionnalité, demande d aide, etc.) Niveau de priorité de la question 5.3. Installer un module Vous avez trouvé le module, il s agit maintenant de le télécharger et de l installer. Téléchargement et installation des sources Vous pouvez télécharger l archive du module Administration menu correspondant à la version 6.x stable de Drupal (Version utilisée pour ce livre 6.x-1.1). Télécharger les sources du module SimpleMenu Il faut maintenant extraire votre archive pour que le module puisse être activé dans Drupal, vous avez le choix entre plusieurs répertoires : /sites/all/modules /sites/default/modules /sites/exemple.fr/modules Le module sera accessibles depuis tout les sites présent sous votre instance de Drupal. Le module ne sera disponible que sur le site par défaut de Drupal. Le module ne sera disponible que sur le site exemple.fr (Voir chapitre 10. Gérer ses différents sites Drupal). L arborescence de Drupal : ou décompresser les sources des modules?

61 5 - Les modules 61 Dans cette illustration : Tous les sites ont accès aux modules backup_migrate, img_filter, tribune (répertoire all). Seul le site par défaut a accès au module simplemenu (répertoire default). Le site test.drupal.tld n a pas accès au module simplemenu. Ce n est pas parce qu un module est accessible depuis tous les sites qu il doit être activé sur tous les sites. Notez bien que chaque module possède son propre répertoire. N ajoutez jamais de module au répertoire racine /modules de Drupal. Celui-ci n est utilisé que pour les modules installés par défaut dans Drupal. Extrayez maintenant l archive Administration menu dans le répertoire /sites/all/modules. Activez ce module sur la page Administrer - Construction du site - Modules dans la section Administration. Cliquez sur le bouton Enregistrer la configuration. Activation du module Administration Menu Vous devriez alors voir apparaître un joli menu qui facilitera votre vie d administrateur de Drupal! Le module Administration menu en action! Ce module est très populaire chez les administrateurs de Drupal. Il permet presque de s affranchir du bloc d administration et de ses innombrables rechargements de page. Cependant, il peut-être organisé différemment, par exemple, pour créer un contenu, il faut aller dans Gestion du contenu - Créer un contenu plutôt que directement dans Créer un contenu dans le bloc d administration.

62 62 I - Démarrage rapide 6. Le contenu Drupal est un gestionnaire de contenu : dans ce chapitre vous verrez comment les différents utilisateurs de votre site vont pouvoir y ajouter du contenu. Vous découvrirez comment présenter ce contenu grâce à des outils de mise en forme de texte, d interfaces pour ajouter des images, etc. Enfin, vous apprendrez comment organiser le contenu créé et le classer Les types de contenu Rendez-vous sur la page Créer un contenu. Vous avez ici le choix entre plusieurs types de contenu : Article, Page, Sondage, etc. Les différents types de contenu disponibles Différences entre Article et Page Il existe par défaut dans Drupal deux types de contenu : Articles et Pages. Ils sont très proches dans la forme, mais différents dans l utilisation : Par exemple, pour un site de nouvelles, on créera un contenu de type Page pour présenter le site. Par contre, pour les nouvelles proprement dites, on choisira un contenu de type Article qui permettra aux lecteurs de laisser des commentaires, d afficher les nouveaux articles sur la page d accueil. En activant des modules, vous pouvez également ajouter des types de contenu à la liste comme cela c est passé pour le module Poll (Ajout du type de contenu Sondage) et Book (Ajout du type de contenu Book page).

63 6 - Le contenu 63 Créez un nouvel Article en cliquant sur Créer un contenu - Article. Vous pouvez, comme vous l avez vu dans le chapitre 3.1. Le contenu ajouter un Titre à l Article, puis un contenu (Corps). Un bouton permet de créer un résumé de l article pour la page d accueil ou pour d autre pages qui présentent plusieurs articles. Tout en bas de la page d ajout, il y a une section Options de publication. Publié Promu en page d accueil Epinglé en haut des listes Options de publication L article est disponible à tous les visiteurs de votre site. Par exemple, si vous considérez que votre article est encore à l état de brouillon mais que vous voulez l enregistrer, décochez cette option. Si cette case est cochée, le résumé de l article apparaîtra sur la page d accueil du site. Si cette case est cochée en même temps que Promu en page d accueil, alors, l article sera affiché avant tous les autres. Par défaut, l Article est Promu en page d accueil et la Page ne l est pas. Options des types de contenu Rendez-vous sur la page Administrer - Gestion du contenu - Type de contenu. Vous retrouvez ici la liste des contenus disponibles pour votre site. Vous pouvez modifier les options par défaut de chaque type de contenu. Cliquez sur le lien modifier du type de contenu Article. Vous pouvez modifier ici les paramètres du contenu article : Son nom, les libellés des champs Titre et Corps, la Description, etc. Mais, en-dessous, vous pouvez également modifier les paramètres par défaut des différentes sections qui s ajouteront en fonctions des modules installés (Ici, Procédures de publication et Paramètres des commentaires).

64 64 I - Démarrage rapide Les paramètres des types de contenu 16. CCK : Créez des types de contenu personnalisés 6.2. Les formats d entrées Vous avez certainement envie de mieux présenter votre contenu, d y ajouter des styles de caractères ou même des images. Rendez-vous sur la page de la mousse au chocolat, éditez là en cliquant sur le bouton Modifier. Vous aller utiliser des balises html pour agrémenter la présentation de votre recette : Les balises HTML sont des commandes interprétés par les navigateurs internet. Elles sont saisies entre les signes «<» et «>». En général, les balises de début (exemple : <strong>) ont une balise de fin (</strong>) Des balises dans les articles

65 6 - Le contenu 65 Mettez les ingrédients en gras grâce à la balise <strong>. Cliquez sur le bouton Enregistrer et voyez le résultat. Mise en gras de Ingrédients Editez à nouveau la page et remplacez la balise <strong> par la balise <b> (mise en gras en HTML) : la mise en gras ne fonctionne plus : la balise <b> n est pas autorisée. Cliquez à nouveau sur Modifier. Rendez-vous alors la section Formats d entrée, et sélectionnez le format Full HTML. Cliquez sur Enregistrer. La mise en gras fonctionne à nouveau. La section des formats d entrées de l article Les formats d entrées permettent donc d autoriser l interprétation de certaines balises dans votre contenu. Il existe par défaut 2 formats d entrées : Filtered HTML et Full HTML. Filtered HTML est moins permissif et donc plus sécurisé. Cliquez sur le lien Plus d informations sur les options de formatage pour connaître les balises acceptées par ces deux formats.

66 66 I - Démarrage rapide 6.3. BBCode : Ajout d un format d entrée Certains modules ajoutent des formats d entrées pour étendre les possibilités de mise en forme de contenus. Vous allez maintenant installer le module BBCode qui ajoute à Drupal un filtre qui permet l utilisation de balises qui simplifient le langage HTML. Ces balises BBCode sont très utilisées pour la mise en forme des messages dans les forums de discussions. Installation du module Téléchargez (Version utilisée pour ce livre 6-x-1.2) et activez le module (Voir Chapitre Installer un module). Création d un format d entrée pour BBCode Rendez-vous sur la page d administration des formats d entrée : Administrer - Configuration du site - Formats d entrée. Ajoutez alors un format d entrée spécifique pour les BBCodes : Cliquez sur Ajouter un format d entrée. Entrez BBCode dans le champ Nom. Cochez dans la section Rôles : Utilisateur identifié. Puis, cochez les filtres BBCode et Convertisseur de saut de ligne. Cliquez sur Enregistrer la configuration. Ajout d un format d entrée

67 6 - Le contenu 67 Utilisation Créez un nouvel article et sélectionnez BBCode dans la section Format d entrée. Un fichier de test est présent avec l archive du module BBCode : dans /sites/all/modules/bbcode/bbcodetest.txt, faites un copier/coller de ce fichier dans un nouvel article (Créer un contenu - Article). Résultat de la page de test bbcode_test.txt Ce qu il faut retenir Un format d entrée (Full HTML, Filtered HTML, etc.) est affecté à un contenu (Article, Page, etc.). Des filtres (BBCode, Filtre HTML, etc) composent un format d entrée Footnotes : Ajoutez des notes de bas de page à vos contenus Geshi Filter : Colorisation syntaxique de code 6.4. PHP filter : Ajout de code Php dans votre contenu Il est possible d ajouter du code Php directement dans votre contenu. Pour cela, il faut activer le module PHP filter (module installé par défaut), vous aurez alors accès à un nouveau format d entrée PHP Code. Installation Activez le module PHP filter comme vu au chapitre Activation et découverte d un module.

68 68 I - Démarrage rapide Utilisation Créez un article : Créer un contenu - Article Titre : Date et heure Corps : <?php $date = date(«d-m-y»); $heure = date(«h:i»); Print(«Nous sommes le $date et il est $heure»);?> Format d entrée : PHP Code. Cliquez sur Enregistrer. Du code Php dans un contenu 6.5. NicEdit + Wysiwyg : Installer un éditeur Wysiwyg Le module BBCode peut faciliter la vie des contributeurs de votre site grâce à un langage moins compliqué que le HTML. Mais, vous avez peut-être envie de proposer quelque chose d encore plus convivial à vos utilisateurs. Il existe pour cela des éditeurs Wysiwig (What You See Is What You Get - Ce que vous voyez est ce que vous avez). Vous allez ici installer un module qui permet la prise en charge d éditeurs Wysiwyg que vous affecterez à certains formats d entrée : Wysiwyg. Ensuite, vous installerez un éditeur : NicEdit, qui est très léger et facile à installer. Installation Téléchargez, décompressez et activez le module Wysiwyg (Version utilisée pour ce livre : 6.x-0.5). Configuration Une page vous indique quels sont les éditeurs installés sur votre configuration : Administrer - Configuration du site - Wysiwyg.

69 6 - Le contenu 69 La page de configuration de Wysiwyg Bien sûr, il n y a pour l instant aucun éditeur installé. Cependant, Wysiwyg indique où les télécharger et leurs chemins d installation. Créez le répertoire sites/all/modules/wysiwyg/nicedit (comme vous l indique Wysiwyg) Cliquez sur le lien Download de NicEdit. Cliquez sur le bouton Download du site nicedit.com Extrayez le contenu de contenu de l archive dans le répertoire précédemment créé. Retournez sur la page Administrer - Configuration du site - Wysiwyg. Vous pouvez maintenant choisir un éditeur pour chaque format d entrée. Choisissez Nicedit pour le format Full HTML. Cliquez sur Enregistrer. Choix d un Editeur pour les formats d entrées

70 70 I - Démarrage rapide Sur cette page, en cliquant sur le bouton modifier d un format d entrée, il est possible de configurer les paramètres de votre éditeur. Utilisation Créez un nouvel Article et testez! N oubliez pas de choisir le format d entrée Full HTML. NicEdit permet de mettre en page graphiquement les contenus Création d un format d entrée spécifique Avec NicEdit, il est conseillé de créer un nouveau format d entrée qui permet le Full HTML sans retour automatique à la ligne pour éviter d avoir des problèmes de sauts de lignes intempestifs : Rendez-vous sur la page d administration des formats d entrée : Administrer - Configuration du site - Formats d entrée. Cliquez sur l onglet Ajouter un format d entrée. Nom : Full HTML sans remise à la ligne. Cochez le rôle utilisateur authentifié. Cochez les filtres HTML corrector et filtre URL. Ajout d un format d entrée pour NicEdit

71 6 - Le contenu 71 Cliquez sur le bouton Enregistrer la configuration. Utilisez toujours ce format lorsque vous créez un contenu avec NicEdit FCKeditor : Un éditeur Wysiwyg complet XStandard WYSIWYG Editor : Un éditeur Wysiwyg coté client NicEdit sera considéré comme désactivé pour les exercices suivants de ce livre Inline : Ajoutez des images à votre contenu Le module Inline permet d ajouter des images à vos articles. Inline crée un nouveau filtre pour vos formats d entrées et utilise ensuite le module Upload (dont l utilisation sera détaillée dans le prochaine chapitre) pour télécharger les images vers Drupal. Il suffira ensuite d utiliser la balise [Inline] pour placer les images à l endroit désiré. Installation Téléchargez et décompressez le module Inline (version utilisée pour ce livre : 6.x-1.0). Inline est dépendant du module Upload, vous devez donc activer ces deux modules. Configuration Il faut maintenant ajouter le filtre Inline file filter dans un format d entrée. Ici, vous allez l ajouter dans Filtered HTML : Administrer - Configuration du site - Formats d entrée. Cliquez sur le lien configurer du format Filtered HTML. Cochez la case Inline file filter de la section Filtres. Cliquez sur le bouton Enregistrer la configuration. Vous pouvez maintenant régler quelques paramètres sur la page d administration du module : Administrer - Configuration du site - Inline.

72 72 I - Démarrage rapide Page de configuration de Inline Vous pouvez choisir ici d afficher l image seulement (Display image only) ou avec un lien vers le fichier image (Display image with a link to the image file). Inline n affichera pas les images ayant une résolution supérieure au paramètre Maximum width and height for inline images. Le paramètre Maximum width and height for inline images ne redimensionne pas les images! Pour cela, il faut utiliser le module ImageCache. Pour cet exemple, régler les paramètres comme cela : Sélectionnez Display image with a link to the image file. Maximum width and height for inline images : 1024,1024. Cliquez sur Enregistrer la configuration. Utilisation Vous allez maintenant éditer la page de la recette de la soupe japonaise et lui adjoindre des photos : Afficher la recette de la soupe japonaise. Cliquez sur Modifier. Vérifiez bien que le Format d entrée Filtered HTML est bien sélectionné.

73 6 - Le contenu 73 Selection du filtre Filtered HTML acceptant les tag inline Il faut maintenant télécharger les fichiers à la section Fichiers attachés ajoutée grâce au module Upload : Cliquez sur le bouton Parcourir... de la section Fichiers attachés. Choisissez la photo à insérer (disponible sur Cliquez sur le bouton Attacher. L image s ajoute à la liste de la section Fichiers attachés. Pour finir, il faut insérer le tag inline dans le corps de l article : Positionnez votre curseur au début de la recette. Insérez le code : [inline:1] (pour afficher première image de la liste des fichiers attachés). Cliquez sur Enregistrer. Insertion du tag Inline dans le corps de l article

74 74 I - Démarrage rapide Une photo dans votre article! Si vous éditez à nouveau l article, le tag inline sera transformé en [inline:soupe_japonaise_5. JPG], le numéro de l image a été remplacé par le nom du fichier. Vous pouvez utiliser directement ce type de notation avec inline. Vous pouvez également ajouter l attribut HTML Alt à votre image en utilisant la notation [inline:1=soupe] ImageCache : Manipulez vos images avant de les afficher 6.7. Attacher des fichiers à vos contenus grâce au module Upload Une autre méthode qui permet d ajouter des images à votre contenu est d utiliser le module Upload. Avec ce module, vous téléchargez vos fichiers vers votre serveur et ensuite, vous ajoutez un lien dans votre contenu qui pointe vers ce fichier. Upload est plus compliqué à utiliser que Inline, mais il présente l avantage de pouvoir attacher n importe quel type de fichier (Image, Vidéo, PDF, etc.) Installation Activez le module Upload présent par défaut dans Drupal (Si vous ne l avez pas déjà fait pour le module Inline). Utilisation h h Créez un nouvel Article et pointez vers un fichier PDF quelconque de votre disque dur dans la section Fichiers attachés.

75 6 - Le contenu 75 Cliquez sur le bouton Attacher. Attacher un fichier à votre article Sauvegardez votre contenu, vous aurez ainsi un lien, à la fin de l article vers le fichier attaché par Upload. L article et son fichier attaché Pour plus de convivialité, vous pouvez insérer un lien vers le fichier attaché directement dans le contenu grâce à la balise html <a>. Pour cela, il faut savoir que tous vos fichiers téléchargés avec le module Upload sont placés dans le répertoire files de votre site (par exemple :./sites/defaut/files). N oubliez pas de choisir le format d entrée Full HTML pour autoriser les balises <a>.

76 76 I - Démarrage rapide Voici le code pour l exemple précédent : Création d un hyperlien vers le fichier attaché dans votre contenu Rendu de la page avec l hyperlien Vous pouvez créer directement vos liens avec NicEdit avec le bouton Add Link. Configuration Vous pouvez régler quelques paramètres du module Upload sur la page Administrer - Configuration du site - Transferts de fichiers. N oubliez pas que vous pouvez également accéder à cette page via Administrer, onglet Par module, section Upload.

77 6 - Le contenu 77 Les options du module Upload Vous pouvez régler ici : la taille maximale des images, si les liens vers les fichiers doivent apparaître à la fin du contenu et les types de fichiers acceptés. Vous pouvez également régler la taille maximale de chaque fichier. Si vous voulez augmenter cette taille, il faut modifier le fichier php.ini comme indiqué dans le chapitre 9.2. Configuration de Php. Il est également possible d autoriser les fichiers attachés uniquement pour certains types de contenus : Allez sur la page Administrer - Gestion du contenu - Types de contenu. Modifiez ensuite le type de contenu concerné, Article par exemple, en cliquant sur le lien Modifier. Rendez-vous à la section Procédures de publication. Cochez le choix Désactivé. Cela désactivera la possibilité de télécharger des fichiers dans les Articles.

78 78 I - Démarrage rapide 6.8. Organiser le contenu Qu est-ce qu une Node? Une node dans Drupal est un contenu de n importe quel type Article Page Page de livre Sondage etc. Cela ne veut pas dire que tout est une node dans Drupal : Un commentaire n est pas une node mais est attaché à une node Une page d administration n est pas une node Page de gestion des contenus Rendez-vous à la page Administrer - Gestion du contenu - Contenu S affiche alors la liste de toutes les nodes présentes sur votre site. Cette page est très importante pour surveiller l activité de votre site ou pour retrouver un contenu particulier. Liste des nodes du site

79 6 - Le contenu 79 A partir de cette page, vous pouvez également effectuer des actions sur une ou un ensemble de nodes. Vous pouvez restreindre cette liste par statut (publié, non publié, promu, etc.), par type de contenu ou par langue. Par défault, trois types de filtres (statut, type, langue) sont activés mais en ajoutant des modules, il est possible que d autres filtres apparaissent. Vous pouvez également combiner ces critères comme sur l illustration suivante : Combinaison de critères pour la sélection des nodes Pour annuler les critères de tri, cliquez sur le bouton Réinitialiser. Vous pouvez ensuite sélectionner une ou plusieurs nodes de la liste en cochant la case devant chaque node. Pour sélectionner l ensemble des nodes, cochez la case de la première ligne (Titre). Ensuite, sélectionnez une action et cliquez sur le bouton Mise à jour pour l appliquer. Liste des actions possibles à appliquer sur les nodes sélectionnée Search : Un moteur de recherche pour votre site

80 80 I - Démarrage rapide 6.9. La taxonomie La taxonomie est la science qui étudie le classement, l organisation. C est également le nom du module qui permet de classer le contenu dans Drupal. Ce module pose souvent quelques difficultés aux nouveaux utilisateurs de Drupal. Vous allez l étudier ici par le biais d un cas pratique. Imaginez un site contenant un grand nombre de recettes de cuisine. On pourrait classer ces recettes selon 3 axes : Par catégorie : Apéritif, Entrée, Plat, Dessert, Sauce Par leur origine : Asie (Chine, Vietnam) Europe (France, Italie) Par les ingrédients qui composent la recette Le but de cette classification est de permettre aux visiteurs de votre site de pouvoir rechercher des recettes selon ces trois axes. Dans Drupal, seront désignés comme vocabulaire : Catégorie, Origine, Ingrédients. Seront désignés comme termes : entrée, plat, dessert, Asie, Europe, Chine, France, chocolat, lait, etc. Ces 3 vocabulaires réagiront de 3 façons différentes : Catégorie : L utilisateur devra pouvoir choisir un ou plusieurs termes. Exemple : Un plat peut également contenir une sauce. Origine : L utilisateur ne pourra choisir qu un seul terme. Par contre un terme peut avoir un autre terme parent. Par exemple, une recette de «France» sera sélectionnée si un visiteur souhaite lister toutes les recettes d Europe. Ingrédients : L utilisateur devra saisir la liste des ingrédients de sa recette et, si le terme n existe pas encore, il devra pouvoir l ajouter directement lors de la rédaction de sa recette. Installation Le module Taxonomy est installé et activé par défaut. Ajout des vocabulaires Allez dans le menu Administrer - Gestion du contenu - Taxonomie. Cliquez sur Ajouter un vocabulaire : Nom du vocabulaire : Catégorie. Description : Catégorie de la recette. Texte d aide : Choisissez une ou plusieurs catégories pour votre recette. Types de contenu : Article.

81 6 - Le contenu 81 Ajout du vocabulaire Catégorie Paramètres : Cochez Choix multiple et Obligatoire. Poids : -5 (pour que ce soit ce paramètre qui s affiche en premier). Cliquez sur Enregistrer. De la même façon, ajoutez le vocabulaire Origine : Nom du vocabulaire : Origine. Paramètres du vocabulaire Catégorie Description : Origine géographique de la recette. Texte d aide : Sélectionnez l origine géographique de votre recette. Types de contenu : Article. Paramètres : Cochez Obligatoire. Poids : 0. Cliquez sur Enregistrer.

82 82 I - Démarrage rapide Enfin, ajoutez le vocabulaire Ingrédients Nom du vocabulaire : Ingrédients. Description : Ingrédients nécessaires à la recette. Texte d aide : Entrez ici les ingrédients nécessaires à la recette, séparés par des virgules. Types de contenu : Article. Paramètres : Cochez Etiquettes. Poids : 5. Cliquez sur Enregistrer. Liste des vocabulaires de votre site Ajout des termes Cliquez sur le lien ajouter des termes pour le vocabulaire Catégorie. Nom du terme : Entrée. Puis cliquer sur Enregistrer. Ajout d un terme à un vocabulaire De la même façon, ajoutez les termes Plat, Dessert et Sauce.

83 6 - Le contenu 83 Cliquez alors sur Liste, vous pouvez alors réarranger les termes dans l ordre que vous désirez. Liste des termes d un vocabulaire De la même façons que pour Catégorie, ajoutez les termes Asie et Europe pour le vocabulaire Origine Ensuite, ajoutez Chine, déroulez alors la section Options avancées et sélectionnez Asie dans la liste Parents Ajout d un terme enfant pour une catégorie hiérarchisée Puis ajoutez les termes Vietnam, France et Italie. Cliquez à nouveau sur Liste

84 84 I - Démarrage rapide Vous pouvez attribuer des termes parents et enfants grâce à l outil dans la liste des termes. Cette interface peut parfois s avérer plus pratique pour hiérarchiser les termes. Organisations des termes pour un vocabulaire hiérarchisé Vous pourriez mettre en place un troisième niveau de termes en découpant par exemple la France en régions. Enfin, ajoutez les termes Farine et Chocolat pour le vocabulaire Ingrédients Attribution de la Taxonomie pour le contenu Editez l article Mousse au chocolat, une nouvelle section Vocabulaire est apparue. Pour Catégorie, choisissez Dessert. Constatez que vous pouvez sélectionner plusieurs valeurs (option Choix multiple cochée). Pour Origine, choisissez France. Constatez que vous pouvez également choisir un continent, mais pas plusieurs valeurs (option Choix multiple décochée) et qu une valeur est obligatoire (astérisque jaune). h h Enfin, pour Ingrédients, entrez Oeufs, Sucre, Crème fraîche, Chocolat. L interface de Drupal vous propose les termes déjà entrés pour le vocabulaire.

85 6 - Le contenu 85 Cliquez sur Enregistrer. Les interfaces proposées par Drupal pour la section vocabulaire Retournez dans la liste de vos termes pour le vocabulaire Ingrédients Administrer - Gestion de contenu - Taxonomie. Cliquez sur le lien lister les termes du vocabulaire Ingrédients. Elle s est étoffée de tous les ingrédients de la mousse au chocolat. Le vocabulaire Ingrédients n est pas une liste finie et s enrichie h h Allez maintenant dans le menu Administrer - Gestion du contenu - Contenu, vous pouvez constater qu un nouveau filtre permet de sélectionner les nodes : la Catégorie.

86 86 I - Démarrage rapide Un nouveau filtre est présent pour la sélection des nodes Les URL s et la taxonomie Retournez sur la page d administration de la taxonomie : Administrer - Gestion de contenu - Taxonomie. Cliquez à nouveau sur le lien lister les termes du vocabulaire Ingrédients. Cliquez dans cette liste sur le terme Chocolat, vous verrez à présent une page contenant toutes les recettes ayant dans leurs ingrédients le terme Chocolat. Repérez maintenant l URL de cette page, chaque terme de la taxonomie est associé à un numéro comme pour les nodes (ici, Chocolat est le terme numéro 12). URL du terme Chocolat

87 7 - Organiser votre site 87 Retournez maintenant sur Administrer - Gestion du contenu - Taxonomie. Cliquez sur lister les termes du vocabulaire Ingrédients et glissez la souris au-dessus des liens des différents termes : dans la barre d état son numéro apparaît. Repérer facilement le numéro d un terme Il est possible de modifier les URL s pour combiner les termes. Il existe pour cela deux opérateurs : la «,» (opérateur et) et le «+» (opérateur ou) : Admettons que le chocolat soit le terme 12 et que le sucre soit le 14 : L URL taxonomy/term/12,14 affichera toutes les recettes contenant comme ingrédients le chocolat et le sucre L URL taxonomy/term/12+14 affichera toutes les recettes contenant comme ingrédients le chocolat ou le sucre 7. Organiser votre site 7.1. Path : L Alias d URLs Vous pourriez préférer avoir des URL s plus explicites que les fameux /node/15 ou taxonomy/term/12,25. Grâce au module Path, vous pouvez créer des Alias d URL qui permettent par exemple de faire correspondre /node/15 à /mousseauchocolat. Installation Le module est installé par défaut dans Drupal, il suffit donc de l activer. Utilisation Rendez-vous sur Administrer - Construction du site - Alias d url. Cliquez sur Ajouter un alias. Entrez ensuite le chemin existant puis l Alias.

88 88 I - Démarrage rapide Page de création des alias La page de la mousse au chocolat et son nouvel Alias Pathauto : Automatisez la création de vos Alias 7.2. Les blocs Dans le chapitre 3.3. Ajout d un bloc, vous avez pu voir la page qui permet de configurer les blocs dans Drupal. Un bloc est une boîte qui permet d afficher des informations pour l utilisateur. Allez sur la page de configuration des blocs : Administrer - Construction du site - Blocs. Cette page est assez intuitive à configurer : pour chaque type de blocs, vous avez une liste de choix permettant de choisir une région de la page.

89 7 - Organiser votre site 89 Liste des régions pour le positionnement des blocs Lorsque vous êtes sur cette page, vous pouvez voir les régions apparaître entourées d un trait discontinu comme sur l illustration suivante : Les régions Contenu et Pied de page Les régions sont définies par les thèmes, il se peut donc qu un thème ajoute des régions ou en supprime. Vous pouvez voir les régions relatives à un thème en cliquant sur la liste en haut de la page de configuration. Ici, vous retrouverez la liste de tous les thèmes activés (Administrer - Construction du site - Thèmes).

90 90 I - Démarrage rapide La liste des thèmes activés dans la page d administration des blocs Les types de bloc Par défaut, vous pouvez activer plusieurs types de bloc : Connexion utilisateur Navigation Commentaires récents Secondary links Propulsé par Drupal Nouveaux membres Primary links Sélecteur de langue Utilisateurs en ligne Syndication Ce bloc permet aux utilisateurs de se connecter s ils ne le sont pas. Ce bloc ne s affiche pas si l utilisateur est déjà connecté (Par défaut dans la Barre de gauche). Ce bloc permet d administrer Drupal, vous l utilisez depuis le début de ce livre! Ce bloc est modifié suivant les droits de l utilisateur connecté. Il ne s affiche pas pour un utilisateur anonyme si aucun droit ne lui est attribué (Par défaut dans la Barre de gauche). Ce bloc affiche les 10 derniers commentaires du site. Ce bloc affiche les menus secondaires (ils sont déjà affichés dans l entête par défaut). Ce bloc affiche le petit logo Drupal qui permet un lien vers (Par défaut dans le Pied de page) Ce bloc affiche les derniers utilisateurs inscrits.. Ce bloc affiche la liste des liens primaires (ils sont déjà affichés dans l entête par défaut). Ce bloc permet de sélectionner la langue du site. Ce bloc affiche le nombre d utilisateurs connectés et leur nom. Ce bloc affiche un lien vers les flux RSS de la page. Lors de l activation de modules, il est possible que vous voyez apparaître de nouveaux type de blocs en lien avec les fonctionnalités de ce module (Exemple : Tribune et Tribune User pour le module Tribune, Navigation de livre pour le module book, Sondage le plus récent pour le module Poll). Les options des blocs Cliquer sur le lien configurer en face du bloc Nouveaux membres.

91 7 - Organiser votre site 91 Options du bloc Nouveaux membres Sur cette page, plusieurs sections vous permettent d agir sur les blocs : Paramètres spécifiques du bloc Paramètres de visibilité spécifiques à l utilisateur Paramètres de visibilité spécifiques au rôles Paramètres de visibilité spécifiques à la page Modifier le titre du bloc et quelques paramètres. Modifier les droits des utilisateurs à afficher ou cacher les blocs. Permet d afficher le bloc uniquement pour certains rôles. Permet d afficher le bloc uniquement pour certaines pages ou type de contenu. Ajouter un bloc Vous allez maintenant ajouter un bloc qui affichera un message de bienvenue. Retournez sur la page Administrer - Construction du site - Blocs. Cliquez sur l onglet Ajouter un bloc. Description du bloc : Bonjour. Titre du bloc : Bienvenue. Corps du bloc : Bonjour le <b>monde</b>. Format d entrée : Full HTML.

92 92 I - Démarrage rapide Création d un nouveau bloc Cliquez sur Enregistrer le bloc, vous avez alors un nouveau bloc Bonjour disponible. Le bloc créé est dans la liste Choisissez alors la région Barre de gauche pour ce bloc. Cliquez sur Enregistrer les blocs. Affichage du bloc de Bienvenue

93 7 - Organiser votre site 93 Ajouter un bloc en PHP Si vous avez activé le module PHP filter (voir chapitre 6.4. PHP filter Ajout de code Php dans votre contenu), vous pouvez inclure du code Php dans vos blocs : Ajoutez un nouveau bloc comme précédemment. Remplissez les champs comme sur l illustration suivante. En format d entrée, choisissez PHP Code. Cliquez sur le bouton Enregistrer le bloc. Nouveau bloc contenant du Php Choisissez la région Barre de gauche pour le bloc Date et heure. Cliquez sur le bouton Enregistrer les blocs. Bloc affichant l heure dynamiquement

94 94 I - Démarrage rapide 7.3. Les menus Allez sur la page Administrer - Construction du site - Menus pour voir la liste des menus existants sur votre installation. Liste des menus du site Par défaut, il y a trois menus dans Drupal : Navigation, Liens primaires, Liens secondaires. Le menu Navigation est généralement affiché dans un bloc à gauche de la page et liste les pages d administration du site. Les liens primaires et secondaires sont généralement affichés dans l entête des pages du site, mais cela n est pas une règle et peut varier d un thème à l autre. Ajouter un élément et organiser les menus Dans Drupal, les menus sont des listes d URLs hiérarchisés. Vous pouvez ajouter des éléments à des menus directement lors de la création d un contenu grâce à la section Paramètres du menu comme vous l avez fait au chapitre 3.2. Les menus. La section Paramètres du menu lors de la création d un contenu

95 7 - Organiser votre site 95 Vous allez ici ajouter un élément de menu à partir de la page Administrer - Construction du site - Menus : Tout d abord, vous devez repérer l URL d une page de votre site. Pour cela, allez sur Administrer - Gestion du contenu - Contenu. Administrer - Construction du site - Menus. Cliquez sur Liens primaires. Puis sur le lien Ajouter un élément. Chemin : Entrez le chemin vers une node de votre site. Menu link title : Titre du lien tel qu il apparaîtra dans le menu. Description : texte affiché lors du survol du menu. Cliquez sur le bouton Enregistrer. Ajout d un élément de menu à partir de la page d administration Créer un nouveau menu et l afficher dans un bloc Vous allez maintenant créer un nouveau menu : Retournez sur la page Administrer - Construction du site - Menus. Cliquez sur le lien Ajouter un menu. Nom du menu : listerecettes. Titre : Liste des recettes. Description : La liste de toutes les recettes.

96 96 I - Démarrage rapide Cliquez sur le bouton Enregistrer. Ajout d un menu Ajoutez ensuite quelques entrées au menu comme précédemment (vers vos deux recettes par exemple). Cliquez sur Enregistrer la configuration. Les entrées dans votre nouveau menu Pour chaque menu créé, un nouveau bloc est automatiquement ajouté. Allez sur la page Administrer - Construction du site - Blocs. Activez le bloc Liste de recettes.

97 7 - Organiser votre site 97 Un nouveau bloc est créé pour chaque menu Affichage du nouveau bloc Comme vous le savez, le bloc navigation est en fait un menu. Vous pouvez donc le modifier et le réorganiser comme tous les autres menus sur la page Administrer - Construction du site - Menus - Navigation. Interface de modification du menu de Navigation

98 98 I - Démarrage rapide Déplacement des items de menus Comme vous pouvez le constater sur la capture précédente, certains modules ajoutent des entrées au menu Navigation. C est le cas du module Book (Entrée Livres qui présente la liste des livres - désactivée par défaut), mais également celui de Tribune qui propose 4 entrées (Tribune, Historique, Information, Modération) activées par défaut. Il est possible sous Drupal d organiser ces menus comme vous le désirez : vous allez par exemple ici déplacer les entrées du module Tribune vers le nouveau menu Liste des recettes que vous avez créé. Cliquez sur le lien modifier de l item Tribune du menu de Navigation. Dans la liste Elément parent, choisissez l item Liste des recettes. Cliquez sur le bouton Enregistrer. Choisissez le menu d un item en modifiant son élément parent Le bloc liste des recettes avec sa nouvelle entrée Tribune Taxonomy menu : Affichez vos vocabulaires dans des menus DHTML Menu: Améliorez la navigation dans votre site Nice Menus : Rendez vos menus dynamiques Menu Block : Divisez, liez et organisez vos blocs

99 7 - Organiser votre site Trigger : Effectuez des actions lorsque des événements se produisent Les déclencheurs sont des événements systèmes que Drupal peut rencontrer comme : Après l ajout d un article. Lorsqu un utilisateur se déconnecte. Après l ajout d un terme de Taxonomie. Les actions sont des tâches que Drupal peut effectuer comme : Envoyer un . Afficher un message à l utilisateur. Afficher une nouvelle page. Il est ensuite possible pour l administrateur de relier les déclencheurs aux actions, ce qui donnerait pour nos exemples : Après l ajout d un article, envoyer un . Lorsqu un utilisateur se déconnecte, le rediriger vers une nouvelle page. Après l ajout d un terme de Taxonomie, afficher la liste des termes. Vous pouvez donc programmer tout cela sans ajouter une seule ligne de code à Drupal grâce au module Trigger. Les actions La liste des actions disponibles se trouve sur la page Administrer - Configuration du site - Actions. Liste des actions

100 100 I - Démarrage rapide Vous pouvez ajouter de nouvelles actions grâce à la liste Rendre une nouvelle action avancée disponible. Vous allez maintenant paramétrer une nouvelle action enverra un message d encouragement : Dans la liste Rendre une nouvelle action avancée disponible, choisissez l item Afficher un message à l utilisateur. Cliquez sur le bouton Créer. Remplissez alors les champs du formulaire qui s affiche: Description : Afficher un message d encouragement à l utilisateur. Message : Merci %username d avoir participé à notre site. Cliquez sur le bouton Enregistrer. Configuration d une nouvelle action L action Afficher un message d encouragement à l utilisateur doit maintenant s afficher dans la liste. Les déclencheurs Le module qui permet de gérer les déclencheurs s appelle Trigger. Ce module est présent dans Drupal, il n est pas activé par défaut. Activez le module Trigger. Rendez-vous sur la page Administrer - Construction du site - Déclencheurs. La page contenant la liste des déclencheurs triée par module (Commentaires, Contenu, Cron, Taxonomie, Utilisateurs) s affiche alors. Choisissez maintenant l onglet relatif au Contenu. h h Dans la liste du déclencheur Après l enregistrement d un nouveau contenu, sélectionnez l action Afficher un message d encouragement à l utilisateur que nous avons créée précédemment.

101 7 - Organiser votre site 101 Cliquez sur le bouton Associer. Liste des déclencheurs relatifs au contenu Lorsque vous activerez de nouveaux modules, il se peut qu ils contiennent des déclencheurs, un nouvel onglet apparaîtra alors sur cette page. Créez alors un contenu de n importe quel type, par exemple Créer un contenu - Page. Cliquez sur le bouton Sauvegarder. Message ajouté par le Trigger après l ajout d un article

102 102 I - Démarrage rapide 8. Le travail collaboratif sous Drupal Drupal est un outil qui permet de créer des sites communautaires dont le contenu est enrichi par plusieurs utilisateurs. Drupal dispose donc d une grande quantité de fonctionnalités qui permettent au webmaster de gérer les utilisateurs de son site. Dans ce chapitre, vous découvrirez les différentes méthodes qui vous sont offertes pour ajouter de nouveaux utilisateurs. Ensuite, vous apprendrez à gérer les droits d accès : vous attribuerez à chacun de vos utilisateurs des rôles qui leur permettront d avoir accès seulement à certaines fonctionnalités Ajout d utilisateurs Il existe par défaut deux utilisateurs sous Drupal : l administrateur du site, qui a tous les droits et l utilisateur anonyme, ou utilisateur non authentifié, qui a des droits limités par défaut. Vous pouvez consulter la liste des utilisateurs sur la page : Administrer - Gestion des utilisateurs - Utilisateurs L utilisateur Anonyme n apparaît pas dans cette liste car il n est pas possible de l éditer. Création manuelle d un compte utilisateur Vous pouvez ajouter un nouvel utilisateur en tant qu administrateur en cliquant sur le lien Ajouter un utilisateur. Remplissez alors le formulaire : Nom d utilisateur : Utilisateur1. Adresse Utilisateur1@monadresse.com. Mot de passe : atelierdrupal, par exemple. Laissez le Statut Actif. Cliquez sur le bouton Créer un nouveau compte. Retournez dans la liste, Utilisateur1 devrait apparaître. Liste des utilisateurs Configuration de l inscription des utilisateurs Comme c est souvent le cas pour les sites communautaires, vous pouvez également permettre l inscription ou la demande d inscription automatiquement pour les visiteurs de votre site.

103 8 - Le travail collaboratif sous Drupal 103 Allez maintenant sur la page Administrer - Gestion des utilisateurs - Paramètres des utilisateurs. Cette page sert à configurer la façon dont vos utilisateurs pourront créer un nouveau compte et les messages envoyés à cette occasion. Les différentes façons de créer un compte avec Drupal Seuls les administrateurs du site peuvent créer de nouveaux comptes Les visiteurs peuvent créer leur propre compte sans approbation de l administrateur Les visiteurs peuvent créer leur propre compte, mais l approbation d un administrateur est requise Si vous choisissez cette option, la ligne «Créer un nouveau compte» n apparaîtra plus. Seul les ajouts manuels seront autorisés. Un visiteur anonyme peut se créer un compte. Vous pouvez demander une vérification de la validité d un pour la création du compte. Ici, un utilisateur anonyme pourra solliciter la demande de création d un compte, mais seul l administrateur du site pourra le valider manuellement. Vous pourrez alors débloquer le compte sur la page Administrer - Gestion des utilisateurs - Utilisateurs. Attention, par défaut, les visiteurs anonymes peuvent créer leur propre compte sans approbation de l administrateur. Vous pouvez sur cette page, modifier le texte des mails envoyés aux utilisateurs. Rendez-vous au chapitre 9.5. Configuration de votre serveur pour l envoi de mail pour configurer votre serveur afin qu il puisse envoyer des mails CAPTCHA : Evitez les robots malveillants CAPTCHA Pack : Ajoutez de nouveaux types de tests 8.2. Les rôles des utilisateurs Chaque utilisateur de Drupal peut-être affecté à un rôle. Les rôles donnent ensuite des droits d accès permettant d exécuter des actions.

104 104 I - Démarrage rapide Un utilisateur est affecté à un rôle qui possède des droits Création d un rôle Allez maintenant sur la page : Administrer - Gestion des utilisateurs - Rôles. Il existe par défaut deux rôles d utilisateur : utilisateur anonyme et utilisateur authentifié. Ajoutez en un troisième : «Cuisinier». Cliquez sur Ajouter un rôle. Attribution d un rôle à un utilisateur Liste des rôles Vous allez maintenant attribuer le rôle Cuisinier à utilisateur1. Allez sur la page : Administrer - Gestion des utilisateurs - Utilisateurs. Cette page s apparente à la page de liste des contenus. Elle permet de filtrer les utilisateurs en fontcion de différents critères (rôle, permissions, statut). Choisissez le lien modifier en bout de ligne Cochez la case Cuisinier de la section Rôles.

105 8 - Le travail collaboratif sous Drupal 105 Cliquez sur le bouton Enregistrer. Il est également possible, à la page de liste des utilisateurs de sélectionner une liste d utilisateurs et choisir une action dans la liste Options de mise à jour. Droits d accès en fonction des rôles Attribution d un rôle à un ensemble d utilisateurs Allez maintenant sur la page : Administrer - Gestion des utilisateurs - Droits d accès. Cette page permet de configurer les droits d accès de chaque rôle. Il y a une colonne par rôle. Vous pouvez, par exemple, permettre aux utilisateurs Cuisinier de créer de nouveaux articles pour pouvoir ajouter des recettes. Cochez alors les cases create story content et edit own story content de la colonne Cuisinier. Droits d accès selon les rôles

106 106 I - Démarrage rapide Cliquez sur le bouton Enregistrer les droits d accès. Vérifiez maintenant que l utilisateur1 peut bien créer un article : Déconnectez-vous en cliquant sur Administration - Se déconnecter. Connectez-vous avec l utilisateur utilisateur1 : Nom d utilisateur : utilisateur1 Mot de passe : atelierdrupal Cliquez sur Se connecter. Vérifiez que vous avez accès à Administration - Créer un contenu - Article. L utilisateur créé peut créer un article Vous pouvez vous connecter avec deux utilisateur en même temps sur un même ordinateur en utilisant deux navigateurs différents (Firefox et Internet Explorer par exemple) Les droits d accès liés aux modules Généralement, chaque module possède une section sur la page Administrer - Gestion des utilisateurs - Droits d accès. Lorsque vous installez un nouveau module, une nouvelle section apparaît ici. Cette section est aussi accessible depuis l onglet Par module de la page Administrer. Voyons par exemple ce qui a été ajouté lors de l activation du module Upload : Allez sur la page Administrer. Choisissez l onglet Par module. Déplacez vous jusqu à la section Upload. Les pages d administration du module Upload Cliquez sur le lien Configurer les droits d accès.

107 8 - Le travail collaboratif sous Drupal 107 Les Droits d accès pour le module Upload Vous pouvez alors configurer les droits d accès de deux actions pour ce menu : transférer des fichiers : Autorise aux rôles cochés d avoir accès à la section Fichiers attachés lors de la création d un contenu. voir les fichiers transférés : Autorise les rôles cochés télécharger les pièces jointes d un contenu Profile : Ajoutez des champs aux profils de vos utilisateurs pour mieux les connaître Forum : Créez un lieu d échange pour vos utilisateurs Blog : Donnez la possibilité à vos utilisateurs de posséder un blog

108 108 I - Démarrage rapide

109 8 - Le travail collaboratif sous Drupal 109 Partie III - Administration système de Drupal

110 110 III - Administration système de Drupal Dans cette partie, vous allez configurer les différentes applications qui permettent de faire fonctionner Drupal : Le serveur web Apache, le langage Php et la base de données MySQL. Il n est bien sûr pas ici question de traiter en profondeur ces sujets, mais de configurer les fonctionnalités qui auront III - Administration système de Drupal une incidence sur le fonctionnement de Drupal. Vous apprendrez également à faire cohabiter plusieurs sites web Drupal sur un même serveur, ainsi qu à sauvegarder et à restaurer votre site dans son ensemble. A la fin de cette partie, vous aurez toutes les cartes en main pour bien administrer votre serveur. Peut-être n êtes vous pas très intéressé par la configuration de ces outils, dans ce cas, vous pouvez très bien vous affranchir de la lecture d une bonne partie de ce chapitre. Mais avant de passer à la partie suivante, il est conseillé au moins d activer les URLs simplifiés comme indiqué au chapitre Configuration de Apache. 9. Configuration de Apache - PHP - MySQL 9.1. Configuration de Apache Drupal peut s exécuter sur de nombreux serveurs HTTP, mais ici, seule la configuration d Apache, qui est le serveur le plus populaire, sera étudiée. Les URLs Simplifiées Par défaut Drupal utilise des URLs de la forme : Dans cet exemple, node/2 est l argument qui est envoyé à Drupal. Les URLs simplifiés sont sous la forme : On enlève ainsi le?q=. Cela peut paraître être un détail, mais il est recommandé d activer les URLs simplifiés pour plusieurs raisons : Certains modules ne fonctionnent pas sans les URLs simplifiés. Cela facilite la lecture pour les utilisateurs. Certains moteurs de recherche indexent mieux les sites avec URLs simplifiés. Activer le mod_rewrite d Apache Pour pouvoir activer les URLs simplifiés, il faut que le module mod_rewrite d Apache soit aussi activé. h h Sous Windows avec WampServer faites un clic gauche sur l icône de notification puis aller dans Apache - Modules Apache - rewrite_module

111 9 - Configuration de Apache - PHP - MySQL 111 Activer le mod_rewrite avec WampServer Sous Linux Ubuntu, activez le mod_rewrite grâce à la ligne de commande sudo a2enmod rewrite Puis modifiez le fichier de configuration d Apache situé dans le répertoire de Drupal : sudo gedit /etc/apache2/apache2.conf Ajoutez à la fin de ce fichier les lignes suivantes : <Directory /var/www/drupal> AllowOverride all </Directory> Redémarrez apache sudo /etc/init.d/apache2 restart Activer les URLs simplifiés dans Drupal Ensuite, sous Drupal, allez dans Administrer - Configuration du site - URLs simplifiés. Si vous ne pouvez pas choisir Activé, c est que le test n a pas réussi et qu il y a un problème dans votre configuration. Cliquez sur Activé.

112 112 III - Administration système de Drupal Les URLs simplifiés peuvent être activés Cliquez sur le bouton Enregistrer la configuration. Si à un moment vous rencontrez un problème avec un URL, désactivez cette fonctionnalité. Elle sera toujours accessible via l adresse Path : L Alias d URLs Pathauto : Automatisez la création de vos Alias Les hôtes virtuels Vous allez maintenant créer un hôte virtuel sur votre serveur apache. Cela vous permettra d accéder à Drupal directement en entrant l adresse plutôt que Ainsi votre site sera plus facile à configurer et à copier vers le serveur de votre hébergeur. Cela vous permettra également d héberger plusieurs sites Web sur un même serveur. Sous Windows Configuration du fichier hosts Editez le fichier %windir%\system32\drivers\etc\hosts et ajoutez la ligne : drupal.tld Attention, ce fichier peut être en lecture seule pour des raisons de sécurité, changez ses droits (clic droit - propriété) en écriture avant de l éditer et protégez le à nouveau après modification. Sous Linux sudo gedit /etc/hosts et ajoutez la ligne : drupal.tld

113 9 - Configuration de Apache - PHP - MySQL 113 Sous Windows Configuration de apache Avec WampServer, faites un clic gauche sur l icône de notification puis aller dans Apache - httpd. conf. Recherchez la ligne : #Include conf/extra/httpd-vhosts.conf Décommentez là (enlevez le # devant). Ensuite, ajoutez les lignes suivantes au fichier C:\wamp\bin\apache\apache2.2.11\conf\extra\httpdvhosts.conf <VirtualHost *:80> DocumentRoot c:/wamp/www ServerName localhost </VirtualHost> <VirtualHost *:80> DocumentRoot c:/wamp/www/drupal ServerName drupal.tld </VirtualHost> Le premier VirtualHost permettra à l adresse de fonctionner (pour accéder à phpmyadmin par exemple). Le second permettra à l adresse de pointer directement vers votre site Drupal. N oubliez pas de redémarrer Apache. (Clic gauche sur l icône de notification et Redémarrer les services) Sous Linux Créez un nouveau fichier avec la commande : sudo gedit /etc/apache2/sites-enabled/drupal.conf Insérez-y les lignes suivantes : <VirtualHost *:80> DocumentRoot /var/www/drupal ServerName drupal.tld </VirtualHost> Redémarrez apache : sudo /etc/init.d/apache2 restart Vérification du bon fonctionnement Allez à l adresse vous devriez voir apparaître votre page d accueil Drupal. Mais si vous retournez sur vous devriez avoir la page d accueil Apache.

114 114 III - Administration système de Drupal Le virtualhost drupal.tld fonctionne Vous n avez ici configuré que le minimum de paramètres des VirtualHosts pour qu ils fonctionnent avec Drupal. Apache étant très complet, il comprend un grand nombre de paramètres supplémentaires. Voyez la documentation Apache pour plus d informations. Vous pouvez lancer une commande Apache pour connaître la configuration de vos virtual hosts (pratique si cela ne fonctionne pas du premier coup) : Sous Windows : Dans une Invite de commandes c:\wamp\bin\apache\apache2.2.11\bin\httpd.exe -S Sous Linux : apache2 -S 9.2. Configuration de Php PHP est le langage de script avec lequel Drupal est développé. PHP est correctement configuré par défaut sous Windows ou Linux pour le bon fonctionnement de Drupal. Toutefois, voici les quelques variables que vous pourriez avoir besoin de modifier dans le fichier php.ini : Sous Windows : Cliquer avec le bouton gauche sur l icône de notification de WampServer puis aller dans Php - php.ini pour éditer php.ini. Sous Linux : Pour éditer php.ini : sudo gedit /etc/php5/apache2/php.ini

115 9 - Configuration de Apache - PHP - MySQL 115 Les paramètres utiles pour Drupal memory_limit : Votre besoin pour Drupal dépend des modules chargés. 128 Mo est normallement suffisant. 32 ou 64 Mo semblent être des solutions choisies par beaucoup. Aujourd hui les machines ont de plus en plus de RAM, si vous faites fonctionner Drupal sur une petite configuration, vous pouvez baisser cette valeur. post_max_size : C est la limite de taille d envoi d un seul fichier par la méthode POST. 2M est une bonne valeur si vous limitez les fichiers à envoyer à des images. Cela peut devenir insuffisant si vous permettez d envoyer des vidéos. Si vous augmentez post_max_size, pensez aussi à augmenter upload_max_size. Pour avoir plus d informations sur la version de Php installée et des modules activés, rendezvous sur Administration - Rapports - Tableau de bord et cliquez sur le lien en face de la vérification PHP : La page phpinfo.php s affichera (Cf chapitre Tableau de bord) 9.3. Configuration de MySQL Comme pour le serveur web Apache, Drupal peut utiliser différentes bases de données grâce à l utilisation d une couche logiciel d abstraction. Cependant, les explications de ce livre se limiteront à MySQL qui est actuellement la base la plus utilisée avec Drupal. Vous avez utilisé, dans la première partie, l utilisateur root pour créer la base SQL de Drupal. Cela peut poser des problèmes de sécurité. Sous Windows, l utilisateur root est de plus sans mot de passe! Il est conseillé de créer un utilisateur spécifique pour la base de données utilisée par Drupal. Pour cela, comme pour toutes les manipulations que vous allez faire sur la base de données, vous utiliserez l outil phpmyadmin qui permet de gérer des bases de données MySQL et qui est très souvent proposé par les hébergeurs. Rendez-vous à l adresse Connectez vous avec l utilisateur root/atelierdrupal (Si vous avez suivi l exemple de la Partie I - Démarrage rapide). Cliquez sur l onglet Privilèges (Sur la page d accueil de phpmyadmin, sans avoir sélectionné de base au préalable). Puis cliquez sur Ajouter un utilisateur. Entrez un Nom d utilisateur : drupal, par exemple. Choisissez Local pour le Serveur : même si vous accédez à Drupal depuis une autre machine, Drupal utilisera la base de données en local. Bien sur, il est possible d installer votre base de données Drupal sur un autre serveur que votre serveur web. Ce cas ne sera pas traité ici. Choisissez un Mot de passe, atelierdrupal par exemple. Ne touchez à rien d autre et cliquez sur le bouton Exécuter tout en bas de la page.

116 116 III - Administration système de Drupal La page se recharge alors. Création d un utilisateur avec PhpMyAdmin Dans la partie Privilèges spécifiques à une base de données choisissez la base de données drupal. Modification des privilèges pour l utilisateur de la base La page se recharge une nouvelle fois et affiche les privilèges à donner pour votre seule base drupal. Cliquez alors sur Tout cocher Puis sur le bouton Exécuter. Ajout des permissions GRANT à la base

117 9 - Configuration de Apache - PHP - MySQL 117 Lors de votre prochaine installation de Drupal, vous pouvez ajouter directement un nouvel utilisateur et cocher l option Créer une base portant son nom et donner à cet utilisateur tous les privilèges sur cette base. Il faut maintenant modifier les paramètres du fichier de configuration de Drupal pour changer le nom d utilisateur qui accédera à la base. Editez le fichier drupal/sites/default/settings.php. Sous Windows, si vous ne percevez pas les retours à la ligne dans votre éditeur (par exemple Notepad), utilisez un éditeur plus avancé (cela fonctionne avec Wordpad). Recherchez la ligne $db_url=... dans ce fichier. C est grâce à cette variable que Drupal se connecte à votre base mysql. Modifiez le couple Nom d utilisateur / Mot de passe en les remplaçant par ceux entrés dans mysql : $db_url = mysqli://drupal:atelierdrupal@localhost/drupal ; Le fichier settings.php est en lecture seule. Il faut donc changer ses droits d accès. N oubliez pas de le remettre en lecture seule lorsque vous aurez appliqué les changements. Il y a par défaut deux autres bases de données existantes en plus de celle de Drupal. Ce sont les bases qui permettent de faire fonctionner le gestionnaire MySQL, il ne faut donc jamais les effacer. Liste des bases de MySQL 9.4. Choisir l hébergeur de votre site Web Il est possible d héberger son site sur une machine reliée à Internet. Cependant, la majorité des administrateurs préfèrent faire appel à un hébergeur pour y louer un serveur ou une partie d un serveur. Vous aurez alors le choix entre deux solutions d hébergement : un serveur dédié ou un serveur mutualisé.

118 118 III - Administration système de Drupal Bien souvent, les hébergeurs proposant des solutions mutualisées offrent une interface d administration qui permet d installer et de configurer votre serveur simplement. Avec un serveur mutualisé, vous n aurez pas à configurer et sécuriser votre système de A à Z comme avec un serveur dédié. Généralement la solution du serveur mutualisé est moins coûteuse, mais aussi moins performante (vous partagez les ressources du serveur avec d autres personnes), il faut donc faire particulièrement attention au système minimum requis par Drupal. Serveur Web La plupart des utilisateurs de Drupal utilisent le serveur WEB Apache. Pourtant, Drupal peut aussi fonctionner sur IIS, LightHTTP ou autre puisqu il a été programmé pour être indépendant du serveur WEB. Sachez cependant que la solution Drupal + Apache est la plus éprouvée. Pour pouvoir activer les URL s simplifiés, il faut que le module mod_rewrite soit ou puisse être activé sur Apache. PHP L utilisation de PHP 5.2 ou supérieur est recommandé par Drupal. En théorie, PHP suffit. La mémoire minimum à allouer à PHP est de 16MB, mais, selon les modules activés et l activité de votre site, il sera nécessaire d augmenter cette valeur. Si vous souhaitez manipuler des images, la bibliothèque GD (Gif Draw - Dessiner des GIF) est nécessaire. Base de données Drupal peut utiliser les logiciels de base de données MySQL 4.1 ou supérieur, ou PostgreSQL 7.4 ou supérieur. Bien que PostgreSQL soit reconnu comme étant un très bon logiciel, MySQL reste préféré par la plupart des utilisateurs de Drupal à l instar d Apache Configuration de votre serveur pour l envoi de mail Drupal doit pouvoir envoyer des mails pour une meilleure communication avec ses utilisateurs : à la création d un nouvel utilisateur, lors d un changement de mot de passe ou pour alerter l administrateur du système d événements particuliers. L envoi de mails se fait grâce à un serveur SMTP (Simple Mail Transfer Protocol ou «Protocole simple de transfert de courrier»). Si vous travaillez en local sur votre machine, vous pouvez utiliser le SMTP de votre fournisseur d accès (exemples : smtp.free.fr, smtp.orange.fr, etc.). Si vous travaillez sur un serveur dédié ou mutualisé, utilisez le smtp de votre fournisseur de mail (smtp.laposte.net, smtp.mondomaine.com, etc.). Configuration de Windows avec WampServer Sous Windows, il suffit de modifier un paramètre dans le fichier php.ini pour indiquer à Drupal quel serveur

119 9 - Configuration de Apache - PHP - MySQL 119 SMTP utiliser: Cliquez avec le bouton gauche de la souris sur l icône de WampServer. Choisissez dans le menu PHP - php.ini. Modification de php.ini avec WampServer Recherchez le paramètre SMTP dans la section [mail function]. Entrez le nom de votre serveur SMTP. Sauvegardez le fichier. Modification du SMTP dans le fichier Redémarrez WampServer en cliquant sur l icône avec le bouton gauche - Redémarrer les services. Testez votre installation comme indiqué à la fin de ce chapitre. Configuration de Linux avec SSMTP SSMTP est très simple à configurer pour permettre au système d envoyer des mails : h h Installation de SSMTP sudo apt-get install ssmtp

120 120 III - Administration système de Drupal Editez le fichier de configuration de SSMTP : sudo gedit /etc/ssmtp/ssmtp.conf Modifiez les champs ainsi root=cyprien.wireless@laposte.net #Votre adresse mailhub=smtp.free.fr #SMTP utilisé rewritedomain=free.fr #Domaine utilisé hostname=cyp-drupal #Nom de votre machine FromLineOverride=YES #Pour que la ligne from contienne l adresse mail de l administrateur de Drupal Sauvegardez le fichier. Testez votre installation comme indiqué à la fin de ce chapitre. Configuration de Linux avec Postfix Vous pouvez également utiliser Postfix qui peut en faire plus que SSMTP, mais avec qui il ne peut pas cohabiter Installez Postfix. sudo apt-get install postfix A la question Configuration type du serveur de messagerie, choisir Site Internet. A la question Nom de courrier, entrez le nom de domaine de votre mail (Si votre mail est contact@ gmail.com, entrez gmail.com). Editez le fichier main.cf : sudo gedit /etc/postfix/main.cf Complétez le paramètre relayhost par le nom de votre STMP entre crochets : relayhost = [smtp.free.fr] Enfin, redémarrez postfix sudo /etc/init.d/postfix restart Test de l installation Votre installation doit maintenant fonctionner, vous pouvez la tester en créant un nouveau compte utilisateur (8.1. Ajout d utilisateurs) ou en créant un Trigger qui envoi un mail (7.4. Trigger : Effectuez des actions lorsque des événements se produisent). 10. Gérer ses différents sites Drupal Vous savez maintenant configurer et sécuriser votre environnement. Faire des modifications directement sur votre site de production peut causer des problèmes. C est pourquoi il est préférable d avoir un site de test pour expérimenter de nouveaux modules ou de nouvelles fonctionnalités de Drupal sans risquer de casser votre site principal.

121 10 - Gérer ses différents sites Drupal 121 Il faudra donc savoir transférer votre site de production vers votre site de test et vice-versa. Pour cela, vous apprendrez à sauvegarder l intégralité d un site Drupal, ensuite, vous installerez un nouveau site sur la même instance, pour finir, vous restaurerez la sauvegarde vers votre nouveau site Sauvegarde/restauration d un site Drupal La sauvegarde de Drupal se déroule en deux temps : Sauvegarde de la base de données Sauvegarde de l intégralité des fichiers de Drupal Sauvegarde de la BDD Vous allez ici sauvegarder la base de données avec l interface PhpMyAdmin : Connectez-vous sur PhpMyAdmin : Choisissez la base de données que vous voulez sauvegarder dans la liste déroulante sur la gauche, drupal, si vous avez suivi l exemple de ce livre. Cliquez sur l onglet Exporter. Les paramètres par défaut devraient être les bons : le format doit être SQL, Structure et Données doivent être cochées. Interface d export d une base sur PhpMyAdmin

122 122 III - Administration système de Drupal Dans le bas, cochez Transmettre. Choisissez aussi gzippé pour gagner du temps et de l espace disque (ou zippé sous Windows). Cliquez sur Exécuter. Téléchargez le fichier sur votre disque local. Sauvegarde du répertoire Drupal Paramètres du fichier à transmettre Il suffit de sauvegarder l ensemble du répertoire racine de Drupal : C:\wamp\www\drupal sous Windows /home/nom_utilisateur/drupal sous Linux Restauration de la BDD Cette manipulation est décrite si vous désirez faire une restauration des données précédemment sauvegardées. Si vous suivez les exemples de ce livre, cela n est pas nécessaire d exécuter ces actions maintenant. Connectez-vous sur PhpMyAdmin : Créez une base de données dans laquelle vous voulez restaurer les données. Cliquez sur l onglet Importer.

123 10 - Gérer ses différents sites Drupal 123 Restauration de la base de données Cliquez sur le bouton Parcourir, choisissez le fichier précédemment téléchargé. Cliquez sur Exécuter. Restauration du répertoire Copier le répertoire précédemment sauvegardé. Editez ensuite le fichier sites\default\settings.php et modifiez la ligne $db_url comme cela: $db_url = mysql://login_mysql:atelierdrupal@localhost/nom_de_la_base_de_données ; Backup and Migrate - Sauvegardez votre base de données Créer un site de test Il est possible d installer plusieurs sites avec la même installation de Drupal. Cela peut-être utile de créer plusieurs sites avec Drupal : Pour héberger plusieurs sites sur un même serveur Pour tester de nouvelles fonctionnalités sur un site de test sans perturber votre site de production.

124 124 III - Administration système de Drupal Tous les sites sont installés dans le répertoire drupal/sites. Par défaut, il contient deux sous-répertoires : default et all. Les fichiers présents dans le répertoire all sont accessibles depuis tous les sites présents dans drupal/sites. Si, par exemple, vous installez un module dans ce répertoire, vous pourrez l activer sur tous les autres sites présents dans drupal/sites. Le répertoire défaut est le répertoire du site par défaut. C est celui que vous utilisez, dans l exemple du livre avec drupal.tld. Vous pourriez renommer ce répertoire défaut en drupal.tld, cela n aurait eu aucune incidence sur son fonctionnement. Vous allez maintenant installer un site de test : test.drupal.tld. Création du Virtual Host Créez un nouveau VirtualHost comme expliqué au chapitre Configuration de Apache avec les paramètres suivants : <VirtualHost *:80> DocumentRoot c:/wamp/www/drupal ServerName test.drupal.tld </VirtualHost> Redémarrez WampServer. Au fichier %windir%\system32\drivers\etc\hosts, ajoutez la ligne : test.drupal.tld Création de la base de données Créez ensuite une base de données pour ce site. Pour cela, vous allez utiliser la méthode décrite dans le chapitre Configuration de MySQL. Cliquez sur l icône Privilèges depuis la page d accueil de PhpMyAdmin. Cliquez sur Ajouter un utilisateur. Nom d utilisateur : drupaltest. Serveur : local. Mot de passe : atelierdrupal. Cochez l option Créer une base portant son nom et donner à cet utilisateur tous les privilèges sur cette base. Cliquez sur le bouton Exécuter.

125 10 - Gérer ses différents sites Drupal 125 La base du site de test est créée avec son utilisateur MySQL Préparation du répertoire du site de test Vous allez maintenant installer votre deuxième site Drupal, vous découvrirez ainsi l installateur de Drupal plus en profondeur. Créez maintenant le dossier drupal/sites/test.drupal.tld. Copiez-y le fichier drupal/sites/default/default.settings.php. Copiez à nouveau ce fichier dans le même répertoire et renommez le en settings.php. Ainsi, vous devriez avoir deux fichiers dans le répertoire test.drupal.tld : default.settings.php et settings.php settings.php est le fichier qui va être utilisé par l installateur Drupal. Configuration de l accès à la base de données dans settings.php Pour que l installateur pointe bien vers votre base drupaltest précédemment créée, il faut modifier la ligne «$db_url =» du fichier settings.php. Donc, pour accéder à la base de données drupaltest, avec l utilisateur drupaltest et le mot de passe atelierdrupal, vous aurez : $db_url = mysql://drupaltest:atelierdrupal@localhost/drupaltest ; Installation de Drupal pour le site de test Avec un navigateur, pointez vers l adresse Si tout s est bien déroulé, vous devriez avoir le choix entre les langues Française et Anglaise comme dans la partie I.

126 126 III - Administration système de Drupal Choisissez bien sûr le Français. Cliquez sur le bouton Select language. Ensuite des vérifications sont faites. Rendez votre./sites/test.drupal.tld accessible en écriture, cela permet à Drupal de créer un répertoire./sites/test.drupal.tld/files pour stocker les fichiers utilisateurs de Drupal. Comme vous avez déjà installé la base de données, vous devriez arriver directement à l étape Configuration du site. Le nom du site est aussi son titre. Prenez compte de cette remarque pour compléter ce champ. Le champ Adresse du site doit correspondre à une adresse valide. Le Nom d utilisateur correspond au compte administrateur qui peut avoir un accès complet au site. N hésitez pas à créer par la suite un autre compte avec moins de permissions. Entrez votre Mot de passe : atelierdrupal. Drupal vérifie durant la saisie le niveau de sécurité et la concordance des mots de passe. Si tout est bien configuré, vous pouvez activer les URLs simplifiées directement depuis l installateur de Drupal (chapitre 9.1. Configuration de Apache) Laissez cochée la case Vérifier automatiquement les mises à jour, c est une fonctionnalité bien pratique (chapitre Update Status : Mettre à jour Drupal) Cliquez sur le bouton Sauvegarder et poursuivre. Cliquez sur le lien votre nouveau site. Et voilà, vous êtes sur notre nouveau site! Vous avez créé un site de test sous la forme test.drupal.tld, mais il est également possible d utiliser des sous-répertoires pour créer un nouveau site, par exemple, Pour cela, il faut créer le répertoire drupal.tld.test dans le répertoire /sites Transfert du site de production vers le site de test Vous allez maintenant transférer votre site de production vers votre site de test. Vous pourrez bien sûr également effectuer la manipulation dans l autre sens avec cette méthode. Vous utiliserez pour cela une technique très similaire à celle vu dans le chapitre Sauvegarde/restauration d un site Drupal. Vous allez maintenant transférer le site drupal.tld vers le site test.drupal.tld. Prérequis Si vous avez suivi les exemples de ce livre, vous devriez avoir : votre site drupal.tld dans le répertoire /sites/default avec la base MySQL Drupal

127 10 - Gérer ses différents sites Drupal 127 votre site test.drupal.tld dans le répertoire /sites/test.drupal.tld avec la base MySQL drupaltest. Copie des fichiers Copiez le contenu du répertoire sites/default vers sites/test.drupal.tld. Accès à la base de données Modifiez ensuite le nom et l accès à la base de données dans le fichier settings.php à la ligne $db_url= $db_url = mysql://drupaltest:atelierdrupal@localhost/drupaltest ; Transfert de la base de données Suppression de la base drupaltest Dans PhpMyAdmin, sélectionnez la Base de données drupaltest. Choisissez l onglet Supprimer. Sauvegardez la base Drupal Dans PhpMyAdmin, sélectionnez la base de données drupal. Cliquez sur l onglet Exporter. En bas de la page, cochez la case Transmettre. Choisissez l option gzippé (ou zippé sous Windows). Cliquez sur le bouton Exécuter. Enregistrez le fichier sur votre disque. Restauration de la sauvegarde sur drupaltest Retournez à la page d accueil de PhpMyAdmin. Créez une base de données drupaltest. Cliquez sur l onglet Importer. Puis sur le bouton Parcourir. Pointez alors vers le fichier que vous avez téléchargé Cliquez sur le bouton Exécuter. Votre base Drupal est alors copiée dans la nouvelle base créée drupaltest. Vous pouvez alors vous rendre à l adresse et constater que vous avez bien copié l ensemble de votre site drupal.tld vers test.drupal.tld. Vous avez utilisé ici uniquement PhpMyAdmin pour faire ces transferts de base, il est également possible d utiliser des lignes de commandes pour automatiser ces tâches.

128 128 III - Administration système de Drupal 11. Configuration avancée de Drupal Update Status : Mettre à jour Drupal Si le module Update status est activé, un message indique à la page Administrer - Construction du site - Modules si des mises à jour sont disponibles (chapitre 4.2. Le tableau de bord). Des mises à jour sont disponibles Update Status signale les mises à jour disponibles pour le cœur de Drupal, l un des modules installé et activé ou encore pour un thème. Pour chaque élément, plusieurs informations sont affichées : La nouvelle version et sa date de publication Un lien vers le fichier à télécharger Un lien vers les notes de versions qui indiquent quelles sont les nouveautés apportées par la nouvelle version. Si la mise à jour corrige des failles de sécurité, la mention Mise à jour de sécurité apparaît (Sur l illustration ci-dessous, Drupal 6.8 contient des mises à jour de sécurité) : Le module Update Status est activé par défaut, en le désactivant, les messages relatifs aux mises à jours disponibles n apparaîtront plus. Vous pouvez consulter les mises à jours disponibles sur la page Administrer - Rapports - Mises à jour disponibles.

129 11 - Configuration avancée de Drupal 129 Des mises à jour sont disponibles Vous pouvez configurer Update Status en cliquant sur l onglet Paramètres de la page Administrer - Rapports - Mises à jour disponibles. Update Status pose parfois des problèmes de lenteur à Drupal car il se connecte via Internet sur le site drupal.org pour vérifier si des mises à jours existent. N hésitez pas à désactiver le module si vous trouvez Drupal particulièrement lent. Les paramètres de UpdateStatus Ici, il est possible d inscrire une adresse pour être notifié des mises à jour disponibles par , de modifier la fréquence de vérification et d indiquer pour quels types de mises à jour vous souhaitez être notifié. Si vous choisissez Seules les mises à jour de sécurité, Update Status ne vous indiquera pas si une version ajoutant seulement des fonctionnalités est publiée.

130 130 III - Administration système de Drupal Mise à jour d un thème Pour mettre à jour un thème : Rendez-vous sur la page Administrer - Construction du site - Thèmes. Désactivez le thème à mettre à jour. Allez sur la page Administrer - Rapports - Mises à jour disponibles. Téléchargez la nouvelle version en cliquant sur le lien Téléchargement. Extrayez le contenu de l archive au même endroit que la précédente version. Réactivez le thème sur la page Administrer - Construction du site - Thèmes. La désactivation du thème avant la mise à jour est recommandée, mais pas obligatoire. Mise à jour d un module Pour mettre à jour un module : Allez sur la page Administrer - Configuration du site - Maintenance du site. Sélectionnez l option Hors ligne. Cela permet d éviter des conflits sur la base de données pendant la mise à jour en supprimant l accès à votre site. Toutefois, un message d information sera délivré à vos visiteurs. Affichage du message Hors ligne pour les visiteurs Rendez vous sur la page Administrer - Construction du site - Modules. Désactivez le module à mettre à jour. Allez sur la page Administrer - Rapports - Mises à jour disponibles. Téléchargez la nouvelle version en cliquant sur le lien Téléchargement. Extrayez le contenu de l archive au même endroit que la précédente version. Exécutez le script update.php en entrant l URL Réactivez le module sur la page Administrer - Construction du site - Modules. Allez sur la page Administrer - Configuration du site - Maintenance du site.

131 11 - Configuration avancée de Drupal 131 Sélectionnez l option En ligne pour autoriser à nouveau l accès au contenu de votre site. Si vous ne pouvez plus vous connecter à votre site parce que le mode Hors ligne est activé, vous pouvez repasser en mode En ligne en exécutant la requête suivante sur votre base (Dans Php- MyAdmin, sélectionnez votre base puis onglet SQL). UPDATE variable SET value = s:1:»0»; WHERE name= site_offline ; DELETE FROM cache WHERE cid = variables ; Mise à jour de Drupal. Sauvegardez l ensemble de votre site (chapitre Sauvegarde/restauration d un site Drupal). Allez sur la page Administrer - Configuration du site - Maintenance du site. Sélectionnez l option Hors ligne. Si votre site possède un thème personnalisé ou installé depuis internet, réactivé le thème Garland. Rendez vous sur la page Administrer - Construction du site - Modules. Désactivez tous les modules installés. Allez sur la page Administrer - Rapports - Mises à jour disponibles. Téléchargez la nouvelle version en cliquant sur le lien Téléchargement. Extrayez le contenu de l archive au même endroit à la racine de Drupal en écrasant les anciens fichiers. Exécutez le script update.php en entrant l URL Si vous n arrivez pas à exécuter le script update.php, ce peut être parce que vous n êtes pas connecté en tant qu administrateur sur votre site Drupal. Vous pouvez alors autoriser le script update.php à être exécuté par n importe quel utilisateur en donnant la valeur TRUE à la variable $update_free_access du fichier votre_repertoire_drupal/sites/default/settings.php. Après l exécution du script update.php, n oubliez pas de repasser cette valeur à FALSE et de protéger à nouveau le fichier settings.php en écriture. Réactivez les modules sur la page Administrer - Construction du site - Modules. Allez sur la page Administrer - Configuration du site - Maintenance du site ou directement à l URL Sélectionnez l option En ligne pour autoriser à nouveau l accès au contenu de votre site Le cron Lorsque vous vous rendez sur le tableau de bord (voir chapitre 4.2. Le tableau de bord), un message apparaît souvent, indiquant que le cron doit être lancé. Cron est un programme qui permet d exécuter automatiquement des tâches à une date ou à une heure spécifiée à l avance ou avec un intervalle de temps régulier. Drupal a besoin d exécuter régulièrement des

132 132 III - Administration système de Drupal tâches de maintenance comme vérifier la présence de mises à jour, purger des fichiers de log et bien d autres choses encore. Pour cela, il utilise le programme cron. Pour exécuter ces tâches, vous pouvez cliquer sur le lien Vous pouvez lancer le cron manuellement ou lancer directement le script Lancement manuel du cron Pour automatiser le lancement de cron sous Windows, il faut configurer une tâche planifiée. Sous Linux, il faut ajouter des lignes au fichier /etc/crontab. Consultez la documentation de ces deux programmes pour en savoir plus Poormanscron : Lancer le cron automatiquement

133 11 - Configuration avancée de Drupal 133 Partie IV - Modifier l apparence de votre site

134 134 III - Administration système de Drupal Personnaliser son site graphiquement est un besoin qui peut se faire rapidement sentir avec Drupal. Vous avez déjà installé de nouveaux thèmes dans la partie I - Démarrage rapide et vu qu ils pouvaient modifier en profondeur l apparence de Drupal. Si vous trouvez un thème qui vous convient, alors, vous économiserez beaucoup de temps à l utiliser sans le modifier. Dans cette partie, vous allez installer un nouveau thème et voir comment le configurer à partir de l interface d administration de Drupal. Ensuite vous le modifierez grâce aux feuilles de style CSS qui sont un moyen simple de personnaliser en profondeur l apparence de Drupal. La connaissance des feuilles de style CSS est nécessaire pour la bonne compréhension de ce chapitre. 12. Organisation des thèmes Activation et découverte du thème Bluemarine Dans la partie I, au chapitre 3.6. Modification de l apparence de Drupal, vous avez pu avoir un aperçu de l interface de Drupal pour la configuration et l activation des thèmes. Dans la partie II, au chapitre 4.3. Les paramètres du site, vous avez constaté qu il existait une page qui permettait d afficher ou de cacher certains champs de votre site. Vous allez maintenant voir plus en détail ces deux aspects de la configuration des thèmes par l interface d administration de Drupal. Activation d un thème Pour ce chapitre, vous allez utiliser un thème installé par défaut avec Drupal qui a l avantage d être simple à modifier : le thème Bluemarine. Pour activer le thème Bluemarine : Rendez vous sur la page Administrer - Construction du site - Thèmes. Cochez la case Activé. Choisissez l option Par défaut.

135 11 - Configuration avancée de Drupal 135 Activation du thème Bluemarine Puis, cliquez sur le bouton Enregistrer les modifications. Vous pouvez activer plusieurs thèmes pour votre site Drupal. Cela permet par exemple de proposer un choix parmi les thèmes activés pour vos utilisateurs ou d utiliser un thème différent pour l administration et pour l utilisation de votre site. Configuration d un thème Découvrez maintenant ce qu il est possible de configurer dans l onglet Configurer de cette page. Rendez sur la page Administrer - Construction du site - Thèmes. Cliquez sur l onglet Configurer. Page de configuration des thèmes activés

136 136 III - Administration système de Drupal Apparaît alors un onglet pour chaque thème activé en plus de l onglet Paramètres globaux. Si aucun paramètre n est entré spécifiquement pour les thèmes activés, ce sont alors les paramètres globaux qui seront utilisés. Vous pouvez retrouver une description des autres éléments de cette page au chapitre 4.3. Les paramètres du site Modifier le logo et l icône du site Il est possible de modifier le logo et l icône de votre site depuis cette page : Interface d administration permettant la modification de l icône et du logo de votre site Le logo n est pas redimensionné automatiquement. Si vous désirez uniquement remplacer le logo par défaut, il faut donc que votre image ait la même dimension en hauteur que l icône par défaut du thème. Les icônes sont dans : votre_repertoire_drupal/themes/nom_de_votre_thème/logo.png Le logo de bluemarine fait 48 pixel de longueur par 55 de hauteur

137 11 - Configuration avancée de Drupal 137 Pour effectuer vos retouches sur des images, vous pouvez utiliser le logiciel libre Gimp ( Pour ne pas avoir un carré blanc autour de votre logo, il est possible de mettre un fond transparent pour votre logo. Pour cela, utilisez le canal alpha sous gimp et sauvegardez votre fichier au format png. Une fois votre logo préparé : Cliquez sur le bouton Parcourir de la section Paramètres du logo Sélectionnez-le sur votre disque dur. Cliquez sur le bouton Enregistrer la configuration. Votre nouveau logo! Utilisez la même procédure pour modifier l icône du site. Drupal se charge alors de le redimensionner automatiquement. Firefox affiche les icônes des sites dans la barre d adresses et les onglets Création d un nouveau thème à partir de BlueMarine Vous allez maintenant dupliquer le thème Bluemarine dans le but de le personnaliser. Il est nécessaire de travailler sur une copie car, avec Drupal, il ne faut modifier que les fichiers qui sont placés dans le répertoire «/site», il ne faut pas modifier directement les thèmes du répertoire «/thème» à la racine de Drupal.

138 138 III - Administration système de Drupal Copie répertoire Commencez par effectuer une copie du répertoire votre_repertoire_drupal/themes/bluemarine. Comme pour les modules, vous pouvez copier votre_repertoire_drupal/themes/bluemarine dans l un des répertoires suivants de Drupal, selon votre besoin : /sites/all/themes /sites/default/themes /sites/exemple.fr/themes le thème sera accessible depuis tous les sites le thème ne sera disponible que sur le site par défaut de Drupal le thème ne sera disponible que sur le site exemple.fr Renommez ensuite le répertoire bluemarine en mon_bluemarine Votre arborescence pour la création d un nouveau thème Le nom du nouveau thème est donc mon_bluemarine. Il va falloir modifier certains fichiers pour qu une entrée soit créée dans la liste des thèmes : Dans le répertoire mon_bluemarine, renommez le fichier bluemarine.info en mon_bluemarine.info. Editez ensuite le fichier mon_bluemarine.info. Modifiez la ligne name = Bluemarine en name = Mon Bluemarine. Enregistrez le fichier. Retournez sur la page Administrer - Construction du site - Thèmes Vous devriez y voir apparaître le thème Mon Bluemarine. Le thème Bluemarine doit toujours être disponible. Activez et mettez par défaut Mon Bluemarine

139 11 - Configuration avancée de Drupal 139 Le thème Mon Bluemarine activé et mis par défaut Cliquez sur le bouton Enregistrer la configuration Les fichiers du thème BlueMarine Vous allez maintenant découvrir les fichiers qui composent le thème créé. Rendez-vous dans le répertoire mon_bluemarine que vous venez de créer, vous y découvrez douze fichiers de différents types : Le fichier.info mon_bluemarine.info : Ce fichier est le point d entrée des thèmes dans Drupal. Il comporte le nom et la description du thème, la version de Drupal sur laquelle il fonctionne, la date de création, les régions qui composent le thème, etc. Les fichiers images logo.png : Logo par défaut du thème pour le site screenshots.png : Copie d écran du thème pour la page d administration des thèmes Les fichiers CSS Les fichiers css sont les feuilles de styles du thème. C est dans ces fichiers que vous pourrez modifier la police utilisée pour les titres, la couleur de fond du site, etc. style.css : Fichier contenant tous les styles du site style-rtl.css : rtl signifie Right To Left (de droite à gauche), cette feuille de style a été créée pour les écritures se lisant de droite à gauche.

140 140 III - Administration système de Drupal Les fichiers Templates Les fichiers template (.tpl.php) sont des fichiers modèles qui sont interprétés par un langage propre à Drupal, le phptemplate. Ces fichiers sont composés d un mélange de HTML et de php. block.tpl.php : Modèle pour la construction des blocs box.tpl.php : Modèle pour la construction des boites comment.tpl.php : Modèle pour la construction des commentaires node.tpl.php : Modèle pour la construction des nodes (tout type de contenu) page.tpl.php : Modèle pour la construction de la page dans son ensemble Composition d un fichier template Vous allez maintenant découvrir comment est composé un bloc à partir de son fichier template : block.tpl. php. Tout d abord, voici à quoi ressemble un bloc classique. Si cela n est pas fait, activez le module Comment et affichez le bloc Commentaires récents dans la barre de gauche. Affichage du bloc Commentaires récents avec le thème Bluemarine Le bloc est donc composé d un titre et d un contenu. Voici le code contenu dans le fichier block.tpl.php du thème Bluemarine : 1. <?php 2. // $Id: block.tpl.php,v /08/07 08:39:36 goba Exp $ 3.?> 4. <div class=»block block-<?php print $block->module;?>» id=»block-<?php print $block->module;?>-<?php print $block->delta;?>»> 5. <h2 class=»title»><?php print $block->subject;?></h2> 6. <div class=»content»><?php print $block->content;?></div> 7. </div> Les trois premières lignes donnent le nom, la version et la date de création du fichier. La ligne 4 débute par la définition des styles CSS : Le premier style, block, est défini pour tous les blocs. Le deuxième style est composé de la chaine «block-» et du nom du module relatif au bloc. Le

141 11 - Configuration avancée de Drupal 141 nom du module est retrouvé grâce au code php : <?php print $block->module;?>. Ici, c est le module comment qui créé la liste des commentaires. Ce deuxième style sera donc «block-comment». Enfin, un troisième style identifiant un élément unique (id=) est défini. Si par exemple vous affichez le bloc des commentaires récents à plusieurs endroits, vous voudrez peut-être les personnaliser différemment grâce à CSS. C est grâce à cet identifiant unique que vous pourrez le faire. Ce troisième style sera donc id=«block-comment-0». La ligne 5 permet d afficher le titre du bloc. Le style sera donc title et le titre est retourné grâce à la fonction <?php print $block->subject;?> Enfin, la ligne 6 permet d afficher le contenu grâce à la fonction <?php print $block->content;?>. Les fichiers template sont donc des gabarits qui indiquent comment se compose chaque élément de la page. Vous pouvez les modifier si le résultat renvoyé par une fonction ne vous convient pas. Ici, vous pourriez par exemple vouloir mettre le titre du bloc après son contenu. Pour cela, il suffit d inverser la position des lignes 5 et <?php 2. // $Id: block.tpl.php,v /08/07 08:39:36 goba Exp $ 3.?> 4. <div class=»block block-<?php print $block->module;?>» id=»block-<?php print $block->module;?>-<?php print $block->delta;?>»> 5. <div class=»content»><?php print $block->content;?></div> 6. <h2 class=»title»><?php print $block->subject;?></h2> 7. </div> Le bloc avec le titre en dessous du contenu Vous trouverez d autres exemples de modification des fichiers template dans le chapitre 14. Quelques exemples de modifications.

142 142 III - Administration système de Drupal 13. Modifier un thème par CSS Modifier par CSS Les feuilles de styles CSS prennent en charge la présentation d une page HTML. Drupal y a largement recours. C est bien sûr dans les thèmes que ces fichiers sont regroupés. Dans ce premier exemple, vous allez souligner l ensemble des titres du site. Pour cela, éditez le fichier style.css et recherchez le code suivant :.title,.title a { font-weight: bold; font-size: 1.3em; color: #777; margin: 0 auto; /* decrease default margins for h<x>.title */ } Modifiez le ainsi :.title,.title a { font-weight: bold; font-size: 1.3em; color: #777; margin: 0 auto; /* decrease default margins for h<x>.title */ text-decoration: underline; } Sauvegardez le fichier. Rechargez votre page : Les titres sont soulignés Utiliser Firebug Pour vous aider à situer les styles que vous voulez modifier dans Drupal, il existe une extension pour Firefox qui s avère rapidement indispensable : Firebug. Si Firefox n est pas sur votre machine, installez le immédiatement!

143 13 - Modifier un thème par CSS 143 Cliquez sur le bouton Catalogue. Recherchez le module Firebug (Version utilisée dans ce livre : 1.3). Cliquez sur Ajouter à Firefox. Installez le module. Redémarrez Firefox. Si tous s est bien déroulé, vous devriez avoir un petit sigle en bas à droite de la barre des tâches : Cliquez sur l icône de Firebug. L icône de Firebug Le contenu de la fenêtre Firebug apparaît, vous pouvez à ce moment naviguer dans le code HTML de votre page. Cliquez ensuite sur le bouton Inspecter. L interface de Firebug Placez votre curseur de souris sur un titre de la page.

144 144 III - Administration système de Drupal Et c est ici que Firebug est magique!!! L élément étudié est entouré en bleu. Les propriétés CSS des titres vues grâce à Firebug Dans le cadre de gauche de Firebug, le code HTML de l élément étudié (<h1 class=«title»...) est surligné Dans le cadre de droite de Firebug, vous retrouvez le code CSS des éléments étudiés, avec la ligne que nous avons rajouté : text-decoration: underline; Au-dessus s affichent le nom du fichier css (style.css) et la position du code css dans le fichier (line 202) Si vous passez votre souris au-dessus du lien, le chemin complet du fichier CSS apparaît, chose indispensable pour savoir quels fichiers sont réellement concernés. Le fichier contenant la propriété CSS Il est également possible de modifier directement depuis Firebug les valeurs de vos propriétés CSS pour avoir un aperçu.

145 14 - Quelques exemples de modifications 145 Modification d une propriété CSS grâce à Firebug Lorsque vous modifiez vos propriétés dans Firebug, les fichiers CSS ne sont pas modifiés. Utilisez flèche haut/flèche bas pour augmenter ou diminuer vos valeurs numériques 14. Quelques exemples de modifications Comme vous l avez vu dans les chapitres précédents, il est possible de modifier l apparence de Drupal de plusieurs façons : Grâce à l interface d administration : en affichant ou cachant des paramètres prédéfinis ou en configurant des blocs. Grâce à CSS en modifiant les styles de certains éléments. Grâce aux fichiers template (Modèles) en réorganisant le contenu ou en modifiant les fonctions incluses. Drupal utilise phptemplate qui interprète les fichiers template, qui définissent les styles. Lorsque vous désirez modifier l apparence de Drupal, il faut donc se poser les questions dans cet ordre : Puis-je arriver au résultat escompté grâce à l interface d administration? Puis-je arriver au résultat escompté en modifiant les fichiers CSS? Puis-je arriver au résultat escompté en modifiant les templates? Si la réponse est non à toutes ces questions, cela veut dire que vous devrez alors développer vos propres modules. Nous ne traiterons pas de cette question dans ce livre... C est cette méthode qui sera utilisée tout au long de ce chapitre.

146 146 III - Administration système de Drupal Objectif Entourer un bloc Vous allez maintenant mettre en valeur le bloc Commentaires récents en l entourant d une ligne blanche. Le bloc Commentaires récents tel que vous aimeriez le voir Méthode Vous ne pouvez pas effectuer cette tâche par l interface d administration. Par contre, cela semble tout à fait possible par CSS. Vous pouvez entourer un élément grâce à la propriété CSS border. Solution Utilisez alors Firebug pour voir de quoi se compose le bloc. Firebug dissèque votre bloc En plaçant votre curseur sur le bloc, vous pouvez constater que trois styles peuvent modifier son apparence : block : style modifiant tous les blocs de votre site. block-comment : style modifiant tous les blocs ayant trait au module Comments. block-comment-0 : style unique modifiant uniquement ce bloc.

147 14 - Quelques exemples de modifications 147 Dans cet exemple, seul ce bloc doit être modifié. Donc, vous utiliserez le style block-comment. Editez le fichier style.css de votre répertoire mon_bluemarine. Faites une recherche du style block-comment : il n existe pas, il va donc falloir en créer une occurrence. A la fin du fichier ajoutez ce code CSS :.block-comment {border : 2px solid white;} Sauvegardez et rechargez la page. Le bloc entouré d un filet blanc Objectif Afficher l auteur et la date d une contribution sans l heure Vous allez maintenant tenter de modifier Drupal pour afficher l auteur et la date des nodes sans heure ni seconde. Affichage par défaut de la ligne Soumis par... Affichage recherché de l auteur et de la date de création de la node

148 148 III - Administration système de Drupal Méthode Solution Il existe dans l interface d administration une section qui permet d afficher l auteur et la date des contributions sur la page Administrer - Construction du site - Thèmes. Par contre, il n est pas possible de supprimer l heure et les secondes grâce à cette page. Cela n est pas possible non plus en modifiant les feuilles CSS : CSS permet de modifier l apparence de l ensemble de la ligne, mais pas d en supprimer une partie. Cela semble possible en modifiant le fichier Template qui permet à Drupal d afficher les nodes : le fichier node.tpl.php Rendez vous sur la page Administrer - Construction du site - Thèmes. Cliquez sur l onglet Configurer. Dans la partie droite de la page, il existe une section Afficher l auteur et la date de la contribution pour les types. Cochez tous les types de contribution. L interface d administration permet de configurer l affichage de l auteur et de la date Cliquez sur le bouton Enregistrer la configuration. Rendez vous ensuite sur n importe quel node, vous pouvez constater que la date s affiche bien, mais avec l heure. Une contribution avec l auteur, la date et l heure

149 14 - Quelques exemples de modifications 149 Vous allez maintenant supprimer l heure en modifiant le fichier Template : Inspectez la ligne Soumis par... avec Firebug. Vous pouvez constater que cette ligne est formatée par le style submitted. Editez maintenant le fichier node.tpl.php La ligne soumis part est formatée par le style submitted La ligne 9 se compose ainsi : <span class=«submitted»><?php print $submitted?></span> C est donc cette ligne qu il va falloir modifier : la variable $submitted retourne l ensemble de la ligne. Il faut donc recréer l ensemble de cette ligne. Voici les variables qui pourraient la composer : $name : retourne le nom de l auteur de la contribution (ici admin). $node->created : retourne la date de création de la contribution. Donc,modifiez la ligne 9 comme cela : <span class=«submitted»> Soumis par <?php print $name?> le <?php print date( d/m/y, $node->created)?></span> Sauvegardez le fichier Rechargez la page Vous obtenez le résultat désiré!

150 150 III - Administration système de Drupal Objectif Modifier le pied de page Vous allez maintenant essayer de modifier le pied de page pour qu il ressemble à quelque chose de similaire à la figure ci-dessous. Pied de page avec dégradé et nouveau texte. Méthode L interface d administration permet de modifier le pied de plusieurs façons : En ajoutant ou en supprimant des blocs par la page Administrer - Construction du site - Blocs. Par la page Administrer - Configuration du site - Informations de base, grâce au paramètre Message de pied de page. Il est donc possible de modifier le contenu du pied de page avec ces deux pages, mais pas la mise en forme. Solution Pour modifier la mise en forme, il faudra donc modifier le CSS. Suppression du logo Drupal Voici à quoi peut ressembler votre pied de page avec le thème Bluemarine. Pied de page avant transformation. Ici, il faut supprimer le logo Drupal. Ce logo provient du bloc Propulsé par Drupal situé dans la zone Pied de page. Allez sur la page Administrer - Construction du site - Blocs. Commencez donc par supprimer ce bloc en choisissant l option <aucun> dans la liste déroulante.

151 14 - Quelques exemples de modifications 151 Cliquez sur le bouton Enregistrer les blocs. Ajout d un message de pied de page Modification du pied de page par les blocs Le message de pied de page peut-être ajouté sur la page Administrer - Configuration du site - Informations de base. Rendez vous sur la page Administrer - Configuration du site - Informations de base. Indiquez le message que vous désirez avoir sur votre pied de page dans la zone de texte Message de pied de page. Modification du message du pied de page Cliquez sur le bouton Enregistrer la configuration. Mise en forme du pied de page Grâce à Firebug, vous pouvez voir que le style CSS à modifier est #footer. Editez votre fichier style.css et recherchez le style #footer : #footer { background-color: #eee; padding: 1em; font-size: 0.8em; } Modifiez ce style pour : Changer la couleur de fond en bleu clair : background:#6293c6; Changer la couleur du texte en blanc : color:white; Centrer le texte : text-align:center;

152 152 III - Administration système de Drupal Agrandir la police : font-size: 1.1em; #footer { background:#6293c6; color:white; text-align:center; font-size: 1.1em; } Votre pied de page en cours de modification Il ne reste plus qu à ajouter le dégradé en haut, à agrandir les marges et à passer en blanc le lien drupal.org. Créez une image dégradée de bleu foncé vers bleu clair de 30 pixels*30 pixels (vous pouvez utiliser Gimp pour cela). Enregistrez là sous le nom de fond_pied.png dans le répertoire du thème mon_bluemarine. Modifiez ensuite le style #footer : Ajoutez votre image sur le haut du pied de page et répétez son affichage de gauche à droite : background:#6293c6 url(fond_pied.png) repeat-x scroll left top; Augmentez les marges du pied de page : padding: 25px; Mettez les liens en blanc en créant un nouveau style pour les liens présents dans le pied de page #footer { background:#6293c6 url(fond_pied.png) repeat-x scroll left top; color:white; text-align:center; padding: 25px; font-size: 1.1em; } #footer a{ color:white; } Sauvegardez le fichier. Rechargez la page. Vous devriez obtenir le résultat voulu!! 15. Le thème Zen Dans les chapitres précédents, vous avez réalisé toutes vos modifications en vous basant sur le thème Bluemarine. C est un thème simple qui comporte peu de fichiers et est donc facile à modifier.

153 15 - Le thème Zen 153 Cependant, si vous désirez personnaliser votre thème en profondeur, il sera préférable que vous vous basiez sur le thème Zen : un thème téléchargeable sur le site drupal.org et qui a été réalisé spécifiquement pour être modifié Installation de Zen Vous allez, dans ce chapitre, télécharger et installer le thème Zen présent sur le site drupal.org. Les méthodes pour télécharger, installer et activer les thèmes sont très proches de celles utilisées pour les modules (Voir chapitre 5.3. Installer un module). Rendez-vous sur le site et cliquez sur le lien direct renvoie vers la page de téléchargement des thèmes. Dans la liste, recherchez alors le thème Zen et téléchargez l archive correspondant à la version 6.x de Drupal. Extrayez alors son contenu dans l un des répertoires suivants de Drupal, selon votre besoin. Rendez vous alors sur la page d administration des thèmes : Administrer - Construction du site - Thèmes. Trois nouveaux thèmes sont maintenant disponibles qui Les trois thèmes présents dans le package Zen

154 154 III - Administration système de Drupal Zen Zen Classic Zen Themer s Starter Kit C est un thème très dépouillé qui sert de base à la construction de nouveaux thèmes Ce thème est basé sur Zen et a été modifié pour ressembler le plus possible au thème par défaut de Drupal (Garland). Si son aspect vous convient, vous pouvez partir de celui-ci pour créer votre thème. Ce thème est en fait la base de la création de nouveaux thèmes, c est un thème minimaliste à modifier Créer un nouveau thème à partir de Zen Les thèmes et les sous-thèmes Le thème Zen crée donc 3 entrées sur la page d administration de Drupal. Zen est le thème parent, Zen Classic et Starterkit sont des sous-thèmes qui héritent de Zen. Création d un thème à partir du StarterKit de Zen Vous allez maintenant créer votre propre thème que vous pourrez ensuite modifier comme vous l avez fait avec Bluemarine. Ce thème sera une copie du StarterKit (Kit de démarrage) qui est lui-même un sous-thème de Zen. Ce nouveau thème s appellera test. Faites une copier du dossier StarterKit (sites/all/themes/zen/starterkit) Renommez le répertoire en zen/test Dans ce répertoire test, renommez le fichier STARTERKIT.info en test.info. Copiez les fichiers layout-fixed.css, print.css et zen.css du répertoire zen/zen dans le répertoire test. Renommez layout-fixed.css en layout.css. Renommez zen.css en test.css. Au final, votre répertoire test devrait ressembler à cela : Les fichiers du nouveau thème test Dans les fichiers test/template.php et zen/template-settings.php, remplacez toutes les occurrences

155 15 - Le thème Zen 155 STARTERKIT par test. Dans le fichier test.info remplacez les lignes name= et description= comme ceci : name = Thème de test description = Thème personnalisé dérivé de Zen Activer le thème Cette méthode permet de créer des thèmes avec une largeur fixe. Pour créer un thème qui prend 100% de la largeur de la page, il faut copier et renommer le fichier layout-liquid.css en layout. css. Retournez sur la page de configuration des thèmes. Activez le thème Thème de test. Le nouveau thème activable Les fichiers de Zen Rendez vous maintenant dans le répertoire sites/all/themes/zen/zen, voici une description des fichiers qui le composent : Zen.info Ce fichier est le point d entrée des thèmes dans Drupal. Il comporte le nom et la description du thème, le version de Drupal sur laquelle il fonctionne et le thème de base. Il indique aussi le nom des régions du thème. Les fichiers images favicon.ico : Icône du thème (qui s affiche dans les onglets de firefox par exemple) logo.png : Logo du thème pour la page d administration des thèmes screenshots.png : Copies d écrans des fichiers pour l affichage dans la liste des thèmes

156 156 III - Administration système de Drupal Les fichiers CSS Zen dispose d un plus grand nombre de fichiers css que Bluemarine : block-editing.css : Styles pour les liens en haut à droite de chaque bloc html-elements.css : Styles pour tous les éléments HTML des pages (h1, ul, a, page...) ie.css : Styles spécifiques pour le navigateur de Microsoft layout-fixed.css : Styles pour les sites à taille fixe, vous pouvez définir ici la taille de la page, les marges des barres de gauche et droite, etc. layout-liquid.css : Styles pour les sites occupant 100% de la page print.css : Styles utilisés pour les pages créées pour l impression (avec le module Book par exemple) tabs.css : Styles utilisés pour afficher les onglets theme-settings.css : Styles utilisés dans la page de configuration du thème Zen zen.css : Voici la plus importante! Elle contient tous les autres styles de votre thème. Les fichiers Templates block.tpl.php : Modèle pour la construction des blocs box.tpl.php : Modèle pour la construction des boites comment.tpl.php : Modèle pour la construction des commentaires node.tpl.php : Modèle pour la construction des nodes node-forum.tpl.php : Modèle pour la construction des nodes de forum page.tpl.php : Modèle pour la construction d une page dans son ensemble search-theme-form.tpl.php : Modèle pour la construction de la page de recherche Les fichiers php Ces fichiers Php permettent de configurer le thème Zen, de créer la page de configuration du thème et de modifier certaines options. template.php : Dans ce fichier, il y a les liens vers les fichiers css utilisés par le thème. Pour la suite de ce livre, revenez au thème Garland.

157 15 - Le thème Zen 157 Partie V - Les modules CCK et Views

158 V - Les modules CCK et Views 158 V - Les modules CCK et Views 16. CCK : Créez des types de contenu personnalisés Présentation de CCK CCK (Content Construction Kit Kit de Construction de Contenu) est un module bien particulier : il permet de créer des types de contenu composés des champs que vous désirez. Tout au long de ce chapitre, vous allez créer un type de contenu Recette de cuisine grâce à CCK, qui possèdera les champs suivants : Titre de la recette Recette Prix par personne Difficulté (Très Facile, Facile, Moyen, Difficile) de l auteur Photo du plat Après avoir créé ce type de contenu, CCK et Drupal proposeront alors une interface de saisie conviviale pour les nouvelles recettes et les afficheront comme un contenu normal. Installation Téléchargez et décompressez l archive (Version utilisée pour ce livre CCK 6.x-2.1). Plusieurs entrées s affichent alors pour ce module dans une nouvelle section CCK :

159 16 - CCK : Créez des types de contenu personnalisés 159 Les différents modules de l archive CCK Activez les modules Content (Ajout de nouveaux types de contenu), Number (Ajout de champs numériques) et Text (Ajout de champs Texte). Cliquez ensuite sur Enregistrer la configuration. Création d un nouveau type de contenu Vous allez maintenant créer un nouveau type de contenu : Rendez vous sur la page Administrer - Gestion du contenu - Types de contenu. Cliquez sur l onglet Ajouter. Une interface permettant de définir votre nouveau type de contenu apparaît : Nom : Recette de cuisine. Type : recette. Description : Ajoute une recette à ce site.

160 160 V - Les modules CCK et Views Cliquez sur le bouton Enregistrer le contenu. Ajout d un nouveau type de contenu Le nouveau type de contenu créé s ajoute alors à la liste des types de contenu de Drupal. Les contenus CCK s affichent aux cotés des contenus classiques de Drupal Ajout d un champ Vous allez maintenant ajouter à votre type de contenu le champ qui indique le prix de la recette par personne : Cliquez sur le lien gérer mes champs de votre nouveau type de contenu. Etiquette : Prix par personne. Field name : prix. Type of data : Réel à virgule flottante.

161 16 - CCK : Créez des types de contenu personnalisés 161 Ajout d un champ pour votre type de contenu Les types de champs Décimal, Réel à virgule flottante et Entier ont été ajoutés avec l activation du module Number, le type Texte avec l activation de Text. D autres choix seront ajoutés lors de l activation de nouveaux modules CCK. Cliquez ensuite sur Enregistrer. La page se recharge pour permettre de configurer l interface de saisie du champ ajouté. Texte d aide : Entrez ici le prix par personne pour votre recette. Les champs de configuration de l interface de saisie Dans le champ Suffixe, entrez par personne. Cliquez sur Enregistrer les paramètres du champ. La liste des champs de votre contenu s affiche alors. Vous pouvez constater que d autres champs sont ajoutés par défaut. C est le cas des champs Titre et Corps, mais cela peut aussi être le cas de champs relatifs aux modules activés sur votre site : Taxonomie, Upload, etc. Placez le champ Prix par personne sous les Paramètres du menu.

162 162 V - Les modules CCK et Views Cliquez sur Enregistrer. Le nouveau champ est ajouté au type de contenu Vous pouvez personnaliser les libellés des champs Titre et Corps du formulaire de contribution à la page Administrer - Gestion du site - Type de contenu, lien modifier de votre type de contenu, section Paramètres du formulaire de contribution. Rendez-vous sur l onglet Afficher les champs pour configurer l affichage de vos champs sur la page de contenu. Modifiez les champs comme sur l illustration suivante. Cliquez sur Enregistrer. La page de configuration de l affichage sur la page de contenu Vous pouvez configurer le format d affichage selon différents contextes : Onglet Basic : Résumé : Affichage dans le résumé de la node Noeud complet : Affichage de l ensemble de la node Onglet Avancé : Elément de flux RSS : Affichage sur un flux RSS Search Index : Affichage dans les résultats d une recherche (21.2 Search : Un moteur de recherche pour votre site). Test du nouveau type de contenu Vous avez donc créé un nouveau type de contenu Recette de cuisine, contenant les champs par défaut Titre et Corps et le champ personnalisé Prix par personne. Voyez maintenant le résultat de votre travail : Cliquez sur Créer un contenu - Recette de cuisine. Vous arrivez à votre formulaire de contribution Remplissez les champs de cette interface.

163 16 - CCK : Créez des types de contenu personnalisés 163 Cliquez sur le bouton Enregistrer. Vous arrivez sur la page affichant votre recette. L interface de saisie de votre type de contenu Une page utilisant votre nouveau type de contenu En créant un nouveau type de contenu, vous paramétrez donc deux pages : la page de saisie et la page d affichage du contenu.

164 164 V - Les modules CCK et Views Modification des paramètres des champs et des types de contenu Paramètres du formulaire de saisie Paramètres de l affichage du contenu Les deux copies d écrans ci-dessus vous permettront de situer ou vous pouvez modifier les paramètres des types de contenus CCK à partir de la page Administrer - Gestion du contenu - Types de contenu.

165 16 - CCK : Créez des types de contenu personnalisés 165 N Onglet Section Champ 1 Editer Identification Nom 2 Editer Paramètres du formulaire de contribution Explications ou directives pour la contribution 3 Editer Paramètres du formulaire de contribution Libellé du champ titre 4 Editer Paramètres du formulaire de contribution Libellé du champ corps 5 Gérer les champs Configurer Etiquette 6 Gérer les champs Configurer Type de widget (zone de texte, liste, choix, etc.) 7 Gérer les champs Configurer Texte d aide 8 Gérer les champs Configurer Valeur par défaut 9 Gérer les champs Configurer Préfixe 10 Gérer les champs Configurer Suffixe 11 Afficher les champs Général Noeud complet (Format du champ) 12 Afficher les champs Général Etiquette Ajout d un champ Texte à choix multiple Vous allez maintenant ajouter un champ texte qui indique la difficulté de la recette. Ce champ devra proposer une liste de choix finie (Très facile, Facile, Moyen, Difficile). Activez le module Option Widgets de CCK. Rendez vous sur la page Administrer - Gestion de contenu - Types de contenu. Cliquez sur le lien modifier du type de contenu Recette de cuisine. Cliquez sur l onglet Gérer les champs. Etiquette : Difficulté de réalisation de la recette. Field name : difficulte Form element : Liste de sélection Cliquez sur le bouton Enregistrer. Ajout du champ difficulté La page se recharge. Il faut maintenant indiquer les valeurs à proposer dans la liste. h h Dans la section Valeurs permises, remplissez le champ Liste de valeurs autorisées. Il ne doit y avoir qu une valeur par ligne.

166 166 V - Les modules CCK et Views Liste des valeurs autorisées Cliquez sur le bouton Enregistrer les paramètres du champ. Réorganisez vos champs en mettant Difficulté de réalisation de la recette juste en-dessous du Titre. Cliquez sur le bouton Enregistrer. Editez alors le contenu de type Recette de cuisine que vous avez créé au chapitre précédent. Vous pouvez retrouver votre contenu sur la page Administrer - Gestion de contenu Contenu (6.8. Organiser le contenu). Vous pouvez constater que votre nouveau champ s affiche sous la forme d une liste déroulante dans le formulaire de saisie. Cliquez sur Enregistrer. La liste déroulante pour sélectionner la difficulté La difficulté s affiche dans le contenu

167 16 - CCK : Créez des types de contenu personnalisés Node Reference : Créer un lien vers une autre Node Vous allez maintenant créer un champ qui permet de mettre en lien d autres Nodes dans votre contenu. La différence avec les champs précédents est qu il sera possible de référencer autant de nodes que désiré. L interface de saisie utilisée sera aussi différente. Pour cet exercice, ajoutez quelques recettes de cuisine (3 ou 4) avec votre nouveau type de contenu (Créer un contenu - Recette de cuisine). Activez le module Node Reference. Rendez vous sur la page Administrer - Gestion de contenu - Types de contenu. Cliquez sur le lien gérer les champs du type de contenu Recette de cuisine. Etiquette : Lien vers d autres recettes. Field name : reference. Type of data : Référence à un noeud. Form element : Champ texte à auto-complètement. Cliquez sur le bouton Enregistrer. Il faut maintenant indiquer qu un nombre illimité de valeurs peuvent être choisies. Dans la liste déroulante Nombre de valeurs, choisissez Illimité. Dans la liste Types de contenu pouvant être référencés, cochez tous les types de contenu. Le nombre des valeurs est illimité pour ce champ Cliquez alors sur le bouton Enregistrer les paramètres du champ. Editez une recette de cuisine que vous avez créée. Le champ Lien vers d autres recettes vous propose alors d entrer deux liens. Vous pouvez alors ajouter autant de liens que vous le désirez grâce au bouton Ajoutez un autre élément.

168 168 V - Les modules CCK et Views L interface d ajout des liens vers les nodes et le bouton Ajouter un autre élément. Cliquez sur le bouton Enregistrer. Les différents liens vers les autres recettes s affichent alors dans votre contenu field : Ajoutez un champ à votre type de contenu Certains modules permettent d ajouter de nouveaux types de champs pour CCK. C est le cas du module field qui permet d ajouter un champ à votre type de contenu. Installation Téléchargez, décompressez et activez le module (Version utilisée pour ce livre : 6.x-1.1) Configuration Rendez vous sur la page Administrer - Gestion de contenu - Types de contenu. Cliquez sur le lien gérer les champs de Recette de cuisine. Etiquette : Adresse de courrier électronique. Nom du champ : . Type de champ : . Cliquez sur le bouton Enregistrer. Les valeurs par défaut conviennent, cliquez sur le bouton Enregistrer les paramètres du champ. Utilisation Editez alors une Recette de cuisine que vous avez créé. Indiquez une adresse dans le champ créé. Cliquez sur le bouton Sauvegarder. Le champ s affiche avec un lien mailto

169 16 - CCK : Créez des types de contenu personnalisés ImageField : Ajoutez un champ image à votre type de contenu Il est possible d ajouter un champ de type image dans vos types de contenu. Pour cela, il faut installer le module ImageField qui est dépendant du module FileField et de ImageAPI. FileField permet d ajouter à un contenu une liaison vers un fichier de n importe quel type. ImageAPI met à disposition des autres modules Drupal des fonctions pour manipuler les images. Installation Téléchargez et décompressez le module FileField (Version utilisée pour ce livre : 6.x-3.0-alpha6). Téléchargez et décompressez le module ImageField (Version utilisée pour ce livre : 6.x-3.0-alpha4). Téléchargez et décompressez le module ImageAPI (Version utilisée pour ce livre : 6.x-1.2). Activez les modules ImageAPI, ImageAPI GD2, FileField et FileField Image. Configuration Rendez vous sur la page Administrer - Gestion de contenu - Types de contenu. Cliquez sur le lien gérer les champs du type de contenu Recette de cuisine. Etiquette : Photo de la recette. Field name : photo. Type of data : Image Form element : Image. Cliquez sur le bouton Enregistrer. Les champs par défaut pour ce champ conviennent. Cliquez sur le bouton Enregistrer les paramètres du champ. Cliquez sur l onglet Afficher les champs. Sur la ligne Photo de la recette, choisissez Image linked to file pour le Résumé et le noeud complet. Cliquez sur Enregistrer. Affichage des images dans le contenu Editez alors une recette de cuisine que vous avez créée et ajoutez une photo de votre disque local grâce au bouton Parcourir... Cliquez sur Transfert de fichiers.

170 170 V - Les modules CCK et Views Transfert d une photo avec ImageField Cliquez sur Enregistrer. La photo s affiche à sa taille normale Pour plus de souplesse dans l affichage de vos photos, il est fortement conseillé de lire la partie CCK du chapitre consacré à ImageCache : le «couteau suisse» pour traiter les images avec Drupal ImageCache : Manipulez vos images avant de les afficher La taxonomie et CCK Vous avez créé le champ Difficulté de réalisation grâce à CCK. Peut-être avez-vous pensé qu il serait possible de le créer aussi avec le module Taxonomie? Cela permettrait d utiliser toute la puissance du module taxonomie pour effectuer des tris et des sélections. Vous allez maintenant permettre à votre type de contenu d utiliser les vocabulaires Catégorie (Entrée, Plat, Dessert...) et Origine créés au chapitre 6.9. La taxonomie. Allez sur la page d administration du module Taxonomie : Administrer - Gestion du contenu - Taxonomie. Cliquez sur le lien modifier le vocabulaire de la ligne Catégorie.

171 16 - CCK : Créez des types de contenu personnalisés 171 A la section Type de contenu, cochez Recette de cuisine. Cliquez sur le bouton Enregistrer. Affection des types de contenu à un vocabulaire Refaites la même manipulation pour le vocabulaire Origine. Voyez maintenant l impact que cela a eu sur votre type de contenu : Editez un contenu du type Recette de cuisine. Une nouvelle section Vocabulaires apparaît alors. La taxonomie dans le formulaire de saisie N oubliez pas que vous pouvez réorganiser l ordre de vos champs sur la page Administrer - Gestion du contenu - Types de contenu, lien Gérer les champs Modification de l apparence des champs CCK Chaque champ CCK se voit attribuer dans le code HTML son propre style CSS, cela permet ainsi mettre en forme facilement votre page de rendu. Aligner à droite le champ difficulté h h Activer votre thème Mon Bluemarine (chapitre Création d un nouveau thème à partir de BlueMarine).

172 172 V - Les modules CCK et Views Affichez votre recette créée avec le type de contenu Recette de cuisine. Grâce à Firebug; sélectionnez la balise div de la difficulté. Firebug vous apprend les informations suivantes : Le champ CCK sélectionné avec Firebug Le style CSS du champ difficulté de la recette est field-field-difficulte. Le fichier dans lequel vous devez définir ce style est votre_repertoire_drupal/sites/all/themes/ mon_bluemarine/style.css. Il faut ajouter ces lignes au fichier style.css :.field-field-difficulte{ text-align:right; } Sauvegardez votre fichier. Rechargez votre page. Le texte est maintenant aligné à droite

173 17 - Views : Créez des vues sur vos données Views : Organisez vos données Comme le module CCK, le module Views semble complexe au premier abord, mais devient vite indispensable. Il permet de créer des vues qui sélectionnent des données de la base de Drupal, les organisent et les affichent ensuite. Views réalise tout cela grâce à une interface utilisateur très riche et bien organisée. Voici quelques exemples de vues : Lister tous les utilisateurs enregistrés en les triant par rôle. Afficher tous les contenus d un même type. Afficher tous les termes de la Taxonomie. Afficher tous les contenus par ordre alphabétique. Dans ce chapitre, vous allez découvrir quelques exemples de vues installées avec Views. Ensuite, vous créerez votre propre vue qui affichera l ensemble des recettes de cuisine sur une page et dans un bloc. Pour bien réussir l exemple de ce chapitre, il faut avoir suivi les manipulations du chapitre 16. CCK : Créez des types de contenu personnalisés et ImageCache : Manipulez vos images avant de les afficher, partie CCK. Installation du module Téléchargez et décompressez Views (Version utilisée dans ce livre : 6.x-2.2). Activez les modules Views et Views UI Découverte de quelques vues par défaut En activant le module Views, quelques exemples de vues sont installés. Vous allez maintenant découvrir deux de ces exemples. Découverte de la vue exemple Tracker Rendez vous sur la page de configuration des vues : Administrer - Construction du site - Views. Dans la liste, cliquez sur le lien Activer de la vue Tracker (Vue Par défaut Node : tracker). La vue exemple Tracker dans la liste des vues Cliquez sur le lien Chemin : Tracker, ce lien permet d accéder au rendu de la vue.

174 174 V - Les modules CCK et Views Voici ce qui peut être observé : La vue Tracker affiche la listes des nodes de votre site. Cette vue utilise les champs Type, Titre, Auteur, Réponses et Last Post de chaque node du site. Elle trie ensuite ces nodes par date. Elle présente ces nodes sous forme de tableau. Il est possible de trier ces nodes sous une autre forme grâce aux titres des colonnes du tableau. Vous pouvez découvrir comment est construite cette vue en l éditant : Retournez sur la page Administrer - Construction du site - Views. Cliquez sur le lien Modifier de la vue tracker. Vous découvrez alors l interface utilisateur du module Views.

175 17 - Views : Créez des vues sur vos données 175 L interface utilisateur très élaborée du module Views Vous apprendrez à utiliser cette interface tout au long de ce chapitre, mais vous pouvez déjà noter certaines choses concernant la vue Tracker : Dans la section Champs, les différents champs affichés sur la vue sont listés (Type, Titre, Auteur, etc.). Dans la section Critères de tri, Heure de dernier commentaire est utilisé. Dans la section Paramètres de base, le style Tableau est utilisé. Découverte de la vue exemple Glossary La vue Glossary est plus complexe, mais elle permet de se rendre compte du potentiel du module Views. Rendez vous sur la page de configuration des vues : Administrer - Construction du site - Views. Dans la liste, cliquez sur le lien Activer de la vue Glossary. Dans la liste, cliquez sur le lien Chemin : Glossary. Apparaît alors la page qui affiche un glossaire de toutes les nodes de votre site. Lorsque vous cliquez sur une lettre, la liste des nodes ayant un Titre commençant par cette lettre s affiche sous forme de tableau. Liste des nodes triées par la première lettre de leur titre

176 176 V - Les modules CCK et Views Affichage des nodes commençant par M Création d une nouvelle vue Après avoir observé ces exemples, vous allez maintenant créer votre propre vue. Cette vue sélectionnera les contenus de type Recette de cuisine et les affichera dans une page sous forme de tableau et dans un bloc. Création de la vue Allez sur la page Administrer - Construction du site - Views. Cliquez sur le bouton Ajouter. Nom de la vue : liste_recettes. View description : Liste des recettes du site. Etiquette de la vue : permet de trier les vues sur la page d administration lorsqu il y en a un grand nombre. Pour cet exemple, laissez-le vide. Type de vue : Ce champ permet de sélectionner sur quelles données s appuiera principalement votre vue. Ici, sélectionnez Node. Cliquez sur le bouton Suivant. Votre vue est maintenant créée. Page de création d une nouvelle vue

177 17 - Views : Créez des vues sur vos données Sélection des champs à afficher (Fields) L interface utilisateur du module apparaît alors. Pour commencer, vous allez ajouter les champs qui s afficheront dans votre vue : Le Titre de la recette, la photo de la recette, la difficulté de réalisation, la date de dernière mise à jour et le Type de recette (Taxonomie). Dans la section Champs, cliquez sur l icône. Lorsque vous modifiez un paramètre de votre vue, une section concernant ce paramètre s affiche en-dessous de l interface utilisateur. Cochez le champ Node: Date de mise à jour, pour sélectionner la date de la dernière mise à jour de la recette. Cochez le champ Node: Titre. Cochez le champ Contenu: Photo de la recette, pour sélectionner la photo de la recette. Cochez le champ Contenu: Difficulté de réalisation de la recette pour sélectionner la difficulté de la recette. Cochez le champ Taxonomie: Tous les termes, pour pouvoir sélectionner par la suite le vocabulaire Catégorie. Section de sélection des champs Vous pouvez réduire le nombre de champs disponibles grâce à la liste Groupes en y sélectionnant la table sur laquelle est basé votre champ. Cliquez sur le bouton Ajouter. Vos champs sont maintenant ajoutés à la section Fields, mais, l interface va passer en revue chaque champ sélectionné pour effectuer quelques réglages (Format, Affichage du champ, Etiquette, etc.). Les possibilités de réglages seront différents en fonction du type de champ.

178 178 V - Les modules CCK et Views Pour le champ Contenu: Difficulté de réalisation de la recette, choisissez Aucun pour Etiquette. Section affichant les paramètres de chaque champ Le champs que vous êtes en train de configurer s affiche sur fond jaune dans la section Champs de Views. Cliquez sur Mise à jour. Pour le champ Contenu: Photo de la recette terminée, cochez Lier ce champs à son noeud pour créer un lien vers la node lorsque vous cliquerez sur l image Choisissez Aucun pour Etiquette. Format : Miniature100 image linked to node. Cliquez sur Mise à jour. Pour le champ Node: Date de mise à jour, choisissez Date de dernière mise à jour pour Etiquette Format de date, choisissez personnalisé et entrez la chaîne d/m/y. Cela formattera la date en type Jour/Mois/Année. Cliquez sur Mise à jour. Configuration du champ date

179 17 - Views : Créez des vues sur vos données 179 Pour le champ Node : Titre, cochez la case Lier ce champ à son noeud. Cliquez sur Mise à jour. Pour le champ Taxonomie: Tous les termes, mettez Type pour Etiquette Cochez la case Lier ce champ vers la page de terme correspondante et Limiter les termes par vocabulaire. Dans la liste des Vocabulaires, sélectionnez Catégorie. Configuration d un champ de la Taxonomie Cliquez sur Mise à jour. Voilà, les champs sont maintenant ajoutés dans la section Fields. Vous pouvez changer leur ordre en cliquant sur le bouton de la section Fields. Organisation des champs Cliquez sur Mise à jour. Les vues ne sont pas sauvegardées automatiquement. Pensez à sauvegarder votre vue régulièrement en cliquant sur le bouton Enregistrer Filtres Pour cette vue, seules les nodes de type Recette de cuisine doivent être sélectionnées. Il faut donc appliquer un filtre à votre vue. Dans la section Filtres, cliquez sur l icône. Cochez le champ Node : Type. Cliquez sur le bouton Ajouter.

180 180 V - Les modules CCK et Views Dans la colonne Operateur, choisissez Fait partie de. Dans la colonne Type de noeud, choisissez Recette de cuisine. Cliquez sur Mise à jour. Ajout d un filtre Lorsque vous faîtes des modifications sur votre vue, une section Prévisualisation en direct (Aperçu en temps réel) en bas de la page affiche : Un aperçu de votre vue. Une section Requête qui affiche la requête SQL exécutée. Des informations concernant les temps d exécution de la requête Critères de tri Votre vue sélectionne maintenant toutes les données désirées. Vous pouvez les trier par ordre de dernière mise à jour. Dans la section Critère de tri, cliquez sur l icône. Cochez le champ Node : Date de mise à jour. Cliquez sur le bouton Ajouter. Dans la liste Ordre de tri, choisissez Descendant pour afficher les dernières recettes modifiées en tête de liste. Dans la liste Granularité, choisissez Seconde. La granularité est le niveau auquel Drupal doit trier les dates. Par exemple, si vous choisissez Année, alors, tous les enregistrements ayant la même année seront au même niveau. Il faudra un deuxième critère de tri pour différencier les enregistrements Cliquez sur Mise à jour. Vous pouvez maintenant constater dans la section Prévisualisation en direct que les recettes sont maintenant triées par ordre de dernière mise à jour. Cliquez sur le bouton Enregistrer de la vue.

181 17 - Views : Créez des vues sur vos données Affichage des données (Display) Jusqu à maintenant, vous avez travaillé uniquement sur les données brutes de votre vue. Le module Views sépare bien la sélection et l organisation des données de la mise en forme de celles-ci. Il est en effet possible, avec la même vue, de créer différentes sorties. C est ce que vous allez faire maintenant en créant un affichage sur une Page et un autre sur un Bloc en utilisant les données de votre vue liste_recette. Ajout des affichage Page et Bloc Sélectionnez Page dans la liste déroulante des affichages (au dessus du bouton Nouvel affichage). Cliquez sur Nouvel Affichage. Sélectionnez Bloc dans la liste déroulante des affichages. Cliquez sur le bouton Nouvel Affichage. Ajout des Display Page et Bloc Les deux affichages que vous venez d ajouter héritent des réglages de l affichage Paramètres par défaut. Paramètres spécifiques/par défaut (Override / Use Default) Vous allez découvrir comment modifier des paramètres pour l ensemble des affichages ou seulement pour l affichage sélectionné. Vous modifierez pour cet exemple le paramètre Éléments à afficher. Le paramètre Éléments à afficher de la section Paramètres de base permet de définir le nombre d items à afficher par page. L affichage Page permettra d afficher 15 recettes, tandis que l affichage Bloc n en affichera que 4. Sélectionnez l affichage Page dans la colonne de gauche. Cliquez sur le paramètre Éléments à afficher. Cliquez sur le bouton Supplanter. Entrez 15 dans le champ texte. Ainsi, vous modifiez cette valeur uniquement pour l affichage Page. Si vous aviez cliqué sur le bouton Utiliser la valeur par défaut, vous auriez modifié le paramètre pour tous les affichages.

182 182 V - Les modules CCK et Views En résumé : Bouton Supplanter affiché : Modification de tous les affichages en cliquant sur le bouton Update default display. Bouton Utiliser la valeur par défaut affiché : Modification de l affichage en cours en cliquant sur le bouton Mise à jour. Cliquez sur Mise à jour. Modification d un champ uniquement pour l affichage sélectionné Modification du paramètre Items to display pour le Display Bloc : Sélectionnez l affichage Bloc dans la colonne de gauche. Cliquez sur le paramètre Éléments à afficher. Cliquez sur le bouton Supplanter. Entrez 4 dans le champ texte. Cliquez sur Mise à jour. Vous pouvez alors vérifier que le paramètre Éléments à afficher est bien à 10 pour l affichage Paramètres par défaut, à 15 pour Page et à 4 pour Bloc Configuration de l affichage Page Quelques paramètres spécifiques à l affichage Page sont à configurer : Sélectionnez l affichage Page. Dans la section Paramètres de la page, modifiez le paramètres Chemin. Entrez liste_recettes dans le formulaire. Création de l URL de la vue

183 17 - Views : Créez des vues sur vos données 183 Validez avec le bouton Mise à jour. Vous allez maintenant présenter la vue en tableau. Dans la section Paramètres de base, modifiez le paramètre Style. Sélectionnez l option Tableau. Cliquez sur le bouton Mise à jour. Vous allez maintenant configurer les paramètres de votre tableau. Cochez la case Classable pour les paramètres Titre, Date de dernière mise à jour. Cela permettra à l utilisateur de la vue de trier par titre ou par date en cliquant sur les entêtes de colonne. Cochez l option Activer les entêtes de tableau «collants» de Drupal (JavaScript) pour que les entêtes de colonne restent fixe. Cliquez sur le bouton Mise à jour. Cliquez sur le bouton Enregistrer pour l ensemble de la vue. Si vous voulez voir à quoi ressemblera votre page, utilisez la Prévisualisation en direct, mais n oubliez pas de sélectionner l Affichage qui vous convient avant! Pointez votre navigateur à l URL : Votre vue sur l affichage page

184 184 V - Les modules CCK et Views Configuration de l affichage Bloc Vous allez maintenant créer un bloc pour votre vue. Pour ce bloc, vous allez afficher uniquement le Titre et la Difficulté de la recette, sans étiquette, sur la même ligne. Administration - Construction du site - Views. Cliquez sur le lien Modifier pour la vue liste_recettes. Sélectionnez l affichage Bloc. Suppression de l étiquette Titre : Dans la section Champs, modifiez le Node : Titre. Supprimez l Etiquette. Cliquez sur le bouton Mise à jour. Suppression de l affichage du type : Cliquez sur Taxonomie: Tous les termes. Cochez l option Exclure de l affichage. Cliquez sur le bouton Mise à jour. De la même façon, supprimez de l affichage les champs Contenu: Photo de la recette et Node: Date de mise à jour. Enregistrez votre vue en cliquant sur Enregistrer. Il s agit maintenant de mettre en forme les champs : ils seront en liste et disposés sur une ligne, séparés par une virgule. Sélectionnez l affichage Bloc. Dans la section Paramètres de base, modifiez le paramètres Style. Cochez l option HTML List. Cliquez sur le bouton Mise à jour. La page se recharge alors, cliquez à nouveau sur Mise à jour. Dans la section Paramètres de base, cliquez sur l icône du paramètre Style de ligne. Cochez les champs Node : Titre et Contenu: Difficulté de réalisation de la recette. Dans la case Separateur, entrez «,».

185 17 - Views : Créez des vues sur vos données 185 Cliquez sur Mise à jour. Options du style de ligne Ajoutez un lien more qui redirigera vers la page de votre vue : Dans la section Paramètres de base, modifiez le paramètre Lien «plus». Cochez la case Créer un lien «plus». Cliquez sur Mise à jour. Enfin, il vous reste à nommer votre Bloc : Dans la section Paramètres des blocs, modifiez le paramètre Admin. Entrez Dernières recettes dans la description. Cliquez sur le bouton Mise à jour. Cliquez sur le bouton Enregistrer pour l ensemble de la vue. Il s agit maintenant d afficher le bloc dans la colonne de gauche : Dans la page Administrer - Construction du site - Blocs, affichez le bloc Dernières recettes comme indiqué au chapitre 7.2. Les blocs. Votre nouveau bloc personnalisé avec Views

186 186 V - Les modules CCK et Views Configuration de l affichage Fichier attaché Après avoir créé les affichages Page et Bloc, vous allez créer un affichage Fichier attaché. Il prendra en argument un terme de Taxonomie et pourra être inséré, par exemple, à l intérieur d un contenu. Administration - Construction du site - Views. Cliquez sur le lien modifier pour la vue liste_recettes. Dans la liste des affichages, choisissez Fichier Attaché. Cliquez sur le bouton Nouvel affichage. Changez le nom de l affichage pour le rappeler plus facilement par la suite : Dans la section Paramètres de base, modifiez le paramètre Nom. Entrez par_categorie Cliquez sur Mise à jour. Vous allez maintenant ajouter un argument à votre affichage. Dans la section Arguments, cliquez sur l icône. Sélectionnez Taxonomie : Terme dans la liste. Cliquez sur Ajouter. L interface permettant de configurer les arguments apparaît. Les valeurs par défaut conviennent. Cliquez sur Mise à jour. Cliquez sur Enregistrer. L affichage par_categorie avec son argument Vous pouvez utiliser la section Prévisualisation en direct pourt ester votre vue. Choisissez l affichage par_categorie et en argument, mettez entrée ou un autre terme de la taxonomie.

187 17 - Views : Créez des vues sur vos données Insert View : Insérer une vue dans un contenu Vous allez créer un nouveau contenu de type page et y insérer la vue par_categorie créée précédemment. Le module Insert View, qui ajoute un nouveau filtre pour les formats d entrées permet de réaliser cela simplement. Installation Téléchargez, décompressez et installez le module (Version utilisée dans ce livre : 6.x-1.0) Configuration Ajoutez le filtre insert view filter au format d entrée Full HTML (6.2. Les formats d entrées). Utilisation Créer un contenu - Page. Titre : Liste de nos entrées. Corps : Voici la liste de nos entrées : [view:liste_recettes=par_categorie=entree]. Format d entrée : Full HTML. Cliquez sur Enregistrer. Création de votre page contenant la vue. Rendu de votre page contenant la vue

188 188 V - Les modules CCK et Views Voici la syntaxe du filtre Insert View : [view:ma_vue] [view:ma_vue=mon_affichage] [view:ma_vue=mon_ affichage=arg1,arg2] Affiche la vue ma_vue Affiche la vue ma_vue avec l affichage mon_affichage Affiche la vue ma_vue avec l affichage mon_affichage en lui passant les arguments arg1 et arg2.

189 17 - Views : Créez des vues sur vos données 189 Partie VI - Description des modules utiles de Drupal

190 VI - Description des modules utiles de Drupal 190 VI - Description des modules utiles de Drupal Voici une sélection de modules utiles pour Drupal. Tout au long de la lecture de cet ouvrage, des renvois vers les chapitres de cette partie ont été réalisés. Pour savoir comment installer des modules, rendez-vous au chapitre 5.1. Activation et découverte d un module. Le chapitre 5.2. Rechercher un module sur drupal.org est, lui, consacré à la recherche des modules sur internet. 18. Administration Backup and Migrate - Sauvegardez votre base de données Ce module permet de sauvegarder, directement à partir de l interface de Drupal, votre base de données. Vous pouvez également programmer des sauvegardes automatiques à intervalles de temps réguliers. Installation Ce module permet de sauvegarder uniquement la base de données et pas l arborescence de fichiers. Veillez à bien sauvegarder l ensemble de données de votre site (chapitre Sauvegarde/restauration d un site Drupal). Décompressez et activez le module (Version utilisée pour ce livre 6.x-1.0). Utilisation Rendez vous sur la page Administrer - Gestion du contenu - Backup and Migrate Vous avez alors accès à 4 onglets. Les différentes pages de configuration de Backup and Migrate Backup/Export DB Cet onglet permet de sauvegarder manuellement votre base de données. Vous pouvez exclure de la sauvegarde la structure des tables dans la première liste et les données des tables dans la seconde. Ensuite, choisissez un nom de fichier et un mode de compression. L option destination permet de choisir si vous voulez télécharger le fichier vers votre ordinateur local ou si vous voulez que votre fichier soit sauvegardé dans un sous-répertoire de /files de votre installation Drupal.

191 18 - Administration 191 Restore/Import DB Cet onglet permet de restaurer une base de données sauvegardée en local avec l onglet Backup/Export DB. Saved Backups Ici, la liste des sauvegardes effectuées dans le répertoire /files est affichée. Vous pouvez restaurer n importe quelle base depuis cette interface. Backup Schedule C est dans cet onglet que réside l intérêt de ce module, vous pouvez automatiser des sauvegardes à partir de cette interface. Le paramètre Backup every permet de définir le nombre d heures qui doivent s écouler entre deux sauvegardes. Le paramètre Number of Backup files to keep est le nombre de sauvegardes à conserver dans le répertoire files. L ordonnanceur de Backup and Migrate Dans l exemple ci-dessus, une sauvegarde sera effectuée tous les jours et les sauvegardes seront conservées durant 30 jours Google Analytics : Mesurez l audience de votre site Google Analytics est un service gratuit pour les possesseurs de site web désirant connaître l audience de leur site. Le module Drupal Google Analytics permet d ajouter le code javascript adéquat à chaque page de votre site pour que Google Analytics puisse établir ses rapports statistiques. Installation Le prérequis pour paramétrer le module est d avoir un compte Google. Vous pouvez en créer un sur Téléchargez, décompressez et activez le module (Version utilisée pour ce livre 6.x-2.0).

192 192 VI - Description des modules utiles de Drupal Configuration Rendez vous sur le site de Google Analytics : Connectez vous avec votre compte Google. Cliquez sur le lien Ajouter un profil de site web. Entrez l URL racine de votre site Drupal. Cliquez sur le bouton Continuer. Dans le code Javascript, notez bien le numéro commencant par UA-xxxxxx-x Votre site est sous surveillance Vous pouvez retrouver ce code en cliquant sur le lien Modifier de votre site, puis sur le lien Vérifier l état en haut à droite du formulaire. Rendez vous sur la page de configuration du module : Administrer - Configuration du site - Google Analytics. Il faut maintenant entrer votre numéro de compte de Google Analytics (UA-xxxxxx-x) dans le champ Numéro du compte Google Analytics. La section Paramètres spécifiques de suivi des utilisateurs permet à vos utilisateurs de personnaliser leur surveillance par Google Analytics. La section Paramètres spécifiques de suivi par rôle permet d activer la surveillance uniquement pour certains rôles. La section Paramètres de suivi spécifiques aux pages permet d activer la surveillance uniquement pour certains types de page. La section Paramètres de ségmentation des utilisateurs permet d enregistrer l activité de vos utilisateurs. La section Paramètres de suivi des liens permet d enregistrer les clics sur liens sortants, les et sur le téléchargement de fichiers. La section Paramètres avancés permet de régler le cache et le suivi des recherches par Search : Un moteur de recherche pour votre site. Quelques heures plus tard, vous devriez avoir accès aux statistiques de votre site

193 18 - Administration 193 Un rapport de Google Analytics Poormanscron : Lancer le cron automatiquement Ce module très simple permet de lancer le cron (11.2.Le cron) sans avoir à configurer la crontab sous Linux ou les tâches planifiées sous Windows. Installation Téléchargez, décompressez et activez le module (Version utilisée pour ce livre 6.x-1.0). Utilisation Rendez-vous sur la page Administrer - Configuration du site - Poormanscron La page de configuration de Poormanscron

194 194 VI - Description des modules utiles de Drupal Vous pouvez alors configurer 4 paramètres : Cron runs interval Retry interval Log Successful cron runs Log poormanscron progress Nombre de minutes qui doivent s écouler entre 2 exécutions de cron. Nombre de minutes à attendre après une erreur d exécution. Inscrire les lancements de cron dans le fichier de log. Inscrire les lancements de poormanscron dans le fichier de log. 19. Editeurs NiceEdit : Un éditeur Wysiwyg simple Rendez vous au chapitre 6.5. NicEdit : Installer un éditeur Wysiwyg pour plus d informations sur ce module FCKeditor : Un éditeur Wysiwyg complet Cet éditeur Wysiwig est très populaire dans la communauté Drupal, car il propose de nombreuses fonctionnalités. Revers de la médaille, il est plus compliqué à installer et à configurer que NicEdit. Installation L installation se déroule en deux temps, d abord, il faut installer la partie Drupal du module, puis télécharger l éditeur lui-même sur le site de fckeditor. Vous pourrez ensuite activer le module. Téléchargez et décompressez le module (Version utilisée pour ce livre 6.x-1.3-rc6). Téléchargez ensuite l archive FCKeditor sur le site : (Version utilisée pour ce livre 2.6.3). Décompressez l archive dans le répertoire /modules/fckeditor/fckeditor (Attention au sous répertoire). Activez le module. Configuration Droits d accès h h Par défaut, seul l administrateur a accès aux fonctionnalités de FCKEditor. Vous pouvez autoriser l accès au module sur la page Administrer - Gestion des utilisateurs - Droits d accès à la section module fckeditor.

195 19 - Editeurs 195 Les droits d accès de FCKEditor access fckeditor administer fckeditor allow fckeditor file uploads Permet d utiliser fckeditor dans les formulaires autorisés Permet d accéder aux pages de configuration de fckeditor Permet de télécharger des fichiers sur le serveur hébergeant Drupal grâce à l interface de fckeditor Profils FCKeditor Allez sur la page de configuration Administrer - Configuration du site - FCKeditor. Cette page liste les profils de configuration de FCKeditor. Chaque profil est créé en fonction des rôles des utilisateurs. Il existe également un profil global (FCKeditor Global Profile) dont les valeurs seront appliquées à tous les autres profils. Les profils d utilisation de FCK Editor Configuration des profils Il existe un grand nombre de paramètres pour régler le module FCKeditor. Vous allez découvrir ici les plus importants : Cliquez sur le lien Modifier d un profil existant ou sur le lien Create new profile.

196 196 VI - Description des modules utiles de Drupal Basic setup (Configuration de base) La section de configuration basique Profile Name Allow users to customize FCKeditor appearance Nom du profil Détermine si l utilisateur peut modifier l apparence de l interface. Visibility settings (Configuration de la présence) La section d affichage Cette section permet d indiquer pour quelle zone de texte fckeditor doit s afficher. Minimum rows Use inclusion or exclusion mode Indique le minimum de lignes potentielles que doit comporter la zone de texte pour que fckeditor s affiche Si vous désirez autoriser toutes les zones de texte du site à utiliser fckeditor et en interdire seulement quelques unes, choisissez exclusion mode. A l inverse, si vous désirez interdire toutes les zones de texte du site à utiliser fckeditor et en autoriser seulement quelques unes, choisissez inclusion mode.

197 19 - Editeurs 197 Fields to exclude/include Paths to exclude/include Force simplified toolbar on the following fields Force simplified toolbar on the following paths Entrez ici les numéros des formulaires où Fckeditor doit être activé ou désactivé (en fonction du mode choisi) Entrez ici les URLs des pages où Fckeditor doit être activé ou désactivé (en fonction du mode choisi) Entrez ici les numéros des formulaires où Fckeditor doit utiliser la barre d outils simplifiée Entrez ici les URLs des pages où Fckeditor doit utiliser la barre d outils simplifiée Pour connaître les numéros des formulaires ou les URLs des pages : Activez fckeditor pour l ensemble des pages (Choisir Exclude). Rendez vous à la page ou se trouve le formulaire. En-dessous de celui-ci, s affiche un message qui indique les numéros des formulaires et l URL de la page. Ce formulaire a pour id : edit-body et pour URL : node/add/story Editor Apearance (Configuration de l apparence) Default state Show disable/enable rich text editor toggle Use FCKeditor in a popup window Skin Indique l état de l éditeur par défaut. Si positionné en désactivé, le code HTML s affichera par défaut. Affiche ou cache le bouton d activation et de désactivation de FCKeditor sur le formulaire Affiche FCKeditor dans une nouvelle fenêtre. Thème à utiliser

198 198 VI - Description des modules utiles de Drupal XStandard WYSIWYG Editor : Un éditeur Wysiwyg coté client Cet éditeur propose une méthode originale d installation et de fonctionnement. En effet, le module demandera à vos visiteurs qui créent du contenu de télécharger un petit plugin pour leur navigateur. Installation : Téléchargez, décompressez et activez le module (Version utilisée pour ce livre 6.x-1.0-beta3). Configuration Rendez-vous sur la page d administration de XStandard (Administrer - Configuration du site - XStandard) pour configurer ses paramètres. Dans la section Basic setting, ajoutez les champs qui pourront utiliser XStandard. Par exemple, ajoutez edit-body pour que les champs corps de tous les types de contenu puissent être édités. Cliquez sur Enregistrer la configuration. Utilisation La page de configuration de XStandard Créez ensuite un nouvel article. A ce moment, votre navigateur devrait vous demander d installer un plugin. C est ce qui arrivera également à l ensemble de vos visiteurs. Installez le plugin. Installation du plugin Vous obtiendrez alors une interface pour que vos visiteurs puissent éditer plus agréablement leur contenu.

199 20 - Formats d entrées 199 XStandard en action 20. Formats d entrées BBCode : Ajoutez des balises de mises en forme Rendez-vous au chapitre 6.3. BBCode : Ajout d un format d entrée pour plus d informations sur ce module Footnotes : Ajoutez des notes de bas de page à vos contenus Le module Footnotes permet d ajouter des notes de bas de page. Installation Téléchargez, décompressez et activez le module (Version utilisée pour ce livre 6.x-2.1). Configuration Pour permettre à certains formats d entrée d utiliser les balises de note de bas de page, il faut y ajouter des filtres. Vous allez maintenant ajouter ces filtres au format d entrée Full HTML. Rendez vous sur la page d administration des formats d entrée (Administrer - Configuration du site - Formats d entrée) Cliquer sur la ligne configurer du format Full HTML.

200 200 VI - Description des modules utiles de Drupal Cochez les filtres Footnotes <fn> et Footnotes Textile style. Les filtres disponibles avec footnotes Cliquez sur le bouton Enregistrer la configuration. Utilisation Créez un nouveau contenu : Créer un contenu - Article. Choisissez le format d entrée Full HTML. Insérer les balises [# votre note] ou <fn>votre note</fn> Insertion d une balise [#] dans un contenu Rendu avec la balise [#] Insertion d une balise <fn> dans un contenu

201 20 - Formats d entrées 201 Rendu avec <fn> GeSHi Filter : Colorisation syntaxique de code Ce module ajoute un nouveau type de contenu qui permet de créer une page de code source (sans autre contenu) et un nouveau filtre pour les formats d entrée. Installation Téléchargez et décompressez le module (Version utilisée pour ce livre 6.x-1.1). Téléchargez GeSHi sur son site web ( (Version utilisée pour ce livre ). Extraire l archive dans le dossier /modules/geshifilter. Vous devriez obtenir une arborescence de type : modules/geshifilter/geshi Activez les modules GeSHi Filter (Filtre pour format d entrée) et GeSHi node (Type de contenu). Ajout des filtres GeSHi à un format d entrée Il faut ajouter le filtre GeSHi au format d entrée Full HTML : Allez sur la page d administration des formats d entrée (Administrer - Configuration du site - Formats d entrée). Cochez le filtre GeSHi filter. Cliquez sur le bouton Enregistrer la configuration. Utilisation Créez un nouveau contenu : Créer un contenu - Article. Choisissez le format d entrée Full HTML. h h Insérer votre code entre les balises <code type=«type de code»> code </code>. Par exemple, pour du code php : <code type=«php»> code PHP </code>.

202 202 VI - Description des modules utiles de Drupal Rendu du code Php Cliquez sur Créer un contenu - Source code node si vous voulez créer uniquement une page de code Inline : Ajoutez des images à vos contenus Rendez vous au chapitre 6.6. Inline : Ajouter des images à votre contenu pour plus d informations sur ce module Video Filter : Ajoutez des liens vers vos vidéos Video Filter est un module qui permet d ajouter des liens vers des sites de partage de vidéos (YouTube, Google Video, GodTube, DailyMotion, Eyespot, Jumpcut, Revver, Vimeo) directement dans vos contenus. Installation Téléchargez, décompressez et activez le module (Version utilisée pour ce livre 6.x-2.4). Configuration Vous pouvez insérer vos vidéos dans votre contenu grâce à la balise [video:url], pour cela, il faut ajouter cette balise à vos formats d entrée. Ici vous allez ajouter la balise [video:] au format d entrée par défaut : Filtered HTML. Rendez vous sur la page Administrer - Configuration du site - Formats d entrée. Cliquez sur l opération configurer du format Filtered HTML. Dans la section Filtre, cochez Video Filter.

203 20 - Formats d entrées 203 Ajout de la balise [video:url] Cliquez sur le bouton Enregistrer la configuration. Utilisation Créez ensuite un nouveau contenu utilisant comme format d entrée Filtered HTML. Ajoutez la balise [video:url_de_votre_video] au contenu. Voici les différents type d URL acceptés : Contenu intégrant une video YouTube Google Video GodTube DailyMotion Eyespot Jumpcut Revver Vimeo [video: [video: [video: [video: [video: [video: [video: [video:

204 204 VI - Description des modules utiles de Drupal Video Filter en action! 21. Organisation du contenu Pathauto : Automatisez la création de vos Alias Pathauto permet de créer automatiquement des alias vers les contenus créés par vos utilisateurs. Grâce au module Token dont il dépend, vous pouvez créer ces alias en fonction du titre du contenu, de son auteur, de la date, etc. Si vous ne savez pas ce qu est un Alias, rendez-vous au chapitre 7.1. Path : L Alias d URLs. Installation Le module Pathauto est dépendant de Path (présent par défaut avec Drupal) et de Token (A télécharger et à installer). Téléchargez et décompressez Token (Version utilisée pour ce livre 6.x-1.11). Téléchargez et décompressez Pathauto (Version utilisée pour ce livre 6.x-1.1). Activez les modules Token, Path et Pathauto. Configuration h h La page de configuration de Pathauto se trouve sur Administrer - Construction du site - Alias d url, onglet Réglages pour les chemins de noeuds.

205 21 - Organisation du contenu 205 La page de configuration de Pathauto Section Réglages pour les chemins de nods Indiquez ici la directive que doit suivre Pathauto pour créer un alias d une node selon son type de contenu. Si vous remplissez le champ Modèle de chemin par défaut, tous les types de contenus utiliseront cette directive sauf si vous indiquez une directive spécifique pour un autre type de contenu. Dans la sous-section Remplacer par le séparateur, vous pouvez lister des variables fournies par le module Token pour composer votre Alias. Les variables permettant de composer vos Alias automatiquement Les variables se terminant raw remplacent les caractères spéciaux (é, è, à, etc.) par le caractère Separateur de la section Paramètres généraux.

206 206 VI - Description des modules utiles de Drupal Section Paramètres généraux : Mode verbeux Separateur Character case Longueur maximale d un alias Longueur maximale d un composant Maximum number of objects to alias in a bulk update Action de mise à jour Mode verbeux qui indique les modifications faites par Pathauto Caractère qui remplace les espaces pour les URLs En choisissant l option Change to lower case, permet d obtenir des alias composés uniquement de minuscules Taille maximum de l alias Taille maximum d un champ composant l alias Lors des mise à jour d alias en masse, nombre d alias maximum créés en une seule fois. Lors des changements d alias, que faire avec l ancien Alias. Section Paramètres généraux (2) Indiquez ici comment vous désirez transformer les caractères spéciaux. Autres sections Selon les modules activés, d autres sections apparaîtront sur cette page pour accéder aux pages qu ils proposent (compte utilisateur, taxonomie, forums, blogs, etc.). Utilisation Après avoir configuré Pathauto, créez un nouveau contenu. Vérifiez que la case Automatic Alias est bien cochée dans la section Paramètres du chemin d URL. Votre Alias est ainsi créé automatiquement. Création automatique des Alias Création de l Alias après ajout d un nouvel article

207 21 - Organisation du contenu 207 Vous pouvez retrouver la liste des alias générés à la page Administrer - Construction du site - Alias d url Search : Un moteur de recherche pour votre site Le module Search, installé par défaut dans Drupal, permet de proposer un moteur de recherche pour l ensemble de votre site. Installation Activez le module Search Configuration Allez sur la page Administrer - Configuration du site - Paramètres de recherche pour configurer le module Search. Plusieurs sections s affichent sur cette page : Statut de l indexation : Commencez toujours par indexer manuellement le site, sinon, votre moteur de recherche ne trouvera rien. Pour indexer le site une première fois, cliquez sur le bouton Ré-indexer le site et lancez manuellement le Cron (chapitre Le cron). Seuil d indexation : Calibrez ici le nombre d items à indexer à chaque indexation. Vous pouvez limiter ce nombre si l indexation prend trop de ressources de votre serveur Paramètres d indexation : Seuls les mots ayant un nombre de caractères supérieur à ce paramètre seront indexés. Plus ce nombre est grand, moins le classement de la recherche sera précis et moins la taille de la base de données sera grande. Evaluation du contenu : Permet de modifier le classement des résultats en fonction de différents paramètres : Pertinence des mots clés : classement en fonction des mots clés. Publié récemment : Classement en fonction de la date de publication. Nombre de commentaires : Classement en fonction du nombre de commentaires. Utilisation A l activation du module, le champ de recherche apparaît au dessus des blocs de la barre de gauche. Le champ de recherche du module Search

208 208 VI - Description des modules utiles de Drupal Le champ de recherche n est pas un bloc, si vous voulez l afficher ou le cacher, rendez vous sur la page Administrer - Construction du site - Thèmes, onglet Configurer cocher Champ de recherche. Affichage du champ de recherche Vous pouvez accéder à la page de recherche avancée grâce à l URL /search. La page de recherche avancée

209 21 - Organisation du contenu CAPTCHA : Evitez les robots malveillants Ce module permet de vérifier qu un contributeur (Contenu, Commentaire, etc.) est bien un humain en le soumettant à un petit test. «Captcha» provient de l anglais «Completely Automated Public Turing test to tell Computers and Humans Apart», soit en français, «test public de Turing complètement automatique ayant pour but de différencier les humains des ordinateurs» Installation Téléchargez, décompressez et installez le module (Version utilisée pour ce livre 6.x-2.0-beta1). Vous pouvez ensuite activer 3 modules : Utilisation CAPTCHA : Module de base à activer obligatoirement Image CAPTCHA : Tests basé sur des images Liste de CAPTCHA Vous avez le choix entre plusieurs type de tests Administrer - Gestion des utilisateurs - CAPTCHA Voir l onglet Examples. Test de calcul Test de lecture sur image (Si image_captcha est activé)

210 210 VI - Description des modules utiles de Drupal Liste des formulaires Rendez-vous sur la page Administrer - Gestion des utilisateurs - CAPTCHA onglet Paramètres généraux. A partir de cette page, vous pouvez décidez quel formulaire doit être vérifié par un test CAPTCHA. Un test de calcul sera demandé lors de l ajout d un commentaire Ajouter un CAPTCHA à un formulaire Cette option ajoute une section CAPTCHA à chaque formulaire. Par exemple, vous allez ajouter un test de calcul pour les utilisateurs voulant ajouter un nouvel article. Ce formulaire n est pas présent dans la liste de la page de configuration de CAPTCHA : Rendez vous sur la page Administrer - Gestion des utilisateurs - CAPTCHA, onglet Paramètres généraux. Cochez la case Add CAPTCHA administration links to forms. Cliquez sur le bouton Enregistrer. Allez sur la page Créer un contenu - Article. Une nouvelle section CAPTCHA doit être présente. La section CAPTCHA dans l ajout de formulaire Cliquez sur le lien Place a CAPTCHA here for untrusted users. Choisissez le test de calcul (Math).

211 21 - Organisation du contenu 211 Cliquez sur le bouton Enregistrer. Ajout d un CAPTCHA lors de l ajout d un article Si vous retournez sur la page Administrer - Gestion des utilisateurs - CAPTCHA onglet Paramètes généraux, vous verrez que le formulaire story_node_form (ajout d article) a été ajouté à la liste. Les utilisateurs qui ne sont pas administrateurs devront donc se soumettre au test pour ajouter des articles. Pour tester votre CAPTCHA, connectez-vous sur votre site avec un autre utilisateur qu admin qui a des droits suffisants pour créer un article. Droits d accès au module Le module CAPTCHA permet la gestion de deux types de Droits d accès : Les droits d accès de CAPTCHA administer CAPTCHA settings : Permet aux utilisateurs appartenant aux rôles cochés d ajouter ou de modifier les demandes de tests. skip CAPTCHA : Permet aux utilisateurs appartenant aux rôles cochés de s affranchir des tests CAPTCHA Pack : Ajoutez de nouveaux types de tests Installation Téléchargez, décompressez et installez le module (Version utilisée pour ce livre 6.x-1.0-beta2).

212 212 VI - Description des modules utiles de Drupal Utilisation Vous pouvez ensuite activer 7 modules : Module ASCII art CAPTCHA Module CSS CAPTCHA Module Foo CAPTCHA Module Lost character CAPTCHA Module Phrase CAPTCHA

213 21 - Organisation du contenu 213 Module Word list Module Random CAPTCHA (Choisi un test au hasard dans tout les types installés) ImageCache : Manipulez vos images avant de les afficher ImageCache est un module permettant de manipuler (redimensionner, découper, etc.) les images téléchargées sur votre site. Il s intègre parfaitement aux modules Inline, CCK et Views. Installation ImageCache est dépendant de ImageAPI : Téléchargez et décompressez ImageAPI (Version utilisée pour ce livre : 6.x-1.2). Téléchargez et décompressez ImageCache (Version utilisée pour ce livre : 6.x-2.0-beta5). Activez les modules ImageAPI, ImageAPI GD2, ImageCache et ImageCache UI.. Configuration ImageCache permet de prédéfinir des réglages (preset) qui modifieront vos images. Vous allez, par exemple, créer un réglage qui créera des miniatures de 100 pixels X 100 pixels pour vos images. Rendez vous sur la page de configuration de Image Cache : Administrer - Construction du site - ImageCache. Cliquez sur Add new preset. Entrez Miniature100 dans le champ Preset Namespace. Cliquez sur le bouton Create New Preset.

214 214 VI - Description des modules utiles de Drupal Ajoutez une action Add Scale Liste des actions possibles sur les images Supprimez la valeur du champ Largeur et laissez le-vide. Entrez 100 dans le champ Hauteur (pas 100%!). Cliquez sur le bouton Add Action. La liste des actions s affiche, vous pouvez les réorganiser comme vous le désirez. Cliquez sur le bouton Update Preset. Voici la liste des actions possibles : Liste des actions d un réglage Add Crop Add Deprecated Scale Add Desaturate Add Resize Recadrage d une image, vous pouvez entrer la hauteur et la largeur de l image en pixel ou pourcentage (Width, Height), ainsi que le point de départ de ce racadrage (X offset, Y offset) Permet une mise à l échelle avec une méthode ancienne. Ne pas utiliser. Passe une image en niveaux de gris. Redimensionne une image sans conserver son aspect. Grâce à cette action, il est possible d étendre ou d allonger une image.

215 21 - Organisation du contenu 215 Add Rotate Add Scale Add Scale And Crop Sharpen Effectue une rotation de l image du nombre de degrés spécifié. Tourne dans le sens des aiguilles d une montre. Mise à l échelle de l image. Vous pouvez par exemple spécifier une hauteur d image, la largeur sera alors calculée pour que l aspect de l image soit conservé. Créé une mise à l échelle de l image en hauteur et largeur, mais découpe l image si celle-ci ne rentre pas dans le cadre. Permet d atténuer l effet de flou lors de la création d une vignette. Utilisation Répertoire utilisé : Les images transformées se trouvent dans le répertoire /votre_repertoire_drupal/sites/votre_site/imagecache/nom_de_votre_reglage. Avec Inline : Il est possible d afficher les images avec les réglages de ImageCache dans vos articles grâce au module Inline (6.6 : Inline) : Administrer - Configuration du site - Sur la même ligne. Dans la section Image dimensions and scaling, vous pouvez alors sélectionner le réglage que vous désirez pour vos résumés (Teaser preset) ou le corps de votre contenu (Full preset). Sélectionnez ici le réglage miniature dans les deux listes. La page de configuration de Inline avec Image Cache Cliquez sur le bouton Enregistrer la configuration. Affichez la recette de la soupe japonaise et voyez le résultat!

216 216 VI - Description des modules utiles de Drupal La recette avec la photo miniaturisée par ImageCache Avec CCK : Si vous avez utilisé l exemple du Chapitre ImageField : Ajoutez un champ image à votre type de contenu, vous pouvez alors modifier votre champ field_image : Allez sur la page Administrer - Gestion du contenu - Types de contenu. Cliquez sur le lien gérer les champs du type Recette de cuisine. Cliquez sur Afficher les champs A la ligne Photo de la recette, choisissez Miniature100 image linked to image. Cliquez sur Enregistrer. Affichez votre contenu. Les nouveaux choix pour afficher la photo

217 21 - Organisation du contenu 217 Affichage de votre miniature dans votre contenu CCK Liste des possibilités de rendu pour votre image modifiée avec ImageCache (Liste Diplay as) Generic files Image Image linked to node Image linked to file Path to file URL to file Miniature100 xxx Affichage d un lien vers l image Affiche de l image à sa taille normale Affiche de l image à sa taille normale liée à la node qui la contient Affiche de l image à sa taille normale liée à son fichier Affiche le chemin relatif vers l image Affiche l URL de l image Idem mais en affichant l image modifiée par ImageCache

218 218 VI - Description des modules utiles de Drupal 22. Administrer Drupal Administration Menu : Navigation facile dans l administration Rendez vous au chapitre 5.3. Installer un module pour plus d informations sur ce module Administration theme : Utiliser un thème spécifique pour administrer Parfois, lors de la création ou de l activation d un nouveau thème, les pages d administration ont un rendu aléatoire. Il est alors possible d utiliser un thème spécifique pour l administration des pages. Il existe par défaut une page pour choisir le thème d administration de votre site. Le module Administration theme permet d étendre les options de cette page. Pour réaliser l exemple de ce livre, vous allez choisir par défaut le thème Blue Marine et utiliser Garland pour l administration. Administrer - Construction du site - Thèmes. Cochez la case Activé du thème Bluemarine et l option Par défaut. Cliquez sur Enregistrer la configuration. Drupal fonctionne maintenant avec le thème Bluemarine. Rendez-vous sur la page : Administrer - Configuration du site - Thème de l administration. Choisissez Garland. Cliquez sur Enregistrer la configuration. La page Thème de l administration par défaut Vous repassez sur le thème Garland. Vous allez maintenant installer le module Administration theme. Installation Téléchargez, décompressez et activez le module (Version utilisée pour ce livre 6.x-1.0). Utilisation Administrer - Construction du site - Thèmes.

219 22 - Interface Drupal 219 Les nouvelles options de la page du choix du thème de l administration Content editing Batch processing Custom pages Utilise le thème d administration pour l édition du contenu Utilise le thème d administration pour les pages de configuration Permet de sélectionner ou d exclure certaines page selon leur chemin. Le caractère * permet de sélectionner un ensemble de pages. Par exemple, node/*/edit, sélectionne toutes les pages d édition de node CSS Injector : Appliquez des styles CSS à certaines pages Ce module permet d ajouter des règles CSS pour certaines pages listées. Vous allez ici mettre le titre des recettes Soupe Japonaise et Mousse au chocolat sur fond jaune. Installation Téléchargez, décompressez et activez le module (Version utilisée pour ce livre 6.x-1.3) Configuration Tout d abord, vous devez repérer l URL des recettes de la soupe japonaise (node/1 dans notre exemple) et de la mousse au chocolat (mousseauchocolat). Ensuite, le style CSS que vous voulez appliquer aux titres est un fond jaune : #main.title{ background-color:lightyellow; } Administrer - Configuration du site - CSS injector. Cliquez sur le lien Create new rule.

220 220 VI - Description des modules utiles de Drupal Titre : Fond jaune sur titre. Css code : le code ci-dessus Choisissez : Add on only the listed pages. Pages : node/1 mousseauchocolat Cliquez sur Enregistrer. Utilisation Votre nouvelle règle CSS Injector Seules les pages de la mousse au chocolat et de la soupe japonaise ont des titres sur fond jaune. Vous pouvez utiliser le joker * pour la sélection de vos pages (forum/* pour sélectionner toutes les pages de forum) Pathauto : Automatisez la création de vos Alias 23. Site coopératif Profile : Ajoutez des champs aux profils de vos utilisateurs pour mieux les connaître Lors de son inscription, un nouvel utilisateur doit vous communiquer son nom, son adresse et son mot de passe. Grâce au module Profile, vous pouvez ajouter des champs à ce formulaire. Dans cet exemple, vous lui demanderez : son activité, son âge, son site web, etc.

221 23 - Site coopératif 221 Informations supplémentaires contenus dans le profil utilisateur Installation Le module est installé par défaut dans Drupal, il suffit donc de l activer. Configuration Vous allez maintenant ajouter le champ Activité au profil de vos utilisateurs : Pour configurer ce module, rendez vous sur la page Administrer - Gestion des utilisateurs - Profils. Cliquez sur le lien zone de texte simple de la section Ajouter un nouveau Champ. Les catégories regroupent les champs dans des onglets : dans le champ Catégorie, entrez Informations supplémentaires. Dans le champ Titre, entrez Activité. Dans le champ Nom du formulaire, entrez profile_activite. C est un identifiant unique pour nommer le champ. Dans le champ Explication : Entrez ici votre profession ou votre secteur d activité. Le champ Visibilité permet de sélectionner le niveau de confidentialité des données. Choisissez ici Champ public, contenu affiché sur la page de profil et sur la page de la liste des membres. Le champ Poids permet de sélectionner la position du champ à l affichage du profil. Le champ de poids -10 s affichera en haut de la page et 10 en bas. Utilisez plutôt l outil dans la liste des champs. Cochez la case : Le formulaire se complètera automatiquement à mesure que l utilisateur saisira : Le champ s affichera comme un champ de type Taxonomie. L utilisateur doit entrer une valeur : Si cette case est cochée, le champ est obligatoire. Visible dans le formulaire d enregistrement : Affiche le champ à l inscription, ici, cochez là.

222 222 VI - Description des modules utiles de Drupal Cliquez sur le bouton Enregistrer le champ. De la même façon, ajoutez un champ âge : Ajout du champ Activité A la section Ajouter un nouveau Champ,cliquez sur le lien liste de sélection. Dans Catégorie, entrez Informations supplémentaires. Dans Titre, entrez Age. Dans Nom du formulaire, entrez profile_age. Dans Explication : Entrez ici votre tranche d âge. Dans Options de sélection, entrez 3 tranches d âges sur 3 lignes distinctes. Cela permettra d avoir 3 items dans votre liste de sélection. Cliquez sur le bouton Enregistrer le champ. Enfin, ajoutez un champ site web: Création d une liste Cliquez sur le lien URL de la section Ajouter un nouveau Champ. Dans Catégorie, entrez Informations supplémentaires.

223 23 - Site coopératif 223 Dans Titre, entrez Site web. Dans Nom du formulaire, entrez profile_site. Dans Explication : Entrez ici l adresse de votre site web. Cliquez sur le bouton Enregistrer le champ. Les 3 champs du formulaire sont créés! Cliquez sur le bouton Enregistrer la configuration. Dans le bloc admin (ou bien avec un autre utilisateur), cliquez sur le lien Mon compte. Cliquez sur l onglet Modifier. Puis sur le sous-onglet Informations supplémentaires. Complétez le formulaire, puis cliquez sur le bouton Enregistrer. Votre formulaire en action! Si vous cliquez sur l onglet Voir, une nouvelle section Informations supplémentaires s affiche...

224 224 VI - Description des modules utiles de Drupal Forum : Créez un lieu d échange pour vos utilisateurs Il est possible sous Drupal de créer facilement des forums internet grâce au module Forum installé par défaut. Installation Le module est installé par défaut dans Drupal, il suffit donc de l activer. Forum est dépendant des modules Taxonomy et Comment, il faut donc les activer également. Configuration Vous pouvez configurer vos forums sur la page Administrer - Gestion du contenu - Forums. Cliquez sur Ajouter un forum. Dans la case Nom du forum, entrez Forum1. Cliquez sur le bouton Enregistrer. Faites de même pour les forums 2, 3 et 4. Pour plus de clarté dans l organisation de vos forums, vous pouvez créer des conteneurs de forums qui regrouperont les forums traitant du même sujet. Cliquez sur Ajouter un conteneur. Dans la case Nom du conteneur, entrez Conteneur 1. Cliquez sur le bouton Enregistrer. Faites de même pour le Conteneur 2 Réorganisez vos forums et conteneurs grâce à l outil. Cliquez sur le bouton Enregistrer. Utilisation La création et l administration des forums Pour accéder à la page contenant vos forums, rendez vous à l URL forum

225 23 - Site coopératif 225 Liste des forums disponibles Ajoutez quelques sujets de discussion dans l un des forums en cliquant sur le lien Nouveau Sujet de discussion. Les sujets débattus dans le Forum 1 Une discussion est un contenu de type Sujet de discussion. Une réponse est un commentaire, géré par le module Comment. La discussion 1ier Sujet et ses 2 réponses

226 226 VI - Description des modules utiles de Drupal Blog : Donnez la possibilité à vos utilisateurs de posséder un blog Vous pouvez proposer à chacun de vos utilisateurs de créer un blog. Installation Le module Blog est installé par défaut dans Drupal, il suffit donc de l activer. Configuration Ce module permet aux utilisateurs autorisés d avoir chacun leur propre blog. Commencez par configurer les droits d accès du module blog en vous rendant sur la page Administrer - Gestion des utilisateurs - Droits d accès, section module blog: Autoriser tous les utilisateurs authentifiés à posséder leur blog Utilisation Le module Blog ajoute un nouveau type de contenu : Blog entry (Billet de blog). Connectez vous avec un utilisateur auquel vous avez donné les droits pour créer des billets de blog. Cliquez sur Créer un contenu - Billet de blog Créez un billet. Votre premier billet Créez ensuite un billet avec un autre utilisateur.

227 23 - Site coopératif 227 Les URLs /blog/id_utilisateur affichent la liste des billets d un utilisateur L URL /blog affiche la liste des billets de tous les utilisateurs Tous les billets de vos utilisateurs Book : Créez des livres coopératifs Rendez-vous au chapitre 5.1. Activation et découverte d un module pour plus d informations sur ce module Date : Ajoutez un champ Date à votre type de contenu Ce module permet de stocker des dates dans vos types de contenu (16. CCK : Créez des types de contenu personnalisés) et effectuer ensuite des traitement sur ces dates (tris, filtres, etc.). Il propose également une interface de type calendrier pour choisir une date. Mais ce module est également utilisé pour créer des calendriers complets en fonctionnant avec les modules Calendar (23.6 Calendar : Ajoutez un calendrier à votre site) et Views (17. Views : Créez des vues sur vos données). Installation Téléchargez, décompressez et installez le module (Version utilisée dans ce livre 6.x-2.0-rc6). Activez les modules Date, Date API, Date Popup et Date Timezone. Configuration Il faut vérifier les options date et heure de Drupal: Administrer - Configuration du site - Date et heure. Configurez à votre convenance les paramètres de cette page.

228 228 VI - Description des modules utiles de Drupal Configuration des formats de date et du fuseau horaire Créez maintenant un nouveau type de contenu «Evénement du calendrier» qui contiendra un champ de type Date. Administrer - Gestion du contenu - Types de contenu. Onglet Ajouter. Nom : Evénement du calendrier Type : evenement h h Description : Evénement qui sera ajouté au calendrier en fonction de son champ Date de l événement.

229 23 - Site coopératif 229 Création du nouveau type de contenu Cliquez sur le bouton Enregistrer le type de contenu. Ensuite, cliquez sur le lien Gérer les champs de votre nouveau type de contenu. Il faut maintenant ajouter votre nouveau champ Date à votre type de contenu : Etiquette : Date événement. Field name : date_evenement Type of data : Date Form element : Text field with Date Pop-up calendar (Disponible si le module Date Popup est activé). Cliquez sur le bouton Enregistrer. Ajout du champ Date La page se recharge, vous devez alors configurer les options de votre champ. Vérifiez que le Format d entrée vous convient. Sélectionnez Année - Mois - Jour - Heure pour la Granularité. Cliquez sur le bouton Enregistrer les paramètres du champ. Placez le champ Date événement en dessous de Titre. Cliquez sur le bouton Enregistrer. Votre type de contenu est créé, entrez maintenant quelques événements : Créer un contenu - Evénement du calendrier. Titre : Repas annuel

230 230 VI - Description des modules utiles de Drupal Date événement : Quelques jours après la date du jour Corps : N oubliez pas notre repas annuel! Ajout d une date à un événement avec Date Popup De la même façon, ajoutez quelques événements pour avoir un calendrier avec quelques items au prochain chapitre Calendar : Ajoutez un calendrier à votre site Calendar est un module qui ajoute une vue au module Views (17. Views : Créez des vues sur vos données). Cette vue affiche les dates des contenus sous forme de calendriers. Plusieurs affichages sont disponibles avec cette vue : par jour, par semaine, par mois ou par année, mais aussi sous forme de bloc ou de page. Installation Téléchargez, décompressez et installez le module (Version utilisée dans ce livre 6.x-2.0-rc6). Activez le module Calendar. Configuration Dans l exemple ci-dessous, vous ferez tout d abord une copie de la vue calendar, pour pouvoir ensuite la réutiliser. Ensuite, vous travaillerez sur cette copie. Clonage de la vue Calendar Administrer - Construction du site - Views. Cliquez sur le lien Activer de la vue Calendar. Cliquez ensuite sur le lien Dupliquer de la vue Calendar.

231 23 - Site coopératif 231 Nom de la vue : Calendrier. Description de la vue : Calendrier des événements de l association. Cliquez sur le bouton Suivant. Vous arrivez alors sur votre nouvelle vue calendrier. Il est nécessaire de modifier plusieurs choses sur cette vue : Chemin d accès à la vue Sélectionnez l affichage Calendar page. Dans la section Paramètres de la page, cliquez sur le paramètre Chemin. Entrez le chemin calendrier. Cliquez sur le bouton Mise à jour. Le nouveau chemin de votre vue Cliquez sur le bouton Enregistrer pour sauvegarder votre vue. Filtrer les types de contenu Il faut ajouter un nouveau filtre pour sélectionner uniquement les contenus de type evenement créé au chapitre précédent (21.6 Date : Ajoutez un champ Date à votre type de contenu). Sélectionnez l affichage Defaults.

232 232 VI - Description des modules utiles de Drupal Dans la section Filtres, cliquez sur le bouton Cochez la case Node : Type. Cliquez sur le bouton Ajouter. Sélectionnez les options Fait partie de et la case Evénement du calendrier. Cliquez sur le bouton Mise à jour. Modification de l argument L argument par défaut de la vue Calendar est Node : Date de mise à jour, vous devez donc le remplacer par le champ Date événement de votre type de contenu : Dans la section Arguments, cliquez sur le lien Date : Date (node.changed). Dans la section Date field(s), seléctionnez Contenu: Date événement (field_date_evenement) et déséléctionnez Node: Date de mise à jour. Cliquez sur le bouton Mise à jour. Sélection de l argument Date pour l affichage du calendrier Cliquez sur le bouton Enregistrer pour sauvegarder votre vue. Modification de l affichage bloc Sélectionnez l affichage Calendar block. Dans la section Paramètres des blocs, cliquez sur le lien Admin : Calendar. Entrez ici Bloc calendrier. Cliquez sur le bouton Mise à jour. Cliquez sur le bouton Enregistrer pour sauvegarder votre vue. Utilisation Vous pouvez maintenant afficher votre bloc Calendrier. Administrer - Construction du site - Blocs. Affichez Bloc calendrier dans la barre de gauche.

233 23 - Site coopératif 233 Cliquez sur le bouton Enregistrer les blocs. Calendar en action! Webform : Créez des formulaires Ce module ajoute un nouveau type de contenu Webform (Formulaire) à Drupal. Il permet de créer des questionnaires à l aide de toute sortes de composants (zone de texte, liste, case à cocher, etc.). Vous pourrez ensuite récupérer ces résultats sous différentes formes. Installation Téléchargez, décompressez et installez le module (Version utilisée dans ce livre 6.x-2.4). Configuration Vous allez créez un formulaire permettant aux utilisateurs de s inscrire à un repas. Dans ce formulaire, il sera demandé à l utilisateur d entrer son nom, son prénom, son et le plat qu il désire. Cliquez sur Créer un contenu - Webform. Vous arrivez alors à la page permettant de configurer les paramètres de votre formulaire Titre : Inscription au repas annuel Description : Merci de remplir les champs suivants et de valider votre inscription Message de confirmation ou URL de redirection : Merci de vous être inscrit!

234 234 VI - Description des modules utiles de Drupal Vous pouvez également indiquer dans cette page un auquel sera envoyé chaque formulaire rempli. Cliquez sur Enregistrer. S affiche alors à la page de configuration des champs du formulaire Page de configuration des champs du formulaire Création du champ Nom Nom : Nom et Prénom Type : textfield Cochez Obligatoire Cliquez sur Ajouter S affiche alors la page de configuration du champ Nom : Ne changez rien ici, cliquez sur le bouton Soumettre Création du champ Nom : Type : Cochez Obligatoire Cliquez sur Ajouter S affiche alors la page de configuration du champ Cochez la case Adresse de l utilisateur par défaut. Cliquez sur le bouton Soumettre.

235 23 - Site coopératif 235 Création de la liste permettant le choix du plat Nom : Choix du plat Type : select Cochez Obligatoire Cliquez sur Ajouter S affiche alors la page de configuration du champ Nom : Dans la zone de texte Options, entrez un plat par ligne (Ici, Tajine, Coucous et Saucisses purée) Cochez la case Liste déroulante. Cliquez sur le bouton Soumettre. Page de configuration d un composant Cliquez à nouveau sur Soumettre pour sauvegarder l ensemble de votre formulaire. Utilisation Votre formulaire est créé, il faut maintenant le remplir et consulter ses résultats : Cliquez sur l onglet Voir. Remplissez votre formulaire

236 236 VI - Description des modules utiles de Drupal Cliquez sur Soumettre. Votre formulaire en action! Essayez de remplir ce formulaire plusieurs fois avec différentes valeurs. Vous pouvez alors consulter les résultats de votre formulaire : Cliquez sur l onglet Résultats Cliquez sur l onglet Tableau Résultats du formulaire sous forme de tableau. Vous obtenez alors un aperçu des réponses envoyées via votre formulaire. Il est possible de les consulter grâce aux différents onglets : Soumissions Analyses Tableau Téléchargement Liste des formulaires soumis. Statistiques sur les différents champs. Listes des formulaires soumis et de la valeur de chaque champs. Exportation des formulaires pour traitement dans une base de données ou un tableur. Liste des types de composants disponibles Voici une copie d écran qui présentes les différents composants qui vous permettront de composer vos formulaires :

237 23 - Site coopératif 237 Les différents composants de Webform date fichier fieldset grid hidden markup pagebreak select textarea textfield time Affiche des listes déroulantes pour choisir une date Affiche un champ avec possibilité de mettre comme valeur par défaut l de l utilisateur Permet à l utilisateur du formulaire de joindre un fichier. Il est possible de n autoriser que certains types de fichiers Permet de regrouper les champs par section. Ces sections peuvent être pliantes. Permet de proposer des questions sous forme de tableau Permet d insérer un champ caché Permet d insérer un texte, du code HTML ou PHP dans votre formulaire Permet de diviser son formulaire en plusieurs pages. Des boutons Précédent et Suivant permettent de naviguer entre ces pages. Affiche une liste de choix sous forme de liste ou de liste déroulante Affiche une zone de texte sur plusieurs lignes Affiche une zone de texte Affiche des listes déroulantes pour choisir une heure

238 238 VI - Description des modules utiles de Drupal Simplenews : Créez des bulletins d informations Ce module permet de gérer les inscriptions et les envois de bulletins d informations par mail. Installation Téléchargez, décompressez et installez le module (Version utilisée dans ce livre 6.x-1.0-rc3). Configuration Pour que Simplenews fonctionne, il faut que votre serveur puisse envoyer correctement des mails comme indiqué au chapitre 9.5. Configuration de votre serveur pour l envoi de mail. Il faut également que les utilisateurs identifiés possèdent les droits pour s inscrire à votre bulletin: Allez sur la page Administrer - Gestion des utilisateurs - Droits d accès. Cochez la case s abonner à des bulletins de la section module simplenews. Cliquez sur le bouton Enregistrer les droits d accès. Allez sur la page Administrer - Configuration du site - Simplenews. pour découvrir les paramètres du module Cette page comporte 4 onglets qui permettent de configurer les lettres d informations : Général Bulletin Inscription Send mail Indiquez ici les Types de contenu pouvant être envoyés par mail. Par défaut, un nouveau type de contenu Newsletter issue est créé à l installation de Simplenews. Paramétrage du Format de vos lettres (HTML ou Texte Brut), de l adresse d envoi des s, d une adresse de test ainsi que de l action à exécuter suite à la rédaction d un bulletin. Paramétrage des textes à envoyer lors de l inscription et de la désinscription des utilisateurs. Paramétrage de la méthode d envoi des mails. Les paramètres par défaut conviennent pour l exemple de ce livre. Utilisation Vous allez créer un bulletin, activer le bloc pour s y inscrire et envoyer votre première lettre. Création de la lettre d information Allez sur la page Administrer - Gestion du contenu - Bulletins. Cliquez sur l onglet Bulletins. Puis sur Ajouter un bulletin. Nom du bulletin : Newsletter du site Description : Recevez notre Newsletter hebdomadaire Expéditeur : Cuisinez

239 23 - Site coopératif 239 From address : votre Création de votre Bulletin Activation du bloc et gestion des abonnements Simplenews propose un nouveau type de bloc permettant aux visiteurs de votre site de s inscrire facilement à votre bulletin. Allez sur la page Administrer - Construction du site - Blocs. Activez le bloc Bulletin : Newsletter du site dans la barre de gauche. Cliquez sur le bouton Enregistrer. Le bloc permettant de s abonner à votre bulletin d informations Vous pouvez maintenant tester ce bloc en vous connectant avec l un de vos utilisateurs et en cliquant sur le bouton M abonner. Connectez vous ensuite en tant qu administrateur

240 240 VI - Description des modules utiles de Drupal Vous pouvez alors gérer la liste des utilisateurs inscrits à votre lettre d information. Allez sur la page Administrer - Gestion du contenu - Bulletins. Cliquez sur l onglet Abonnements puis Liste. Votre nouvel abonné! Vous pouvez, à partir de cette page, inscrire de nouveaux abonnés en nombre grâce à l onglet Mass subscribe. Création et envoi d une lettre d information Il est maintenant temps de créer votre première lettre! Cliquez sur Créer un contenu - Newsletter Issue. Titre : Première lettre d information Newsletter : Mes recettes! Newsletter Corps : Ceci est notre première lettre! Section Envoyer le bulletin, cochez Envoyer le bulletin.

241 23 - Site coopératif 241 Cliquez sur le bouton Save and send. Exécutez le cron 11.2 Le cron Rédaction du premier bulletin Vous pouvez envoyer un mail au format HTML en installant et activant le module Mime Mail et en modifiant le format à la page Administrer - Configuration du site - Simplenews, onglet Bulletin, paramètre Format. Votre lettre devrait alors parvenir à l adresse mail de votre abonné! 24. Blocs et menus Taxonomy menu : Affichez vos vocabulaires dans des menus. Après avoir configuré les vocabulaires et termes (6.9. La taxonomie), vous aimeriez peut-être les exposer sous forme de menus ou de blocs sur votre site. Taxonomy_menu permet cela et remet à jour automatiquement ces blocs et menus lors de l ajout de contenus associés ou de termes. Pour bien comprendre ce module, lisez d abord les chapitre 6.9. La taxonomie, 7.2. Les blocs et 7.3. Les menus

242 242 VI - Description des modules utiles de Drupal Installation Téléchargez, décompressez et activez le module Taxonomy Menu (Version utilisée pour ce livre 6.x-1.01). Configuration Sélection des vocabulaires à exposer Vous pouvez maintenant configurer le module sur sa page d administration : Administrer - Configuration du site - Taxonomy Menu settings. Une section par vocabulaire s affiche alors. Sélectionnez l option Normal pour les vocabulaires Catégorie et Origine. Voici les autres options de ce module. Module page Display number of nodes per terms Hide Empty Terms Display descendants Nom du chemin à afficher pour les catégories Affiche le nombre de contenu associé à chaque terme Cache les termes n ayant aucun contenu associé Affiche les contenus associés aux termes enfants Cochez l option Display number of nodes per terms. Cliquez sur le bouton Enregistrer la configuration. Les menus Catégorie et Origine apparaissent dans votre menu Admin (Navigation) Voilà donc un premier résultat. Vous allez maintenant créer un bloc spécifique par vocabulaire. Création d un menu pour les vocabulaires Vous allez maintenant créer un nouveau menu pour isoler des entrées Catégories et Origine. Administrer - Construction du site - Menus Cliquez sur l onglet Ajouter un menu Nom du menu : taxonomymenu

243 23 - Site coopératif 243 Titre : Nos recettes Description : Menu affichant les recettes par catégories et origines. Cliquez sur le bouton Enregistrer Changement des éléments parents de menu Il faut maintenant modifier le menu parent des éléments Catégorie et Origine : Administrer - Construction du site - Menus Cliquez sur le menu Navigation. Cliquez sur le lien modifier de l élément Catégorie. Dans la liste Elément parent, choisissez <Nos recettes>, c est le titre du menu que vous avez précédemment créé. Cliquez sur le bouton Enregistrer. Changement de l élément parent d un élément de menu Renouvelez l opération pour l élément Origine. Affichage du menu dans un bloc Vous allez maintenant afficher ce menu dans un bloc : Administrer - Construction du site - Blocs. Afficher le nouveau bloc Nos recettes dans la région Barre de gauche. Cliquez sur Enregistrer les blocs.

244 244 VI - Description des modules utiles de Drupal Le bloc affichant les recettes! Pour rafraîchir les listes de ce bloc, lancez le cron (11.2. Le cron) DHTML Menu: Améliorez la navigation dans votre site DHTML menu est un petit module, très simple d utilisation, qui permet de faciliter la navigation dans vos menus affichés sous forme de bloc. Il pourra être utile pour le bloc Navigation, mais également pour celui que vous avez créé au chapitre Taxonomy Menu. Installation Téléchargez, décompressez et activez le module DHTML Menu (Version utilisée pour ce site 6.x-3.3) Utilisation Menu navigation avec DHTML Aucune configuration n est nécessaire pour utiliser DHTML menu, cliquez sur les items de votre menu admin (Navigation) et constatez que la page entière ne se recharge pas à chaque fois. Les items parents sont répétés en italique et permettent d accéder à la page lié à l élément parent (Exemple : Cliquez sur l élément Administrer en italique pour atteindre la page Administrer).

245 23 - Site coopératif 245 Le DHTML (HTML Dynamique) n est autre qu une collection de fonctions Javascript permettant de modifier dynamiquement (sans la recharger complètement) une page HTML Nice Menus : Rendez vos menus dynamiques Ce module transforme vos blocs en menus déroulants. Ils peuvent se dérouler de droite à gauche, de gauche à droite ou de haut en bas. Associé à Taxonomy menu, il permet de créer de véritables menus déroulants pour l ensemble de votre site. L exemple utilisé pour ce module suppose que vous ayez créé le bloc Nos recettes comme indiqué dans Taxonomy_menu : Affichez vos vocabulaires dans des menus. Installation Téléchargez, décompressez et activez le module Nice Menus (Version utilisée pour ce site 6.x-1.3). Configuration A l activation de Nice Menus, 2 blocs sont créés (Nice Menu 1 et Nice Menu 2). Il faut configurer ces blocs pour leur indiquer quel sera leur contenu. Vous pouvez modifier le nombre de blocs créés par Nice Menus sur la page de configuration du module (Administrer - Configuration du site - Nice Menus). Administration - Construction du site - Blocs. Cliquez sur le lien configurer du bloc Nice menu 1 (Nice Menu). Titre du bloc : <none> Menu Name : Nos recettes Source Menu Tree : <Nos recettes> Menu Style : Right

246 246 VI - Description des modules utiles de Drupal Cliquez sur le bouton Enregistrer le bloc. Modification du bloc Nice Menus Choisissez la région Barre de gauche pour le bloc Nos recettes (Nice Menus). Cliquez sur le bouton Enregistrer les blocs. Le menu déroulant s affiche! Modifier l apparence des menus L apparence de menus avec Nice Menus est entièrement personnalisable avec CSS. Pour cela, vous pouvez modifier le fichier /sites/nom_du_repertoire_de_votre_site/modules/nice_menus/nice_menus_default.css. Vous pouvez modifier directement nice_menus_default.css ou alors le copier dans un autre répertoire (celui de votre thème par exemple) et indiquer le chemin sur la page Administrer - Construction du site - Thèmes, onglet Configurer, onglet Paramètres globaux, puis entrer le chemin dans le champ : Path to custom Nice Menus CSS file Menu Block : Divisez, liez et organisez vos blocs Tout menu de Drupal peut être affiché dans un bloc. Mais, parfois, vous aurez peut-être besoin de séparer ce bloc en deux ou de lier un bloc de menu à un autre. Menu Block offre des options de configuration spécifiques pour les blocs créés à partir des menus.

247 23 - Site coopératif 247 Dans cette exemple, vous allez reprendre votre bloc Nos recettes créé précédemment (24.1. Taxonomy menu : Affichez vos vocabulaires dans des menus) et afficher le niveau 1 du menu (les vocabulaires Catégorie et Origine) dans un bloc en entête et l autre partie du menu dans un autre bloc dans la colonne de gauche de Drupal. Installation Téléchargez, décompressez et activez le module Menu block (Version utilisée pour ce site 6.x-2.2). Configuration Vous allez maintenant créer votre bloc d entête contenant le niveau 1 de votre menu : Administrer - Construction du site - Blocs. Onglet Add menu block. Titre du bloc : <none> Elément parent : Nos recettes Starting level : 1st level (primary) Maximum depth : 1 (Profondeur de l affichage depuis le niveau de départ). Cliquez sur Enregistrer le bloc. Pour afficher ce bloc dans l en-tête : Administrer - Construction du site - Blocs. Configuration du bloc d entête Choisir la région Entête pour le bloc Nos recettes (level 1).

248 248 VI - Description des modules utiles de Drupal Cliquez sur Enregistrer les blocs. Pour la création du deuxième bloc : Administrer - Construction du site - Blocs. Onglet Add menu block. Titre du bloc : <none> Elément parent : Nos recettes Starting level : 2nd level (secondary) Maximum depth : Illimité. Cochez l option Expand children. Cliquez sur Enregistrer le bloc. Pour afficher ce bloc dans la colonne de gauche : Administrer - Construction du site - Blocs. Choisir la région Barre de gauche pour le bloc Nos recettes (level 2+). Cliquez sur Enregistrer les blocs. Utilisation Votre menu 1st level apparaît dans l entête, si vous sélectionnez l un de ses items, l autre bloc s affiche dans la barre de gauche : Affichage de la liste des recettes par catégorie

249 23 - Site coopératif 249 Affichage de la liste des recettes par origine 25. Ubercart : créez un site e-commerce Ubercart est une suite e-commerce développée pour Drupal. Elle se présente sous la forme d un ensemble de modules permettant de construire une boutique en ligne complète (page produit, catalogue, panier, paiement en ligne, facturation, etc.). Ce sont en tout 32 modules qui sont livrés avec Ubercart! Vous allez donc créer une boutique complète qui vous permettra de vendre deux cuillères en bois, ainsi que deux passoires en marge de votre site de recettes Store : Installation de la boutique Installation Téléchargez, décompressez le module (Version utilisée dans ce livre : 6.x-2.0-beta2) Activez le module Store. Configuration des formats d adresses Une nouvelle entrée apparaît alors dans votre bloc d administration : Administrer - Store Administration.

250 250 VI - Description des modules utiles de Drupal L écran de configuration de Store Au fur et à mesure de l activation des modules de Ubercart, de nouveaux items apparaîtront sur cette page. Pour l instant, il ne vous est guère possible de faire autre chose que de configurer les paramètres de base de votre boutique. Cliquez sur le lien Show links pour voir les sous-catégories. Cliquez sur le lien Configuration. Puis sur Country settings (Paramètres pays). Les paramètres Ubercart par pays Voici un écran «vue d ensemble» que vous retrouverez fréquemment sur Ubercart, il permet d avoir un aperçu des réglages effectués dans les autres onglets. Ici, deux formats d adresses sont à disposition (Canada et Etats-Unis) et il est possible de les modifier. Vous allez maintenant ajouter un nouveau format d adresses pour la France : Cliquez sur l onglet Modifier. Sélectionnez l item france_250_1.cif.

251 23 - Site coopératif 251 Cliquez sur le bouton Importer. Importation du format d adresses pour la France Le pays France doit maintenant apparaître dans la liste du dessous. Ensuite cliquez sur l onglet Country formats. Déroulez la section France. Le format d adresses pour la France Ce format d adresses convient bien pour la France et sera utilisé pour les formulaires de commande pour l adresse de livraison et de facturation. Il est possible de modifier le format d adresses en changeant les variables. La liste des variables disponibles est dans la section Address variables instructions.

252 252 VI - Description des modules utiles de Drupal Configuration des paramètres de la boutique Onglet Contact settings Allez sur la page Administrer - Store Administration - Configuration - Store settings. Ici encore la vue d ensemble permet de connaître tout ce qui peut être configuré dans cette section. Il y a un peu de travail. Cliquez sur l onglet Modifier. Dans l onglet Contact settings, complétez les champs comme cela : Store name (Nom de la boutique) : Boutique. Store owner (Propriétaire du magasin) : votre nom. Adresse votre adresse mail. Cochez la case Include the store name in the from line of store s si vous désirez que le nom de votre boutique apparaisse dans le champ «de» de vos s. Indiquez ensuite vos éventuels numéros de téléphone et fax, adresse, ville, pays et code postal. Cliquez sur Enregistrer la configuration. Onglet Display settings Les paramètres par défaut de cet onglet vont convenir pour la suite de cet exemple, voici cependant une explication de leur incidence. Display type for the main store admininstration page - Type de page pour l administration de la boutique Dashboard with collapsed submenu linksl Dashboard with expanded submenu links Dashboard with no submenu links Normal Drupal submenu listing Page de configuration par défaut avec liste des différentes catégories et sous-catégories à afficher Page de configuration par défaut avec liste des différentes catégories et sous-catégories Page de configuration par défaut avec liste des différentes catégories et sans sous-catégories Liste les catégories normalement. Primary customer address - Adresse principale des clients Billing address Shipping address Adresse de facturation Adresse de livraison Footer message for store pages - Message de bas de page pour la boutique : Dans cette section, vous pouvez sélectionner un message de bas de page faisant référence à Ubercart. Onglet Format settings Dans cette section, vous pourrez régler les formats monétaires (Currency format), de poids (Weight format), de longueur (Lenght format) et de Date (Date format).

253 23 - Site coopératif 253 Placez-vous à la section Currency format. Default currency (Monnaie par défaut) : EUR Currency sign : Thousand Marker (Séparateur de milliers) : le signe espace. A la section Weight format, choisissez Grams dans la liste Default unit of measurement. A la section Length format, choisissez Centimeters dans la liste Default unit of measurement. Placez vous à la section Date format. Default format string (Format de date par défaut) : d/m/y. Cliquez sur Enregistrer la configuration. Les formats de poids et longueur peuvent servir si vous les précisez pour vos produits et ultérieurement pour calculer les frais de port. Reporting Settings Par défaut, un rapport est envoyé aux créateurs de Ubercart toutes les semaines pour mieux connaître l utilisation du logiciel. Votre boutique est maintenant configurée, vous allez maintenant créer vos produits Product : Créez les produits de voter boutique Vous allez maintenant créer les quatre produits de votre boutique. Installation Activez le module Product. Pour afficher correctement les photos des produits, Product peut utiliser les modules CCK (16. CCK : Créez des types de contenu personnalisés), CCK Image Field (16.6 ImageField : Ajoutez un champ image à voter type de contenu) et ImageCache (21.5 ImageCache : Manipulez vos images avant de les afficher). Allez sur la page Administrer - Store administration. Product peut configurer vos images automatiquement Si ce message s affiche en bas de la page, activez les modules sus-cités.

254 254 VI - Description des modules utiles de Drupal Vos modules pour la gestion des images par Product sont bien activés Cliquez sur le lien Click here pour configurer automatiquement la gestion des images par Product. Trois choses ont maintenant été installées à l activation de ce module : Une nouvelle page de configuration pour les produits, un type de contenu Product et des nouveaux réglages pour ImageCache. Configuration Vous pouvez modifier le type de contenu Product (Administrer - gestion du contenu - Type de contenu) et les réglages de ImageCache (Administrer - Construction du site - ImageCache) si ceux définis par Ubercart ne vous conviennent pas. Vous allez maintenant créer votre premier produit : Créer un contenu - Product. Nom : Cuillère en bois de hêtre. Description : Une cuillère en bois qui vous permettra de mélanger vos préparations. Image : Pointez vers une image de cuillère en bois (disponible sur le site Cliquez sur Transfert de fichiers. La section Product information est plus spécifique à Ubercart : SKU : Cuill01, c est un numéro d identification arbitraire du produit. Il doit être unique. Sell price (Prix de vente) : 6 Poids : 90 grams

255 23 - Site coopératif 255 La section Product information Vous pouvez configurer l affichage de ces champs à la page Administrer - Store administration - Configuration - Product settings, onglet Modifier, onglet Product Fields. Cliquez sur Enregistrer. Le premier produit de votre boutique! De la même façon, ajoutez les produits suivants : Nom : Cuillère en balsa. Description : Une cuillère de bois qui vous suivra partout dans vos voyages à prix mini. SKU : Cuill02 Sell price : 2.50 Poids : 5 Grams. Nom : Passoire métal. Description : Une passoire robuste. SKU : Pass01

256 256 VI - Description des modules utiles de Drupal Sell price : 12 Poids : 550 Grams. Nom : Passoire plastique. Description : Une passoire à prix canon. SKU : Pass02 Sell price : 4 Poids : 180 Grams. Votre boutique contient maintenant quatre produits, vous pouvez en voir la liste à la page Administrer - Store administration - Products. Vous allez maintenant organiser ces produits. La liste des produits de votre boutique Catalog : Créez un catalogue pour vos produits Installation Activez le module Catalog. Allez sur la page Administrer - Store administration.

257 23 - Site coopératif 257 Messages de Ubercart concernant l installation de catalog Ces messages vous indiquent qu un vocabulaire Catalog a bien été créé dans la Taxonomy (Activez le module 6.9 La taxonomie en cas d erreur), et que quatre produits ne sont pas assignés à un terme du catalogue. Configuration Il faut tout d abord créer les termes du catalogue, vous allez ici créer deux catégories de produits : Cuillères et Passoires. Administrer - Gestion du contenu - Taxonomie. Un nouveau vocabulaire Catalog a été créé, cliquez sur le lien ajouter des termes. Nom du terme : Cuillères Ajoutez une image pour ce terme. Cliquez sur Enregistrer. Nom du terme : Passoires Ajoutez une image pour ce terme Cliquez sur Enregistrer. Cliquez sur l onglet Liste, vos deux termes devraient apparaître. Liste des termes à associer à vos produits

258 258 VI - Description des modules utiles de Drupal Il faut maintenant éditer chaque produit et l associer à l un de ces termes. Administrer - Store administration - Products - Find orphaned products. Cette page liste tous les produits non associés à un terme du vocabulaire Catalog. Cliquez sur le premier produit de la liste. A la section Catalog, sélectionnez le terme qui convient au produit. Cliquez sur Enregistrer. Attribution d un terme du catalogue à un produit Répétez l opération pour les trois autres produits. Vous disposez maintenant de plusieurs nouvelles page pour votre boutique : L URL catalog : La liste des catégories de vos produits

259 23 - Site coopératif 259 La liste des produits d une catégorie Si ces URL s ne vous conviennent pas, vous pouvez bien sûr les modifier grâce au module 7.1 Path : L Alias d URL s. Enfin, le module Catalog propose également un bloc. Le bloc de Catalog Cart : Créez le panier de votre site Un site e-commerces doit de proposer un panier. Ubercart en propose un permettant à l acheteur de visionner la liste de ses produits sélectionnés durant la visite de votre boutique. Installation Pour activer, le module Cart, il faut également activer les modules Conditionnal Actions, Order (vous configurerez ce module au chapitre suivant) et Token (non inclus à Ubercart). Activez ensuite le module Cart. Configuration Le panier de Ubercart peut s afficher sous forme de bloc Drupal Administrer - Construction du site - Blocs. Affichez le bloc Shopping Cart dans la région Barre de gauche (en haut si possible). Cliquez sur le bouton Enregistrer les blocs.

260 260 VI - Description des modules utiles de Drupal Le panier de Ubercart Vous allez maintenant simuler l achat d une cuillère en bois de hêtre : Retournez à votre catalogue (URL : catalog). Choisissez la catégorie Cuillères. Le nouveau bouton Add to cart pour chaque produit Vous pouvez modifier l intitulé de ce bouton à la page Administrer - Store administration - Configuration - Product settings, onglet Modifier, onglet Product settings. Cliquez sur le bouton Add to Cart. La liste de vos achats Un produit est maintenant dans le panier, il faut maintenant valider l achat (Checkout).

261 23 - Site coopératif Order : Validation du panier Installation Le module Order a été activé au chapitre précédent, il n y a pas d autre installation à effectuer. Utilisation Cliquez sur le bouton Checkout de votre panier. Apparaît alors la page de validation de la commande, remplissez les champs obligatoires marqués d un caractère * Dans la section Billing information (Adresse de facturation), cochez la case My billing information is the same as my delivery information (Adresse de facturation identique à l adresse de livraison). Vous pouvez configurer les champs d adresse à la page Administrer - Store administration - Configuration - Checkout settings, onglet Modifier, onglet Adress fields. Cliquez sur le bouton Review order. Un résumé de la commande apparaît. Validation de la commande

262 262 VI - Description des modules utiles de Drupal Résumé de la commande Cliquez sur Submit Order pour valider la commande Si votre serveur de mail n est pas correctement configuré, un message d erreur s affichera (9.5. Configuration de votre serveur pour l envoi de mail). Allez à la page Administrer - Store administration - Orders, votre première commande apparaît dans la liste. Vous venez donc de réceptionner votre première commande. Il faut maintenant permettre un paiement en ligne. C est ce que vous allez configurer durant les deux prochains chapitres Création d un compte Paypal SandBox Pour tester le module de paiement de Ubercart, vous allez configurer un compte Paypal. Ne considérez pas que je vous encourage à utiliser Paypal pour effectuer vos paiements en ligne. Paypal a l avantage de proposer un environnement de développement, appelé sandbox (Bac à sable) simulant complètement le site de production. J ai donc choisi de vous fournir un exemple de solution qui fonctionne de A à Z. Création d un compte sur SandBox Rendez-vous à l adresse Cliquez sur le bouton Sign Up Now. Complétez les différents champs du formulaire qui s affiche, entrez une adresse valide.

263 23 - Site coopératif 263 Cliquez sur le bouton SignUp. Formulaire d inscription à SandBox Vous devriez alors recevoir un de confirmation. Rendez vous à l URL indiqué dans le corps du mail. Connectez vous en utilisant votre adresse et le mot de passe entré lors de l inscription. Création d un compte Seller (vendeur) Cliquez sur le lien Create a preconfigured buyer or seller account. Country : France. Account Type : Seller. Login Une adresse mail fictive. Cliquez sur le bouton Create Account. Création d un compte Seller sous Paypal Sandbox

264 264 VI - Description des modules utiles de Drupal Création d un compte acheteur La liste de vos comptes de tests apparaît alors, cliquez sur le lien Create account : Preconfigured placé au-dessus de cette liste. Country : France. Account Type : Buyer. Login Une adresse mail fictive. Cliquez sur la section Show Advanced Options et vérifiez qu une carte de crédit sera bien créée en même temps que le compte. Cliquez sur le bouton Create Account. Votre liste doit maintenant comporter un compte vendeur et un compte acheteur. Activez Payment Review en cliquant sur Disabled pour les deux comptes. Activez Test mode en cliquant sur Disabled pour le compte vendeur. Vos comptes sont activés Payment : Permettez un paiement en ligne Un grand nombre de solutions de paiement en ligne existent avec Ubercart, ils sont regroupés à la page Administrer - Construction du site - Modules à la section Ubercart - Payment. Ces différents modules nécessitent l activation du module de base pour les paiements : Payment. Dans cet exemple, vous allez apprendre à configurer Ubercart avec les comptes Paypal de test configurés au chapitre précédent. Installation Activez les modules Payment et Paypal.

265 23 - Site coopératif 265 Configuration Une erreur peut apparaître à l activation de ces modules concernant l usage de Paypal WPP (Web Payments Pro). Elle peut être résolue en activant le module php_curl. Sous Windows : clic gauche sur wampserver, PHP - Extensions PHP - php_curl. Sous Linux : sudo apt-get install php5-curl sudo /etc/init.d/apache2 restart Administration - Store administration - Configuration - Payment settings. Onglet Modifier. Onglet Payment methods. Cochez le moyen de paiement PayPal Website Payments Standard. Paypal address : L adresse mail saisie lors de la création du compte vendeur (Seller). Currency code : EUR Paypal login page language : FR Paypal server : Sandbox. Cliquez sur Enregistrer la configuration. Utilisation Configuration du moyen de paiement Paypal WPS Maintenant que votre compte Paypal et Ubercart sont configurés pour fonctionner ensemble, vous pouvez simuler une transaction complète :

266 266 VI - Description des modules utiles de Drupal Remplissez votre panier de quelques produits. Cliquez sur le bouton Checkout. Le panier est rempli! Remplissez les différents champs du formulaire (25.5. Order : Validation du panier) Vérifiez que la méthode de paiement est Paypal. Cliquez sur Review Order. Cliquez sur Submit Order. Connectez vous avec votre compte Buyer. La section des méthodes de paiement Connexion au compte Buyer pour le paiement Attention : Lorsque vous copiez les adresses mails de vos comptes de test dans le presse-papier, vérifiez qu un espace n a pas été inséré par Paypal dans votre chaîne de caractère.

267 23 - Site coopératif 267 Cliquez sur Connexion. Cliquez sur Payer. Paiement sur Paypal avec la carte bancaire virtuelle Le paiement devrait alors s effectuer. Un bouton permet de retourner du site Paypal vers votre Boutique Drupal. Vous allez maintenant vérifier que tout a bien fonctionné sur Drupal : Administrer - Store Administration - Orders. Une deuxième commande doit apparaître, cliquez sur l icône en forme de loupe. Constatez que la commande a été payée avec Paypal. Vérifiez maintenant si votre compte Paypal a bien été crédité : Allez sur Cliquez sur Test Accounts. Cliquez sur la section View Details du compte Seller.

268 268 VI - Description des modules utiles de Drupal Votre compte Paypal a maintenant un crédit de 14,00 Vous pouvez voir plus d informations sur votre compte Paypal en cliquant sur le bouton Enter Sandbox Test Site et en vous connectant à votre compte Seller. Le détail du paiement Cette introduction à Ubercart touche maintenant à sa fin. Vous pourrez si vous le souhaitez explorer les autres modules de Ubercart permettant de calculer les frais d envoi (Shipping Quotes + Flatrate), calculer la TVA (Taxes) et bien d autres choses encore! Note finale de l auteur J espère que c est avec plaisir que vous avez découvert les possibilités de Drupal. Ce livre ne se prétend pas exhaustif car le sujet est vaste. J ai essayé de vous donner les clés pour ouvrir le maximum de portes pour explorer le grand monde de Drupal. Maintenant, à vous de découvrir LA fonctionnalité que vous recherchez! Bonne route et à bientôt au détour d un forum!