Se connecter Commencer

Documentation

Tout ce qu'il faut savoir pour utiliser, administrer et faire évoluer la plateforme Al-Miftah.

Pour l'élève : bien démarrer

  1. Créez un compte avec un simple pseudonyme et un mot de passe (aucun e-mail requis).
  2. Passez le test de positionnement si vous avez déjà des bases — sinon commencez par l'alphabet puis la leçon 1.
  3. Chaque leçon = un cours (à lire et écouter) puis des exercices (à jouer). Lisez toujours l'explication : elle s'affiche même quand vous avez juste.
  4. Visez 30 à 60 minutes par jour. La régularité (votre série 🔥) compte plus que la durée.

Écrire en arabe (clavier)

Pour les exercices d'écriture, activez un clavier arabe :

  • Windows : Paramètres → Heure et langue → Langue → Ajouter « العربية ». Basculez avec Alt+Maj.
  • Android / iPhone : Réglages → Clavier → Ajouter le clavier arabe, puis appuyez sur 🌐.
  • Sans installer : utilisez un clavier arabe en ligne (lexilogos) et copiez-collez.

Astuce : nos exercices d'écriture acceptent les réponses avec ou sans les voyelles (harakat).

Polices : classique et indo-pakistanaise

Via le bouton 🎨 (en haut), section « Écriture arabe », vous choisissez parmi plusieurs polices de référence :

  • Amiri (naskh classique) : police par défaut, élégante, proche des éditions du Coran.
  • Scheherazade (lecture) : police SIL très lisible, excellente pour le texte vocalisé.
  • Noto Naskh (net) : naskh Google très propre, rendu régulier sur tous les écrans.
  • Cairo (moderne) : sans-serif contemporain, pour un rendu épuré.
  • Lateef (grande lisibilité) : caractères généreux, idéale pour débuter ou en cas de fatigue visuelle.
  • Indo-pakistanaise : le style d'écriture du Coran « Indopak », familier en Asie du Sud.

Pour activer la police indo-pakistanaise, déposez un fichier de police (par ex. PDMS Saleem QuranFont, ou celui préparé via DDEDITOR) dans assets/fonts/ sous le nom indopak.ttf (ou indopak.woff2). La plateforme la détecte automatiquement.

Mode dyslexie

Toujours via le bouton 🎨, section « Confort de lecture », le mode dyslexie augmente l'interligne et l'espacement entre les mots, agrandit légèrement le texte, aligne le français à gauche (pas de justification) et bascule sur la police Lexend (conçue pour faciliter la lecture) pour le français et un naskh aéré pour l'arabe.

Note d'honnêteté : il n'existe pas de police « dyslexie » officielle dédiée à l'arabe (les polices type OpenDyslexic sont latines et l'arabe, cursif, ne supporte pas l'espacement entre lettres). Le mode dyslexie applique donc les leviers reconnus efficaces pour l'arabe — lisibilité des caractères, espacement des mots, interligne, taille — sans jamais casser la liaison des lettres. Cette préférence est enregistrée localement sur l'appareil.

Audio, prononciation et reconnaissance vocale

Chaque texte arabe possède un bouton 🔊. La plateforme lit l'arabe dans cet ordre de priorité :

  1. Service serveur tts.php (recommandé, activé par défaut) : il récupère la prononciation arabe et la met en cache en MP3 dans audio/tts-cache/. Avantage majeur : le son fonctionne pour tous les élèves, même si leur appareil n'a aucune voix arabe installée. La première lecture d'un mot prend une seconde (téléchargement), puis c'est instantané (cache).
  2. Enregistrements MP3 maison : déposez vos propres fichiers dans audio/ et référencez-les via le champ audio_mp3 d'un exercice — ils sont prioritaires.
  3. Synthèse vocale du navigateur (repli) : utilisée seulement si le serveur est indisponible. Elle dépend des voix installées sur l'appareil (souvent absentes en arabe sous Windows).

Vérifier que le service fonctionne : ouvrez https://arabe.dindar.re/tts.php?q=مرحبا — un fichier MP3 doit se lire ou se télécharger. Si vous obtenez « tts indisponible » (502), c'est que votre hébergement bloque les requêtes sortantes ; contactez OVH ou utilisez des MP3 maison.

Prérequis serveur : cURL ou allow_url_fopen actif (par défaut chez OVH), et le dossier audio/ accessible en écriture (créé automatiquement).

Améliorer la qualité : voix premium Google & choix homme/femme

