Ce partiel dure 4 heures
Vous devez créer un module qui permet de gérer une bibliothèque de propriétaires d'animaux
ATTENTION : votre module doit s'appeler par votre nom de famille (sans aucun caractère spécial). A la fin de l'épreuve, vous devez l'envoyer zippé à l'adresse
Ce partiel dure 4 heures
Vous devez créer un module qui permet de gérer une bibliothèque de films.
ATTENTION : votre module doit s'appeler par votre nom de famille (sans aucun caractère spécial). A la fin de l'épreuve, vous devez l'envoyer zippé à l'adresse
L’association Drupalophile souhaite présenter un ensemble de ressources documentaires sur le CMS Drupal (des livres, des tutos et des vidéos). Vous êtes chargé de créer ce site en respectant les consignes du cahier des charges fourni en annexe.
A la fin de ce TP de 8 heures, je serai capable de
Pour créer un lien depuis le contrôleur, on va créer un render array et le passer en variable au gabarit pour l'afficher. La classe Link donne l'exemple suivant :
Plutôt que de créer un tableau HTML dans un gabarit, il est possible d'utiliser la classe table pour le créer depuis le contrôleur.
A la base, la taxonomie est la branche des sciences naturelles qui a pour objectif de classifier les différents êtres vivants. Petit à petit, le terme a été utilisé dans d'autres sciences et désigne la science de la classification.
Drupal 8 propose quatre types de menu.
Il est important de connaitre les noms de ces différents types de menu et de savoir à quoi ils correspondent pour pouvoir trouver de la documentation. Nous allons maintenant décrire chaque type de menu.
Drupal permet d’avoir plusieurs configurations. Nous allons modifier la configurer local pour développer plus rapidement. Consulter cette page pour des explication complémentaire : https://www.drupal.org/node/2598914
Le dossier qui contient les fichiers de configuration se trouve à l’adresse « monsite/sites/default ». Ce dossier est protégé. Il est donc nécessaire de modifier le fichier pour obtenir les droits de lecture, écriture et exécution.
Drupal est un site web du type CMS c'est à dire un "Content Manager System" ou un "système de gestion de contenu". Un CMS permet de stocker des informations sur des "contenus" pour les afficher aux visiteurs. Les premiers CMS permettaient uniquement de gérer des blogs. L'utilisateur y stockait les informations sur des contenus de type articles : titre, texte, date d'écriture... Drupal est un CMS plus évolué, car il permet de stocker des informations sur n'importe quel type de contenu. Par exemple, vous pourriez stocker des informations sur
Drupal permet de créer différents types de routes pour générer des sorties différentes. Pour définir le type de route, il faut l'indiquer dans le paramètre defaults de la route. La doc officielle sur les routes décrit 6 types de routes :
Drupal fourni les fonctionnalités de base pour la plupart des sites web, cependant vous pouvez avoir besoin de fonctionnalités supplémentaires. C’est justement les rôles des modules.
Pour qu’un module fonctionne, il doit être installé et activé. Pour voir l’ensemble des modules installé sur votre site, il faut cliquer sur « Extension » dans le menu d’administration de votre site.
Le module view permet de sélectionner un ou plusieurs éléments et de les afficher sous forme de page ou de bloc. C'est ce groupe d'éléments qu'on appelle une vue. Le module view est généralement défini comme un concepteur graphique de requêtes. Il a été créé sous Drupal 7 et comme il était très utilisé, a été intégré au cœur de Drupal 8. L'objectif de cet article est de vous expliquer ce qu'il est possible de faire. D'autres articles, vous expliqueront comment faire. Nous allons donc commencer par répondre aux questions suivantes :
Un hook est une fonction prédéfinie par Drupal ou un module. Chaque Hook est exécuté à un moment prédéfini et pourra modifier le comportement du core de drupal ou d'autres modules. Comme n'importe quelle fonction, chaque hook a un nom unique, peut utiliser des paramètres et renvoie une valeur.
Un module peut rajouter un lien dans n'importe quel menu du site. Il existe deux types de lien. Les lien éditables par l'utilisateur et les lien non éditables. Un lien de menu non éditable ne pourra être modifié qu’en touchant au code du module. Ces liens sont créés à partir d’un fichier nom_module.links.menu.yml placé à la racine du module.
Dans ce tp vous allez apprendre à créer votre premier module.
A la fin de ce module vous devez être capable de
Vous devez lire les deux articles suivants
Une entité est un ensemble de données structurées. Il existe deux grandes catégories d’entités : les entités de configuration et les entités de contenu.
Après avoir installé le site, on arrive sur une page d’accueil en étant connecté. Voici quelques zones
Superfish est un module qui permet d'obtenir des modules déroulants avec des thèmes qui ne le prévoit pas (Bartik par exemple).
L'adresse du module sur drupal.org est https://www.drupal.org/project/superfish
Commencer par ajouter la librairie superfish qui se trouve à cette adresse dans le répertoire "libraries "à la racine de votre site (créer ce répertoire s'il n'existe pas encore)
Vidéo embed field a pour but d’ajouter sur votre site, des vidéos hébergées sur une plateforme telle que YouTube ou Facebook. Le module permet :
Le module AddToAny permet d’ajouter des boutons de partage dans des blocs ou des champs. Vous pouvez ensuite afficher le bloc à l’endroit voulu.
Installer le module AddToAny qui se trouve à cette adresse. Normalement vous devriez utiliser les commandes suivantes :
Pour améliorer le SEO de votre site Drupal, il faut être capa
Pour trouver des modules, vous pouvez faire une recherche sur le site Drupal.org. Pour cela, rendez-vous à l’adresse suivante : https://www.drupal.org/project/project_module
Un thème est un ensemble de fichier qui gère l’affichage du site web. Il existe des thèmes pour la partie administration du site (back), et d’autres pour la partie front du site. Certains thèmes sont gratuits, d’autres payants. Il est primordial de travailler avec des thèmes adaptés à la version de votre Drupal.
Vous pouvez trouver des thèmes sur Drupal.org : https://www.drupal.org/project/themes
Dans Drupal, les utilisateurs ont des droits qui dépendent de leur rôle
Par défaut, il existe trois rôles :
Dans ce tuto pour Drupal, nous allons voir comment créer un bloc. Un bloc est un élément de la mise en page de votre site qui peut contenir toutes sortes d’éléments : des vues, du texte des images. Les blocs peuvent être placés dans les régions de votre thème. Toutes les opérations de gestion des blocs se fait dans la zone Mise en page des blocs (Structure -> Mise en page des blocs.
Un thème est un ensemble de fichiers php, html, css, et javascript qui permettent d’afficher du contenu et de définir l’apparence d’un site web. En séparant la logique de l’apparence, il devient possible de modifier l’apparence du site web sans toucher à la partie logique.
Après avoir créé un nouveau drupal et l'avoir configuré en mode développement, essayer de reproduire la maquette que vous trouverez à cette adresse :
https://drive.google.com/drive/folders/14kZIYMOtw1KBWkXTBxddsEkfjoRtu_RQ?usp=sharing
Par défaut, la navigation dans l'administration de Drupal est une catastrophe. Pour accéder au moindre élément, il faut 2 clics... Le module admin toolbar, vous fera gagner énormément de temps en rendant le menu administration déroulant comme dans l'image ci-dessous :
Pour l'installer, vous pouvez utiliser composer
Nous avons vu dans l'article "Qu'est ce qu'une vue", que l'objectif des vues est d'afficher plusieurs contenus en appliquant des filtres, des tris, ou des formats d'affichages. Pour pouvoir s'entraîner à créer des vues, il faut donc disposer de contenus. C'est pourquoi, vous trouverez en bas de l'article le module "frenchtown" qui rajoute 100 départements et 200 villes à votre site.
Pour Utiliser un hook dans un module, il faut suivre les étapes suivantes :
Nous avons vu dans le tuto précédent, "créer des liens non éditables", qu'un module pouvait créer des liens éditables ou non éditables. Les lien non éditables ne sont pas modifiables par l'utilisateur. Dans ce tuto, nous allons voir comment en créer des éditables. Le problème est qu les liens non éditables ne peuvent être stockés dans un fichier yaml. Nous allons donc devoir les créer lors de l'installation du module.
Dans Drupal, la configuration est l’ensemble de paramétrages d’administration qui détermine comment le site fonctionne. La configuration s’oppose au contenu du site. La configuration comprend généralement des éléments tels que le nom du site, les types de contenu, les champs, les vocabulaires de taxonomie, les vues, etc.
Un bloc configurable est un bloc qui propose un formulaire lorsqu'on le place dans une région.
Dans ce tp vous allez apprendre à manipuler des entités et continuer à manipuler des routes. Pour réaliser ce tuto, vous devez avoir terminé les tp précédents.
A la fin de ce module vous devez être capable de
Vous devez lire les articles suivants :
Drush peut vous faire gagner beaucoup de temps à la création d'un module grâce à la commande :
drush gen module
Cette commande va créer automatique
Pour créer ces éléments, Drush vous posera plusieurs questions. Quand à la fin d'une question il y a un mot entre crochet, il s'agit de la réponse par défaut que vous pouvez valider en appuyant sur la touche [entrée]
Pour charger une entité, on utilise une "storage instance" à partir du service entityTypeManager. Pour utiliser ce service, il y a deux méthodes. La simple consiste à l'appeler à l'aide du code :
\Drupal::entityTypeManager()->getStorage('id_type_entité')
Il est donc primordial de connaitre les identifiants des différents types d'entités. Pour cela, il est possible d'utiliser la commande drush suivante :
Si vous êtes connecté, commencez par vous déconnecter puis cliquez sur le lien « Se connecter » qui se trouve en haut à gauche
Dans ce tuto pour Drupal, nous allons découvrir Drush, une librairie php qui permet d’exécuter des actions sur le site Drupal en ligne de commande. Il permet notamment de vider le cache très facilement.
Il faut disposer de composer et donc de NPM et Node.js
Pour installer Drush il faut :
Le module Fontawesome (attention à ne pas utiliser font_awesome) a pour but d’ajouter sur votre site, les icones de la célèbre librairie soit :
Path auto permet de générer facilement et rapidement des alias pour les contenus de votre site. Pour rappel, un alias est une URL lisible par un être humain.
Installer un module se fait en deux étapes :
Ces tâches peuvent se faire soit
Dans ce tuto pour Drupal, nous allons voir qu'il existe 3 options pour définir qui peut créer un compte :
Par défaut, les visiteurs peuvent créer un compte mais celui-ci doit être activé par un administrateur pour devenir actif.
Pour créer ou modifier un bloc personnalisé, il faut vous rendre sur la page « Bibliothèque de bloc personnalisés » :
Dans ce tuto pour Drupal, nous allons voir qu'il est possible de modifier un menu pour changer son titre, sa description et sa langue. Surtout, nous verrons qu'il est possible de rajouter des liens et de définir leur ordre.
Le but d’une route est d’aiguiller l’utilisateur vers un contrôleur, en fonction de l’URL qu’il a saisi. Le contrôleur pourra alors effectuer des traitements et afficher du contenu.
Une route pointe vers un contrôleur. Nous allons commencer par en créer un basique. Dans le répertoire de votre module :
Dans ce tuto Drupal 8 nous allons apprendre à attacher les librairies que nous avons déclaré dans le fichier « montheme.libraries.yml ». Nous allons voir qu'il est possible d'attacher une librairie pour qu'elles soit accessible sur l'ensemble du site, ou juste sur un gabarit (template)
Les librairies attachées dans le fichier *.info.yml sont disponible sur l’ensemble du site. Il faut saisir le code suivant :
Dans l'article "créer une vue" nous avons parlé des différents affichages d'une vues : sous forme de bloc ou de page. Nous avons vu aussi qu'il était possible de définir dans le formulaire de création de la vue, son format d'affichage en choisissant un style de vue ("Grille", "Liste HTML", "Liste non mise en forme", et "Tableau") et un style de lignes ("contenu" ou "champ").
Nous avons vu qu'une "vue" est une façon d'afficher un, ou plusieurs éléments, récupérés à l'aide d'une requête sql qui a été générée grâce à l'interface graphique "view UI". Nous avons vu dans l'article sur les principes de base de l'affichage d'une vue, qu'il est possible d'afficher une page soit sous forme de page, soit sous forme de bloc. Dans cet article, nous allons voir comment créer une vue affichée sous forme de page.
Imaginons que vous créez un bloc et que vous l'affichez uniquement sur des pages qui contiennent un article. Vous pouvez avoir besoin de récupérer des informations sur l'article qui est affiché. Pour cela, vous devez utiliser la méthode getParameter de la classe RouteMach.
Surcharger un gabarit va permettre de modifier le code html d'une portion plus ou moins grande du code html de votre site. Généralement, on utilise un thème, mais il peut être nécessaire de le faire depuis un module.
Dans ce tuto pour Drupal, nous allons découvrir Drupal console, qui est un outil de ligne de commande qui permet de piloter une installation drupal.
Si vous avez installé drupal avec la méthode que nous conseillons, c'est-à-dire avec la commande composer "composer create-project drupal/recommended-project my_site_name_dir" alors drupal console est déjà installé. Vous pouvez vérifier en tapant "Drupal - v". Si ce n'est pas le cas, vous pouvez utiliser "composer require drupal/console. Attention les dernières versions ne supportent plus l'installation globale.
Dans ce tuto, nous allons apprendre à construire un local task : les menus sous forme d'onglet qui se situent au-dessus du contenu. Vous en trouverez un exemple sur la page gestion des commentaires de la partie admin de votre site :
Dans ce tp, vous allez apprendre à créer des formulaires pour modifier en masse des articles. Pour réaliser ce tuto, vous devez savoir créer le squelette d'un module, créer des routes et manipuler des entités
A la fin de ce tp, vous devez être capable de :
Drupal dispose d'une api pour gérer les formulaires. La classe form, implémente l'interface \Drupal\Core\Form\FormInterface. Comme pour les render array, le contenu est généré à l'aide tableau associatif. La construction, la validation et les actions à faire après un submit seront stockées dans le fichier src/Form/NomDuFormForm.php.
Dans cet article nous allons voir comment modifier puis sauvegarder une entité. Vous êtes censé savoir avoir lu l'article charger des entités
Dans ce tuto nous allons imaginer que le node 1 a été chargée de la façon suivante :
Maintenant que vous avez créé des alias, vous avez du beau duplicate content car votre contenu est accessible depuis l’adresse system et l’alias. Il est donc nécessaire de faire systématiquement des redirections 301 depuis l’adresse system vers l’alias. Pour cela, nous allons utiliser redirect
Dans le tuto "Définir qui peut créer un compte dans Drupal", nous avons vu qu'il est possible de :
Un bloc se place dans les régions d’un thème. Le placement des blocs est donc spécifique à un thème. Si vous changez de thème, vous devrez refaire votre placement.
Pour modifier le placement de vos blocs, vous devez vous rendre sur la page « Mise en page des blocs ». Pour cela :
L'objectif de ce tuto est d'attacher un gabarit (template) à une route pour gérer le html finement.
On déclare des gabarits et des variables dans le fichier nom_module.module. Une route renvoie vers un contrôleur qui permet de valoriser les variables et qui fait appel à un template au format Twig pour les afficher.
Créer un fichier nommodule.module à la racine du répertoire du module et rajouter le code suivant pour déclarer un gabarit et des variables :
Un gabarit, ou template en anglais, est un fichier twig qui affiche du contenu. Pour modifier l'apparence de Drupal il est nécessaire des les modifier. Voici comment faire.
Une "vue" permet d'afficher un, ou plusieurs éléments, récupérés à l'aide d'une requête sql qui a été générée grâce à l'interface graphique "view UI". Nous avons vu dans l'article sur les principes de base de l'affichage d'une vue, qu'il est possible d'afficher une page soit sous forme de page, soit sous forme de bloc. Dans cet article, nous allons voir comment créer une vue affichée sous forme de page de bloc.
Les local action sont des lien en forme de boutons qui sont généralement placés dans la partie administration. Dans l'image ci-dessous, le bouton "Ajouter un menu" est un local action.
Dans ce tp vous allez apprendre à créer des blocs configurables. Pour cela vous allez devoir apprendre à stocker des éléments de configuration. Pour réaliser ce tuto, vous devez savoir créer des formulaires comme vous l'avez vu dans le tp n°3
A la fin de ce module vous devez être capable de
Vous devez lire les articles suivants :
L'article utiliser les formulaires décrit la procédure globale pour construire un formulaire. Dans cet article, nous allons voir plus précisément l'utilisation des éléments de formulaire qui permettent de générer des éléments html intégrés au formulaire comme des inputs, des textarea...
Pour créer une nouvelle entité, il suffit d'utiliser la méthode create() de l'interface d'une classe de stockage d'entité. Pour obtenir une classe de stockage d'entité on utilise la fonction suivante :
$storage=\Drupal::entityTypeManager()->getStorage("identifiant d'un type d'entité")
Ensuite, on peut utiliser la méthode create() soit sur la variable $storage :
Metatag va vous permettre de paramétrer des balises importantes en SEO (title, meta description canonical) ainsi que les favicons.
Dans ce tuto pour Drupal, nous allons voir comment il est possible de modifier le type d'informations que l'on stocke sur les utilisateurs. Drupal stocke chaque type d'information dans des champs. Par défaut les champs utilisateurs sont :
Dans ce tuto pour Drupal 8 et 9, nous allons voir comment supprimer un menu.
la démarche est la suivante :
Twig est le moteur de template utilisé par Drupal 8 et Symphony. Twig permet de séparer le contenu de la logique PHP. Il permet à des non développeurs de créer des templates. Dans cette partie, nous allons commencer par activer le mode debug de twig puis nous verrons les principales commandes de TWIG.
Le mode debug de twig va nous donner plusieurs informations quand on utilise la commande inspecter du navigateur :
Dans ce tp, nous allons créer un module qui permet de gérer une bibliothèque. Pour cela nous allons apprendre à créer des types de contenu lors de l'installation d'un module, gérer des rôles et des droits, et créer des liens de menu. Pour réaliser ce module, vous devez avoir réalisé les autres tp.
A la fin de ce tp, vous devez être capable de :
Pour supprimer une entité, il faut commencer par la charger, puis, si le contenu existe, lui appliquer la méthode delete().
Pour rappel, on utilise la méthode getStorage('identifiant_type_entité') pour obtenir une classe de stockage d'entité. Ensuite on utilise une méthode de chargement comme load ou loadmultiple (voir l'article "charger une entité")
Dans l'exemple ci-dessous, on charge le noeud 1 avant de le supprimer :
Un sitemap est un fichier XML qui va lister les pages de votre site Web. Ce fichier est utilisé par les robots des moteurs de recherche pour connaitre toutes les pages qu’il doit indexer.
Dans cet article nous allons présenter le style de vue "Tableau". Pour rappel, une vue est un outil qui permet de sélectionner et d'afficher un ensemble d'éléments. Le style de vue va servir à choisir quelles sont les balises HTML qui encadrent chaque élément. Comme vous vous en doutez, le style de vue "Tableau" permet de placer les éléments dans une balise <table>.
Au cours de ce tp, vous allez créer un diaporama. Le but n'est évidemment pas de faire mieux que view slideshow, mais d'apprendre à surcharger des gabarits depuis un module et d'intégrer des bibliothèques CSS et JS
Avant de lancer des actions sur des entités, il peut être nécessaire de vérifier s'il s'agit d'un bien d'une entité ou son type.
Vérifier qu'une variable contient bien une entité :
if ($entity instanceof \Drupal\Core\Entity\EntityInterface) {
}
Vérifier qu'il s'agit bien d'un noeud
if ($entity instanceof \Drupal\node\NodeInterface) {
}
Vérifier qu'il s'agit bien d'un type de contenu particulier comme un article ou une page
Ce partiel dure 4 heures
L'entreprise Immo+ est un promoteur qui permet à des agents immobiliers indépendants de vendre les appartements qu'elle construit à travers toute la France. Chaque agent dispose d'un site Drupal qu'il peut mettre en forme comme il le souhaite. Par contre, ils doivent installer le module immoplus qui va ajouter plusieurs fonctionnalités à leur site.
Suite au passage à Drupal 8, votre entreprise est chargée de réécrire le module immoplus.
Pour créer un type de contenu à l'aide d'un module, il faut rajoute les fichiers yaml qui décrivent ce type de contenu et tous ses champs dans le répertoire config/install du module.
Créer les fichiers yaml peut être très laborieux. C'est pourquoi il est conseillé de créer le type de contenu avec l'interface graphique puis de les exporter à l'aide de l'outil en ligne de commande drupal console. Pour savoir comment installer cet outil, lisez l'article "installer drupal console"
Le but de ce tuto Drupal est de vous montrer comment réaliser des vues qui utilisent des
Pour afficher un noeud, il faut commencer par la charger comme décrit dans l'article "Charger des entités depuis un contrôleur". Ensuite on génère une instance de la classe view builder avec la méthode getViewBuilder() de la classe entityTypeManager puis on utilise la méthode view("entity", "view_mode" et "lang_code").
Le but de ce tuto est de vous montrer comment afficher sur la page d'un contenu, une vue qui va lister les éléments qui ont un contenu référencé en commun avec le contenu affiché. Voici quelques exemples d'utilisation :
On peut imagine afficher sur la page d'une ville, les autres villes du même département :
Dans ce tuto, nous allons voir comment créer des vues qui utilisent ce qu'on appelle en SQL des fonctions d'agrégation : des sommes, des moyennes, des décomptes...
Vous pouvez regarder la vidéo, ou les explications en dessous de la vidéo.
La classe views permet d'afficher des vues. Il faut donc commencer par la charger
use Drupal\views\Views;
Ensuite on récupère la vue
$view = Views::getView('liste_livre');
Enfin on génère le render array
L'objectif de cet article est de vous montrer comment utiliser, dans les vues, des fil