Installation des modules Drupal 8
Installez un ou plusieurs modules pour modifier, étendre ou améliorer Drupal avec des fonctionnalités supplémentaires.
Connaissances requises
Étape 1 : Obtenir le module
Si le module que vous souhaitez installer fait partie du noyau Drupal, vous pouvez passer à l’étape suivante.
Pour installer un module, vous devez d’abord obtenir le code du module que vous souhaitez installer. La méthode recommandée pour ajouter une dépendance à votre projet est d’utiliser Composer. Cela suppose que vous gérez déjà votre projet avec Composer.
Pour ajouter un module, commencez par identifier son nom court. Il correspond à la dernière partie de l’URL de la page du projet. Par exemple, le module Geofield à l’adresse https://www.drupal.org/project/geofield a pour nom court geofield.
Pour télécharger un module contrib avec ses dépendances, tapez la commande suivante à la racine de votre site (en remplaçant geofield par le nom court du module) :
composer require drupal/geofield
Après l’exécution de la commande, vous devriez voir un message indiquant que le module a été ajouté en tant que dépendance dans votre fichier composer.json et que le code correspondant a été téléchargé.
Pour plus d’informations et une démonstration vidéo, consultez : Utiliser Composer pour télécharger et mettre à jour des fichiers et Télécharger des modules et thèmes avec Composer.
Les autres méthodes pour obtenir un module incluent :
- Télécharger manuellement le fichier .zip ou .tar.gz
- Utiliser le gestionnaire de mises à jour intégré à Drupal
Étape 2 : Activer le module
Utilisation de l’interface Drupal :
- Allez sur la page « Étendre » (admin/modules) via le menu « Gestion ».
- Trouvez le(s) module(s) que vous souhaitez activer et cochez la case à côté de chacun.
- Cliquez sur « Installer » pour activer le(s) nouveau(x) module(s).
Utilisation de Drush :
drush en geofield
Pour plus d’informations et une démonstration vidéo, consultez : Télécharger et installer un module depuis Drupal.org et Installer des modules en ligne de commande.
Informations supplémentaires
Organisation du stockage des modules
Drupal recherche les modules à plusieurs endroits : le répertoire racine /modules (préféré) ou /sites/*/modules. Dans ces emplacements, Drupal parcourt tous les sous-répertoires à la recherche de modules.
La pratique courante consiste à ajouter tous les modules téléchargés depuis Drupal.org dans /modules/contrib, et tous les modules contenant du code personnalisé spécifique au projet dans /modules/custom.
Plusieurs modules regroupés dans un seul projet
En général, un projet (par exemple https://drupal.org/project/devel) contient plusieurs modules. Chaque module du projet sera listé et peut être activé individuellement sur la page Étendre.