PhpBB Lab Académie

Créer S4, répéter proprement un remplacement des fichiers de Board Announcements sans perdre son annonce et préparer la maintenance du style enfant avec son parent.

Entretenir ce que vous venez d’installer

Votre clone possède maintenant un style Atelier Jardins et une annonce fonctionnelle. Une personnalisation ne s’arrête pas à l’installation : les versions évoluent, des corrections apparaissent et le style peut dépendre de ressources conservées ailleurs. Nous allons apprendre à intervenir en gardant une preuve du résultat et un moyen de retrouver l’état précédent.

La seule cible reste http://localhost/forum-ecole-restauration/. Les dossiers forum-ecole et forum-ecole-retour ne sont pas concernés. Dans cette leçon, nous répéterons réellement le remplacement des fichiers de l’extension avec le paquet stable déjà utilisé. Réinstaller les fichiers de la même version n’est pas une mise à jour vers une version plus récente : inscrivez « répétition à version identique » dans le carnet.

Préparer le point S4

Avec CamilleAdmin, vérifiez que le clone est fermé et qu’aucun compte ni traitement n’y écrit. Constituez une paire complète suivant la méthode du cours 4 : toutes les tables de phpbb_ecole_restauration, structure et données, dans un SQL neutre ; tous les fichiers du dossier forum-ecole-restauration pendant la même période maîtrisée. Les courriels restent désactivés.

Placez cette paire dans un nouveau dossier privé, extérieur à www :

Documents\Sauvegardes-phpBB\S4-AAAA-MM-JJ-HHMM-avant-entretien-ajouts

Remplacez les repères de date et d’heure. Conservez phpbb_ecole_restauration.sql, fichiers\forum-ecole-restauration, inventaire.txt et preuves.txt. Ne réutilisez pas le dossier S3 : S3 précède les personnalisations, tandis que S4 les contient. En cas de difficulté à produire la paire, reprenez le chapitre de sauvegarde avant de remplacer des fichiers.

Ajoutez à l’inventaire les versions réellement installées de phpBB, prosilver, Atelier Jardins et Board Announcements, ainsi que leurs sources de téléchargement. Notez le texte exact de l’annonce et les réglages validés au chapitre 4. Ajoutez le choix Atelier Jardins d’accueil_test. Aucun mot de passe ne doit figurer dans les notes.

Décider s’il existe une véritable mise à jour

Pour une intervention future, consultez la fiche officielle de l’extension, son historique et les instructions de l’auteur. Comparez la version proposée à celle installée ; vérifiez les versions de PHP et phpBB acceptées. Un numéro plus élevé ne suffit pas si la nouvelle publication vise une autre branche de phpBB. Une préversion de développement n’est pas le paquet de référence de cet exercice.

Si une version validée compatible existe, suivez ses instructions d’actualisation, y compris un éventuel ordre particulier des versions. Si aucune mise à jour adaptée n’est disponible, vous pouvez conserver la version actuelle. Le cours n’invente pas une nouvelle publication pour vous obliger à changer.

Notre référence est Board Announcements 1.3.0. Pour la répétition, reprenez son paquet officiel conservé au chapitre 3. Si vous aviez choisi une autre version validée, reprenez exactement cette version et ses instructions. L’objectif est de connaître les gestes et de vérifier la conservation des données, pas de simuler un changement de numéro.

Remplacer uniquement les fichiers du module

Décompressez le paquet dans votre espace de préparation hors www. Contrôlez composer.json, son nom phpbb/boardannouncements et sa version. Retrouvez directement les dossiers du module sous le dossier boardannouncements ; évitez un niveau supplémentaire provenant du nom du ZIP.

Dans le panneau d’administration du clone, ouvrez Personnaliser, puis Gérer les extensions. Désactivez Board Announcements et attendez le message de réussite. Cette désactivation conserve ses données. Ne choisissez pas « Supprimer les données » : l’annonce enregistrée fait partie de ce que nous voulons retrouver.

Dans l’Explorateur, vérifiez une nouvelle fois le chemin du clone :

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

Déplacez uniquement cet ancien dossier boardannouncements vers un sous-dossier daté de Documents\Atelier-phpBB\anciens-fichiers, hors www. Ne le renommez pas simplement en boardannouncements-ancien à côté de l’extension : nous ne voulons pas laisser plusieurs copies de son manifeste dans l’arborescence ext.

