PhpBB Lab Académie

Retrouver la copie de travail du cours précédent et distinguer un réglage natif, un changement de présentation et une fonction ajoutée par extension.

Personnaliser commence par une question

Votre forum des Jardins Partagés est installé, organisé et administré. Vous avez appris à sauvegarder ses fichiers et sa base, puis à vérifier une restauration. Vous pouvez maintenant préparer une personnalisation avec une méthode : décrire ce que les membres doivent pouvoir faire, choisir l’outil approprié et vérifier le résultat.

« Je veux changer quelque chose » est trop vague. « Je veux afficher une courte information sur l’index, pour les visiteurs comme pour les membres » constitue un besoin précis. Nous pourrons vérifier si ce texte apparaît au bon endroit et pour les bonnes personnes. Un autre besoin pourrait être d’essayer un style dans un seul profil avant de décider de son usage collectif.

Dans ce cours, nous ferons les deux. Vous préparerez un style d’atelier à partir des ressources de prosilver, puis installerez une extension d’annonce. Chaque ajout sera testé dans une seule copie locale. Aucune programmation PHP ou CSS n’est demandée. Quelques lignes d’un fichier de description de style seront expliquées avant leur utilisation.

Trois moyens différents

Un réglage natif fait déjà partie de phpBB : par exemple le nom du site ou sa description. Inutile de rechercher une extension pour modifier un champ que l’administration propose déjà.

Un style organise la présentation des pages. Il comporte notamment des modèles de page, appelés templates, et des ressources d’apparence comme les feuilles de style et les images. Nous préciserons ces éléments au chapitre suivant. Changer de style ne doit pas être confondu avec changer les permissions des membres : un menu présenté différemment ne donne pas un droit supplémentaire.

Une extension ajoute ou adapte une fonction au moyen prévu par phpBB. Elle possède ses fichiers et peut aussi enregistrer des réglages ou des données dans la base. Elle n’est donc pas simplement un dessin à placer dans un dossier. Nous distinguerons son installation, son activation, sa configuration et son entretien.

Ces trois moyens peuvent se compléter, mais chacun répond à une question différente. Nous commencerons par le nom et la description, puis un style d’essai, et enfin une information affichée par une extension.

La copie concernée est celle du quatrième cours

À la fin du cours précédent, vous aviez trois installations distinctes. Le forum source demeure dans C:\wamp64\www\forum-ecole, avec la base phpbb_ecole. Il conserve le projet des premiers cours. La première copie restaurée se trouve dans C:\wamp64\www\forum-ecole-restauration, avec la base phpbb_ecole_restauration. La copie de retour se trouve dans forum-ecole-retour, avec la base phpbb_ecole_retour.

Nous travaillerons exclusivement sur la première copie restaurée, à http://localhost/forum-ecole-restauration/. Dans la suite, « le clone » désigne cette installation. Le forum source et la copie de retour restent tels qu’ils étaient. Si vous aviez adapté les noms ou le port web, utilisez les correspondances de votre carnet.

Cette adresse locale est celle de votre laboratoire. Elle n’est pas l’adresse du site public phpBB Lab où vous lisez ce cours. Les extensions installées sur le site de formation ne sont pas automatiquement présentes dans votre laboratoire. Vous n’avez pas à importer toutes les extensions du site public pour suivre les exercices.

Si vous n’avez pas encore terminé la restauration et les contrôles du cours 4, réalisez-les avant de continuer. Copier seulement un dossier sans isoler sa base ne crée pas le laboratoire prévu. Nous ne recommencerons pas cette opération à moitié dans un autre chapitre.

Reconnaître un clone même quand son nom change

Avant toute intervention, lisez l’adresse complète du navigateur. Sous Windows, Ctrl+L place le focus dans la barre d’adresse ; relisez le chemin forum-ecole-restauration avant de revenir à la page. Pour une manipulation de fichiers, utilisez la barre d’adresse de l’Explorateur, accessible avec Alt+D. Le dossier et la base de travail doivent correspondre au même clone.

