Atelier Drupal 7

Le module Views dépend du module CTools :

-> Téléchargez et activez les module Chaos tool suite (http://drupal.org/project/ctools) - Version utilisée pour ce livre 7.x-1.0-rc1 et Views et Views UI (http://drupal.org/project/views) - Version utilisée pour ce livre 7.x-3.0-rc1.

CTools est un module qui contient des fonctions PHP pour Drupal. Il facilite la vie des programmeurs.

Au moment de la rédaction de cet ouvrage, Views n'était pas encore traduit en français. Pour les copies d'écran, une traduction a été importée depuis http://localize.drupal.org/.

Pour pouvoir consulter la volumineuse aide de Views, il faut installer le module Advanced help.

En activant le module Views, quelques exemples de vues sont installés.

-> Menu Structure - lien Views.

-> Dans la liste, cliquez sur le lien activer de la vue Tracker

Un bogue présent sur la version 3.0-rc1 empêche d'accéder directement au contenu de la vue activée, il faut donc d'abord :
-> cliquer sur le lien modifier de la vue Tracker ;
-> bouton Enregistrer ;
-> retourner menu Structure - lien Views.

-> Pour voir la vue en action, cliquez sur /tracker dans la colonne CHEMIN

Cette vue affiche la liste des nodes du site et diverses informations à leur propos. Remarquez également que :

• les nodes sont présentées sous forme de tableau ;
• il est possible de modifier l'ordre de tri de ces nodes en cliquant sur les en-têtes du tableau.

Tout est configurable dans cette vue : le nombre de colonnes du tableau, l'ordre de tri par défaut, le format des colonnes, de la date, les liens vers les nodes et les auteurs, etc.

Vous pouvez voir comment est construite cette vue en l'éditant.

-> Éditez la vue.

Vous arrivez alors sur la page de construction des vues. Celle-ci est divisée en trois parties : Affichages, Détails de l'affichage et Aperçu de la vue.

Affichages

Chaque vue peut définir plusieurs sorties (page, bloc, etc.). Cet aspect sera détaillé plus tard dans ce chapitre.

Détails de l'affichage

C'est dans cette section que vous pouvez configurer les paramètres de la vue. Remarquez par exemple la liste dans la section CHAMPS qui correspond exactement aux champs affichés dans la vue tracker.

Aperçu de la vue

Cette section répercute automatiquement les modifications faites aux paramètres de la section précédente.

Des menus contextuels permettent également de modifier certains paramètres directement depuis l'aperçu.

Vous allez maintenant modifier quelques paramètres de la vue Tracker :

• modifier le format d'affichage de la vue ;
• limiter à 10 le nombre de nodes par page ;
• supprimer des champs de la vue.

Modification du format

La section FORMAT de la vue indique que Tracker est affichée sous forme de Tableau. Modifiez ce paramètre pour que les nodes s'affichent sous forme de liste.

-> Cliquez sur le lien Tableau pour modifier ce paramètre.

Dans la fenêtre qui apparaît, vous pouvez choisir le format de la vue.

-> Choisissez Liste HTML

-> Bouton Appliquer (tous les affichages).

Une deuxième page popup permet de configurer le style Liste HTML. Vous pourriez par exemple choisir un type de liste ordonnée (items numérotés).

-> Bouton Appliquer (tous les affichages).

Vous pouvez dès à présent constater dans l'aperçu l'impact qu'a eu ce changement de paramètre sur la vue.

Modification de la pagination

De la même façon, vous pouvez changer la pagination de cette vue. Par défaut, 25 éléments par page s'affichent en format tableau, vous allez le passer à 10.

-> Cliquez sur le lien Avec pagination, 25 éléments.

-> Éléments par page : 10.

Si le nombre de nodes de votre installation Drupal est inférieur à 10, la pagination ne s'affichera pas.

-> Bouton Appliquer (tous les affichages)

Une nouvelle section pagination apparaît alors en aperçu. Remarquez qu'un nouveau menu contextuel permet d'accéder directement aux paramètres de pagination.

Suppression de champs

La zone CHAMPS affiche la liste des champs qui apparaissent dans la vue. Vous allez supprimer les champs relatifs aux commentaires.

-> Cliquez sur le lien réordonner de la section CHAMPS.

-> Cliquez sur le lien Retirer des trois champs relatifs aux commentaires (Contenu : Nombre de commentaires (Replies), Contenu : Last comment time (Last Post) et Contenu : Nouveaux commentaires).

-> Bouton Appliquer (tous les affichages)

-> Menu Structure - lien Vues.

-> Lien + Ajouter une nouvelle vue.

La page qui apparaît est l'assistant de création d'une vue.

-> Nom de la vue : Liste des recettes.

-> Description : Une page qui affiche la liste de toutes les recettes et un bloc qui affiche les cinq dernières recettes

Le paramètre Format d'affichage permet de modifier le style des lignes :

-> Format d'affichage : Tableau.

Pour ce premier exemple, vous n'allez pas utiliser les paramètres de cet assistant pour mieux comprendre les mécanismes de l'interface de Views.

-> Bouton Continuer & modifier

Ajoutez deux champs à votre vue :

-> le champ Prix ;

-> le champ Photo sous forme de miniature (Thumbnail).

Le champ Titre a été automatiquement ajouté à la vue par l'assistant.

Ajout du champ prix

-> Cliquez sur le lien ajouter de la section CHAMPS.

-> Dans le popup, cochez la ligne Contenu : Prix par personne.

-> Bouton Ajouter et configurer le champ.

S'affiche une deuxième fenêtre popup contenant des dizaines d'options. Cette fenêtre permet de configurer l'affichage du champ.

-> Bouton Appliquer (tous les affichages)

Ajout du champ photo

Ajouter le champ photo n'est pas plus compliqué :

-> cliquez sur le lien ajouter de la section CHAMPS ;

-> dans le popup, cochez la ligne Contenu : Photo de la recette ;

-> bouton Ajouter et configurer le champ.

S'affiche alors la deuxième fenêtre popup de configuration du champ photo.

-> Étiquette : Photo.

-> Style d'image : Thumbnail.

-> Link image to : Contenu.

-> Bouton Appliquer (tous les affichages)

Chap. Image : créez des styles d'image personnalisésImage : créez des styles d'image personnalisés .

Modification d'un champ

Il manque une étiquette (titre de colonne) au champ titre. Pour l'ajouter, il faut éditer le champ titre :

-> dans la section CHAMPS, lien Contenu : Titre ;

-> cocher Créer une étiquette ;

-> Étiquette : Titre

-> bouton Appliquer (tous les affichages).

N'oubliez pas d'enregistrer votre vue de temps à autre en cliquant sur le bouton Enregistrer situé en haut de la page.

La section CHAMPS de Views correspond à la clause SELECT d'une requête SQL.

Vous pouvez créer un raccourci vers la page /liste_des_recettes avec le module chap. Shortcuts : gérez la barre de raccourcisShortcuts : gérez la barre de raccourcis pour accéder rapidement au rendu de la vue.

La vue créée affiche toutes les nodes (articles, sondages, etc.). Vous pouvez restreindre cette liste aux seules nodes de type Recette.

-> Cliquez sur le lien ajouter de la section CRITÈRES DE FILTRAGE.

-> Dans le popup, cochez la ligne Contenu : Type.

-> Bouton Ajouter et configurer critères de filtre.

S'affiche une deuxième fenêtre popup qui permet de configurer le filtre.

-> Opérateur : Fait partie de.

-> Types de contenu : Recette...

-> Bouton Appliquer (tous les affichages).

Le filtre Contenu : Publié (Oui) a été automatiquement ajouté par défaut. Il ne sélectionne que les contenus qui ont la case Publié cochée dans les Options de publication.

Dans l'aperçu, vous pouvez constater que seules les recettes sont maintenant affichées.

La section CRITÈRES DE FILTRAGE de Views correspond à la clause WHERE d'une requête SQL.

Par défaut, la vue est triée par ordre de Date de publication du plus récent au plus vieux. Vous allez supprimer ce critère et ordonner la vue par Titre en ordre alphabétique.

Suppression du critère Contenu : Date de publication (desc) .

-> Cliquez sur le lien réordonner de la section CRITÈRES DE TRI.

-> Cliquez sur le lien Retirer de la ligne Contenu : Date de publication desc.

-> Bouton Appliquer (tous les affichages).

Ajout du critère par ordre alphabétique

-> Cliquez sur le lien ajouter de la section CRITÈRES DE TRI.

-> Dans le popup, cochez la ligne Contenu : Titre.

-> Bouton Ajouter et configurer critères de tri.

S'affiche alors la deuxième fenêtre popup qui permet de configurer le critère.

-> Option : Trier par ordre croissant.

-> Bouton Appliquer (tous les affichages)

La section CRITÈRES DE TRI de Views correspond à la clause ORDER BY d'une requête SQL.

Tri par tableau

Lorsque votre vue utilise un format en Tableau, vous pouvez trier la vue par colonne :

-> Lien Paramètres de la section FORMAT.

-> Cochez la case CLASSABLE des colonnes désirées

• Modifier la vue de façon à ce qu'elle s'affiche de la façon suivante :

Corrigé

Ajout du champ Difficulté

-> Cliquez sur le lien ajouter de la section CHAMPS.

-> Dans le popup, cochez la ligne Contenu : Difficulté.

-> Bouton Ajouter et configurer le champ.

S'affiche alors la deuxième fenêtre popup de configuration du champ.

-> Bouton Appliquer (tous les affichages).

Réordonner les champs

-> Cliquez sur le lien réordonner de la section CHAMPS.

-> Déplacez les champs en cliquant sur l'icône de gauche

-> Bouton Appliquer (tous les affichages).

Lors du chap. Ajout d'un champ à un terme de taxonomieAjout d'un champ à un terme de taxonomie, vous avez associé à chaque terme Illustration. Il s'agit maintenant d'afficher dans la vue cette illustration à la place des termes de difficulté (Très facile, Facile, Moyen, etc.)

Votre vue étant basée sur le contenu, vous ne trouverez pas le champ Illustration du terme de taxonomie dans la liste.

Il faut alors créer une relation entre la node affichée et son terme de taxonomie du vocabulaire difficulté.

-> Dans la troisième colonne de la page de configuration de Views, cliquez sur le lien ajouter de la section RELATIONS

S'affiche la liste des liens possibles par rapport à une vue basée sur le contenu. Voici quelques-uns de ces liens :

• lien vers l'utilisateur Auteur de la recette (Contenu : Auteur) ;
• lien vers les fichiers rattachés au nœud (Utilisation du fichier : Fichier) ;
• lien vers les différents vocabulaires de taxonomie liés à un type de contenu (Contenu : Difficulté (field_difficulte), Contenu : Provenance (field_provenance), etc.).

-> Sélectionnez la ligne Contenu : Difficulté (field_difficulte).

Bouton Ajouter et configurer relations.

Bouton Appliquer (tous les affichages).

Le champ Illustration doit être disponible maintenant :

-> cliquez sur le lien ajouter de la section CHAMPS ;

-> dans le popup, cochez la ligne Terme de taxonomie : Illustration

-> bouton Ajouter et configurer le champ.

S'affiche la deuxième fenêtre popup. Remarquez que Views indique qu'une relation est utilisée pour accéder à ce champ.

-> Étiquette : Difficulté.

-> Bouton Appliquer (tous les affichages).

La section RELATION de Views correspond à la clause JOIN d'une requête SQL.

-> Vous pouvez retirer le champ difficulté précédent et réorganiser les champs.

Views permet à l'utilisateur de votre vue d'interagir avec son contenu. Pour cela, il est possible d'ajouter des filtres ou des critères de tris.

Voici par exemple le formulaire que vous allez créer :

Ajout d'un filtre exposé pour le champ Difficulté

Il est aussi simple de créer un filtre exposé à l'utilisateur qu'un filtre normal :

-> cliquez sur le lien ajouter de la section CRITÈRES DE FILTRAGE ;

-> dans le popup, cochez la ligne Contenu : Difficulté (field_difficulte) ;

-> bouton Ajouter et configurer critères de filtre.

Le champ ajouté est de type terme de taxonomie. Il faut donc choisir le widget à utiliser pour le formulaire :

-> choisissez Liste déroulante ;

-> bouton Appliquer et continuer.

S'affiche la fenêtre popup qui permet de configurer le filtre.

-> Cochez la case Exposer ce filtre aux visiteurs, pour leur permettre de le modifier.

-> Étiquette : Difficulté.

-> Bouton Appliquer (tous les affichages).

Dans l'aperçu, apparaît une nouvelle section Filtres exposés au-dessus de la vue.

Ajout d'un critère de tri exposé pour le champ difficulté

De la même façon, il est possible d'exposer un critère de tri :

-> cliquez sur le lien ajouter de la section CRITÈRES DE TRI ;

-> dans le popup, cochez la ligne Contenu : Difficulté (field_difficulte) ;

-> bouton Ajouter et configurer critères de tri.

S'affiche la deuxième fenêtre popup qui permet de configurer le critère.

-> Cochez la case Exposer ce filtre aux visiteurs, pour leur permettre de le modifier.

-> Étiquette : Difficulté.

-> Bouton Appliquer (tous les affichages)

Lorsque vous utilisez un style Tableau, vous pouvez permettre à l'utilisateur de trier le contenu en utilisant les en-têtes.

Ajout d'un filtre exposé pour le champ Tags

Pour le champ tags, vous allez utiliser un autre widget que la liste déroulante :

-> cliquez sur le lien ajouter de la section CRITÈRES DE FILTRAGE ;

-> dans le popup, cochez la ligne Contenu : Tags (field_tags) ;

-> bouton Ajouter et configurer critères de filtre.

Le champ ajouté est de type terme de taxonomie. Il faut donc choisir le widget à utiliser :

-> choisissez Autocomplétion ;

-> bouton Appliquer et continuer.

S'affiche la fenêtre popup qui permet de configurer le filtre.

-> Cochez la case Exposer ce filtre aux visiteurs, pour leur permettre de le modifier.

-> Étiquette : Mots-clés.

-> Bouton Appliquer (tous les affichages)

Les options des formulaires exposés d'une vue

Une section FORMULAIRE EXPOSÉ permet de modifier certains paramètres :

• Formulaire exposé dans un bloc : le formulaire ne sera pas affiché au-dessus de la vue, mais il sera disponible sous forme de bloc. Il sera alors possible de le positionner dans une autre région du thème ;
• Style de formulaire exposé : si Valeur requise est choisie, la vue n'affichera aucun résultat tant que l'utilisateur n'a pas utilisé le formulaire ;
• Paramètres : permet de modifier les textes et quelques options du formulaire.

Notez également l'option Utiliser AJAX qui permet de ne recharger que la vue lorsqu'une valeur du formulaire est modifiée et non pas l'ensemble de la page.

Bravo ! Votre page est maintenant terminée. Vous pouvez Enregistrer votre vue et cliquez sur le lien voir page.

Vous allez créer le bloc qui affiche les trois recettes au hasard.

Dans la section Affichages, lien + Add.

Sélectionner Ajouter Bloc

Un bloc ne s'affiche pas par une URL, mais pas l'interface d'administration des blocs. Il faut donc lui donner un nom dans cette page.

-> Dans la section PARAMÈTRES DU BLOC, modifiez le paramètre Nom du bloc.

-> Nom du bloc : Trois recettes au hasard.

-> Bouton Appliquer.

Si vous enregistrez la page, vous pourrez alors activer le bloc sur la page menu Structure - lien Blocs.

Forcément, l'affichage de la page dans un bloc n'est pas adapté. Il va falloir modifier quelques paramètres de la vue pour cet affichage.

Il y a quelques modifications à apporter à l'affichage Bloc.

Modification du Format

Le format en Tableau ne convient pas pour un bloc :

-> si ce n'est pas le cas, sélectionnez l'affichage Bloc

-> lien Tableau de la section FORMAT ;

-> choisissez Liste non mise en forme.

Si vous appliquez cette modification en cliquant sur le bouton Appliquer (Tous les affichages), l'ensemble des affichages seront impactés. Une liste déroulante en haut de la fenêtre permet de choisir l'affichage à modifier.

• Choisir Ce block (supplanter) dans la liste en haut de page

Remarquez que l'intitulé du bouton Appliquer (cet affichage) a changé pour vous permettre d'éviter l'erreur commune de modifier l'ensemble des affichages.
Il est conseillé d'enregistrer régulièrement votre vue pour pouvoir annuler les modifications en cas d'écrasement des paramètres des autres vues.

-> Bouton Appliquer (cet affichage).

-> Bouton Appliquer (cet affichage) de nouveau pour les paramètres du format.

Modifiez les paramètres de l'affichage bloc pour qu'il ait l'aspect suivant :

Corrigé

Suppression des champs Photo et Prix par personne

-> Cliquez sur le lien réordonner de la section CHAMPS.

-> Lien Retirer sur les lignes Contenu : Photo de la recette Photo et Contenu : Prix par personne.

-> Choisir Ce block (supplanter) dans la liste en haut de page.

-> Bouton Appliquer (cet affichage).

Suppression de l'étiquette du titre

-> Cliquez sur le lien Contenu : Titre (Titre) de la section CHAMPS.

-> Décocher la case Créer une étiquette.

-> Bouton Appliquer (cet affichage).

Modification du champ difficulté

-> Cliquez sur le lien Terme de taxonomie : Illustration de la section CHAMPS.

-> Décocher la case Créer une étiquette.

-> Style d'image : Thumbnail.

-> Bouton Appliquer (cet affichage).

Affichage de trois éléments et du lien plus

-> Cliquez sur le lien Complet de la section PAGINATION.

-> Option Afficher un nombre défini d'éléments.

-> Bouton Appliquer (cet affichage)...

-> Éléments à afficher : 3.

-> Bouton Appliquer (cet affichage).

-> Cliquez sur le lien Lien « plus » de la section PAGINATION.

-> Cochez la case Créer un lien « plus ».

-> Bouton Appliquer (cet affichage).

Tri au hasard

-> Cliquez sur le lien ajouter de la section CRITÈRES DE TRI.

-> Sélectionnez la ligne Global : Au hasard.

-> Bouton Ajouter et configurer critères de tri.

-> Bouton Appliquer (cet affichage).

Modification du titre

-> Cliquez sur le lien Liste de recettes de la section TITRE.

-> Entrez Trois recettes au hasard.

-> Bouton Appliquer (cet affichage).

Retirer les filtres exposé

-> Cliquez sur le lien réordonner de la section CRITÈRES DE TRI.

-> Lien retirer des lignes avec filtre exposé.

-> Bouton Appliquer (cet affichage).

-> Cliquez sur le lien et/ou de la section CRITÈRES DE FILTRAGE.

-> Lien retirer des lignes avec filtre exposé.

-> Bouton Appliquer (cet affichage)

-> Menu Structure - lien Vues.

-> Lien + Ajouter une nouvelle vue.

L'assistant de création de vue apparaît alors. Complétez-le comme dans l'illustration suivante :

-> Bouton Continuer et modifier.

Un filtre contextuel est un paramètre que la vue récupère dans l'URL de la page. Par exemple, l'URL d'affichage d'une node est de type node/6. La vue peut donc utiliser le nid du contenu affiché en récupérant le deuxième paramètre de l'URL.

-> Cliquez sur le lien ajouter de la section Filtres contextuels.

-> Sélectionnez la ligne Contenu : Nid.

-> Bouton Ajouter et configurer filtres contextuels.

La fenêtre popup de configuration des filtres contextuels s'affiche alors.

Choisir l'option Fournir une valeur par défaut à la section Quand la valeur de filtre n'est pas disponible.

Cette option Fournir une valeur par défaut est très utilisée pour fournir des arguments aux vues. Views peut trouver les nid des nodes, les uid des utilisateurs, etc. Vous pouvez également entrer directement du code PHP pour générer l'argument.

-> Cocher Supplanter le titre à la section Quand la valeur de filtre est disponible.

-> Titre : Recette : %1

-> Bouton Appliquer (tous les affichages).

Aperçu avec filtres contextuels

La section Aperçu automatique n'affiche rien, car aucun filtre contextuel n'est fourni. Il est possible d'en fournir un grâce à la zone de texte Aperçu avec filtres contextuels.

Test du bloc

Vous pouvez déjà tester si votre bloc fonctionne :

-> cliquez sur le paramètre Nom du bloc ;

-> Nom : Informations supplémentaires ;

-> Enregistrer la vue ;

-> placez le bloc Informations supplémentaires en Première barre latérale ;

-> chargez une page contenant une recette (attention : la vue ne fonctionne pas avec la page de liste des recettes)

Modification de la balise HTML - Créé il y a

L'affichage d'un champ est entièrement configurable avec Views. Vous allez créer ici un champ qui affichera le temps écoulé depuis la date de création de la recette :

-> cliquez sur le lien ajouter de la section CHAMPS ;

-> sélectionnez la ligne Contenu : Date de mise à jour ;

-> bouton Ajouter et configurer champs ;

-> Étiquette : Créé il y a ;

-> Format de date : Il y a

Pour la présentation, il faudrait que le texte soit en italiques. Pour cela, il faut l'inclure dans une balise <em> :

-> section PARAMÈTRES D'AFFICHAGE ;

-> cocher Personnaliser le code HTML du champ ;

-> Élément HTML : EM

-> bouton Appliquer (tous les affichages)

Beaucoup d'options dans cette fenêtre permettent de modifier l'affichage du champ. Elles peuvent varier selon le type de champ : n'hésitez pas à les explorer !

Modification du texte - Photo

Vous allez à nouveau utiliser ces options de transformation de texte pour afficher le champ photo... sous forme de texte !

Si la photo est présente, le texte affichera « Photo présente », sinon, « Photo non présente » :

-> cliquez sur le lien ajouter de la section Champs ;

-> sélectionnez la ligne Contenu : Photo de la recette ;

-> bouton Ajouter et configurer champs ;

-> décochez Créer une étiquette ;

-> à la section Comportement en l'absence de résultats, dans la zone de texte Texte en l'absence de résultats, entrez le texte <strong>Photo non présente</strong>

-> à la section Réécrire les résultats, cochez la case Réécrire la sortie de ce champ ;

-> dans la zone de texte, mettez Photo présente

-> bouton Appliquer (tous les affichages)

Créez un lien « Vous pouvez modifier cette recette » qui mènera directement à la page d'édition de la recette.

Corrigé

-> Cliquez sur le lien ajouter.

-> Sélectionnez la ligne Contenu : Lien de modification.

-> Bouton Ajouter et configurer champs.

-> Décocher Créer une étiquette.

-> Texte à afficher : Vous pouvez modifier cette recette.

-> Bouton Appliquer (tous les affichages).

Ajoutez un champ qui affiche le nom de l'utilisateur auteur de la recette :

Cet exercice fait appel à des connaissances apprises lors des chapitres précédents, fouillez dans les options de Views.

Corrigé

Dans la liste des champs à ajouter, rien n'est en lien avec le nom de l'utilisateur qui est l'auteur de la node.

Il faut donc ajouter ce champ en passant par une relation.

-> Cliquez sur le lien ajouter de la section RELATIONS.

-> Sélectionnez la ligne Contenu : Auteur.

-> Bouton Ajouter et configurer relations.

-> Bouton Appliquer (tous les affichages).

-> Cliquez sur le lien ajouter de la section CHAMPS

-> Sélectionnez la ligne Utilisateur : Nom.

-> Étiquette : Par.

-> Bouton Appliquer (tous les affichages).

-> Réorganisez l'ordre des champs, profitez-en pour supprimer le champ titre.

Ce bloc ne doit s'afficher que pour les utilisateurs ayant le rôle rédacteur de recettes. Il est possible de gérer ces droits d'accès directement pour le bloc, mais également à partir de Views (ce qui est plus sécuritaire) :

-> dans la section PARAMÈTRES DU BLOC, cliquez sur le paramètre Droits d'accès.

Vous pouvez alors choisir le type de restriction d'accès pour votre vue :

• Aucun(e) restriction d'accès ;
• Droit d'accès : permet de choisir le droit d'accès (Menu Personnes - onglet Droits) que l'utilisateur devra posséder pour voir la vue ;
• Rôle : permet de choisir le rôle que l'utilisateur devra posséder pour voir la vue.

-> choisissez l'option Rôle ;

-> bouton Appliquer (tous les affichages) ;

-> cochez les rôles administrator et Rédacteur de recettes ;

-> bouton Appliquer (cet affichage)

Vous pouvez modifier l'affichage des vues chap. Le theming des vues6 - Le theming des vues dans les thèmes Drupal.

Le module Locale est installé et activé par défaut si la langue française a été ajoutée durant le processus d'installation.

-> Menu Configuration - lien Langues (ou lien configurer du module Locale)

-> Onglet Détection et sélection.

Cet onglet permet d'indiquer à Drupal comment il doit choisir la langue de l'utilisateur courant.

Il est possible de cumuler les méthodes de détection et de les réordonner.

-> Cliquez sur le lien Configurer de la ligne URL.

-> Choisir Préfixe de chemin.

-> Bouton Enregistrer la configuration.

Ainsi la langue sera négociée selon l'URL :

• http://drupal.tld/en/node/1 : langue anglaise ;
• http://drupal.tld/fr/node/1 : langue française.

-> Cochez les cases Activé des lignes URL et Utilisateur

-> Bouton Enregistrer les paramètres.

Vous allez maintenant ajouter la langue espagnole à votre site. Pour cela, il faut d'abord copier le fichier de traduction dans votre installation Drupal.

-> Cliquez sur le menu Download & Extend de www.drupal.org.

-> Dans la section Translations, cliquez sur le lien All Translations.

Vous pouvez accéder à cette page directement depuis l'adresse http://localize.drupal.org

Pour pouvoir télécharger des fichiers sur ce site, il faut être connecté. Créez vous un compte sur http://www.drupal.org

-> Dans la liste des langues, choisir Spanish.

-> Téléchargez le fichier correspondant à la version 7 de Drupal.

-> Enregistrez le fichier dans le répertoire profile\standard\translation de votre installation.

-> Renommez le fichier en es.po, vous devriez obtenir un fichier profile\standard\translation\es.po.

Vous pouvez ajouter la langue espagnole, ses traductions seront importées automatiquement :

-> menu Configuration - lien Langues ;

-> lien + Ajouter une langue ;

-> choisir Espagnol (Español) dans la liste

-> bouton Ajouter une langue

Le module Locale met à disposition un bloc permettant de choisir la langue courante. Cela va vous permettre de faire fonctionner le site dans les trois langues installées.

-> Menu Structure - lien Blocs.

-> Mettez le bloc Sélecteur de langue (User interface text) en région Première barre latérale.

-> Bouton Enregistrer les blocs.

-> Retournez sur la page d'accueil du site.

Vous pouvez alors modifier la langue courante en utilisant le bloc.

Remarquez l'URL qui est sous la forme : http://drupal.tld/es

-> Repassez en langue française après avoir eu la satisfaction de constater que vous compreniez parfaitement l'espagnol.

Vous avez peut-être constaté que certains modules de Drupal ne sont pas traduits en français ou uniquement partiellement. Il est possible de traduire ces chaînes directement à partir de l'interface de Drupal. Pour cet exemple, vous allez traduire certaines chaînes du module Chaos tools.

-> Téléchargez et activez le module Chaos tool suite (http://drupal.org/project/ctools) - Version utilisée pour ce livre 7.x-1.0-rc1

Il est possible qu'au moment où vous lirez ces lignes, le module soit livré avec ses traductions. Dans ce cas, choisissez un autre module non traduit.

Vous allez traduire la chaîne « A library of helpful tools by Merlin of Chaos. » pour votre site :

-> menu Configuration - lien Traduire l'interface.

Sur cette page, un tableau vous indique quelle est la proportion des chaînes traduites dans les différentes langues installées.

-> Onglet Traduire.

Le formulaire permet de rechercher des chaînes dans tous les modules et thèmes installés.

-> La chaîne contient : library of helpful.

-> Bouton Filtrer

Vous respectez la casse (majuscules - minuscules).

Si vous ne trouvez pas une chaîne grâce à cette interface, vérifiez que la chaîne ne contient pas d'arguments (Recent posts for %1 - ou %1 est remplacé par le nom d'utilisateur).

-> Lien modifier de la chaîne.

Vous pouvez alors proposer un texte de remplacement pour les différents langages installés.

-> Français : Une bibliothèque d'outils utiles par Merlin of Chaos

-> Bouton Enregistrer les traductions.

La colonne LANGUES de l'interface de recherche montre alors que la chaîne est bien traduite en français, mais pas en espagnol.

Vous pouvez retourner sur la page des modules pour constater le résultat de votre travail :

Pour exécuter cet exercice, vous allez utiliser la vue créée chap. Création d'une vue liste des recettesCréation d'une vue liste des recettes  :

• modifiez le titre de la vue en Recipes list ;
• traduisez le titre en français ;
• testez si le titre change lorsque vous passez d'anglais à français.

Corrigé

Modifiez le titre de la vue en Recipes list

-> Menu Structure - lien Vues.

-> Lien modifier de la vue Liste des recettes.

-> Modifiez l'argument Titre de la section TITRE.

-> Entrez le texte Recipes list

-> Bouton Appliquer (tous les affichages).

-> Bouton Enregistrer de la vue.

À ce moment, le titre de la page de la vue est Recipes list.

Traduisez le titre en français

-> Menu Configuration - lien Traduire l'interface.

-> Onglet Traduire.

-> La chaîne contient : Recipes.

-> Bouton Filtrer.

-> Lien modifier.

-> Français : Liste des recettes

-> Bouton Enregistrer les traductions.

Test

Pour savoir si tout fonctionne, il faut afficher la vue Liste des recettes et ensuite utiliser le bloc de langues pour changer la langue :

-> cliquez sur le lien voir page de la vue ou entrez l'URL fr/liste-des-recettes ;

-> choisissez la langue Français dans le bloc

-> choisissez la langue English dans le bloc

Si vous voulez créer un site multilingue, il faut toujours entrer ses chaînes de caractères d'origine en anglais et ensuite les traduire.
Cela est vrai pour le module Views, mais également lorsque vous créez un thème ou un module et utilisez la fonction t() (chap. Conventions et finitionsConventions et finitions ).

-> Rendez-vous sur localize.drupal.org, vérifiez que vous êtes bien connecté.

-> Dans le bloc de droite Quick navigation, sélectionnez French dans la liste Pick a language

-> Cliquez sur le bouton Go there.

Vous arrivez alors sur la page d'accueil du groupe de traduction de Drupal en français (French team).

Cinq onglets permettent d'accéder aux différentes fonctionnalités de localize.drupal.org :

Vous avez traduit au chapitre précédent une chaîne du module Chaos tool suite. Mais d'autres utilisateurs avaient déjà traduit ces chaînes.

Vous allez exporter le fruit de leur travail depuis localize.drupal.org et les importer sur votre site.

-> Onglet Export de la page d'accueil du groupe (http://localize.drupal.org/translate/languages/fr).

-> Project : Chaos tool suite (ctools).

-> Release : 7.x-1.0-rc1 only

-> Bouton Export Gettext file.

Repérez où votre navigateur a enregistré le fichier (.po) et retournez à votre site Drupal :

-> menu Configuration - lien Traduire l'interface ;

-> onglet Importer ;

-> Fichier de langue : pointez vers le fichier .po que vous avez téléchargé ;

-> bouton Importer

Si beaucoup de chaînes restent non traduites et que vous pensez qu'elles devraient l'être, choisissez All releases merged (toutes versions confondues) lors de l'export.

Dans le module CTools, certaines chaînes ne sont pas encore traduites par la communauté.

Vous pouvez proposer une traduction à la communauté.

-> Onglet Translate de la page d'accueil du groupe (http://localize.drupal.org/translate/languages/fr).

-> Project : Chaos tool suite (ctools).

Un formulaire propose des listes pour trouver ce que vous voulez traduire :

-> cliquez sur le lien Reveal more filters ;

-> Status : Untranslated (Non traduites) ;

-> Contains : custom styles

Vous pouvez alors proposer ou corriger une traduction et l'ensemble de la communauté en profitera !

Voici un module plus convivial pour traduire les chaînes de l'interface et les partager automatiquement sur http://localize.drupal.org.

-> Téléchargez et activez le module Localization client (http://drupal.org/project/l10n_client) - Version utilisée pour ce livre 7.x-1.0.

Il faut désactiver le module Overlay pour que Localization client fonctionne de manière optimale.

Utilisation

Une fois le module activé, une barre apparaît en bas de page. Vous pouvez l'utiliser pour traduire quelques chaînes du module CTools :

-> menu Modules ;

-> cliquez sur le lien Traduire le texte en bas à droite de la page.

Les chaînes déjà traduites dans la langue courante sont en vert, les non traduites en blanc.

-> Repérez une chaîne non traduite dans la page et utilisez la zone de recherche de Localization Client pour la retrouver dans la liste TEXTE SUR LA PAGE.

-> Sélectionnez la ligne à traduire.

-> Entrez une traduction pour la chaîne dans la zone TRADUCTION EN FRANÇAIS

-> Bouton Enregistrer la traduction.

Si vous rechargez la page, la chaîne est bien traduite.

Pour traduire une chaîne en espagnol, il faut que la langue courante soit espagnol.

Lien avec un serveur de traduction (localize.drupal.org)

Il est possible de configurer Localize Client pour que vos traductions soient directement envoyées vers http://localize.drupal.org :

-> menu Configuration - lien Langues ;

-> onglet PARTAGE ;

-> cochez la case Activer le partage des traductions avec le serveur

-> bouton Enregistrer la configuration.

Il faut maintenant que le site localize.drupal.org puisse vous identifier. Pour cela, il faut entrer une clé unique dans votre profil utilisateur Drupal.

-> Menu Bonjour Admin.

-> Onglet Modifier.

-> À la section Client de traduction, cliquez sur le lien proposé (qui commence par http://localize.drupal.org).

-> Si vous êtes déjà connecté sur drupal.org, une clé vous est fournie.

-> Copiez la clé dans la zone Your Localization Server API key.

-> Bouton Enregistrer.

À partir de là, lorsque vous utiliserez Localization Client pour traduire une chaîne, le message suivant apparaîtra :

Vous pouvez configurer la gestion multilingue du contenu par type de contenu (Article, Page, Recette, etc.). Ici, vous allez traduire un contenu de type Page de base.

-> Menu Structure - lien Types de contenu.

-> Lien modifier du type Page de base.

-> Onglet Options de publication.

De nouvelles options pour la Gestion multilingue sont apparues. Par défaut, celle-ci est désactivée.

-> Choisissez Activé, avec traductions.

L'option Activé permet de choisir la langue de l'article.
L'option Activé, avec traductions permet de choisir la langue de l'article et de le mettre en lien avec sa(ses) traduction(s).

-> Bouton Enregistrer le type de contenu.

Vous allez créer un contenu en français que vous traduirez ensuite :

-> menu Contenu ;

-> lien + Ajouter du contenu ;

-> lien Page de base ;

-> Title : Bonjour le monde ;

-> Body : Il pleut aujourd'hui ! ;

-> Langue : Français

-> Bouton Enregistrer.

Lorsque vous ajoutez la node que vous venez de créer, le bloc de langues indique que l'article existe uniquement en français.

À présent, il faut traduire cette page en anglais :

-> onglet Traduire ;

-> lien ajouter une traduction de la ligne English.

Drupal créé une copie de la page en français. Il ne reste plus qu'au traducteur de remplacer les chaînes :

-> Title : Hello World ;

-> Body : It's raining today ! ;

-> bouton Save.

Vous pouvez changer la langue courante d'anglais à français, le contenu est automatiquement traduit ainsi que l'interface.

Recommencez l'opération pour la langue espagnole.

-> Onglet Traduire

-> Lien ajouter une traduction de la ligne Spanish.

Chaque page de traduction est une node à part entière, le module Content translation enregistre seulement un lien entre les nodes.
Grâce à ce système, il est donc possible de traduire tous les champs d'une node (texte, photo, fichiers attachés, liens, etc.).

-> Title : Hola mundo.

-> Body : Esta lloviendo hoy !

-> Bouton Guardar.

Lorsqu'un utilisateur se déconnecte du site, il est redirigé vers la page d'accueil du site. Votre première règle va rediriger l'utilisateur vers une page d'adieu s'il a le rôle « Rédacteur de recettes ».

-> Commencez par ajouter une nouvelle node de type Page de base.

-> Titre : Au revoir.

-> Body : Merci d'avoir participé à ce site en tant que créateur de recettes !

-> Alias d'URL : byebye.

Vous pouvez maintenant créer votre règle :

-> menu Configuration - lien Règles (ou lien Configurer du module Rules) ;

-> lien + Ajouter une nouvelle règle ;

-> Nom : Redirection après déconnexion.

Il faut également choisir un événement.

-> Réagir à l'événement : dans la section Utilisateur, choisir L'utilisateur s'est déconnecté

-> Bouton Enregistrer.

Un événement est donc ajouté. Vous allez maintenant ajouter l'action à déclencher lorsque cet événement se réalise.

-> Lien + Ajouter action.

-> Dans la liste, à la section Système, choisir Redirection de page.

La page se recharge alors, les options de configuration de l'action s'affichent :

-> Valeur : byebye (ou le chemin vers la page que vous avez créée) ;

-> bouton Enregistrer.

Le but de cette règle est de ne rediriger que les utilisateurs ayant le rôle Rédacteur de recettes. Il faut donc ajouter cette condition :

-> lien + Ajouter condition ;

-> dans la liste, à la section Utilisateur, choisir L'utilisateur a le(s) rôle(s) ;

-> dans la liste des Rôles, choisir Rédacteur de recettes ;

-> bouton Enregistrer.

-> Bouton Enregistrer les modifications.

Vous pouvez maintenant tester votre règle en vous déconnectant avec un utilisateur ayant pour rôle Rédacteur de recettes.

Vérifiez également qu'il n'y a pas de redirection lorsque vous vous déconnectez avec l'utilisateur administrateur.

• Créez une règle qui envoie un mail à l'adresse recette_asie@example.com lorsqu'une recette ayant pour provenance Chine est créée.

Corrigé

-> Menu Configuration - lien Règles.

-> Lien + Ajouter une nouvelle règle.

-> Nom : Mail pour recette chinoise.

-> Réagir à l'événement : Dans la section Nœud, choisir Après l'enregistrement d'un nouveau contenu.

-> Bouton Enregistrer.

Ajoutez maintenant l'action :

-> lien + Ajouter action ;

-> dans la liste, à la section Système, choisir Envoi de courriel ;

-> Valeur : recette_asie@example.com (ou votre adresse mail) ;

-> Sujet : Une nouvelle recette chinoise a été envoyée par [node:author].

-> Message :

La recette [node:title] a été ajoutée. <a href=»[node:url]»>Cliquez ici pour la consulter.</a>

-> Bouton Enregistrer.

Lisez le chap. Configuration du serveur pour l'envoi de mailConfiguration du serveur pour l'envoi de mail pour que votre installation Drupal puisse envoyer des mails.

Reste à ajouter les conditions. La première filtrera uniquement les nodes de type recette :

-> lien + Ajouter condition ;

-> dans la liste, à la section Nœud, choisir Content is of type ;

-> dans la liste des Types de contenu, choisir Recette ;

-> Bouton Enregistrer.

Dans la seconde, on doit savoir si le terme de taxonomie du champ « Provenance » est « Chine » :

-> lien + Ajouter condition ;

-> dans la liste, à la section Données, choisir Data comparison ;

-> choisissez l'item node:... (contenu créé) ;

-> choisissez l'item node:provenance:... (Provenance) ;

-> choisissez l'item node:provenance:name (Nom) ;

-> bouton Continuer.

Vous devez maintenant tester si le champ provenance est égal à la chaîne « Chine » :

-> Opérateur : égale.

-> Valeur : Chine.

-> Bouton Enregistrer

-> Créez une recette ayant pour provenance la Chine pour tester votre règle.

Vous allez personnaliser l'affichage d'un contenu de type recette en positionnant ses différents champs sur une mise en page contenant quatre régions.

Le module Display Suite a largement modifié la page gérer l'affichage des entités :

-> menu Structure - lien Types de contenu ;

-> lien gérer l'affichage du type Recette.

Deux nouveaux onglets horizontaux apparaissent en bas de page. Il faut commencer par choisir l'onglet Mise en page :

-> onglet Mise en page pour recette dans default

-> choisir la mise en page Deux colonnes empilées.

L'option Désactiver les blocs/régions Drupal permet de ne pas afficher les barres latérales pour ce type de contenu. Ainsi, vous pouvez prévoir une mise en page qui prend toute la largeur de la page.

-> Bouton Enregistrer.

En choisissant un style de mise en page, vous confiez à Display Suite le soin d'afficher le contenu des nodes pour le mode d'affichage Par défaut.

Le style de mise en page Deux colonnes empilées propose quatre régions. Il suffit maintenant de les garnir de champs par simple glisser/déposer.

-> Positionnez les champs comme sur les copies d'écran suivantes (pensez également à régler les étiquettes et les formats)

-> Bouton Enregistrer

Pour améliorer cet affichage, il faudra ajouter un peu de code CSS. Ne modifiez pas directement les fichiers CSS de Display Suite, sachez qu'il est possible de créer un thème uniquement pour intégrer une seule feuille CSS (chap. Créer un thème à partir d'un design HTML/CSSCréer un thème à partir d'un design HTML/CSS ).

Faites en sorte que les recettes s'affichent comme sur la copie d'écran suivante sur la page d'accueil :

Corrigé

Il faut commencer par choisir une mise en page pour le mode Accroche.

-> Menu Structure - lien Types de contenu.

-> Lien gérer l'affichage du type Recette.

-> Mode d'affichage : Accroche.

-> Onglet Mise en page pour recette dans teaser.

-> Choisir la mise en page Trois colonnes empilées fluides - 25/50/25...

-> Bouton Enregistrer.

Reste à disposer les champs dans les régions.

-> Positionnez les champs comme sur la copie d'écran suivante (n'oubliez pas de mettre un lien sur le titre).

En bas de la page Gérer l'affichage ou une mise en page Display Suite est sélectionnée, un onglet Add custom Field est disponible. Cette section permet d'ajouter différents types de champs.

Code field

Permet d'ajouter un champ calculé à partir de code PHP ou de jetons Token (chap. Token : des jetons pour les modulesToken : des jetons pour les modules ).

-> Cliquez sur le bouton Add a code field.

-> Étiquette : Nid.

-> Entités : cochez Node.

-> Champ de code : <?php print $entity->nid; ?>

-> Bouton Enregistrer.

-> Un nouveau champ Nid s'ajoute à la liste, placez-le en région Pied de page

-> Bouton Enregistrer.

Il est possible de modifier les champs personnalisés sur la page de configuration de Display Suite :
-> menu Structure - lien Display Suite ;
-> lien Champs.

Vous pouvez également utiliser des jetons (Token) dans la zone Champ de code. Ici le résultat aurait été le même avec le jeton :
-> Champ de code : [node:nid].

Block field

Permet d'afficher un bloc à l'intérieur du contenu. Il est par exemple possible d'afficher le bloc trois recettes au hasard (chap. Gestion des affichagesGestion des affichages ) en dessous de la liste des ingrédients :

-> bouton Add a block field ;

-> Étiquette : Trois autres recettes.

-> Entités : cochez Node.

-> Bloc : Trois recettes au hasard

-> Bouton Enregistrer.

-> Placez le nouveau champ Trois autres recettes en région Gauche.

-> Bouton Enregistrer.

Display Suite peut fonctionner avec le module Views en mettant à disposition de nouveaux styles d'affichage. Dans cet exemple, un nouveau style d'affichage de la node contenant uniquement le titre et la photo sera créé et ensuite utilisé dans Views.

-> Menu Structure - lien Display suite.

-> Lien View modes.

-> Lien + Add a view mode.

-> Étiquette : Titre et photo.

-> Entités : cochez Node.

-> Bouton Enregistrer.

Un nouveau mode d'affichage est alors créé, activez-le pour le type de contenu Recette :

-> menu Structure - lien Types de contenu ;

-> lien gérer l'affichage du type Recette ;

-> en bas de page cochez le mode d'affichage Titre et photo

-> bouton Enregistrer ;

-> sélectionnez le mode Titre et photo (bouton en haut de page)

-> sélectionnez la mise en page Deux colonnes ;

-> bouton Enregistrer ;

-> positionnez les champs comme sur la copie d'écran suivante

Vous pouvez maintenant utiliser ce mode d'affichage avec Views :

-> menu Structure - lien Vues ;

-> lien modifier de la vue Liste des recettes (chap. Création d'une vue liste des recettesCréation d'une vue liste des recettes ) ;

-> lien +Add dans la zone des Affichages ;

-> lien Ajouter Page

-> lien Chemin : liste_recettes_ds ;

-> bouton Appliquer.

Il reste maintenant à utiliser le format mis à disposition par Display Suite :

-> format : Liste non mise en forme ;

-> choisir Cette page (supplanter) dans la liste en haut de page ;

-> bouton Appliquer (cet affichage) ;

-> à nouveau bouton Appliquer (cet affichage) ;

-> lien Champs ;

-> choisir le style Display suite

-> bouton Appliquer (cet affichage).

Il faut maintenant choisir le mode d'affichage que vous avez créé :

-> Mode de visualisation par défaut : Titre et photo 

-> bouton Appliquer (cet affichage) ;

-> affichez la page de la vue

• Views est un module plus répandu, donc mieux connu. Votre site sera donc plus facile à maintenir ;
• votre vue sera alors configurable uniquement avec l'interface de Views et non avec les interfaces des deux modules.

Vous auriez pu réaliser cet affichage avec Views. Vous pourrez donc parfois hésiter entre les deux méthodes. Je vous conseille d'utiliser Views pour plusieurs raisons.

Drupal commerce utilise un grand nombre de modules de la communauté Drupal, il est donc normal qu'il ait un grand nombre de dépendances.

-> Téléchargez et activez les modules Entity API (http://drupal.org/project/entity) - version utilisée pour ce livre 7.x-1.0-beta10, Rules (http://drupal.org/project/rules) - version utilisée pour ce livre 7.x-2.0-rc2, Views (http://drupal.org/project/rules) - version utilisée pour ce livre 7.x-3.0-rc1 et Adress Field (http://drupal.org/project/adressfield) - version utilisée pour ce livre 7.x-1.0-beta2.

-> Téléchargez le module Commerce (http://drupal.org/project/commerce) - version utilisée pour ce livre 7.x-1.0.

Drupal Commerce intègre 21 modules au moment de la rédaction de cet ouvrage. Vous activerez ces modules au fur et à mesure de leur utilisation.

-> Commencez par activer les modules Commerce et Commerce UI

Les modules se terminant par UI (User Interface) servent à l'interface utilisateur du module.

Un nouveau menu Boutique apparaît dans la barre de menu. C'est à partir de ce menu que vous pourrez effectuer la majorité des tâches d'administration du module. Pour commencer, vous pouvez configurer les devises qui seront utilisées sur votre site :

-> menu Boutique - lien Configuration ;

-> lien Paramètres des devises ;

-> Devise par défaut de la boutique : EUR - Euro ;

-> bouton Enregistrer la configuration.

Commencez par créer un premier produit (un robot multifonction à 79 EUR) pour votre boutique. Il faut pour cela activer de nouveaux modules :

-> activer les modules Product, Price et Product UI

Le module Price est nécessaire, car un produit contient un champ prix.

-> menu Boutique - lien Produits ;

-> lien + Ajouter un produit ;

-> SKU : robot-multifonction (c'est la référence de votre produit et elle doit être unique sur l'ensemble de votre site) ;

-> Titre : Robot multifonction ;

-> Prix : 79

-> bouton Enregistrer le produit.

Votre nouveau produit est maintenant créé... mais vous ne pouvez pas l'afficher ! En effet, les produits sont des entités à part entière et non des nodes. Pour les afficher, il faut les lier à une node grâce à un nouveau type de champ proposé par Drupal commerce :

-> activez le module Product Reference.

Commencez par créer un nouveau type de contenu Produit :

-> menu Structure - lien Types de contenu ;

-> lien + Ajouter un type de contenu ;

-> Nom : Produit ;

-> Description : Node à lier à des produits existants dans la boutique ;

-> bouton Enregistrer et ajouter les champs.

Il faut maintenant ajouter des champs à votre type de contenu. Ici, vous ajouterez un champ image pour votre produit et un champ « référence produit » pour lier les produits :

-> lien gérer les champs du type Produit.

À la section Ajouter un champ existant :

-> dans la liste Champ à partager, sélectionnez le champ Image : field_image ;

-> Étiquette : Image ;

-> Bouton Enregistrer ;

-> Bouton Enregistrer les paramètres.

Maintenant, ajoutez le champ référence produit, à la section Ajouter un nouveau champ :

-> Étiquette : Image ;

-> field_produit ;

-> Type de données : Référence produit ;

-> Élément de formulaire : Champ à autocomplétion ;

-> bouton Enregistrer ;

-> bouton Enregistrer les paramètres du champ.

La page de configuration d'un champ de type référence produit s'affiche alors. Pour ce produit, les paramètres par défaut conviennent.

-> Bouton Enregistrer les paramètres

Créez une node de type produit en la liant au robot :

-> menu Contenu ;

-> lien + Ajouter un contenu.

Créez la node comme sur la copie d'écran suivante :

-> Bouton Enregistrer.

La node s'affiche alors avec un lien vers le produit de votre boutique, ce qui est encore loin d'être parfait, mais vous allez l'améliorer.

Le module Cart (Panier) permet d'afficher des boutons « Ajouter au panier » et de gérer le panier utilisateur via un bloc et une page.

-> Activez le module Cart.

La node doit afficher le bouton d'ajout au panier en lieu et place du lien vers le produit :

-> menu Structure - lien Types de contenu ;

-> lien gérer l'affichage du type Produit ;

-> pour la ligne produit, choisir le format Formulaire d'ajout au panier

-> Bouton Enregistrer.

Vous pouvez gérer l'affichage des différents champs sur la page gérer l'affichage du type Produit.

-> Vous pouvez maintenant ajouter votre article au panier !

Affichage du panier

Votre article est au panier, mais où est votre panier ? Il peut s'afficher sous forme de bloc :

-> menu Structure - lien Blocs ;

-> choisir la région Première barre latérale pour le bloc Panier

Le lien Voir le panier affiche une page qui permet de gérer les quantités et les lignes du panier.

Le panier étant maintenant rempli, vous pouvez passer commande.

-> Activez le module Order UI.

-> Cliquez sur le lien Valider la commande du panier

Dernière étape : il faut effectuer un paiement !

Drupal Commerce propose pour cela un module permettant de simuler un paiement fictif :

-> activer les modules Payment, Payment UI et Payment Method Example ;

-> bouton Passez à l'étape suivante de l'écran de commande.

Une page résumant la commande se charge avec une section permettant de choisir le mode de paiement.

-> Entrez une chaîne de plus d'un caractère dans la zone Nom du paiement

Le module Payment Method Example teste seulement si la zone nom contient plus d'un caractère. Dans le cas inverse, le paiement est refusé. Ce module permet donc de tester les divers états d'un paiement.

-> Bouton Passez à l'étape suivante.

Une nouvelle page vous indique que la commande est complétée. Le client peut y voir la liste des commandes passées sur le site depuis son profil :

-> lien Bonjour admin - Onglet Commandes

Côté vendeur, une page permet la gestion des commandes :

-> menu Boutique - lien Commandes

À partir de cette ligne, vous pouvez effectuer différentes opérations :

• voir : voir la commande ;
• modifier : changer le contenu de la commande, l'adresse du client et surtout, le statut de la commande ;

• paiement : consulter la balance des paiements pour savoir si le paiement a été effectué et par quel moyen ;
• supprimer : supprimer la commande.

Entité produit

-> Menu Boutique - lien Produits.

-> Onglet Types de produits.

Ici, vous pouvez définir de nouvelles familles de produits. Par exemple, un produit « Stage » peut avoir un nouveau champ Date.

Un exemple de création de nouveau produit est décrit au chapitre suivant.

L'onglet gérer l'affichage permet de définir la façon dont s'affichera le produit dans la node à laquelle il est attaché (mode d'affichage Par défaut) ou dans le panier et la commande (mode d'affichage Ligne article).

Type de champ Référence produit

Permet de lier un ou des produit(s) à un contenu.

Vous pouvez gérer l'affichage de chaque champ du produit dans la node pour un champ de type Référence produit.

Type de champ Prix

Champ utilisé par défaut dans les types produits.

Plusieurs formats d'affichage sont disponibles : montant formaté (79,00 EUR), montant brut (7900), prix calculé avec l'application des règles, prix original sans application des règles.

Entité Commande

Vous pouvez configurer les champs qui composent une commande :

-> menu Boutique - lien Configuration ;

-> lien Paramètres de commande ;

-> onglet Gérer les champs

Entité Type de ligne de commande

Chaque ligne d'une commande est une entité de type ligne de commande.

Champ Référence de ligne article

Champ utilisé par l'entité commande pour lier plusieurs lignes articles à une commande.

Entité Client

Un client est un utilisateur Drupal qui a validé une commande. Il est possible de modifier les champs des profils des clients :

-> menu Boutique - lien Profils client ;

-> onglet Types de profils ;

-> lien gérer les champs

Champ Référence du profil client

Champ utilisé par l'entité commande pour lier une commande à un client.

Champ Postal address

Champ utilisé par défaut dans le profil des clients. Ce champ comporte à lui seul plusieurs éléments de formulaire.

Voici les différentes vues créées par défaut par le module Commerce :

Shopping cart block

Vue utilisée pour afficher le bloc panier.

Shopping cart form

Vue utilisée pour afficher le détail du panier.

Shopping cart summary

Vue utilisée pour afficher le résumé du panier lors de la validation de la commande.

Line items

Affiche les lignes d'une commande.

Order payments

Vue utilisée pour afficher les paiements d'une commande.

-> Menu Boutique - lien Commandes.

-> Lien paiement d'une commande

Users orders

Liste des commandes d'un utilisateur.

Orders

Liste les commandes dans l'administration.

Products

Liste des produits dans l'administration.

Customer profiles

Liste des profils des clients dans l'administration.

Le module Commerce propose également de nombreuses règles utilisant des actions et des événements spécifiques ajoutés au module Rules.

Certaines règles peuvent être ajoutées ou modifiées via les pages de configuration de la boutique :

-> menu Boutique - lien Configuration ;

-> lien Règles de tarification des produits.

Sur cette page, vous pouvez ajouter des règles pour modifier le calcul des prix des produits.

-> Lien Modes de paiement.

Sur cette page, vous pouvez ajouter des règles pour sélectionner les modes de paiement disponibles.

-> Lien Paramètres de validation de commande.

-> Onglet Règles de validation de commande.

Sur cette page, vous pouvez ajouter des règles qui permettront de modifier les critères de validation des commandes.

Vous pouvez consulter l'ensemble des règles de Drupal Commerce à la page :
-> menu Configuration - lien Règles.

Formulaire de commande

Vous pouvez cacher ou afficher certaines sections de la page de validation de commande :

-> menu Boutique - lien Configuration ;

-> lien Paramètres de validation de commande.

Un lien configurer permet de paramétrer le comportement de chaque panneau.

Paramètres des devises

Vous pouvez activer plusieurs devises pour votre boutique :

-> menu Boutique - lien Configuration ;

-> lien Paramètres des devises

Il est possible de lier plusieurs produits à une seule node. Cela peut permettre à vos clients de ne pas avoir à naviguer sur le site pour trouver les produits d'un même thème.

Ici, vous allez créer une node qui listera l'ensemble des pièces détachées du robot multifonction.

Tout d'abord, il faut créer les produits « pièces détachées » :

-> menu Boutique - lien Produits ;

-> lien + Ajouter un produit ;

-> SKU : robot-multifonction-couteau ;

-> Titre : Couteau pour robot multifonction ;

-> Prix : 19 ;

-> bouton Enregistrer et ajouter un autre.

Ajoutez le deuxième produit :

-> SKU : robot-multifonction-bol ;

-> Titre : Bol pour robot multifonction ;

-> Prix : 29 ;

-> Bouton Enregistrer le produit.

Ensuite, il faut permettre au type de contenu Produit de référencer plusieurs entités produit :

-> menu Structure - lien Types de contenu ;

-> lien Gérer les champs du type Produit ;

-> lien modifier du champ Produit ;

-> Nombre de valeurs : Illimité ;

-> bouton Enregistrer les paramètres.

Il reste à créer une nouvelle node de type Produit :

-> Titre : Pièces détachées pour robot multifonction ;

-> Corps : Commandez vos pièces détachées ;

-> Produit : robot-multifonction-bol, robot-multifonction-couteau (ajout de deux produits dans la zone)

-> Bouton Enregistrer

Imaginez maintenant que vous souhaitiez vendre une batterie de cuisine contenant les éléments suivants :

• poêle de 14 cm et 16 cm ;
• casserole de 12 cm, 14 cm et 16 cm ;
• sauteuse de 16 cm et 18 cm.

Vous souhaitez vendre chaque élément de cette batterie séparément.

Voici l'interface que vous pourriez proposer avec le module Commerce :

Pour cela il faut créer un nouveau type de produit et lui ajouter les deux champs attributs (type d'élément et taille) et un champ image pour les différents types.

-> Menu Boutique - lien Produits.

-> Onglet Types de produit.

-> Lien + Ajouter un type de produit.

-> Nom : Élément de batterie de cuisine.

-> Bouton Enregistrer et ajouter les champs.

-> Ajoutez le champ existant Image (chap. Ajout du champ photo de l'articleAjout du champ photo de l'article).

Puis, il faut ajouter les attributs. Commencez par le type d'élément (poêle, casserole, etc.) :

-> Étiquette : Type d'élément ;

-> Nom du champ : type_element ;

-> Type de données à stocker : Liste (texte) ;

-> Élément du formulaire pour l'édition des données : Liste de sélection ;

-> bouton Enregistrer ;

-> Liste des valeurs autorisées : Poêle, Casserole, Sauteuse (une par ligne)

-> bouton Enregistrer les paramètres du champ.

La page de configuration du champ numérique s'affiche alors.

-> Autoriser ce champ à fonctionner comme un champ d'attribut sur le formulaire d'Ajout au panier. : coché.

-> Widget de sélection d'attribut : Boutons radio

-> Nombre de valeurs : 1

Les attributs des produits ne peuvent avoir un nombre de valeurs supérieur à 1.

-> Bouton Enregistrer les paramètres.

Puis, faites de même pour la taille :

-> Étiquette : Taille ;

-> Nom du champ : taille ;

-> Type de données à stocker : Liste (texte) ;

-> Élément du formulaire pour l'édition des données : Liste de sélection ;

-> bouton Enregistrer ;

-> Liste des valeurs autorisées : 12 14 16 18 (une par ligne) ;

-> bouton Enregistrer les paramètres du champ.

La page de configuration du champ numérique s'affiche alors.

-> Autoriser ce champ à fonctionner comme un champ d'attribut sur le formulaire d'Ajout au panier : coché.

-> Widget de sélection d'attribut : Boutons radio.

-> Nombre de valeurs : 1.

-> Bouton Enregistrer les paramètres.

Vous pouvez maintenant ajouter les sept produits que vous proposez à la vente :

-> menu Boutique - lien Produits ;

-> lien + Ajouter un produit ;

-> lien Créer Élément de batterie de cuisine ;

-> SKU : poele14 ;

-> Titre : Poêle (14 cm) ;

-> Prix : 15 ;

-> Type d'élément : Poêle ;

-> Taille : 14

-> Bouton Enregistrer et ajouter un autre.

Ajoutez ainsi les six autres produits de la batterie de cuisine.

Vous pouvez maintenant créer la node Batterie de cuisine qui contiendra l'ensemble des produits :

-> Titre : Batterie de cuisine ;

-> Corps : Achetez nos éléments au détail ;

-> Produit : poele14, poele16, casserole12, casserole14, casserole16, sauteuse16, sauteuse18 ;

-> Bouton Enregistrer

Il manque encore quelques éléments de mise en forme : l'image ne s'affiche pas et il faut réordonner les champs. Vous pouvez gérer l'affichage grâce à deux pages :

• l'onglet Gérer l'affichage du type de contenu Produit : ici, vous réordonnez les champs du produit et déterminez lesquels doivent s'afficher ;

• l'onglet Gérer l'affichage du type de produit Élément de batterie de cuisine : ici, vous définissez le format des champs du produit.

Modifiez bloc panier pour qu'il ait l'aspect suivant :

Corrigé

Le panier est une vue, il suffit donc de la modifier.

-> Cliquez sur le menu contextuel du panier : Modifier la vue.

-> Choisir le menu réordonner de la section Champs.

-> Placer l'item (Article) Commerce Entrée d'article : Quantité avant le Total.

-> Bouton Appliquer.

Il reste à modifier l'affichage de la quantité :

-> dans la section Champs, cliquez sur l'item (Article) Commerce Entrée d'article ;

-> mettez x en Préfixe ;

-> supprimez le Suffixe ;

-> bouton Appliquer ;

-> bouton Enregistrer de la vue.

Vous allez maintenant créer une nouvelle règle qui appliquera une réduction des prix de 10 % sur l'ensemble du site pour un utilisateur ayant pour rôle Rédacteur de recettes.

-> Menu Boutique - lien Configuration.

-> Lien Règles de tarification des produits.

Vous reconnaissez l'interface de Rules. Il va donc falloir créer une nouvelle règle :

-> lien + Ajouter une règle de tarification ;

-> Nom : 10% aux rôles Rédacteur de recettes ;

-> bouton Enregistrer.

L'événement Calcul du prix de vente d'un produit est sélectionné. La règle sera donc déclenchée chaque fois qu'un prix sera affiché.

Commencez par ajouter la condition :

-> lien + Ajouter une condition ;

-> dans la liste, à la section Utilisateur, choisir L'utilisateur a le(s) rôle(s) ;

-> dans la liste Rôles, sélectionnez Rédacteur de recettes ;

-> Bouton Enregistrer.

Puis l'action :

-> lien + Ajouter une action ;

-> dans la liste, à la section Commerce Entrée d'article, choisir Multiply the unit price by some amount ;

-> Valeur : 0.9 ;

-> Bouton Enregistrer

-> bouton Enregistrer les modifications.

Connectez-vous avec un utilisateur ayant le rôle Rédacteur de recettes.