Copiez le dossier neuf issu du paquet préparé à sa place. Le résultat doit à nouveau contenir ext\phpbb\boardannouncements\composer.json, avec les fichiers de cette seule version. Le parent ext\phpbb peut héberger d’autres extensions ; ne le supprimez pas. Aucun fichier config.php du forum n’est remplacé par cette opération.

Revenez au gestionnaire et activez Board Announcements. Attendez la fin de l’opération. L’activation d’une nouvelle version peut faire évoluer ses données par des migrations ; la répétition avec la même version retrouve les migrations déjà appliquées. Nous n’allons ni lancer un installateur phpBB neuf ni effacer des tables à la main.

Vérifier les données après l’opération

Ouvrez Extensions, Annonce du forum, Paramètres de l’annonce. Vous devez retrouver une seule annonce, sa description administrative et son texte exact. Contrôlez le réglage global d’affichage, le réglage individuel, le public, l’index comme emplacement, le masquage désactivé et les champs d’expiration et de couleur vides.

Ouvrez temporairement le seul clone avec CamilleAdmin. Sur l’index, vérifiez le texte avec un vrai visiteur puis avec accueil_test, dont le style doit rester Atelier Jardins. Vérifiez aussi qu’une page de sujet n’affiche pas cette annonce limitée à l’index. Refermez le clone après les essais et consignez les résultats.

Si une activation ou une vérification échoue, gardez l’erreur exacte et consultez la leçon suivante. Pour une vraie montée de version ayant changé la base, remettre seulement les anciens fichiers ne garantit pas un retour cohérent. Le point complet S4 et la méthode de restauration isolée du cours 4 servent à retrouver la paire précédente.

Le style enfant a aussi une maintenance

Atelier Jardins hérite des modèles de prosilver, mais son dossier theme est une copie physique de celui du parent. Une mise à jour de prosilver ne recopie pas automatiquement ses nouveaux fichiers dans ce dossier enfant. Il faut donc suivre ensemble le parent, les ressources copiées et la version phpBB effectivement utilisée.

Dans notre atelier sans modification CSS, une future actualisation du parent demandera de sauvegarder l’enfant, de reprendre le thème complet du prosilver correspondant et de refaire la recette des pages. Vérifiez aussi les métadonnées de style.cfg. Le champ phpbb_version doit décrire la référence réelle ; changer sa valeur ne rend pas des fichiers anciens compatibles. La version 1.0.0 d’Atelier Jardins est le numéro de notre style, pas celui de phpBB.

Si vous personnalisez plus tard le CSS, une copie automatique du thème neuf pourrait écraser ces changements. Il faudra alors comparer et reporter volontairement les modifications, ou suivre la méthode d’entretien d’un véritable style distribué par son auteur. Pour aujourd’hui, conservez le parent et l’enfant cohérents, sans introduire un nouvel exercice de développement.

Exemple — une opération à nommer correctement

Camille désactive Board Announcements 1.3.0, remplace son dossier par les fichiers propres du paquet 1.3.0, puis le réactive. L’annonce est toujours là. Elle a réussi une répétition de maintenance, mais sa version est restée 1.3.0.

Plus tard, une version différente pourra annoncer un changement des données. Camille lira alors les instructions de cette publication et fera un nouveau point de sauvegarde avant l’intervention. Le succès de la répétition précédente ne justifie pas de sauter cette préparation.

Exercice — une répétition contrôlée

1. Avec CamilleAdmin, contrôlez l’adresse du clone, sa fermeture et l’absence d’écritures. Constituez S4 complet avec les preuves de l’annonce et du style.
2. Hors www, préparez le paquet de la même version stable de Board Announcements que celle installée. Vérifiez son identité et sa version.
3. Dans le gestionnaire du clone, désactivez cette extension et attendez la réussite. Déplacez son ancien dossier hors www, puis copiez le dossier neuf au chemin technique attendu.
4. Réactivez l’extension sans supprimer ses données. Retrouvez l’annonce et ses réglages dans le panneau d’administration.
5. Ouvrez temporairement le clone, testez l’index comme visiteur puis accueil_test et une page de sujet. Refermez-le.
6. Inscrivez les versions avant et après, « répétition à version identique », les résultats observés et le nom S4. Expliquez pourquoi le thème copié d’Atelier Jardins devra être suivi lors d’un changement de prosilver.

Constituez S4 avant l’entretien. Pour remplacer les fichiers d’une extension, suivez sa procédure et préservez ses données lorsqu’elles doivent être conservées. Une répétition à version identique reste une répétition. Les ressources copiées du thème enfant demandent un suivi distinct de l’héritage des modèles.