PhpBB Lab Académie

Créer la fiche du style enfant, copier les ressources complètes de son thème et vérifier son installation puis son aperçu sans remplacer prosilver.

Construire une arborescence simple

Notre cible reste le dossier C:\wamp64\www\forum-ecole-restauration. Dans son sous-dossier styles, prosilver existe déjà. Nous allons créer à côté un dossier atelier_jardins. Vérifiez le chemin complet dans l’Explorateur avant de créer quoi que ce soit : un dossier styles existe aussi dans le forum source et dans le clone de retour, que nous ne modifions pas.

Si atelier_jardins existe déjà parce que vous reprenez un essai interrompu, examinez son contenu et la liste des styles installés avant de recommencer. Ne fusionnez pas aveuglément deux versions. Dans le déroulement normal de ce cours, ce nom n’existe pas encore et le nouveau dossier sera vide.

Affichez les extensions de noms de fichiers dans l’Explorateur. Un document style.cfg.txt pourrait sembler correct si sa dernière extension était masquée, mais phpBB ne le reconnaîtrait pas comme la fiche attendue. Nous utilisons un éditeur de texte brut, par exemple le Bloc-notes, pas un traitement de texte produisant une page mise en forme.

Lire une ligne de configuration

Dans style.cfg, une ligne utile associe un nom de réglage à une valeur, séparés par le signe égal. À gauche, on conserve le nom du réglage ; à droite, on écrit sa valeur. Une ligne commençant par # est un commentaire : elle sert à expliquer le fichier. Les lignes vides permettent simplement de l’aérer.

name donne le nom visible dans phpBB. copyright conserve l’attribution des ressources reprises. style_version décrit notre édition d’atelier. phpbb_version indique la version de phpBB visée. parent désigne le style installé dont nous hériterons les modèles. Ce fichier n’est pas un programme PHP et ne comporte pas de mot de passe.

Pour un clone vérifié en 3.3.17, copiez exactement ce contenu dans un nouveau document texte :

# Atelier local : templates herites et theme copie de prosilver.
# Ressources prosilver : phpBB Limited.
# Licence des ressources reprises : GNU GPL version 2 (GPL-2.0).
name = Atelier Jardins
copyright = © phpBB Limited, 2007
style_version = 1.0.0
phpbb_version = 3.3.17
parent = prosilver

Si votre clone a réellement été mis à jour et que son prosilver correspond à une autre version, remplacez seulement la valeur phpbb_version par celle vérifiée à la leçon précédente. Ne devinez pas un futur numéro. La valeur style_version reste 1.0.0 pour cette première édition de notre enfant. Les fichiers de thème copiés à l’étape suivante doivent venir de ce même prosilver vérifié.

Enregistrez le document en UTF-8, de préférence sans BOM si ce choix est proposé. Dans la boîte « Enregistrer sous », choisissez le type « Tous les fichiers » si nécessaire pour éviter l’ajout de .txt. Donnez-lui le nom style.cfg et placez-le directement dans styles\atelier_jardins. Fermez puis rouvrez le fichier pour vérifier le nom et les valeurs, sans lui ajouter une deuxième extension.

Copier tout le thème

Dans styles\prosilver, sélectionnez le dossier theme, copiez-le, puis collez cette copie dans styles\atelier_jardins. Il s’agit d’une copie, pas d’un déplacement : le thème de prosilver reste à sa place. Copiez le dossier entier avec tous ses fichiers et sous-dossiers, sans choisir seulement les fichiers dont le nom vous semble familier.

Vous devez maintenant retrouver ces deux fichiers aux emplacements suivants :

C:\wamp64\www\forum-ecole-restauration\styles\atelier_jardins\style.cfg
C:\wamp64\www\forum-ecole-restauration\styles\atelier_jardins\theme\stylesheet.css

Le dossier theme contient davantage que stylesheet.css : conservez l’ensemble. Vous ne devez pas obtenir theme\theme\stylesheet.css, ni atelier_jardins\atelier_jardins\style.cfg. Ces dossiers doublés décaleraient l’emplacement attendu. Aucun dossier template n’est à copier pour ce montage : les modèles viendront du parent prosilver.

Nous n’ouvrons aucun fichier CSS pour le modifier. Un changement de couleur n’est pas nécessaire pour prouver l’installation. Les mentions de licence et d’attribution des fichiers copiés sont conservées ; elles ne sont pas remplacées par le nom de notre association.

Enregistrer le style dans phpBB

Sur le clone, connectez-vous comme CamilleAdmin et ouvrez le Panneau d’administration. Le clone peut rester fermé pendant cette préparation : l’administrateur conserve l’accès requis. Dans l’onglet « Personnaliser », ouvrez « Installer des styles ».

Repérez la ligne « Atelier Jardins ». Relisez « Chemin du style » et la version indiquée. Si phpBB signale que le parent manque ou que le style ne peut pas être installé, lisez ce message avant toute correction. prosilver doit être installé, et notre fiche doit nommer exactement ce parent.

