Fonctions essentielles

Voici une liste de fonctions importantes du code du logiciel Moodle.

La quasi totalité de ces fonctions se trouvent dans le répertoire lib.

Fonctions relatives à la localisation

• get_string() - va chercher la chaîne de caractères dans le paquetage de langue sélectionné par l'utilisateur
• print_string() - imprime la chaîne de caractères dans le paquetage de langue sélectionné par l'utilisateur
• print_error() - imprime un message d'erreur, en étant allé le chercher dans le paquetage de langue

Fonctions interrogeant le statut de l'utilisateur

• isadmin() - vérifie si l'utilisateur est un administrateur du site

On remplace de plus en plus cette dernière par le test de la capacité "moodle/site:doanything" :

   $context = get_context_instance(CONTEXT_SYSTEM);
   has_capability('moodle/site:doanything', $context);

• isloggedin() - vérifie si l'utilisateur est loggué
• isguest() - vérifie si l'utilisateur n'est pas en statut "d'invité"

Fonctions d'impression et de génération de HTML

• print_header() - ajoute l'en-tête de la page
• print_footer() - ajoute le bas de page

• print_table() - imprime une table formattée sur la base d'une structure la décrivant.
• print_tabs() - imprime une ou plusieurs rangées d'onglets avec un système pour les utiliser comme barre de navigation

Fonctions d'accès au modèle de données

• get_records() - récupère une hash d'enregistrements choisis
• get_record() - récupère un enregistrement particulier

• get_records_select()
• get_record_select()

mêmes fonctions que précédemment, mais permet d'écrire la clause SELECT à la main.

• get_records_sql()
• get_record_sql()

mêmes fonctions que précédemment, mais permet d'écrire la totalité de la requête SQL.

• get_records_menu() - permet d'obtenir directement le tableau d'options d'une liste déroulante à partir d'un lot d'enregistrements choisis.

• get_records_list() - permet d'obtenir les enregistrements à partir d'une liste d'id (typiquement id IN (liste)).

• insert_record() - permet d'ajouter un nouvel enregistrement. Retourne le dernier "id" créé en base de données.
• update_record() - permet de mettre à jour un enregistrement. L'objet passé DOIT avoir un membre "id".

• delete_records() - permet de détruire des enregistrements

ATTENTION : Certaines de ces fonctions ont changé avec le remodelage de la librairie d'accès à la base de données. Si vous développez en vue d'une intégration pour du Moodle 2.0, vous devrez tenir compte de ces nouvelles formes

Les pages de fonctions

weblib - toutes les fonctions qui produisent une sortie en code HTML

Voir aussi

• référence complète des fonctions de Moodle
• en:Output functions