La voix gratuite (StreamElements) est correcte mais robotique. La plateforme utilise en priorité Google Cloud Text-to-Speech (voix WaveNet) si une clé est configurée — bien meilleure qualité et vrai choix homme/femme.

  • Google Cloud Text-to-Speech (moteur par défaut) — voix WaveNet arabes ar-XA-Wavenet-B (masculine) et ar-XA-Wavenet-A (féminine), 1 million de caractères/mois gratuits. Procédure :
    1. Allez sur console.cloud.google.com et créez un projet (gratuit).
    2. Activez l'API : menu « APIs & Services » → « Enable APIs » → cherchez Cloud Text-to-Speech API → Activer.
    3. Créez une clé : « APIs & Services » → « Credentials » → « Create credentials » → « API key ». Copiez la clé. (Recommandé : « Restrict key » → limitez-la à l'API Text-to-Speech.)
    4. Activez la facturation sur le projet (obligatoire même pour le palier gratuit ; aucun prélèvement sous 1 M caractères/mois).
    5. Dans includes/config.php, ajoutez : define('GOOGLE_TTS_KEY', 'votre_cle');
    Le choix Homme/Femme (menu 🎨 › Voix) fonctionne alors.

Après avoir ajouté la clé Google, allez dans Espace enseignant › Audio autonome, choisissez la voix (Féminine / Masculine), cochez « Régénérer tout » et lancez : tout le cursus est recréé avec la voix Google et mis en cache.

Sans clé, la voix gratuite est utilisée automatiquement. Astuce qualité : la plateforme privilégie d'abord une voix installée sur l'appareil de l'élève, puis Google (serveur), puis le gratuit. Une voix humaine enregistrée (Studio voix) l'emporte toujours.

La reconnaissance vocale (atelier de prononciation) fonctionne sur Chrome et Edge : elle écoute votre voix localement et estime la proximité avec le modèle. Aucune voix n'est envoyée sur un serveur.

Pour le professeur : le suivi

Les comptes professeur et administrateur accèdent à l'espace de suivi :

  • Vue d'ensemble : élèves actifs, leçons les plus travaillées, exercices les plus difficiles.
  • Élèves : fiche individuelle (progression par leçon, historique, badges, temps passé).
  • Questions supplémentaires : ajoutez vos propres questions à n'importe quel exercice.
  • Messages : les demandes reçues via la page de contact.
  • Comptes & rôles (admin) : promouvoir un professeur, réinitialiser un mot de passe, supprimer un compte.

Un administrateur promeut un professeur depuis Comptes & rôles.

Installation sur l'hébergement OVH

  1. Téléversez tout le contenu dans le dossier /arabe de votre FTP (arabe.dindar.re).
  2. Copiez includes/config.sample.php en includes/config.php — la version fournie contient déjà vos identifiants OVH.
  3. Ouvrez https://arabe.dindar.re/install/install.php et créez votre compte administrateur.
  4. Supprimez le dossier install/ une fois terminé.

Prérequis : PHP 8.0+ et MySQL 8.4 (déjà le cas chez OVH). La base dindarresparabe est utilisée telle quelle.

Mettre à jour la plateforme (dossier MAJ)

Les mises à jour sont livrées sous forme de paquets à déposer dans le dossier MAJ/. Chaque paquet est un sous-dossier nommé par sa version (ex. MAJ/1.1.0/) contenant les fichiers à remplacer et un éventuel migration.sql.

  1. Téléversez le dossier de version dans MAJ/.
  2. Ouvrez https://arabe.dindar.re/MAJ/appliquer.php (réservé aux administrateurs).
  3. L'assistant applique les fichiers et les migrations SQL, puis met à jour le numéro de version.

Votre config.php et vos données ne sont jamais écrasés.

Ajouter des leçons et des exercices

Chaque leçon est un fichier JSON dans data/lessons/ (ex. t1-l01.json). Le format complet est décrit dans docs/SCHEMA-CONTENU.md. En résumé :

  • Un bloc cours (intro, dialogues, règles, vocabulaire, exemples religieux…).
  • Un bloc exercices parmi 10 types, chaque question ayant une explication obligatoire.
  • Déposez le fichier, il apparaît automatiquement dans le programme (aucune base à modifier).

Pour de petites additions ponctuelles, préférez l'éditeur de questions supplémentaires dans l'espace enseignant.

Créer des pages libres avec DDeditor

L'espace enseignant intègre DDeditor, un éditeur de blocs complet (36 types : titres, textes, tableaux, encadrés, images, audio, PDF, schémas, onglets, accordéons, jeux…). Rendez-vous dans Pages & leçons :

  • Composez votre page bloc par bloc (bouton + ou touche /).
  • Les images, sons et PDF s'uploadent directement (stockés dans medias/).
  • Enregistrez en brouillon, puis publiez : la page apparaît pour les élèves dans « Leçons › Ressources de l'école », à l'adresse page.php?slug=….

Idéal pour des leçons manuelles, fiches de vocabulaire thématiques, annonces de l'école ou supports de cours ponctuels — sans toucher aux fichiers JSON.

Confidentialité et RGPD

La plateforme ne collecte aucune donnée personnelle : ni nom réel, ni e-mail obligatoire. L'identification se fait par pseudonyme. Les seules données conservées sont pédagogiques (progression, scores) et servent au suivi de l'élève. Un élève peut demander la suppression totale de son compte (droit à l'effacement) via la page de contact ; un administrateur l'exécute en un clic.