Développement:Modules
Les modules d'activités se trouvent dans le dossier mod. Chaque module dispose de son propre sous-dossier qui inclut les éléments suivants obligatoires (avec des scripts supplémentaires spécifiques à chaque module) :
- mod.html - une page web pour configurer ou modifier une instance du module
- version.php - précise des méta-informations, par exemple les numéros de versions
- icon.gif - une icône 16x16 pour le module
- db/ - les commandes SQL pour les tables de la DB nécessaires au module
- index.php - une liste des instances pour un cours spécifique (par exemple tous les forums)
- view.php - une page pour visualiser une instance
- lib.php - toutes les fonctions de ce module.
Supposons qu'un module s'appelle widget :
- widget_add_instance() - fonction pour ajouter une nouvelle instance de widget
- widget_update_instance() - fonction pour mettre à jour une instance
- widget_delete_instance() - fonction pour supprimer une instance
- widget_user_outline() - pour chaque instance, retourne un résumé des contributions
- widget_user_complete() - pour une instance, affiche les détails des contributions d'un utilisateur
- Autres fonctions (optionnelles) :
- widget_delete_course() - code pour nettoyer les éléments restant après la suppression de toutes les instances
- widget_process_options() - code pour traiter les informations de configuration
- Le nom de toutes les fonctions du module doit commencer par widget_ et le nom de toutes les constantes définies débute avec WIDGET_
- config.html - (optionnel) une page permettant la configuration du module
- Enfin, chaque module disposera de fichiers de langue qui contiennent les chaînes de caractères appropriées.
Important : quand vous créez un nouveau module, son nom ne doit pas contenir de chiffres.
Par ailleurs, vous devez vous assurer que votre module d'activité supporte les groupes et les méta-cours.
Voir aussi
- NEWMODULE.zip - un modèle de module pour construire un nouveau module. Lisez les instructions du fichier README contenu dans l'archive.
- Forum Activity modules du cours Using Moodle (en anglais)