Attention : vous consultez actuellement la documentation dédiée aux versions 1.x de Moodle. La documentation pour les versions 2.x de Moodle est consultable ici : Blocs (développeur), celle pour les versions 3.x de Moodle est consultable ici : Blocs (développeur) et celle pour Moodle 4.x est consultable là : Blocs (développeur).

Blocs (développeur)

De MoodleDocs
Révision datée du 23 mars 2009 à 13:58 par Aurélie M (discussion | contributions) (traduction commencée)
Aller à :navigation, rechercher

Remarque : la traduction de cet article n'est pas terminée. N'hésitez pas à traduire tout ou partie de cette page ou à la compléter. Vous pouvez aussi utiliser la page de discussion pour vos recommandations et suggestions d'améliorations.


Un guide pas à pas pour créer des blocs

Le présent document est un guide qui s'adresse aux développeurs désireux de créer leur propres blocs dans Moodle. Il s'applique seulement à la version 1.5 de Moodle (et plus récentes), étant donné que le sous-système de blocs a été réécrit et étendu à la sortie de la 1.5. Toutefois, vous pouvez aussi le trouver utile si vous voulez modifier des blocs écrits pour Moodle 1.3 et 1.4 et les rendre compatibles avec les dernières versions (voir Annexe B).

Ce guide a été écrit comme un cours interactif dont le but est de développer un bloc configurable qui affiche du HTML arbitraire. Il vise principalement les personnes avec peu d'expérience sur Moodle ou la programmation en général et vise à montrer comment il est facile de créer de nouveaux blocs pour Moodle, bien qu'un minimum de connaissances en PHP soit toujours requis.

Les développeurs expérimentés et ceux qui veulent juste un texte de référence peuvent se référer à l' Annexe A, ce guide principal ayant une plutôt faible concentration d'information brute.


Basic Concepts

Through this guide, we will be following the creation of an "HTML" block from scratch in order to demonstrate most of the block features at our disposal. Our block will be named "SimpleHTML". This does not constrain us regarding the name of the actual directory on the server where the files for our block will be stored, but for consistency we will follow the practice of using the lowercased form "simplehtml" in any case where such a name is required.

Whenever we refer to a file or directory name which contains "simplehtml", it's important to remember that only the "simplehtml" part is up to us to change; the rest is standardized and essential for Moodle to work correctly.

Whenever a file's path is mentioned in this guide, it will always start with a slash. This refers to the Moodle home directory; all files and directories will be referred to with respect to that directory.