PhpBB Lab Académie

Rechercher dans ce cours

Personnaliser son forum phpBB avec les styles et les extensions

Auteur : phpBB-Lab. Date de cette version : jeu. 17 sept. 2026 12:39.

Diagnostiquer un problème et revenir au bon niveau

Objectif de la leçon

Distinguer un réglage, un choix de style et une panne d’extension, effectuer un retour de préférence ciblé et expliquer les conséquences d’une désinstallation.

Explications

Transformer une impression en observation

« L’annonce a disparu » décrit un symptôme, pas encore sa cause. Commencez par noter l’adresse complète, le compte connecté, la page et le résultat attendu. Une annonce réglée sur l’index seul doit être absente d’un sujet. Une annonce réservée aux invités doit être absente d’un compte connecté. Dans ces deux cas, l’absence peut être le bon résultat.

Le clone reste notre unique terrain d’essai. Sa fermeture administrative empêche aussi les membres ordinaires de parcourir normalement le forum. Pour effectuer les tests de cette leçon, CamilleAdmin ouvrira temporairement http://localhost/forum-ecole-restauration/, puis le refermera à la fin. Ne changez pas la fermeture du forum source ou du clone retour pour tenter de résoudre le problème.

Examiner les réglages dans un ordre utile

Vérifiez d’abord le nom du clone et l’identité utilisée. Dans le gestionnaire, Board Announcements doit être activée. Dans ses paramètres, « Activer les annonces du forum » doit être à Oui. Dans l’annonce concernée, « Afficher l’annonce du forum » doit aussi être à Oui.

Relisez ensuite « Qui peut voir l’annonce du forum » et la sélection d’emplacements. Pour notre état attendu : Tous les utilisateurs, Board Index uniquement. La date d’expiration est vide et le masquage est réglé sur Non. Sur un autre projet autorisant le masquage, un utilisateur peut avoir fermé l’annonce pour lui-même ; ce résultat ne signifie pas qu’elle a été supprimée pour tout le monde.

Contrôlez enfin le texte public. La Description aide l’administrateur à reconnaître l’annonce, mais ce n’est pas son message affiché. Un texte saisi dans la mauvaise zone peut expliquer un résultat inattendu. Retrouvez l’annonce existante avant d’en créer une deuxième pour essayer de compenser le problème.

Comparer les styles sans changer toutes les données

Si l’annonce est présente sous prosilver et absente sous un style tiers, vous disposez d’une différence utile. Il faut encore vérifier que les comptes, les pages et les réglages d’affichage étaient identiques. Changer simultanément le style, le public de l’annonce et le compte ferait perdre la valeur de la comparaison.

Une extension insère souvent son contenu à un endroit prévu par les modèles du style, appelé événement. Board Announcements utilise un événement présent dans prosilver. Atelier Jardins hérite de ces modèles ; un style tiers peut les organiser autrement. Cette notion explique ce qu’il faut vérifier auprès de l’auteur, sans vous demander d’éditer le code PHP ou les modèles du forum.

Purger le cache peut être utile après un remplacement de fichiers lorsque le paquet est complet. Dans le panneau d’administration, la commande « Purger le cache » supprime des éléments générés que phpBB peut reconstruire. Elle ne récupère pas une annonce supprimée et ne fournit pas un fichier absent. Rechargez ensuite la page dans le navigateur et refaites exactement le même test.

Effectuer un retour individuel

Pour vérifier une préférence de style, il n’est pas nécessaire de désinstaller le style. Avec accueil_test, ouvrez le Panneau de l’utilisateur, Préférences du forum, Modifier les préférences générales. Le champ « Style » doit actuellement indiquer Atelier Jardins. Choisissez prosilver, validez, puis revisitez l’index.

Revenez dans les préférences et relisez la valeur enregistrée. L’apparence peut rester identique, puisque notre style enfant reprend les ressources de prosilver. Votre preuve est le choix conservé par le formulaire, complété par la recette des pages ; ne cherchez pas une couleur différente qui n’a jamais été créée.

Choisissez ensuite Atelier Jardins, validez et contrôlez à nouveau la valeur. Cette intervention porte sur accueil_test. Le style par défaut et le style des invités restent prosilver ; « Annuler le style de l’utilisateur » reste à Non. Si le choix individuel n’est pas proposé, CamilleAdmin vérifiera d’abord ces réglages et l’activation du style, au lieu d’attribuer un nouveau droit au membre.

Comprendre ce qu’une désactivation de style changerait

Une désactivation administrative ne se comporte pas comme ce changement de préférence. Dans phpBB 3.3.17, désactiver un style remet les utilisateurs qui l’avaient choisi sur le style par défaut. Le réactiver le rend disponible, mais ne rétablit pas automatiquement leurs anciens choix. Il faudrait donc sélectionner Atelier Jardins à nouveau avec accueil_test.

Cette conséquence est importante pour un forum fréquenté. Un essai apparemment temporaire peut laisser des préférences différentes après réactivation. Dans cette leçon, notre véritable manipulation reste le changement individuel prosilver, puis Atelier Jardins. Nous conservons le style installé et actif, et nous n’imposons aucun changement aux autres comptes.

Distinguer désactivation et suppression des données

Pour une extension, Désactiver conserve normalement ses fichiers, ses données et ses réglages ; elle cesse de fournir ses fonctions. Nous avons vérifié cette conservation avec Board Announcements. « Supprimer les données » est une opération différente qui retire les données et réglages propres à l’extension. Dans notre cas, l’annonce serait perdue dans l’installation courante.

