Installer un module

Version imprimableEnvoyer à un amiversion PDF

Préliminaire (DRUPAL 6.x)

Ouvrez le répertoire SITES de Drupal, puis le sous-répertoire ALL. Créez ici un répertoire MODULES.

créer son répertoire modules pour les nuls

C'est a priori dans ce dernier que vous installerez les modules. Si vous gérez plusieurs sites avec une même installation de Drupal [sur ce point référez-vous à la documentation existant par ailleurs], vous pourrez créer un sous-répertoire MODULES dans le répertoire de chacun de vos sites ; les modules que vous y mettrez ne seront utilisables que sur le site concerné.

Un module se présente sous la forme d'un fichier à l'extension .tar.gz ; une fois décompressé (avec le logiciel 7-zip par exemple), il s'agit d'un répertoire qui porte le nom du module, et contient tous les fichiers et sous-répertoires nécessaires.

Installation et activation

Téléchargez le fichier .tar.gz du module sur la page du site drupal.org correspondante. Décompressez et chargez le répertoire dans sites/all/modules.

Sur votre site Drupal, rendez-vous sur la page ...admin/build/modules. En principe, vous devriez voir votre module (qui peut être un ensemble de modules à lui tout seul). Cochez la case pour l'activer, puis sauvegardez.

Il faudra peut-être activer d'autres modules (dont celui que vous avez choisi est dépendant) pour qu'il fonctionne. Cela est indiqué en petits caractères sous la description du module.

activation du module Views

Exemple : Views est un ensemble de 3 modules.

Ici le module principal est activé et ne peut être désactivé car il est requis par Views UI
(il faut désactiver Views UI pour désactiver Views)
La liste des modules "Dépend de" ou "Requis par :" est fonction des modules présents sur votre site.

Et après ?

Une fois le module activé, le premier réflexe à avoir est d'aller sur la page d'administration par module (admin/by-module) pour paramétrer le module. Mais certains modules ne se paramètrent pas par là : examinez votre menu "navigation", la page d'administration des blocs (des modules en génèrent automatiquement), la page des permissions / droits d'accès ...

Les bugs à l'activation de modules

"Fatal error: Allowed memory size exceeded"

Celui-ci est très courant (et peut intervenir à d'autres moments que l'activation de modules) : après avoir mouliné, Drupal affiche  un message d'erreur "Fatal error: Allowed memory size of ... bytes exceeded...". Cela vient de la gourmandise de Drupal en ressources : il faut lui allouer davantage de mémoire

  • dans le fichier php.ini, indiquez par exemple "memory_limit = 64M"
  • si vous ne pouvez pas modifier ce fichier (hébergement mutualisé), indiquez ini_set('memory_limit', '64M'); dans le fichier sttings.php de Drupal
  • si vous ne pouvez pas augmenter la taille de la mémoire allouée, changez d'hébergeur ! ou au moins de contrat d'hébergement

On peut parfois s'en sortir en activant moins de modules à la fois.

Page blanche

Un module mal codé peut transformer la page d'administration des modules en page blanche.

Solution barbare : touche "précédent" de votre navigateur, décochez tous les modules que vous venez d'activer, sauvegardez, puis réactivez un par un pour identifier le module qui pose problème. Voyez ensuite les rapports de bugs associés à ce module.

Autre solution barbare : désactivez le module depuis votre base de données en basculant son status de 1 à 0 dans la table "system".