Ecole2Nat'

Plugin WordPress de suivi pédagogique pour école de natation.

Modules disponibles

• saisons ;
• catégories ;
• référentiel pédagogique : domaines et compétences ;
• bibliothèque d'exercices ;
• groupes ;
• nageurs ;
• évaluations progressives ;
• portail parents sécurisé ;
• distribution groupée des accès parents par email, coupons ou CSV ;
• synchronisation d’un classeur club avec saison cible ;
• maintenance et purge contrôlée des données ;
• portail Coach avec semaine type et évaluations rapides.
• planning des compétitions, réponses familiales et suivi des engagements Extranat.
• distributions de matériel ciblées, suivies par les coachs et consultables dans le parcours des nageurs.

La synchronisation attend un onglet Référentiel <catégorie> par référentiel (par exemple Référentiel Némo) avec les colonnes Domaine, Compétence et Exercice(s). Les inscriptions ne sont importées que lorsque la colonne Renouvellement contient explicitement OUI ou NON.

La colonne Compétition de l'onglet Inscriptions accepte une ou plusieurs catégories de compétiteur séparées par ;, par exemple U11;HANDI. Chaque changement est historisé à la date de sa synchronisation. L'onglet facultatif Compétitions utilise un code stable, une période de réponse, un champ facultatif Bassin limité à 25m ou 50m, et les catégories de compétiteur concernées. TOUS permet de cibler tous les nageurs actifs de la saison, même sans catégorie de compétiteur. Les colonnes facultatives Programme, Covoiturage, liveFFN et Album photo ajoutent les boutons correspondants aux portails Parents et Coach lorsqu'une URL est renseignée.

Les familles peuvent répondre pendant la période d'inscription, indiquer si les parents participent comme officiels et, pour une compétition sur deux jours, choisir les deux jours ou un seul. Le coach conserve séparément le suivi de l'engagement Extranat. Chaque compétition affiche aussi l'état de la réponse familiale dans un cartouche distinct, qui devient vert lorsque l'engagement Extranat est validé par le coach. Lorsqu'un numéro de licence est renseigné, les fiches nageur et les écrans de compétition proposent aussi un accès direct à ses performances Extranat. Dans la vue Coach « Nageurs par catégorie », chaque coach peut masquer les catégories dont il n'a pas besoin ; cette préférence est conservée dans son profil WordPress. Une pastille sur chaque nageur indique le nombre cumulé de chronos d'entraînement et de compétition enregistrés dans les vues Catégories et les groupes de la Semaine type. Dans une compétition, une pastille verte indique uniquement le nombre d'épreuves déjà chronométrées pendant cette compétition. Les pastilles sont masquées lorsque leur total est nul. Depuis la liste du back-office, un administrateur peut supprimer définitivement une compétition après confirmation ; ses réponses et engagements sont alors supprimés avec elle. Le coach peut ensuite démarrer la compétition lorsque tous les nageurs ayant répondu Oui sont engagés sur Extranat, ou forcer ce démarrage après alerte. Le mode terrain suit uniquement les engagés, permet des ajouts manuels et conserve plusieurs performances par nageur avec épreuve, chrono, commentaire, disqualification et appréciation sur cinq. Il propose également un chronomètre de série : le coach choisit l'épreuve et les participants, lance un départ commun puis arrête et enregistre chaque nageur individuellement, tout en continuant à saisir ses observations pendant la course. Un bouton permet de remplacer les cartes complètes par des lignes réduites au nom, au chrono et à l'action Stop ; ce choix d'affichage est mémorisé sur l'appareil du coach. Jusqu'à dix compétitions en cours sont épinglées sous l'en-tête Coach. Elles peuvent être clôturées puis redémarrées sans perdre ni verrouiller les performances.

Chaque compétition propose aussi un écran Facturation, limité aux nageurs engagés sur Extranat. Le coach y renseigne le nombre de repas et de nuitées, peut ajouter un montant libre affiché comme Autre et le justifier aux parents dans le commentaire individuel, puis génère des factures web imprimables. Les tarifs, l'identité du club, le logo, le RIB et l'adresse de la trésorière se configurent dans Ecole2Nat' → Réglages. La première génération attribue un numéro annuel continu commençant à 1000 ; une régénération conserve ce numéro et ajoute une version traçable.