Si l’on voulait désinstaller définitivement cette extension, on suivrait son ordre documenté : désactiver, supprimer ses données en attendant la fin, puis retirer son dossier précis. Ses fichiers doivent rester disponibles jusqu’à la fin des opérations qui en ont besoin. Copier ensuite un paquet neuf ne recréerait pas le message supprimé ; retrouver les anciennes données demanderait la sauvegarde adaptée.

Nous étudions cette séquence par écrit. Ne l’exécutez pas : l’état final du cours doit conserver l’annonce. Ne confondez jamais « Supprimer les données » avec « Purger le cache », même si les deux opérations comportent l’idée de nettoyage.

Choisir le retour qui correspond au problème

Une description du site mal saisie se corrige dans Configuration du forum. Une préférence individuelle incorrecte se corrige dans le profil concerné. Une annonce mal ciblée se corrige dans ses paramètres. Une erreur apparue après une vraie mise à jour peut demander une restauration complète cohérente, préparée et testée comme au cours 4.

Si l’administration n’est plus accessible, conservez l’erreur, les versions, l’heure et l’opération qui vient de se produire. Reprenez la procédure documentée de l’ajout et le plan de retour du laboratoire. N’effectuez pas une série de suppressions dans la base pour faire disparaître le symptôme. Le carnet permet de demander une aide précise avec des informations utiles et sans publier config.php ni des mots de passe.

Exemple commenté

Exemple — deux absences, deux décisions

Sur l’index comme visiteur, Camille ne voit pas l’annonce alors qu’elle la voit avec inscrit_test. Elle découvre le choix Utilisateurs enregistrés : elle remet Tous les utilisateurs, le public prévu pour notre atelier, puis refait les deux tests.

Dans un autre cas, l’annonce apparaît sur l’index mais pas dans Questions publiques. Board Index est le seul emplacement sélectionné : aucune correction n’est nécessaire. Le diagnostic consiste aussi à reconnaître un fonctionnement conforme, au lieu de multiplier les modifications.

Exercice à réaliser

Exercice — revenir à un réglage maîtrisé

1. Avec CamilleAdmin, vérifiez l’adresse et ouvrez temporairement le clone pour les essais de comptes ordinaires.
2. Avec accueil_test, relevez le champ Style, choisissez prosilver et validez. Retrouvez l’index et contrôlez que l’annonce prévue est présente.
3. Retournez dans les préférences, choisissez Atelier Jardins, validez puis relisez le choix enregistré. Ne changez aucun réglage global.
4. Par écrit, décidez de la première vérification pour ces trois symptômes : annonce absente chez un invité mais présente chez un membre ; annonce absente seulement dans un sujet ; préférence de style non proposée au membre.
5. Expliquez ce qui resterait après Désactiver une extension, puis ce qui serait perdu après Supprimer les données. N’effectuez pas cette suppression.
6. Avec CamilleAdmin, vérifiez prosilver par défaut et pour les invités, l’annulation du choix utilisateur sur Non, puis refermez le clone. Notez le retour d’accueil_test sur Atelier Jardins.

Correction et résultat attendu

Correction et résultat attendu

accueil_test a réellement utilisé la préférence prosilver puis retrouvé Atelier Jardins. Les deux styles restent installés et actifs ; les autres comptes et les réglages globaux n’ont pas changé. L’apparence identique est normale dans notre atelier.

Pour le premier symptôme, contrôlez le public de l’annonce et l’identité réelle. Pour le deuxième, contrôlez les emplacements : l’absence sur un sujet est attendue avec Board Index uniquement. Pour le troisième, contrôlez notamment l’annulation du choix utilisateur et la disponibilité du style. Désactiver Board Announcements conserve l’annonce ; supprimer ses données la retirerait. Cette dernière opération n’a pas été exécutée et le clone est fermé.

À retenir

Décrivez le symptôme avec une page et une identité précises. Vérifiez les réglages avant de multiplier les changements. Un retour de préférence peut suffire ; une désactivation de style réaffecte les utilisateurs au défaut. La suppression des données d’une extension n’est ni une désactivation ni une purge de cache.

Seuil de réussite, en pourcentage : 100 %. QCM obligatoire pour terminer le cours.

Sommaire du cours

Préparer une personnalisation utile et réversible

  1. Choisir un besoin et retrouver le bon forum de test
  2. Préparer son inventaire et son point de sauvegarde
  3. Personnaliser le nom et la description avec les réglages existants

Comprendre, installer et essayer un style

  1. Comprendre ce qu’un style change et ce qu’il conserve
  2. Préparer Atelier Jardins et l’installer dans le clone
  3. Choisir un style et vérifier à qui il s’applique

Choisir et installer une extension

  1. Choisir une extension qui répond à un besoin précis
  2. Installer les fichiers puis activer Board Announcements
  3. Désactiver et réactiver sans effacer les réglages

Configurer une annonce et vérifier l’expérience des membres

  1. Créer une annonce utile et maîtriser ses réglages
  2. Tester les publics et les emplacements sans changer les permissions
  3. Vérifier les styles, la navigation et l’état final du clone

Entretenir ses ajouts et terminer son projet

  1. Entretenir une extension et suivre les dépendances du style
  2. Diagnostiquer un problème et revenir au bon niveau
  3. Terminer une personnalisation vérifiée et documentée