Voilà, voilà... Fin de l'aventure...

 

Fermeture de kolossaldrupal.org dans...


Bonjour tout le monde,

Drupal évolue, les versions changent et Kolossaldrupal.org était essentiellement consacré à la version 6 de Drupal.

Autant dire que les infos présentées ici commencent à dater...

Faute de temps, je ne peux plus garder le site Kolossaldrupal à jour...

Je vous aurais bien proposé de reprendre le flambeau mais... c'est tellement simple de nos jours de se faire son propre site à soi...Pourquoi s'embêter alors ? :-)

Ce site restera donc en l'état, tel qu'il était en 2011...

Ah la la ! Cela ne nous rajeunit pas !

Manuel Vila - Avril 2016

Création de modules : un tutoriel Drupal 6.x

Référence en anglais sur drupal.org : 18 Juin 2009 - 23h01 - http://drupal.org/node/206753


Ce tutoriel explique comment créer un module pour Drupal 6. C'est une mise à jour du tutoriel pour Drupal 5. Une grande partie de ce tutoriel est aussi valable pour Drupal 5, mais vous devriez vérifier la documentation de l'API ainsi que la documentation sur comment mettre à jour vos modules d'une version Drupal vers une autre.

Un module est une collection de fonctions qui s'enchaînent dans Drupal, lui fournissant des fonctionnalités supplémentaires. Après la lecture de ce tutoriel, vous pourrez créer un module pour un bloc élémentaire et l'utiliser comme modèle pour des modules plus sophistiqués et des modules de nodes.

Ce tutoriel ne vous préparera probablement pas à l'écriture de modules que vous lâcherez dans la nature. Il ne traite pas des mises en cache ni des questions de sécurité ou des droits. Utilisez-le comme point de départ et jetez un œil aux autres modules, au Manuel Drupal, à la documentation sur l'écriture de code sécurisé et sur les Normes de programmation.

Ce tutoriel suppose que vous avez :

  • des connaissances de base en PHP, y compris sur la syntaxe et les concepts d'objets PHP,
  • une certaine compréhension des tables de bases de données, des champs, enregistrement et des instructions SQL,
  • une installation Drupal en fonctionnement,
  • un accès à un serveur web.

Ce tutoriel ne part pas du principe que vous connaissez le fonctionnement interne d'un module Drupal. Il ne vous aidera pas à écrire des modules pour les versions Drupal antérieures à la 5.

Pour la mise en cache, voir Cache API and caching tutorials.

Plan

Ce tutoriel expose une par une les étapes nécessaire pour la création d'un module qui affiche un bloc listant les dernières parutions de blog et de forums de discussion. Voici les grandes lignes de ce qui sera traité dans chaque page du tutoriel :

  • Démarrer: création d'un dossier pour votre module et pour le premier fichier .module
  • Communiquer votre module à Drupal : création d'un fichier .info pour votre module, et implémentation de hook_help() pour fournir au système d'aide de Drupal une brève description de votre module
  • Dire à Drupal qui peut utiliser votre module : implémentation de hook_perm(), qui déclare les types de droits pour votre module
  • Déclarer le bloc de contenu : début de l'implémentation de hook_block(), cette partie informe Drupal que le module déploie un bloc
  • Générer le bloc de contenu : fin de l'implémentation de hook_block(), la partie qui affiche le contenu du bloc. Cela implique l'exécution d'une requête sur la base de données pour récupérer les posts récent de blog et de forum, et leur affichage
  • Installation, activation et test du module : on fait bosser le module
  • Création de la page de configuration du module : modification du module pour que l'utilisateur donne un sens à « récent », en implémentant un hook_menu() et en utilisant l'API Form de Drupal pour déclarer une page de configuration.
  • Générer une page de contenu : ajouter une pleine page vue au module, dans le cas où il y aurait davantage des posts récents qui s'afficheront mieux que dans le bloc - 1ère partie : écrire une fonction qui génère la page
  • Informer Drupal de l'existence de cette nouvelle fonction : 2ème partie sur l'ajout de la page au module, utilisation de hook_menu() pour donner une URL à la page
  • Ajouter un lien « en voir plus » et afficher toutes les entrées : 3ème partie sur l'ajout d'une page d'affichage au module, associer la nouvelle URL au lien « en savoir plus » du bloc