Une facture générée apparaît aussi dans la compétition correspondante du portail Nageurs. La famille peut consulter son détail web, télécharger le RIB par un lien protégé et déclarer son paiement avec un commentaire. Cette déclaration verrouille la facture et envoie un récapitulatif à la trésorière ; elle ne vaut pas confirmation bancaire du règlement.

Portail parents

1. Créez et publiez une page WordPress, par exemple Mon parcours de natation.
2. Placez-y uniquement le shortcode :

[e2n_parent_report]

3. Le lien Accès parents de la liste des nageurs ouvre une prévisualisation administrateur du parcours.

Le code d'accès est déterministe : prénom en majuscules sans accent, espace ni caractère spécial, suivi de la date de naissance au format JJMMAAAA. Ainsi, Éléonore, née le 3 avril 2012, utilise ELEONORE03042012. Il n'est ni envoyé par email ni stocké en clair. Si deux nageurs actifs produisent exactement le même code, la connexion est refusée afin de ne jamais afficher le mauvais parcours.

Évaluations progressives

Le module Évaluations permet de suivre le niveau courant de chaque nageur sur les compétences du référentiel de la catégorie de son groupe. Les trois états disponibles sont : Non observé, En cours et Acquis. Chaque changement conserve sa date et le nom du coach dans un historique saisonnier.

Portail Coach

Les administrateurs peuvent ouvrir directement le portail Coach depuis le menu Ecole2Nat' → Portail Coach ou depuis l'écran Coachs, sans recevoir le rôle Coach.

Le shortcode [e2n_coach_portal] propose trois accès complémentaires aux nageurs : liste alphabétique avec recherche, classement par catégorie et semaine type permanente construite depuis les créneaux des groupes. Aucun créneau n'est associé à une date et aucune préparation de séance n'est requise. Depuis une fiche d'évaluation, un coach peut ouvrir une prévisualisation sécurisée de la fiche Parents, afficher et copier le code permanent, ou le renvoyer à l'adresse responsable enregistrée.

Un clic sur un créneau ouvre directement le groupe. Tous les comptes Coach peuvent mettre à jour les progressions de tous les groupes actifs, individuellement ou collectivement. Les titulaires habituels restent affichés à titre informatif.

Les changements sont enregistrés immédiatement et alimentent la chronologie de chaque compétence. Les informations médicales restent réservées au portail Coach et ne sont jamais exposées dans le portail Parents.

Le portail utilise une mise en page autonome, pensée comme une application mobile et tablette : navigation compacte et persistante, actions secondaires regroupées, résumé de progression et notes internes affichées à la demande. Il conserve les hooks WordPress nécessaires aux extensions et à la barre d'administration, mais ne reprend ni l'en-tête, ni le pied de page, ni les colonnes du thème actif.

Le portail Parents présente l'état courant de façon synthétique. Un contrôle replié sous chaque compétence permet d'afficher à la demande la date, le statut atteint et le coach ayant effectué chaque changement.

Lorsqu'une catégorie ne possède aucune compétence, les portails Coach et Parents n'affichent aucun bloc de progression vide. Le rapport Parents conserve toutefois les chronos d'entraînement et de compétition, regroupés par épreuve, sans les commentaires internes, les appréciations en étoiles ni l'identité du coach. Le meilleur temps validé et sa date restent visibles pour chaque épreuve ; les graphiques sont repliés par défaut et peuvent être ouverts séparément ou tous ensemble. Depuis la fiche Coach, chaque temps peut être supprimé individuellement et l'action « Purger les chronos » supprime, après confirmation, tout l'historique chronométrique du nageur, entraînements et compétitions compris.

Comme le portail Coach, le portail Parents possède un gabarit autonome et responsive fourni par le plugin. La saisie du code, la fiche enfant et les prévisualisations Coach ou administrateur utilisent la même identité visuelle sans dépendre des fichiers du thème WordPress.

Le nom et le logo communs aux en-têtes Coach et Parents se configurent dans Ecole2Nat' → Réglages. Le logo est choisi dans la médiathèque WordPress ; en son absence, le monogramme E2N reste affiché.

La bibliothèque d'exercices reste disponible dans le back-office comme ressource pédagogique indépendante.