Le titre de page est un indice utile, mais ne constitue pas une preuve suffisante. Nous allons justement modifier le nom du site. La vérification du dossier, de l’adresse et du config.php reste plus fiable qu’un titre mémorisé.

Les comptes CamilleAdmin, inscrit_test, eleve_test, equipe_test et accueil_test ont été retrouvés par restauration. CamilleAdmin effectuera les réglages. accueil_test, compte ordinaire, servira notamment à essayer le style. equipe_test garde sa modération locale de Questions publiques et de Bac à sable de modération. Aucun groupe ne doit recevoir de permission supplémentaire pour changer de présentation.

La fermeture est normale au départ

Le clone a été laissé fermé après les contrôles de maintenance. CamilleAdmin peut encore accéder à l’administration, mais un visiteur ou un membre ordinaire voit le message de fermeture. C’est l’état attendu, pas un défaut d’affichage causé par un style.

Pour tester une page avec un membre ordinaire, nous ouvrirons temporairement ce seul clone dans une étape annoncée, puis nous le refermerons. Pour préparer une sauvegarde ou remplacer des fichiers, nous arrêterons les écritures. Rappelez-vous que « Désactiver le forum » ne bloque pas toutes les actions des administrateurs et des modérateurs.

Une modification, une preuve

Pour chaque exercice, conservez dans votre carnet le besoin, la valeur initiale, l’action et le résultat observé. Commencez par un seul changement. Si vous modifiez simultanément le style, trois extensions et les groupes d’un membre, vous ne saurez plus quelle opération explique une différence.

Notre style d’atelier aura d’abord le même aspect que prosilver : le but est de comprendre sa structure, son choix et son entretien. Nous ne promettons pas un nouveau graphisme en changeant simplement un nom. L’extension produira ensuite un changement concret : un texte d’information sur l’index. Les exercices vous apprendront à distinguer ces résultats.

Exemple — trois demandes, trois décisions

L’association souhaite d’abord remplacer un nom de site provisoire. Camille utilise le réglage natif « Nom du site ». Elle n’installe rien.

Elle veut ensuite essayer une présentation distincte dans le compte accueil_test. Elle prépare un style et teste ce choix dans les préférences de ce membre. Elle ne modifie pas les groupes du compte.

Enfin, elle veut afficher un message d’information au-dessus du contenu de l’index. Elle compare la fonction recherchée à celle de Board Announcements. Un sujet portant le type « annonce », étudié au cours 3, reste une discussion ; ce n’est pas le même mécanisme qu’un encart d’information ajouté par l’extension.

Exercice — délimiter votre atelier

1. Ouvrez votre carnet du cours 4. Repérez la première copie restaurée, sa base et sa configuration isolée.
2. Démarrez WampServer et ouvrez l’adresse du clone. Contrôlez son chemin complet dans la barre d’adresse.
3. Connectez-vous avec CamilleAdmin. Vérifiez que le nom du compte et le forum correspondent au laboratoire. Ne rouvrez pas encore le clone pour les autres comptes.
4. Dans vos notes, inscrivez trois lignes : source conservée ; clone de personnalisation ; copie de retour conservée. Associez à chacune son dossier et sa base réels.
5. Classez les demandes suivantes : changer le nom du site ; essayer une présentation dans un seul profil ; ajouter une annonce sur l’index. Choisissez entre réglage natif, style et extension.
6. Écrivez un critère observable pour l’annonce : qui doit la lire et sur quelle page ? Aucun téléchargement ni ajout de fichier n’est encore nécessaire.

Résultat attendu : un périmètre de travail clair. Vous savez précisément quelle installation modifier et quelle installation conserver.

À retenir

Décrivez le besoin avant de choisir un ajout. Distinguez réglages natifs, style et extension. Ce cours utilise uniquement la copie forum-ecole-restauration. Vérifiez l’adresse et le dossier, gardez les permissions existantes et notez une preuve après chaque changement.