PhpBB Lab Académie

Distinguer présentation, contenu et permissions, puis comprendre les éléments d’un style enfant compatible avant de préparer Atelier Jardins.

Changer la présentation d’un même forum

Vous avez déjà donné un nom et une description au clone. Ces réglages changent le texte présenté aux visiteurs. Un style concerne une autre couche : la manière dont les pages du forum sont construites et présentées. Deux membres peuvent consulter les mêmes discussions avec des styles différents, si l’administration autorise ce choix. Les messages ne sont pas copiés dans chaque style ; ils restent dans la base du même forum.

Nous intervenons uniquement sur http://localhost/forum-ecole-restauration/, le « Jardins Partagés — clone de personnalisation » du chapitre précédent. La source /forum-ecole/ et le clone de retour /forum-ecole-retour/ restent intacts. La sauvegarde S3 est déjà conservée hors du dossier web. Ce chapitre ajoute un style d’exercice nommé Atelier Jardins à la copie de personnalisation.

Notre premier objectif sera de comprendre son installation et la sélection par un utilisateur. Son apparence restera volontairement identique à celle de prosilver, car nous réutiliserons ses ressources sans écrire de CSS. Vous apprendrez ainsi à vérifier un style autrement qu’en cherchant une différence de couleur. Les chapitres suivants ajouteront une information visible avec une extension.

Trois éléments à reconnaître

Un style phpBB possède d’abord une fiche nommée style.cfg. C’est un petit fichier texte qui décrit notamment son nom, sa version et son éventuel parent. Le suffixe cfg indique ici un fichier de configuration. Il ne contient ni les messages du forum ni les comptes des membres. À la prochaine leçon, nous en créerons une fiche courte dont chaque ligne sera expliquée.

Les modèles de pages, appelés templates dans les dossiers, organisent les éléments : en-tête, liste des forums, sujet, formulaires. Imaginez le plan d’une page dans lequel phpBB insère le titre d’une discussion et ses messages. Ces modèles contiennent aussi des emplacements que certaines extensions peuvent utiliser. Nous ne modifierons pas leur code.

Le dossier theme contient notamment les feuilles de style CSS et leurs ressources. Le CSS définit la présentation : espacements, dimensions, couleurs et organisation selon la largeur disponible. Une feuille CSS peut faire référence à d’autres fichiers du même thème. Copier seulement stylesheet.css ne garantit donc pas que toutes ses dépendances seront présentes.

Une erreur fréquente consiste à appeler indistinctement « thème » tout le style, puis à ne copier qu’un fichier isolé. Pour les manipulations, nous garderons les noms précis : style.cfg est la fiche ; template correspond aux modèles de pages ; theme correspond aux ressources de présentation. Ces repères permettent de vérifier le bon emplacement sans connaître les langages utilisés à l’intérieur.

Un parent et un enfant

prosilver est le style fourni avec phpBB. Dans notre atelier, il reste installé, actif et disponible comme référence. Atelier Jardins sera un style enfant : sa fiche indiquera parent = prosilver. L’enfant peut alors utiliser les modèles de pages de son parent lorsqu’il ne fournit pas ses propres modèles. C’est l’héritage des templates.

Cet héritage ne dispense pas de fournir les ressources du thème de l’enfant. Pour notre montage, les pages chercheront leur feuille principale dans styles/atelier_jardins/theme/stylesheet.css. Si nous créions uniquement style.cfg, le style pourrait apparaître comme installé tout en servant des pages mal présentées, faute de CSS à cet emplacement. Nous copierons donc intégralement le dossier theme du prosilver de ce clone vers le dossier de l’enfant.

Nous n’ajouterons aucun dossier template dans Atelier Jardins : les modèles seront hérités. Nous copierons le thème sans modifier son CSS. Cette distinction est centrale. Les modèles continuent à venir du parent, tandis que les ressources du thème sont une copie matérielle qui devra être entretenue si la version du parent change.

Deux numéros de version pour deux questions

La fiche du style contient style_version et phpbb_version. Le premier est le numéro de cette édition du style : nous utiliserons 1.0.0 pour Atelier Jardins. Le second décrit la version de phpBB visée par les ressources du style. Pour le laboratoire resté en 3.3.17, nous indiquerons 3.3.17.

