PhpBB Lab Académie

Placer le dossier de l’extension à son emplacement exact dans le clone, vérifier sa détection, l’activer dans le PCA et retrouver son écran de configuration encore vide.

Pourquoi l’emplacement est-il aussi important ?

phpBB recherche les extensions sous son dossier ext. Pour Board Announcements, l’identité phpbb/boardannouncements correspond à deux niveaux : un dossier phpbb sous ext, puis un dossier boardannouncements sous phpbb. Le fichier composer.json doit se trouver directement dans ce dernier dossier.

Pensez à une adresse composée de plusieurs parties. Le nom de la rue et le numéro ne sont pas interchangeables ; de même, ext/phpbb/boardannouncements n’est pas équivalent à ext/boardannouncements/phpbb. Un nom visible agréable ne compense pas une adresse technique incorrecte.

Le dossier phpbb peut déjà exister dans ext parce qu’un autre module du même fournisseur y est présent. Cela ne signifie pas que Board Announcements est déjà installé. On ajoute son propre dossier boardannouncements sans remplacer tout le dossier phpbb ni ses autres extensions.

L’archive peut comporter une enveloppe supplémentaire

Le logiciel de décompression crée parfois un dossier portant le nom de l’archive, puis le véritable contenu à l’intérieur. Le paquet peut lui-même proposer un dossier phpbb contenant boardannouncements. C’est pourquoi nous avons repéré composer.json avant de copier : il indique le dossier réel de l’extension.

Ne choisissez pas le dossier uniquement d’après sa taille ou sa première position dans la fenêtre. Ouvrez-le et retrouvez composer.json, ext.php ainsi que les autres répertoires fournis. Nous copions l’extension complète, pas seulement son manifeste. Un composer.json seul est une description sans le programme qui doit l’accompagner.

Le résultat attendu est ce chemin précis :

C:\wamp64\www\forum-ecole-restauration\ext\phpbb\boardannouncements\composer.json

Il ne doit pas contenir un second ext, un second phpbb ou un dossier intermédiaire boardannouncements-1.3.0 entre boardannouncements et composer.json. L’archive peut porter ce suffixe de version ; le dossier technique installé porte simplement boardannouncements.

Copier et activer sont deux étapes

La copie rend les fichiers disponibles sur le disque. L’activation demande à phpBB de prendre en compte l’extension et, si nécessaire, de préparer ses tables et ses réglages. Le gestionnaire affiche ces états. La première copie peut apparaître sous « Extensions non installées ». Une extension déjà installée puis arrêtée apparaît sous « Extensions désactivées ».

Vous n’avez pas à exécuter un script PHP, à installer Composer ou à lancer npm pour cette procédure utilisateur. Les instructions de Board Announcements demandent un paquet préparé, une copie sous ext et une activation dans le PCA. Le nom composer.json ne transforme pas la lecture du manifeste en installation d’un outil supplémentaire.

Les réglages de Board Announcements se trouvent dans le PCA, donc nous utiliserons CamilleAdmin. Les comptes inscrit_test et accueil_test serviront à vérifier l’expérience des membres plus tard ; ils n’ont pas besoin de devenir administrateurs pour voir une annonce.

Prévoir ce que vous allez constater

Après l’activation, le gestionnaire indique que l’extension est activée et propose de la désactiver. L’onglet « Extensions » donne accès à « Annonce du forum », puis à « Paramètres de l’annonce ». Comme nous effectuons une première installation dans ce laboratoire, la liste des annonces sera vide.

L’absence de bandeau à ce stade est normale. Nous n’avons pas encore écrit de message. De plus, l’option générale « Activer les annonces du forum » est initialement sur Non. L’état actif du module et l’autorisation générale d’afficher ses annonces sont deux informations différentes. Nous apprendrons à les manipuler sans ambiguïté.

Lire un chemin plutôt que deviner une copie

Dans la préparation, vous pourriez trouver preparation-boardannouncements/phpbb/boardannouncements/composer.json. Le dossier à installer est alors boardannouncements, qui contient directement composer.json. Vous le copiez dans le dossier ext/phpbb du clone.

Autre présentation possible : preparation-boardannouncements/boardannouncements-1.3.0/composer.json. Dans la copie de préparation seulement, le dossier contenant directement le manifeste doit être nommé boardannouncements avant son placement sous ext/phpbb. Son contenu interne n’est pas modifié.

Dans les deux cas, vous contrôlez la même destination finale. Si ext/phpbb existe déjà, ouvrez-le et ajoutez seulement boardannouncements. Vous ne remplacez ni son contenu entier ni le dossier ext de l’installation.

Installer dans le clone fermé

1. Vérifiez le chemin de la destination dans l’Explorateur : C:/wamp64/www/forum-ecole-restauration. Le dossier forum-ecole est le forum source et forum-ecole-retour est l’autre clone ; aucun des deux n’est notre cible. Alt+D permet de placer le focus dans la barre d’adresse pour lire le chemin complet.

2. Ouvrez ext dans le clone, puis phpbb. Si phpbb n’existe pas, créez ce dossier avec ce nom. Si boardannouncements y existe déjà, ne copiez rien par-dessus : relevez son état et sa version, car vous n’êtes plus dans le cas d’une première installation. Sinon, repérez dans la préparation privée le dossier boardannouncements contenant directement composer.json. Copiez ce dossier complet dans ext/phpbb. Gardez les autres dossiers d’extensions intacts.

3. Ouvrez le composer.json installé en lecture. Vérifiez son chemin final, name et version, puis refermez-le sans modification. Vérifiez également la présence d’ext.php et des autres fichiers copiés.

4. Dans le navigateur, ouvrez http://localhost/forum-ecole-restauration/ et connectez-vous sous CamilleAdmin. Vérifiez le nom « Jardins Partagés — clone de personnalisation », puis ouvrez le PCA. Le clone reste fermé aux visites ordinaires durant cette préparation.

5. Ouvrez « Personnaliser », puis « Gestion des extensions » et « Gérer les extensions ». Retrouvez la ligne Board Announcements, normalement parmi les extensions non installées. Lisez sa version et utilisez « Détails » pour contrôler les informations. Ne confondez pas ce menu avec la gestion des extensions de fichiers joints.

6. Sur la ligne Board Announcements, choisissez « Activer ». L’écran de confirmation rappelle le nom de l’extension ; relisez-le, puis utilisez le bouton « Activer » de cette confirmation. Attendez le message « L’extension a été activée. » Pendant un traitement en cours, ne quittez pas et n’actualisez pas la page.

7. Utilisez « Retourner à la liste des extensions ». Vérifiez Board Announcements dans « Extensions activées ». Ouvrez ensuite l’onglet « Extensions », puis « Annonce du forum » et « Paramètres de l’annonce ».

8. Repérez la liste vide et le bouton « Créer une annonce », sans le déclencher. Vérifiez que « Activer les annonces du forum » est sur Non. Notez la réussite de l’activation, la version et l’accès aux paramètres. Ne créez aucun texte d’essai supplémentaire : le prochain chapitre préparera notre unique annonce commune.

Installer les fichiers et activer les fonctions sont deux étapes. Le manifeste doit être directement sous ext/phpbb/boardannouncements. Après activation, les paramètres sont disponibles, mais notre liste reste vide et l’affichage général reste désactivé. Aucun texte d’annonce n’est créé dans cette leçon.