# Extension e-learning : suivre la progression d’un cours sans LMS complet

> Trois actions suffisent souvent à suivre une progression de cours en ligne : voir la leçon, la marquer terminée, reprendre où on s'était arrêté. Pas besoin d'installer LearnDash pour ça.

- Auteur : WordPress Développement
- Publié le : 2022-01-23
- Mis à jour le : 2022-01-23
- Catégorie : Extensions
- URL : https://www.wpmoderne.fr/extensions/extension-elearning-suivre-progression-sans-lms/

## L’essentiel

- Un CPT « leçon » avec un champ d'ordre suffit à structurer un parcours
- Le suivi de complétion tient dans une seule table de progression par utilisateur
- Un LMS complet ajoute des fonctionnalités souvent inutilisées sur un petit catalogue

Combien de fonctionnalités d'un LMS complet comme LearnDash ou LifterLMS sont réellement utilisées sur un catalogue de dix à vingt leçons ? Sur un projet client récent dans le secteur de la formation professionnelle, la réponse a été : très peu. Le client avait besoin de trois actions précises — afficher une leçon, la marquer comme terminée, reprendre le parcours là où l'apprenant s'était arrêté — sans les quiz notés, les certificats, les groupes d'apprenants ou les parcours conditionnels que propose un LMS complet, avec le poids et la complexité d'administration que cela implique.

Construire un module léger sur mesure, plutôt que d'installer et de configurer un LMS complet pour n'en utiliser qu'une fraction, s'est révélé plus rapide à livrer et plus simple à maintenir pour un catalogue de cette taille. Ce choix ne convient évidemment pas à tous les projets : au-delà d'une certaine complexité pédagogique (quiz, prérequis conditionnels, certificats), un LMS établi redevient le bon choix.

## Structurer le parcours avec un CPT et un champ d'ordre

Le cœur du module repose sur un CPT `lecon`, hiérarchisé par un champ numérique d'ordre plutôt que par la hiérarchie native des pages, plus rigide à requêter :

```
register_post_type( 'lecon', [
    'label' => 'Leçons',
    'public' => true,
    'show_in_rest' => true,
    'supports' => [ 'title', 'editor', 'thumbnail' ],
    'has_archive' => false,
] );

register_post_meta( 'lecon', 'ordre_parcours', [
    'type' => 'integer',
    'single' => true,
    'show_in_rest' => true,
] );
```

Le champ `ordre_parcours` permet de récupérer l'ensemble des leçons d'un cours triées dans l'ordre pédagogique voulu, via `meta_key` et `orderby => 'meta_value_num'` dans une `WP_Query`, sans dépendre de l'ordre de création des articles.

## Enregistrer la complétion d'une leçon

Le suivi de progression tient dans une seule table personnalisée, associant un utilisateur, une leçon et un horodatage de complétion. Une table dédiée évite d'alourdir `wp_usermeta` avec des dizaines d'entrées sérialisées difficiles à requêter en masse :

> L'essentiel à retenir : Un CPT « leçon » avec un champ d'ordre suffit à structurer un parcours ; Le suivi de complétion tient dans une seule table de progression par utilisateur ; Un LMS complet ajoute des fonctionnalités souvent inutilisées sur un petit catalogue

```
CREATE TABLE {$wpdb->prefix}elearning_progression (
  id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
  user_id BIGINT UNSIGNED NOT NULL,
  lecon_id BIGINT UNSIGNED NOT NULL,
  terminee_le DATETIME NOT NULL,
  UNIQUE KEY user_lecon (user_id, lecon_id)
) {$charset_collate};
```

La contrainte `UNIQUE KEY` sur la paire utilisateur/leçon évite les doublons et simplifie la logique d'enregistrement : une requête `INSERT ... ON DUPLICATE KEY UPDATE` suffit à marquer une leçon terminée, qu'elle l'ait déjà été ou non.

### Le point d'entrée AJAX de complétion

La marque de complétion se déclenche depuis le front, via un point d'entrée AJAX authentifié :

```
add_action( 'wp_ajax_marquer_lecon_terminee', function () {
    check_ajax_referer( 'elearning_progression', 'nonce' );

    $lecon_id = absint( $_POST['lecon_id'] ?? 0 );
    if ( ! $lecon_id || ! get_post( $lecon_id ) ) {
        wp_send_json_error( 'Leçon introuvable.' );
    }

    global $wpdb;
    $wpdb->query( $wpdb->prepare(
        "INSERT INTO {$wpdb->prefix}elearning_progression (user_id, lecon_id, terminee_le)
         VALUES (%d, %d, NOW())
         ON DUPLICATE KEY UPDATE terminee_le = NOW()",
        get_current_user_id(), $lecon_id
    ) );

    wp_send_json_success();
} );
```

## Calculer un pourcentage de progression global

Le pourcentage affiché à l'apprenant se calcule simplement en comparant le nombre de leçons terminées au nombre total de leçons du cours, sans nécessiter de logique complexe de pondération — sauf si le client demande explicitement des leçons à poids variable, auquel cas un champ `poids_lecon` supplémentaire suffit :

- Compter les leçons terminées pour l'utilisateur courant via une requête `COUNT` sur la table de progression.
- Diviser par le nombre total de leçons du cours obtenu via `WP_Query`.
- Mettre en cache ce calcul dans un transient de courte durée si le module est affiché sur une page à fort trafic.

## Reprendre le parcours là où l'apprenant s'est arrêté

La fonctionnalité « reprendre » consiste simplement à identifier, parmi les leçons triées par `ordre_parcours`, la première qui n'apparaît pas encore dans la table de progression de l'utilisateur. Aucune notion de session complexe n'est nécessaire : la table de progression fait déjà foi.

> Sur ce projet, le client avait initialement demandé LearnDash par réflexe, avant de réaliser qu'aucune de ses fonctionnalités de quiz ou de certification n'était utile à son catalogue. Le module sur mesure a coûté moins cher à développer que la configuration seule d'un LMS complet.

## En résumé

Un suivi de progression de cours en ligne ne justifie pas systématiquement l'installation d'un LMS complet. Pour un catalogue de leçons linéaires sans quiz noté ni certification, un CPT ordonné, une table de progression dédiée et un point d'entrée AJAX de complétion couvrent l'essentiel du besoin, avec une charge d'administration bien moindre pour l'équipe pédagogique du client.