Si vous avez réellement mis à jour le clone au cours 4, lisez d’abord le style.cfg du prosilver livré avec cette même version. Reprenez la version correspondante, vérifiée avec votre inventaire du chapitre 1. Ne copiez pas un thème prosilver provenant d’un autre téléchargement plus ancien. Ne changez pas simplement le numéro déclaré pour faire croire qu’un ensemble de fichiers est compatible : une étiquette ne met pas son contenu à jour.

Pour un style tiers, le même raisonnement demande de lire sa fiche officielle, ses prérequis, son éventuel parent et ses notes de version. Une capture attrayante ne répond pas à ces questions. Dans notre exercice, la provenance est simple et contrôlable : le prosilver complet et fonctionnel du clone lui-même. Aucun style tiers n’est nécessaire pour terminer le chapitre.

Conserver une référence que l’on sait reconnaître

Nous créerons un dossier différent, atelier_jardins, dans styles. Le dossier prosilver restera inchangé. Cela permet de comparer le parent et l’enfant, puis de sélectionner à nouveau prosilver si l’essai ne donne pas le résultat attendu. Renommer directement prosilver brouillerait la dépendance et compliquerait les mises à jour du forum.

Le nom visible « Atelier Jardins » comporte un espace ; le dossier atelier_jardins utilise un trait de soulignement. Ce sont deux repères différents. Le fichier de configuration expliquera le nom visible, tandis que le chemin du dossier indiquera où lire ses fichiers. Ne créez pas deux dossiers pour ces deux noms : ils décrivent un seul style.

Les fichiers copiés de prosilver restent des ressources du projet phpBB. Nous conservons leur attribution à phpBB Limited, les mentions présentes dans les fichiers et la référence à la licence GPL version 2 du paquet d’origine. Donner un nom à notre atelier ne fait pas de nous les auteurs de ces ressources. Le cours ne distribue pas un nouveau paquet de style ; si vous partagez ultérieurement une copie, conservez aussi les informations de licence et d’attribution applicables.

La présentation ne donne pas de nouveaux droits

accueil_test reste un membre ordinaire. Même après avoir choisi Atelier Jardins, il ne doit pas lire Coordination ni les espaces réservés aux adhérents. equipe_test reste modérateur local de Questions publiques et du Bac à sable de modération. Un changement de style n’ajoute ni groupe ni permission.

Lors des essais, nous regarderons à la fois ce qui fonctionne et ce qui reste refusé. Nous distinguerons également « installer un style », « le rendre sélectionnable » et « le choisir pour une personne ». Un style installé et actif n’est pas automatiquement imposé à tout le monde. La troisième leçon détaillera le choix personnel, les invités, le style par défaut et l’option qui force un style commun.

Exemple — une installation annoncée comme réussie

Camille prépare une fiche Atelier Jardins avec parent = prosilver, puis oublie le dossier theme. Le panneau peut annoncer que le style a été installé. Ce message prouve que son enregistrement a eu lieu ; il ne garantit pas que tous les fichiers nécessaires à une page existent.

La bonne correction consiste à reprendre la structure prévue et à copier le thème complet de la même version. Modifier les permissions des membres ou changer le nom du style ne fournirait pas les fichiers CSS manquants.

Exercice — préparer une fiche de décision

1. Dans votre carnet, écrivez l’adresse du clone de personnalisation et l’emplacement de S3. Notez « aucune modification de la source ni du clone de retour ».
2. Dans l’Explorateur, ouvrez le dossier styles du clone, puis prosilver. Repérez style.cfg, template et theme, sans les modifier.
3. Ouvrez le style.cfg de prosilver en lecture dans un éditeur de texte. Relevez sa version et la version de phpBB indiquée. Fermez sans enregistrer.
4. Décrivez en quatre phrases le futur enfant : son nom, son dossier, son parent et la provenance du thème copié.
5. Écrivez deux résultats attendus : une apparence identique à prosilver et des permissions inchangées. Ajoutez comment vous réagiriez à un thème incomplet : corriger les fichiers de l’enfant avant de poursuivre.

Un style présente les données du forum ; il ne remplace pas leurs permissions. Dans Atelier Jardins, les modèles seront hérités de prosilver et le thème sera copié intégralement depuis la même version. Conservez le parent, ses attributions et la distinction entre version du style et version de phpBB visée.