Prérequis

• WordPress 6.0 ou supérieur ;
• PHP 8.1 ou supérieur ;
• Composer 2.

Installation de développement

git clone https://github.com/elouf/ecole2nat.git
cd ecole2nat
composer install

Construire une archive installable

composer build

Le ZIP est généré dans build/ avec les dépendances de production. Il exclut Git, les tests et la documentation de développement, et contient un dossier racine ecole2nat/ directement installable dans WordPress.

Placez ensuite le dépôt dans :

wp-content/plugins/ecole2nat

Activez l'extension dans l'administration WordPress.

Vérification de syntaxe

find src -name '*.php' -print0 | xargs -0 -n1 php -l

Les tests automatisés ciblés s’exécutent sans installation supplémentaire avec :

composer test

Modèle de données

Voir docs/database.md.

Synchronisation du classeur club

Le menu Ecole2Nat' → Synchronisation accepte un classeur .xlsx comprenant :

• Inscriptions ;
• Groupes ou Catégories ;
• Référentiel.

Les autres onglets et les colonnes comptables sont ignorés. Avant l'analyse, l'administrateur choisit la saison cible : la colonne Saison n'est donc pas nécessaire dans l'onglet Groupes. L'association d'un nageur à son groupe repose sur la concaténation de la catégorie et du créneau, par exemple Dauphin + Lundi 17h15 → Dauphin Lundi 17h15.

L’onglet Groupes ou Catégories peut contenir une colonne facultative Durée (min). Lorsqu’elle est renseignée, l’heure de fin est calculée depuis l’heure de début reconnue dans le nom du groupe. Lorsqu’elle est vide, une heure de fin déjà corrigée dans WordPress est conservée. Les groupes peuvent aussi être modifiés depuis Ecole2Nat’ → Groupes → Modifier.

Maintenance

L'écran Ecole2Nat' → Maintenance permet à un administrateur de purger intégralement les données du plugin sans désinstaller Ecole2Nat'. La purge conserve le schéma de base de données et les options techniques de version, mais efface toutes les données métier, évaluations, accès parents et journaux de synchronisation.

Cette action est irréversible et exige une double confirmation explicite.

Mise à jour du schéma

Ecole2Nat' compare automatiquement la version de base installée à E2N_DB_VERSION. Les migrations dbDelta() nécessaires sont appliquées au chargement après une mise à jour ; il n'est plus nécessaire de désactiver/réactiver l'extension pour ajouter les nouvelles colonnes.

Depuis un groupe de la semaine type, le coach peut chronométrer une série avec les nageurs du groupe. Chaque arrêt est enregistré immédiatement comme chrono d'entraînement. La fiche Coach d'un nageur rassemble ensuite, par ordre chronologique, ses chronos d'entraînement et de compétition. La même action est disponible depuis la vue Catégories : seuls les nageurs des catégories actuellement cochées sont proposés. Sur ces deux vues, le module est replié par défaut pour ne pas dupliquer une longue liste de nageurs à l'écran. Après un départ collectif, le coach peut supprimer un chrono erroné sans toucher aux autres nageurs, ou supprimer toute la série après confirmation. La fiche Coach du nageur regroupe son rapport chronométrique par épreuve dans l'ordre des distances et des nages. Chaque groupe affiche une courbe de progression par jour et conserve le détail des saisies à la demande.

Saisons et historique pédagogique

Depuis la v0.9.0, les évaluations, le référentiel actif et les affectations de groupe sont historisés par saison. Une synchronisation Excel associe son référentiel à la saison cible choisie dans le back-office. Le portail parents permet de consulter les saisons précédentes sans altérer les acquis historiques.

Synchronisation des informations nageur

Dans l’onglet Inscriptions, Ecole2Nat’ reconnaît notamment les colonnes Info médicale et Droit à l'image. Une cellule Info médicale non vide active uniquement un indicateur de santé : son texte n'est jamais stocké dans WordPress. Le droit à l’image accepte OUI ou NON (la cellule peut rester vide si l’information n’est pas connue). La colonne historique Commentaire est ignorée. Plusieurs emails ou téléphones responsables peuvent être séparés par / ou ; ; ils sont conservés distinctement et les emails valides reçoivent chacun les envois Parents.