🛠️ Cahier des Charges – Extension phpBB Reactions au 28/09/2025

🔧 A. Core Technique et Base de Données

A.1 – Support des Émojis 4 Octets (utf8mb4)

🟥 NÉCESSAIRE

Pour que l’extension fonctionne correctement avec l’ensemble des émojis modernes, la colonne reaction_emoji de la table phpbb_post_reactions doit absolument utiliser un encodage utf8mb4.

Pourquoi ?

L’encodage utf8 classique dans MySQL/MariaDB ne stocke que 3 octets, ce qui suffit pour la plupart des caractères, mais pas pour les émojis récents.
Résultat : lorsqu’un utilisateur tente d’ajouter un émoji comme 🪼, 🦖 ou 🧑🏿‍💻, la base de données renvoie une erreur du type : « Incorrect string value : ‘\xF0\x9F\xAA\xBC’ « .

Avec utf8mb4, tous les émojis Unicode (4 octets) sont correctement pris en charge, sans plantage.

👉 Autrement dit :

Si nous voulons que l’extension soit robuste et universelle, utf8mb4 est indispensable.
Rester en utf8 fonctionnerait seulement avec une liste très restreinte d’émojis basiques (👍 ❤️ 😂), mais cela casserait dès qu’un utilisateur choisirait un caractère plus récent.

A.2 – Chargement initial des réactions
🟧 BUG MAJEUR à corriger
Le système doit corriger le bug actuel : les réactions enregistrées en base de données doivent être correctement chargées et affichées sous chaque post lors du chargement initial de la page (viewtopic).

A.3 – Gestion AJAX
🟨 Squelette prêt
Toutes les interactions de l’utilisateur (ajouter, retirer, changer une réaction) doivent être gérées via des requêtes AJAX pour garantir une expérience fluide et sans rechargement de page.

A.4 – Structure des dossiers
🟩 Confirmé (via Feedback Ami)
L’installation doit respecter la structure canonique de phpBB : ext/bastien59960/reactions/.

🙋‍♂️ B. Fonctionnalités et Interactions Utilisateur

B.1 – Limite de Types par Post
⚙️ PARAMÉTRABLE
Le nombre maximum de types d’émojis différents (e.g., 👍, ❤️, 😂) affichés sous un post sera une option configurable dans le PCA (par défaut : 20). Une fois cette limite atteinte, les utilisateurs ne peuvent plus introduire de nouveau type.

B.2 – Limite par Utilisateur/Post
⚙️ PARAMÉTRABLE
Le nombre maximum de réactions totales qu’un utilisateur peut laisser sur un post sera une option configurable dans le PCA (par défaut : 10).

B.3 – Interaction Toggle
✅ SPEC FINALE
Un clic sur un émoji doit basculer l’état de la réaction pour l’utilisateur concerné : Ajouter si la réaction n’existe pas, ou la retirer si l’utilisateur l’a déjà sélectionnée.

🎨 C. Affichage et Expérience Utilisateur (UX)

C.1 – Visibilité Invités
✅ SPEC FINALE
Les utilisateurs non-connectés (invités) ne verront que le compteur total de réactions. Ils ne pourront ni réagir, ni voir la liste des réacteurs.

C.2 – Liste des Réacteurs (Hover)
✅ SPEC FINALE
Les utilisateurs connectés, en passant la souris sur un émoji affiché sous le post, doivent voir une tooltip ou une liste détaillée des utilisateurs ayant utilisé cette réaction. Cette liste doit se charger dynamiquement via AJAX.

C.3 – Affichage par défaut du post
✅ SPEC FINALE
Par défaut, les émojis de réaction n’apparaissent pas sous le message s’il n’y a aucune réaction. Seul le bouton + (ou équivalent) pour ajouter une réaction doit être visible.

C.4 – Sélecteur Pickup (Mobile-First)
🔧 TODO
Le sélecteur d’émojis (Pickup) doit être optimisé pour le mobile :

Afficher exactement les 10 émojis les plus courantes (configurables via le PCA).
Un bouton dédié doit permettre d’accéder à la liste complète à partir du fichier JSON.

C.5 – Priorisation du Pickup
✅ SPEC FINALE
Les 10 émojis du Pickup doivent être clairement identifiées, avec le pouce en l’air (👍) et le pouce en bas (👎) positionnés en premier et deuxième par défaut.

🔔 D. Système de Notifications

D.1 – Notification Cloche phpBB
✅ SPEC FINALE
Le propriétaire du post doit recevoir une notification via le système de cloche (bell system) de phpBB lorsqu’un utilisateur y ajoute une réaction.

D.2 – Notification Email
✅ SPEC FINALE
Une notification doit également être envoyée par email au propriétaire du post, en respectant ses préférences utilisateur définies dans le PCA.

🛡️ E. Administration et Maintenance (PCA)

E.1 – Interface ACP (Général)
🔧 TODO
Création d’un onglet dédié dans le Panneau de Configuration Administrateur (PCA) pour gérer les paramètres de l’extension.

E.2 – Paramétrage des Limites
⚙️ PARAMÉTRABLE
L’ACP doit permettre de définir les valeurs pour les exigences B.1 (Limite de types par post) et B.2 (Limite par utilisateur/post).

E.3 – Gestion du Pickup
🔧 TODO :

L’ACP doit permettre de définir et d’ordonner les 10 émojis par défaut qui apparaissent dans le sélecteur rapide (Pickup).

Dans le Pickup : Un bouton dédié dans le sélecteur permettra, si l’utilisateur le souhaite, d’afficher l’intégralité des émojis disponibles.

La liste complète des émojis (provenant du fichier JSON, plus de 4000 éléments) doit être masquée par défaut, afin d’éviter un affichage trop long sur mobile.

E.4 – Migration des données
🔧 TODO :
Développer une fonctionnalité d’import pour les utilisateurs souhaitant migrer les anciennes réactions (d’une autre extension, par exemple) vers la nouvelle table phpbb_post_reactions.