Activez « Installer le style » pour la seule ligne Atelier Jardins. Lisez le message « Le style “Atelier Jardins” a été installé. », puis utilisez « Aller à la liste des styles installés ». Dans cette version de phpBB, l’installation rend le style actif automatiquement. Actif signifie ici disponible pour être sélectionné ; cela ne signifie pas qu’il remplace le choix de chaque membre.

Dans « Gérer les styles », vous devez retrouver prosilver et Atelier Jardins. Le lien « Désactiver le style » sur la ligne de l’enfant indique qu’il est actuellement actif. Ne l’actionnez pas simplement pour vérifier ce libellé. « Détails » permet aussi de lire sa fiche et l’état « Style actif ».

Conservez prosilver comme style par défaut. Dans « Général », « Configuration du forum », vérifiez également « Style pour les invités » sur prosilver et « Annuler le style de l’utilisateur » sur Non. Ce sont des réglages distincts que la prochaine leçon expliquera avec un vrai compte ordinaire. L’installation d’Atelier Jardins ne justifie pas de modifier les groupes ou permissions du forum.

Faire un aperçu sans enregistrer une préférence

Revenez à « Personnaliser », « Gérer les styles ». Sur la ligne Atelier Jardins, activez « Aperçu ». Le navigateur ouvre une page du forum qui demande ce style pour l’aperçu. L’adresse peut comporter un paramètre style suivi d’un numéro. Ce numéro est attribué par votre installation ; il n’est pas à recopier depuis un autre forum.

Avec CamilleAdmin, consultez l’index, Questions publiques puis un sujet d’exercice. Les titres, liens, messages et formulaires doivent rester utilisables. L’apparence ressemble à prosilver : nous avons repris ses modèles et son thème. Cette ressemblance est le résultat attendu, pas la preuve d’un échec.

L’aperçu ne constitue pas le choix enregistré d’accueil_test. Pour sortir de cet essai, rouvrez explicitement l’adresse normale http://localhost/forum-ecole-restauration/, sans paramètre style, ou fermez l’onglet d’aperçu puis ouvrez cette adresse. Garder un lien issu de l’aperçu pourrait prolonger cette sélection ponctuelle et brouiller les tests de préférence.

Si Atelier Jardins n’apparaît pas

Vérifiez d’abord le dossier du clone, le nom atelier_jardins, le style.cfg directement à sa racine et l’absence de suffixe .txt. Vérifiez ensuite qu’il n’est pas déjà dans « Gérer les styles » : un style installé n’attend plus dans la liste d’installation. Relisez enfin name et parent dans sa fiche. Corrigez une cause à la fois, puis rechargez la page adaptée.

Si le style est installé mais que la présentation est manifestement incomplète, contrôlez le chemin theme\stylesheet.css et la copie entière du thème. Ne modifiez pas prosilver pour compenser une copie manquante. Un message d’installation réussie ne dispense pas de ce contrôle des fichiers et de l’aperçu.

Exemple — un dossier de trop

Camille crée atelier_jardins, puis y colle un autre dossier atelier_jardins contenant style.cfg. Le fichier existe sur le disque, mais pas à l’emplacement que phpBB recherche. Le chemin contient deux fois le nom du style.

Après avoir identifié les fichiers de cet essai, Camille replace style.cfg et theme directement sous le premier dossier atelier_jardins. Le parent prosilver ne bouge pas. L’écran « Installer des styles » peut alors détecter la fiche au bon niveau.

Exercice — installer puis relire

1. Dans le styles du seul clone de personnalisation, créez atelier_jardins et sa fiche expliquée ci-dessus. Vérifiez l’extension réelle du fichier et la version correspondant à votre clone.
2. Copiez intégralement le dossier theme de son prosilver. Relisez les deux chemins de contrôle ; il ne doit y avoir aucun dossier doublé.
3. Comme CamilleAdmin, ouvrez « Personnaliser », « Installer des styles », puis installez Atelier Jardins. Notez le message de réussite et son état actif.
4. Vérifiez que prosilver reste actif et par défaut, que le style des invités reste prosilver et que l’annulation des choix utilisateur reste sur Non.
5. Utilisez « Aperçu » pour Atelier Jardins. Parcourez l’index, Questions publiques et un sujet d’exercice. Notez le fonctionnement observé sans inventer une différence de couleur.
6. Sortez de l’aperçu en rouvrant l’adresse normale du clone. Le clone est toujours fermé pour les participants ordinaires ; leur fenêtre de test arrive à la leçon suivante.

Créez une fiche correctement nommée et copiez le thème entier de la même version, sans déplacer prosilver. Installez l’enfant depuis « Personnaliser », puis vérifiez son état et son aperçu. La présence du style dans la liste et l’apparence de ses pages sont deux contrôles complémentaires.