étapes du 21/09/2025

🛠️ Étape 1 : Le cœur de l’extension (PHP & SQL)

Maintenant que la table phpbb_post_reactions existe, il faut créer les scripts qui vont interagir avec elle.

1.1. Création du contrôleur principal (Back-end)

C’est le script qui va gérer les requêtes AJAX venant du front-end. Il doit être capable de :

• Récupérer les données de la requête : l’ID du post, l’ID de l’utilisateur et l’emoji cliqué.
• Valider et sécuriser les données :
  • Vérifier que l’utilisateur est connecté et autorisé à réagir.
  • S’assurer que le post_id existe bien.
  • Valider l’emoji (par exemple, s’il fait partie d’une liste autorisée).
• Interagir avec la base de données :
  • Ajouter une réaction : Si l’utilisateur n’a pas encore réagi à ce post, insère une nouvelle ligne dans la table post_reactions.
  • Modifier une réaction : Si l’utilisateur a déjà réagi, met à jour sa réaction existante.
  • Supprimer une réaction : Si l’utilisateur clique à nouveau sur son emoji, supprime la ligne de la table.
• Retourner une réponse : Après l’opération, renvoie une réponse au format JSON contenant :
  • Un statut de succès ou d’échec.
  • Les compteurs mis à jour pour ce post.

1.2. Mettre en place la logique pour les compteurs

Il te faudra une fonction pour compter les réactions par post.

• Utilise une requête GROUP BY reaction_unicode sur ta table post_reactions pour obtenir le nombre de réactions pour chaque emoji sur un post donné.
• Cette fonction sera appelée par le contrôleur AJAX pour retourner les compteurs mis à jour, mais aussi par le front-end pour afficher les compteurs lors du chargement initial de la page.

---

🖥️ Étape 2 : Le front-end (HTML, CSS & JavaScript)

C’est la partie visible de l’extension. L’objectif est de rendre l’interaction fluide et agréable.

2.1. Affichage des réactions dans le template

• Ouvre le fichier de template viewtopic_body.html de ton style.
• Localise la boucle « . C’est ici que chaque post est affiché.
• À l’intérieur de cette boucle, ajoute un bloc HTML pour les réactions, comme tu l’as déjà prévu dans ton cahier des charges.
• Utilise les variables de template de phpBB (postrow.POST_ID) pour associer les réactions au bon post.

<div class="post-reactions" data-post-id="{postrow.POST_ID}"></div>

2.2. L’interface utilisateur avec JavaScript

• Crée un fichier JavaScript (par exemple, reactions.js) dans le répertoire styles/all/template/ de ton extension.
• Dans ce fichier, tu vas coder la logique d’interaction :
  • Détecter les clics : Ajoute des écouteurs d’événements sur les boutons d’emojis et sur le bouton +.
  • Envoi des requêtes AJAX : Au clic, envoie une requête POST à ton contrôleur PHP, en passant le post_id et l’emoji en paramètre.
  • Mise à jour de l’interface : Une fois la réponse JSON reçue, mets à jour les compteurs des emojis et change la classe CSS pour indiquer si l’utilisateur a déjà réagi ou non.
• N’oublie pas d’inclure ton fichier JavaScript dans le template via la fonction page_footer_after.html.

2.3. Le sélecteur d’emojis

• Crée la logique JavaScript pour afficher et masquer la palette complète d’emojis lorsque l’utilisateur clique sur le bouton +.
• Tu peux utiliser une simple classe CSS pour contrôler la visibilité (par exemple, display: none ou display: block).

---

💾 Étape 3 : Les fonctionnalités avancées et la finalisation

Une fois le noyau fonctionnel, tu peux ajouter les fonctionnalités supplémentaires.

3.1. L’import des données de l’ancienne extension

• C’est une fonctionnalité optionnelle mais cruciale pour la migration.
• Identifie la table de l’ancienne extension.
• Crée un script d’importation dans la migration (un nouveau fichier migration.php ou une fonction dans release_1_0_0.php).
• Ce script lira les données de l’ancienne table et les insérera dans ta nouvelle table post_reactions, en s’assurant que les formats correspondent.

3.2. Les fichiers de langue et les permissions

• Crée les fichiers language/fr/reactions.php et language/en/reactions.php comme prévu.
• Utilise les fonctions de phpBB ($user->lang) pour intégrer les chaînes de traduction dans tes templates et tes scripts.
• Ajoute des permissions dans l’ACP (panneau d’administration) pour permettre aux administrateurs de contrôler qui peut réagir aux posts (par groupe d’utilisateurs, par forum, etc.).

3.3. Tests et débogage

• Teste toutes les fonctionnalités : ajouter, modifier, supprimer une réaction.
• Vérifie que les compteurs se mettent à jour correctement pour tous les utilisateurs.
• Assure-toi que l’extension est compatible avec différents navigateurs et sur mobile.
• Utilise les outils de développement du navigateur pour inspecter les requêtes AJAX et les réponses du serveur en cas de problème.