Partie 12 — Annexes
Références rapides, glossaire, pièges classiques, ressources et plan de carrière. Cette partie est faite pour être consultée plus que lue : gardez-la ouverte dans un onglet pendant que vous travaillez sur les parties 1 à 11.
Version de référence : Moodle 5.2 (avril 2026, PHP 8.3+, Bootstrap 5). Les branches git et numéros de version cités correspondent à cette version.
Sommaire
| Chapitre | Fichier | Contenu | Quand l’utiliser |
|---|---|---|---|
| 1 | 01-glossaire.md | Glossaire trilingue : terme d’interface FR / terme d’interface EN / nom dans le code (+ table de base de données quand pertinent). Plus de 150 entrées, acronymes inclus (AMOS, MUC, DML, XMLDB, AGS, NRPS, MDL-, HQ, CiBoT…). | Chaque fois qu’un terme de l’interface française ne « matche » pas ce que vous voyez dans le code ou dans la doc anglaise. |
| 2 | 02-cheatsheets.md | Cheatsheets copiables : toutes les méthodes $DB (DML), pattern de page sécurisée, squelettes de plugins local/block/mod, top 30 moosh, CLI admin, moodle-docker, appels REST (curl + TypeScript), fonctions WS les plus utiles, snippets Mustache/AMD/core-ajax, branches git. | Au quotidien, pendant que vous codez. C’est le chapitre à épingler. |
| 3 | 03-pieges-faq.md | Top ~30 pièges du débutant Moodle venant du monde JS/React, chacun avec sa solution, suivi d’une FAQ franche (headless ? Composer ? hot reload ? pourquoi PHP ?). | Quand « ça ne marche pas et je ne comprends pas pourquoi ». 9 fois sur 10, la réponse est ici (souvent : purgez les caches). |
| 4 | 04-ressources.md | Ressources annotées : moodledev.io, docs.moodle.org, Moodle Academy, tracker, forums, dépôts GitHub à connaître, plugins exemplaires à lire, blogs actifs, communauté francophone, livres. | Quand cette documentation ne suffit plus et qu’il faut aller à la source. |
| 5 | 05-parcours-carriere.md | Parcours d’apprentissage semaine par semaine (avec renvois vers les parties 1–11 et projets jalons), auto-évaluation débutant/confirmé/expert, marché du travail Moodle (salaires, TJM), certifications, comment contribuer au core. | Au début (pour planifier) et régulièrement (pour vous situer). |
Comment lire ces annexes
- Le glossaire (ch. 1) résout le problème n°1 du dev francophone : l’interface dit « Devoir », la doc dit « Assignment », le code dit
mod_assignet la table s’appellemdl_assign. Ce chapitre fait la correspondance systématiquement. - Les cheatsheets (ch. 2) sont volontairement tabulaires et copiables. Chaque snippet a été aligné sur les API de Moodle 5.2 ; les points qui varient selon les versions sont signalés.
- Les pièges (ch. 3) sont classés par domaine (caches, plugins, formulaires, JS, sécurité, WS/LTI). Si vous ne lisez qu’une chose de cette partie, lisez les pièges 1 à 5.
- Les ressources (ch. 4) sont annotées avec le niveau visé : 🟢 débutant, 🟡 confirmé, 🔴 expert.
- Le parcours (ch. 5) reprend le tableau du README racine et le détaille semaine par semaine avec des livrables concrets et vérifiables.
Rappels transverses (valables partout)
Trois réflexes à ancrer avant même d’ouvrir les autres chapitres :
- Purger les caches après tout changement de code :
php admin/cli/purge_caches.php(ouAdministration du site → Développement → Purger les caches). Moodle met en cache les chaînes de langue, les templates Mustache, le JavaScript compilé, la liste des plugins… Un changement « qui ne s’applique pas » est presque toujours un cache. - Bumper
version.phpde votre plugin pour que Moodle rejouedb/upgrade.php, rechargedb/access.php,db/services.php, etc. - Chercher en anglais. La communauté, le tracker et la doc développeur sont anglophones. Le glossaire du chapitre 1 vous donne le bon terme de recherche.
Retour au README général.