PhpBB Lab Académie

Identifier la fonction à ajouter, vérifier la provenance et les prérequis d’une version stable de Board Announcements, puis préparer une décision d’installation adaptée au clone.

Partir du besoin avant de chercher un téléchargement

Les Jardins Partagés souhaitent afficher une courte information sur l’index du forum. Cette information doit être visible sans ouvrir une discussion. Le nom et la description du site présentent déjà la communauté ; un sujet épinglé sert à mettre une discussion en évidence. Notre besoin est différent : un petit panneau d’information, que l’administrateur peut configurer séparément des sujets.

Board Announcements ajoute cette fonction à phpBB. Son nom peut se traduire par « annonces du forum ». L’extension fournit des réglages et un emplacement d’affichage ; nous rédigerons nous-mêmes le texte au prochain chapitre. Installer cet outil ne crée pas automatiquement la bonne annonce et ne remplace pas la vérification de son public.

Le cours utilise Board Announcements 1.3.0 comme version de référence. Ce numéro identifie la version dont nous avons étudié les fichiers et les libellés. Il ne signifie pas qu’elle restera indéfiniment la dernière version publiée. Si vous préparez l’atelier plus tard, vérifiez la version réellement proposée et les changements annoncés avant de suivre des écrans différents.

Une extension, un style et un réglage natif

Un réglage natif utilise une fonction déjà présente dans phpBB, comme le nom du site. Un style organise la présentation. Une extension ajoute ou adapte des fonctions au moyen de fichiers installés dans ext/. Il ne faut pas chercher une extension chaque fois qu’une option existante répond déjà au besoin.

Une extension n’est pas non plus une modification manuelle du cœur. Nous ne collerons aucun code dans index.php ou dans les templates de prosilver. Les fichiers de l’ajout restent identifiables dans son propre dossier, et le gestionnaire permet d’activer ou de désactiver ses fonctions. Cette séparation facilite l’entretien, sans rendre les vérifications inutiles.

D’où vient le paquet ?

La documentation du projet renvoie vers sa fiche dans la base officielle des extensions de phpBB : https://www.phpbb.com/customise/db/extension/boardannouncements/ . Cherchez le paquet de diffusion validé correspondant à la version que vous retenez. Relevez l’auteur, le numéro, les prérequis et les instructions de cette publication.

Le dépôt de développement contient aussi des fichiers, mais le bouton « Code » puis « Download ZIP » d’une branche n’est pas un choix équivalent. Une branche peut évoluer entre deux téléchargements et contenir un travail non publié. Une mention beta, RC ou dev ne signifie pas version stable. Notre atelier ne demande pas de forcer l’installation d’une version instable.

Si la fiche est momentanément inaccessible, notez cette difficulté et reprenez le téléchargement officiel lorsqu’elle redevient accessible. Ne transformez pas le premier fichier trouvé sur un site inconnu en paquet de référence. Une archive déjà conservée depuis une diffusion officielle identifiable peut convenir, à condition d’en vérifier le numéro et l’intégrité comme appris au cours précédent.

Lire les prérequis avec les bonnes versions

Board Announcements 1.3.0 déclare une compatibilité avec phpBB à partir de 3.3.0 et avant la branche 4.0 en développement. Votre phpBB 3.3.17 entre dans cette plage déclarée. Si votre clone a été réellement actualisé au cours précédent, reprenez son numéro exact : ne supposez pas qu’il est encore en 3.3.17 simplement parce que le premier cours utilisait cette version.

Son manifeste déclare également PHP à partir de 7.1.3 dans la branche 7, ou PHP dans la branche 8. Ces indications se combinent avec les exigences de phpBB lui-même. Elles n’autorisent pas à abaisser PHP en dessous de ce que phpBB demande. La version de PHP est celle du serveur qui exécute le forum, pas la version de Windows ni celle du navigateur.

