Comprendre l'architecture Drupal

 

 

Voici une liste des principaux dossiers et modules que vous trouverez dans Drupal Core :

Voici un fichier à ne pas toucher : c'est le point d'entrée de Drupal. C'est par là que tout commence lorsque quelqu'un veut consulter une page de votre site.

Ce dossier contient un ensemble de répertoires et de fichiers nécessaires au fonctionnement de Drupal. Il est très important de bien comprendre qu'il ne faut pas toucher à quoi que ce soit dans ce dossier. Ne pas le déplacer ni renommer ce qu'il y a dedans, ne rien modifier, bref NE PAS TOUCHER !

Je vais vous présenter très brièvement la structure des sous-dossiers de ce répertoire core, mais rien à retenir ici, c'est pour votre culture !

Dans ce dossier se trouvent les fichiers de diverses librairies javascript incluses dans le core de Drupal. Pour les connaisseurs, on retrouve les classiques JQuery et JQuery UI, mais aussi Backbone, CKEditor et bien d'autres. Évidement, on y touche pas !

Ce dossier contient un ensemble de fichiers ".inc". Chacun de ces fichiers contient le code d'un outil ou d'une fonctionnalité de base de Drupal core ne faisant partie d'aucun module (par exemple, DatabaseAPI qui regroupe l'ensemble des fonctions permettant de se connecter à la base de donnée). Vous n'aurez pas à toucher quoi que ce soit dans ce dossier.

Ce dossier contient du code propre à Drupal également nécessaire à son fonctionnement. Pour les connaisseurs, Drupal 8 a été réécrit en PHP orienté objet. Ici se trouvent majoritairement les définitions de classes.

Ce dossier contient les ressources graphiques et javascript de votre site web. En d'autres mots, ce sont de petites icônes (dont l'extension est souvent .png) utilisée dans votre site : des bordures, des cadres, des fonds dégradés, des puces, des petits symboles, etc... Les fichiers javascript permettent quant à eux des manipulations et interactions avec le site "après chargement" de la page. Un bon exemple est la zone déroulante ci-dessous:

Là encore, si vous ne retenez pas tout, ce n'est pas grave ! Ne retenez qu'une chose: on touche à rien là dedans !

Drupal est modulaire: son architecture s'articule autour de modules, chacun apportant une fonctionnalité supplémentaire à l'ensemble. Dans ce dossier se trouvent les modules dit "core", c'est à dire fournis de base avec Drupal. Certains sont activés obligatoirement (comme le module permettant la gestion des utilisateurs !), d'autres sont facultatifs. Contrairement à ce que le nom de ce dossier pourrait laisser penser, ce n'est PAS ici que nous placerons les modules que nous installerons sur notre site. Ce dossier étant réservé aux modules de Drupal core. Ne retenez encore une fois que ceci: on touche à rien !

Ce dossier contient des profils d'installations préétablis, permettant un déploiement rapide d'un site préconfiguré. Par défaut, Drupal 8 propose les profils minimal (seuls les modules strictement nécessaires sont activés), standard (c'est l'installation de Drupal la plus courante) et testing (utilisant des modules supplémentaires spécialement conçus pour le test et le développement). Ce dossier contient les fichiers suivants :

+ minimal

   + config

   + lib

   - minimal.info.yml

   - minimal.install

   - minimal.profile

+ standard

  + config

  + lib

   - standard.info.yml

   - standard.install

   - standard.profile

+ testing

   + config

   + lib

   - testing.info.yml

   - testing.install

   - testing.profile

Dans chaque dossier de profil se trouve :

Contient des scripts d'exécution un peu particuliers pour des opérations de maintenance principalement. Nous n'avons pas à en savoir plus à ce stade d'autant qu'encore une fois ici, on ne touche à rien !

Comme son nom l'indique, ce sont des tests -dit tests unitaires- pour vérifier le bon fonctionnement de Drupal. Encore une fois, on touche à rien !

Les thèmes de base (apparence visuelle de votre site, les couleurs, les formes, les placements etc...) sont contenus dans ce dossier. Nous n'y toucherons pas. Le (ou les) thème personnalisé(s) de notre site ne sera(seront) pas contenu(s) ici !

Voici un nom de dossier bien étonnant, n'est-ce pas ? C'est ici qu'est conservé, bien séparé du reste, le code provenant des librairies Open-Sources (telles Symphony 2) utilisées par Drupal. Encore un dossier de plus à ne pas toucher.

Le fichier d'installation de Drupal. Il est séparé du reste de Drupal puisqu'il est censé l'installer: lorsqu'on l'utilise, Drupal n'existe pas encore !

C'est le fichier d'exécution des mises à jour de Drupal. Séparé lui aussi de Drupal, il s'exécute indépendamment de l'installation pour être capable de résoudre certains problèmes, notamment liés à la mise à jour de votre site et de ses modules. Là encore, on touche pas !

Ce petit fichier n'a rien à voir avec Drupal : il permet d'expliquer aux robots d'explorations comment naviguer sur votre site. Pour que votre site soit inclus dans Google par exemple, un robot, c'est à dire un petit programme automatique, va naviguer sur votre site et indexer son contenu dans les bases de données de Google. Avec ce petit fichier, vous pouvez ordonner aux robots de ne pas visiter votre site, ou de ne pas visiter certaines pages de votre site, souvent par mesure de sécurité - notamment pour les pages d'administrations qui ne sont pas accessibles aux utilisateurs, mais bien uniquement à vous.

Pour ajouter des fonctionnalités à notre site, nous utiliserons des modules Drupal additionnels appelés modules contributeurs. C'est dans ce dossier que nous les placerons ! Voilà enfin un endroit que l'on peut donc toucher. A vrai dire, il faudra même retenir que lorsque l'on parlera du dossier modules de votre installation, c'est à celui-ci que l'on fera référence.

Idem pour les thèmes additionnels que nous souhaiterions installer pour notre site. C'est ici qu'ils seront placés !

Je vous ai précédemment parlé des profils dans le dossier Core. Sachez que l'on peut en télécharger d'autres pour répondre à divers besoins. Par exemple un profil comme "Commerce QuickStart" permettra en quelques clics de transformer Drupal en un site d'eCommerce prêt à l'emploi : les bons modules et les bonnes configurations seront faites à votre place ! Notez qu'un profil doit être installé en même temps que Drupal : il faut donc y penser dès le début ! Après, c'est trop tard.

Voilà LE dossier intéressant de Drupal pour nous. C'est ici que se placera tout ce qui fera la spécificité de notre site web : nos images, nos vidéos, les modules que nous voulons installer sur notre site... Bref, tout ce qui n'est pas fourni de base avec Drupal. Pour l'instant il contient deux dossiers: all et default. Nous verrons dans le prochain article comment s'en servir.