Vous êtes ici

Accueil » Programmer » Mon premier module Drupal 8 : Hello World !
07 Jan 2014

Créer un nouveau module pour Drupal via Eclipse

Vous avez 30 secondes ?
Répondez à notre sondage : Quelle priorité pour les tutoriaux Drupal-Addict ?
S'abonner au flux d'actualités
Rubrique: 
Technique
Difficultée: 
Facile
En commençant ce tutoriel, vous avez mis en place votre environnnement de travail, téléchargé les sources de Drupal 8 et préparer votre configuration de debug.
 
De la même façon que lors du téléchargement des sources de Drupal 8 :
  • Effectuez un clic-droit sur le PHP Explorer ( dans la partie gauche de Eclipse).
  • Créer un nouveau projet PHP : New -> Project
  • Choisissez PHP -> PHP Project.
  • Puis cliquez sur Next.
Créer un nouveau projet PHP.
  • Choisissez un nom pour votre projet dans la case Project name.
  • Choisissez l'option Create project at existing location.
  • Indiquez l'emplacement du dossier module de votre installation Drupal 8 suivi du nom en minuscule sans espace de votre module.
  • Cliquez sur Finish.
Créer le projet pour notre module.
Le dossier modules de Drupal 8 se trouve à la racine de votre installation Drupal. N'oubliez pas d'entrer le nom d'un répertoire pour votre module à la fin de ce chemin. Par convention, le nom de ce répertoire est le nom dit "machine" de votre module. C'est un nom unique, en minuscules et sans espaces.
Le nom machine de votre module doit être unique et sans espaces. Afin d'éviter les soucis de compatibilité entre deux modules de même nom, la convention est d'utiliser comme nom machine pour votre module le nom utilisé dans l'URL du module sur Drupal.org. En d'autres termes, avant de créer un nouveau module, vérifiez que nom_du_module choisi n'existe pas déjà en vérifiant que la page https://drupal.org/project/le_nom_choisi n'existe pas encore.
Vous devriez désormais disposer d'un nouveau projet vide pour votre module.
Nouveau projet Eclipse vide pour notre module.
 
Ajoutons les dépendances vers Drupal 8 afin de bénéficier au maximum des fonctionnalités d'Eclipse.
  • Effectuez un clic-droit sur le projet de votre module, puis Properties.
  • Choisissez à gauche les options PHP Include Path.
  • Sélectionnez l'onglet Projects.
  • Cliquez sur le bouton Add...
  • Dans la popup, sélectionnez le projet correspondant à votre installation Drupal 8.
  • Cliquez sur OK.
  • Validez votre configuration en cliquant sur OK.
Inclure les dépendances Drupal 8 au projet de notre module.
 
En résumé...
 
Votre module doit être placé dans le dossier modules de votre installation Drupal. Tous les fichiers de ce module seront contenus dans un dossier dont le nom sera le "nom machine" du module. Ce nom machine doit être unique et sans espaces. 
Avant de créer un nouveau module, vérifiez que nom_du_module choisi n'existe pas déjà en vérifiant que la page https://drupal.org/project/le_nom_choisi n'existe pas encore.
Notation: 
Average: 4 (3 votes)
Vous avez aimé: 
Faites un don !

Commentaires

Salut !
Quand je crée mon projet HelloWorld, je n'ai pas les données "Javascript Ressources", "PHP include path", et "PHP include library". Cela peut il entraver mes dev? Comment y remédier?
 
Mon arbo est la suivante :
C:\wamp\www\TutoDrupalAddict --> install drupal (avec tous les rep Core, modules, profiles, site ...)
C:\wamp\www\TutoDrupalAddict\modules\hello_world
This post is useful!
This post is useless!

Bonjour, 
"Javascript Ressources", "PHP include path", et "PHP include library" sont ajoutés dans l'arborescence du workspace par Eclipse, mais pas dans l'arborescence des fichiers. Ce sont des données propres au fonctionnement de cet IDEinfo-icon permettant de configurer/gérer le projet. Inutile donc de les chercher dans C:/wamp/... et inutile de s'inquiéter.
Je suis surpris qu'ils n'apparaissent pas dans Eclipse comme sur le screenshot, mais cela ne posera toutefois pas de soucis sur la création et l'utilisation du module par la suite. Vous pouvez d'ailleurs normalement suivre ce tutoriel et les suivants sans soucis.
This post is useful!
This post is useless!