Une plage déclarée est un premier filtre. Elle ne prouve pas que votre thème, vos autres ajouts et votre environnement réel ont tous été testés ensemble. C’est la raison de notre clone et des contrôles du chapitre suivant. Le style Atelier Jardins hérite ici des templates de prosilver ; nous vérifierons néanmoins le résultat au lieu de promettre une compatibilité visuelle universelle.

Conserver l’identité de l’ajout

Le nom visible est Board Announcements ; son identité technique est phpbb/boardannouncements. La première partie identifie le fournisseur technique, la seconde l’extension. Elles détermineront son emplacement. Cette extension tierce garde son identité phpbb. Le fait que notre formation soit publiée par PHPBB Lab ne justifie pas de remplacer ce nom par phpbblab.

La version de référence est distribuée sous GPL version 2. Conservez les mentions et fichiers de licence du paquet. Vous n’avez pas besoin de renommer les auteurs, de traduire les noms de dossiers ou de modifier le code pour utiliser l’extension. Notre exercice porte sur son installation et ses réglages, pas sur le développement d’un nouveau module.

La fiche de décision des Jardins Partagés

Besoin : afficher une information locale d’atelier sur l’index, distincte d’un sujet du forum.
Outil retenu : Board Announcements.
Version de référence étudiée : 1.3.0.
Identité technique attendue : phpbb/boardannouncements.
Cible unique : forum-ecole-restauration, le clone de personnalisation.
Vérifications : provenance officielle, version stable, prérequis PHP et phpBB, instructions, licence, essai avec les styles du clone.

Le forum source et le clone de retour ne figurent pas parmi les cibles. La sauvegarde S3 constitue notre point d’avant personnalisation et reste intacte. Elle n’est pas un dossier dans lequel installer le nouvel ajout.

Le critère futur sera concret : une annonce fictive à l’index du clone, consultable par les comptes prévus, avec ses données conservées lors d’une désactivation puis réactivation. « L’archive a été téléchargée » ne suffira pas à valider ce résultat.

Préparer le paquet sans encore l’installer

1. Reprenez le carnet d’inventaire du clone. Relevez ses versions effectives de phpBB et de PHP, les styles installés et les extensions réellement présentes. Les extensions de la plateforme PHPBB Lab ne sont pas automatiquement celles de votre Forum école.

2. Consultez la fiche officielle de Board Announcements. Identifiez une publication stable et ses instructions. Pour reproduire précisément cette édition, vérifiez la référence 1.3.0 ; si vous retenez une autre publication, relevez son numéro et ses différences documentées au lieu de lui attribuer automatiquement les mêmes écrans.

3. Téléchargez le paquet retenu dans Documents/Atelier-phpBB, hors de www. Conservez l’archive d’origine. Décompressez-en une copie dans un sous-dossier nommé preparation-boardannouncements. L’extraction prépare des fichiers ; elle ne les installe pas encore dans phpBB.

4. Repérez composer.json à la racine de l’extension extraite et ouvrez-le en lecture dans un éditeur de texte. Recherchez les informations name, version et license. Pour la référence étudiée, vous devez lire phpbb/boardannouncements, 1.3.0 et GPL-2.0-only. Ce fichier est une fiche descriptive du programme ; le lire ne demande pas de lancer Composer.

5. Notez votre décision dans le carnet, avec la provenance et la date du téléchargement. Comparez les prérequis de l’extension à ceux de phpBB et aux versions du clone. N’éditez aucun numéro pour donner artificiellement l’apparence d’une compatibilité.

6. Gardez le clone fermé comme à la fin du chapitre des styles. À ce stade, seul le dossier privé de préparation contient le nouvel ajout. Aucun fichier du forum source, du clone de retour ou du cœur phpBB n’a été modifié.

Une extension se choisit pour une fonction précise. Sa provenance, sa version, ses prérequis et son identité technique doivent être connus avant la copie. Board Announcements 1.3.0 est notre référence, pas une promesse de dernière version permanente. Le travail reste limité au clone.