phpBB Lab

Installer et modifier un thème phpBB : styles, compatibilité, mise à jour et problèmes fréquents

Changer l’apparence d’un forum phpBB paraît souvent très simple.

On télécharge un thème, on copie un dossier dans

styles/

, on l’active et le tour est joué.

En pratique, beaucoup de problèmes commencent exactement à ce moment-là.

Le style n’apparaît pas dans le panneau d’administration.

Le forum devient mal affiché.

Le logo ne change pas.

Une modification du CSS semble être ignorée.

Le thème fonctionnait avant une mise à jour de phpBB et ne fonctionne plus correctement ensuite.

Ou encore, toutes les personnalisations disparaissent lors de l’installation d’une nouvelle version du style.

Pour éviter ces problèmes, il faut d’abord comprendre comment phpBB organise réellement ses styles.

Dans ce guide, nous allons voir :

• []ce qu’est un style phpBB ;
  []la différence entre style, thème et templates ;
  []où installer un nouveau style ;
  []comment reconnaître une bonne arborescence ;
  []comment l’activer ;
  []comment choisir le style par défaut ;
  []comment vérifier sa compatibilité avec votre version de phpBB ;
  []comment modifier proprement son apparence ;
  []pourquoi les modifications semblent parfois ne pas apparaître ;
  []comment mettre un style à jour ;
  []pourquoi un style enfant peut être préférable ;
  []et comment diagnostiquer un forum cassé après un changement de thème.

1. Dans phpBB, on parle surtout de style

Dans le langage courant, beaucoup d’utilisateurs parlent de :

thème phpBB

Dans phpBB, le terme que vous rencontrerez le plus souvent est :

style

Un style définit l’apparence générale du forum.

Il peut notamment intervenir sur :

• []la mise en page ;
  []les couleurs ;
  []les polices ;
  []les boutons ;
  []les icônes ;
  []les menus ;
  []le logo ;
  []l’affichage des forums ;
  []l’affichage des sujets ;
  []les formulaires ;

• les différents composants visuels.

Le style par défaut fourni avec phpBB est généralement :

prosilver

2. Un style ne se résume pas à une feuille CSS

C’est une confusion importante.

Lorsqu’un utilisateur dit :

Je veux changer le thème.

il pense souvent uniquement aux couleurs.

Mais un style phpBB peut contenir plusieurs catégories de fichiers.

Par exemple :

styles/
monstyle/
style.cfg
template/
theme/

Selon le style, vous pourrez y trouver notamment :

template/
theme/
images/
fichiers de configuration

Le style peut donc modifier beaucoup plus que quelques couleurs.

3. Le dossier template

Le dossier :

template/

contient les fichiers de présentation utilisés pour construire les pages.

Ces fichiers déterminent notamment la structure HTML produite par phpBB.

On y retrouve des éléments concernant :

• []l’en-tête ;
  []le pied de page ;
  []les listes de forums ;
  []les sujets ;
  []les profils ;
  []les formulaires ;
  []les menus ;
  []les différents écrans du forum.

Modifier un template peut donc changer la structure d’une page, pas seulement son apparence.

4. Le dossier theme

Le dossier :

theme/

contient généralement les éléments visuels du style.

On peut notamment y retrouver les feuilles CSS.

Exemple :

stylesheet.css

ainsi que d’autres fichiers utilisés pour l’apparence.

C’est souvent ici que sont définis :

• []les couleurs ;
  []les dimensions ;
  []les marges ;
  []les polices ;
  []les comportements responsives ;
  []les éléments de présentation.

5. Pourquoi cette distinction est-elle importante ?

Parce qu’un problème visuel ne vient pas forcément du CSS.

Exemple :

Le bouton est au mauvais endroit.

Cela peut venir de la structure du template.

Autre exemple :

Le bouton est au bon endroit mais sa couleur est incorrecte.

Le problème est alors probablement visuel.

Avant de modifier quoi que ce soit, identifiez donc la nature du problème.

6. Où installer un style phpBB ?

Les styles se trouvent dans :

styles/

Une installation phpBB peut donc ressembler à :

styles/
prosilver/
monstyle/

Le style doit avoir sa propre arborescence.

Par exemple :

styles/
monstyle/
style.cfg
template/
theme/

Le fichier

style.cfg

est particulièrement important pour identifier le style.

7. L’erreur classique : le dossier supplémentaire

Comme avec les extensions, les styles sont souvent distribués dans une archive ZIP.

Vous téléchargez :

monstyle-2.0.zip

Vous décompressez et obtenez :

monstyle-2.0/
monstyle/
style.cfg
template/
theme/

Si vous copiez directement le premier dossier dans

styles/

, vous risquez d’obtenir :

styles/
monstyle-2.0/
monstyle/
style.cfg

Alors que phpBB attend plutôt :

styles/
monstyle/
style.cfg

Il faut donc toujours regarder l’arborescence réelle de l’archive.

8. Le style n’apparaît pas dans le PCA

Avant de chercher une erreur compliquée, vérifiez ceci :

styles/nom_du_style/style.cfg

Si

style.cfg

se trouve un niveau plus bas, le style peut ne pas être détecté comme prévu.

Exemple incorrect :

styles/
monstyle-1.0/
monstyle/
style.cfg

Exemple correct :

styles/
monstyle/
style.cfg

9. Installer n’est pas encore utiliser

Copier les fichiers dans :

styles/

ne signifie pas forcément que le style est immédiatement utilisé.

Il faut ensuite passer par le Panneau d’administration et ouvrir la gestion des styles.

Le style détecté pourra alors être installé ou activé selon l’interface disponible.

Une fois installé, il pourra être utilisé par le forum.

10. Le style par défaut

phpBB possède un style défini par défaut.

C’est celui que le forum propose normalement aux utilisateurs qui n’ont pas choisi autre chose.

Vous pouvez donc avoir plusieurs styles installés :

prosilver
monstyle
autrestyle

mais un seul style par défaut.

Si vous installez un nouveau style sans le définir comme style par défaut, vous pouvez avoir l’impression que rien n’a changé.

11. Un utilisateur peut parfois conserver son ancien style

Selon la configuration du forum, certains utilisateurs peuvent avoir choisi un style particulier dans leurs préférences.

Vous changez alors le style par défaut.

Vous voyez le nouveau style avec un nouveau compte.

Mais un utilisateur existant continue d’utiliser l’ancien.

Ce comportement peut être normal.

Il faut distinguer :

style par défaut du forum

et :

style choisi par un utilisateur

12. Faut-il forcer un style pour tout le monde ?

phpBB permet selon sa configuration de contrôler le choix du style.

Si vous souhaitez absolument que tous les utilisateurs voient la même apparence, vous pouvez utiliser les réglages correspondants.

Mais ne forcez pas cette option simplement pour masquer un problème de configuration.

Déterminez d’abord pourquoi certains utilisateurs voient un autre style.

13. Vérifier la compatibilité avant installation

Un style conçu pour phpBB 3.3 n’est pas automatiquement compatible avec toutes les versions de phpBB 3.3.

C’est particulièrement important lorsque le cœur évolue.

Des templates peuvent être modifiés entre deux versions.

De nouvelles variables peuvent apparaître.

Certaines structures HTML peuvent évoluer.

Un style ancien peut alors continuer à sembler fonctionnel tout en étant partiellement incompatible.

Avant installation, vérifiez :

Version de phpBB
Version du style
Compatibilité annoncée
Date de la dernière mise à jour
Style parent éventuel
Instructions de l’auteur

14. Pourquoi un style ancien peut-il casser après une mise à jour de phpBB ?

Supposons que votre style contienne une copie personnalisée d’un template.
Entre-temps, phpBB modifie le template original de prosilver.

Votre style continue d’utiliser son ancienne copie.

Il peut alors manquer :

• []une nouvelle variable ;
  []une correction ;
  []un nouvel événement ;
  []une modification HTML ;
  []un élément de sécurité ;
  []une amélioration d’accessibilité.

Le problème ne vient pas nécessairement de phpBB.

Votre style n’a simplement pas suivi l’évolution du cœur.

15. Version phpBB et version du style doivent évoluer ensemble

Avant de mettre phpBB à jour, faites l’inventaire de vos styles.

Exemple :

phpBB actuel : 3.3.x

Style :
Nom : Mon Style
Version : 1.4.0
Compatibilité annoncée : à vérifier

Ne découvrez pas après la mise à jour que votre thème principal n’est plus maintenu.

16. Prosilver joue un rôle particulier

prosilver

est le style de référence de phpBB.

Beaucoup de styles utilisent directement ou indirectement sa structure.

Lorsqu’on développe ou adapte un style, prosilver sert donc souvent de référence technique.

Une bonne pratique consiste généralement à conserver prosilver disponible même si votre forum utilise un autre style.

Il peut également être très utile pour diagnostiquer un problème.

17. Un problème existe avec mon style : testez prosilver

C’est l’un des tests les plus simples et les plus utiles.

Votre forum présente un problème visuel ou fonctionnel.

Testez exactement la même page avec prosilver.

Deux résultats sont possibles.

Le problème existe aussi avec prosilver

Le style personnalisé n’est probablement pas la cause principale.

Le problème disparaît avec prosilver

Votre style devient un suspect sérieux.

Ce simple test peut faire gagner énormément de temps.

18. Exemple concret

Avec votre style personnalisé :

Le bouton Répondre a disparu.

Vous passez temporairement sur prosilver :

Le bouton Répondre est présent.

Vous savez maintenant que :

phpBB sait produire le bouton ;
la permission semble correcte ;
le problème est probablement lié au style.

Le diagnostic devient beaucoup plus précis.

19. Modifier directement prosilver : bonne ou mauvaise idée ?

Pour une personnalisation durable, modifier directement prosilver présente un gros inconvénient.

Lors d’une mise à jour de phpBB, les fichiers officiels de prosilver peuvent être remplacés ou évoluer.

Vos modifications deviennent alors difficiles à distinguer des fichiers d’origine.

Vous pouvez :

• []perdre vos changements ;
  []ou conserver un ancien fichier devenu incompatible.

Pour une personnalisation importante, une approche basée sur un style distinct est généralement plus propre.

20. Pourquoi créer un style enfant ?

Un style enfant permet de conserver vos personnalisations dans un style séparé tout en héritant d’un style parent.

Le raisonnement est :

prosilver

base

monstyle

personnalisation

Vous ne recopiez pas nécessairement tous les fichiers de prosilver.

Vous surchargez seulement ce dont vous avez réellement besoin.

Cette approche facilite énormément la maintenance.

21. Exemple d’héritage

Imaginons que vous souhaitiez uniquement modifier :

le logo
quelques couleurs
un template

Au lieu de copier l’intégralité de prosilver puis de modifier trois fichiers, un style correctement conçu peut conserver seulement ses différences.

Le reste continue de venir du style parent.

Cela limite le nombre de fichiers personnalisés à surveiller lors des mises à jour.

22. Copier tout prosilver n’est pas toujours la meilleure solution

C’est une erreur très courante.

On fait :

Copier prosilver
Renommer le dossier
Modifier 5 fichiers

Quelques mois plus tard, phpBB met à jour 40 fichiers dans prosilver.

Votre copie contient toujours 40 anciennes versions.

Vous devez alors comparer énormément de fichiers alors que seulement cinq étaient réellement personnalisés.

Plus votre style contient de copies inutiles, plus sa maintenance devient difficile.

23. Une personnalisation minimale est plus facile à maintenir

Essayez de garder cette logique :

Ne remplacer que ce qui doit réellement être différent.

Si votre style parent fournit déjà un fichier parfaitement adapté, il n’est pas nécessaire d’en conserver une copie simplement pour l’avoir.

Chaque fichier personnalisé devient une responsabilité supplémentaire lors des mises à jour.

24. Modifier les couleurs

Les modifications visuelles passent généralement par les fichiers du thème.

Avant de modifier une règle, identifiez précisément l’élément concerné.

Évitez de changer au hasard une couleur utilisée à quinze endroits différents.

Utilisez les outils de développement du navigateur si nécessaire pour identifier :

la classe ;
la règle ;
le fichier ;
la propriété appliquée.

Puis effectuez une modification ciblée.

25. Je modifie le CSS mais rien ne change

C’est probablement l’un des problèmes les plus courants.

Vous changez :

une couleur
une marge
une police

Vous rechargez la page.

Rien ne change.

Plusieurs caches peuvent intervenir :

• []cache de phpBB ;
  []cache du navigateur ;
  []éventuellement un cache serveur ;
  []éventuellement un proxy ou CDN.

Commencez donc par déterminer si votre nouveau fichier est réellement chargé.

26. Purger le cache phpBB

Après certaines modifications de style ou de template, il peut être nécessaire de purger le cache phpBB.

Cela force le moteur à reconstruire certains éléments mis en cache.

Mais retenez :

Purger le cache
≠
réparer un mauvais code

Si votre template contient une erreur ou votre CSS cible le mauvais élément, vider le cache ne corrigera pas le problème.

27. Le navigateur peut aussi conserver l’ancienne version

Vous avez purgé le cache phpBB mais voyez toujours l’ancien résultat.

Le navigateur peut encore utiliser une ressource mise en cache.

Testez notamment :

actualisation complète
navigation privée
autre navigateur
autre appareil

Cela permet de distinguer un problème serveur d’un cache local.

28. Le logo ne change pas

Avant de remplacer dix fichiers, vérifiez comment votre style affiche réellement le logo.

Selon sa conception, le logo peut venir :

• []d’une image ;
  []du CSS ;
  []d’un template ;
  []d’une configuration particulière ;

• d’un élément hérité du style parent.

La bonne question n’est donc pas seulement :

Où est le logo de phpBB ?

mais :

Comment CE style précis affiche-t-il son logo ?

29. Ne remplacez pas un fichier au hasard uniquement parce qu’il porte le mot logo

Vous trouvez :

logo.png

Vous le remplacez.

Rien ne change.

Cela peut simplement signifier que votre style n’utilise pas ce fichier.

Inspectez la page ou recherchez la référence réelle utilisée par le style.

Cela évite de modifier des fichiers sans effet.

30. Style cassé après modification d’un template

Vous modifiez un fichier HTML du style.

Le forum affiche ensuite :

une page incomplète ;
une erreur ;
une mise en page cassée ;
un élément manquant.

Revenez à la dernière version fonctionnelle du fichier.

Ensuite, comparez précisément votre modification.

Les erreurs fréquentes sont :

• []balise HTML mal fermée ;
  []condition Twig incorrecte ;
  []bloc supprimé involontairement ;
  []variable mal utilisée ;

• copier-coller incomplet.

Modifier un template demande plus de prudence que changer une couleur CSS.

31. Toujours conserver une copie avant modification

Avant de modifier :

overall_header.html
viewtopic_body.html
stylesheet.css
ou tout autre fichier important

conservez une version fonctionnelle.

Vous devez pouvoir répondre à :

Quel était exactement le fichier avant ma modification ?

Sans sauvegarde, un simple test peut devenir une longue recherche.

32. Ne modifiez qu’une chose à la fois

Évitez :

Changer le header
Changer le footer
Modifier 20 règles CSS
Changer le logo
Modifier la navigation
Purger le cache
Puis regarder si ça marche

Si quelque chose casse, vous aurez cinq suspects.

Préférez :

Modification 1
Test

Modification 2
Test

Modification 3
Test

Cette méthode paraît plus lente.

En réalité, elle fait gagner énormément de temps lorsqu’un problème apparaît.

33. Installer plusieurs styles pour tester

Vous pouvez conserver plusieurs styles installés.

C’est utile pour comparer :

prosilver
style actuel
nouveau style

Vous pouvez alors vérifier une même page avec plusieurs rendus.

C’est particulièrement pratique pour déterminer si un problème vient :

du cœur phpBB
ou
du style

34. Une extension fonctionne avec prosilver mais pas avec mon style

C’est un cas classique.
L’extension utilise peut-être un événement de template ou une structure que votre style ne reprend pas correctement.

Scénario :

Extension activée
+
prosilver

fonctionne

Extension activée
+
style personnalisé

élément absent

Le problème est alors probablement lié à la compatibilité du style avec les événements ou templates attendus.

35. Les extensions et les styles doivent pouvoir cohabiter

Un bon style doit rester suffisamment compatible avec les mécanismes de phpBB pour permettre aux extensions d’utiliser les événements prévus.

Un style très ancien ou fortement modifié peut avoir supprimé certains emplacements utilisés par les extensions.

Résultat :

L’extension fonctionne,
mais rien ne s’affiche dans ce style.

Encore une fois, le test avec prosilver est précieux.

36. Le style fonctionne mais certaines pages sont cassées

Notez précisément lesquelles.

Par exemple :

Index : OK
Liste des forums : OK
Sujet : OK
Profil : cassé
PCA : sans rapport
Messagerie privée : cassée

Cette information permet de rechercher les templates spécifiques aux pages touchées.

Dire :

Le thème est cassé.

est trop vague.

Dire :

Le formulaire de rédaction est cassé uniquement avec ce style.

est déjà un vrai diagnostic.

37. Mettre un style à jour n’est pas simplement copier des fichiers au hasard

Vous utilisez :

Mon Style 1.2

et une version :

1.3

est publiée.

Si vous avez personnalisé directement la version 1.2, remplacer tous les fichiers peut supprimer vos modifications.

À l’inverse, conserver tous vos anciens fichiers peut empêcher de bénéficier des corrections de la version 1.3.

Il faut donc connaître précisément :

les fichiers officiels ;
les fichiers personnalisés ;
les changements de la nouvelle version.

38. C’est pourquoi il faut séparer personnalisation et fichiers d’origine

Si vous modifiez directement 40 fichiers d’un style tiers, chaque mise à jour devient difficile.

Si vos personnalisations sont isolées et documentées, vous savez immédiatement ce que vous devez réappliquer ou comparer.

Une personnalisation propre est donc aussi une stratégie de maintenance.

39. Avant de mettre à jour un style

Préparez au minimum :

Version actuellement installée
Nouvelle version
Version phpBB utilisée
Liste des personnalisations
Sauvegarde du style actuel
Instructions de mise à jour

Ne remplacez jamais votre seul exemplaire fonctionnel sans avoir de retour arrière.

40. Une bonne procédure de mise à jour

Selon les instructions de l’auteur, la logique générale est :

1. Vérifier la compatibilité avec votre version de phpBB.
2. Sauvegarder le style actuel.
3. Identifier vos modifications personnelles.
4. Installer ou préparer la nouvelle version.
5. Reporter uniquement les personnalisations nécessaires.
6. Purger le cache.
7. Tester les pages importantes. 8. Tester sur ordinateur et mobile.
9. Vérifier les extensions.
10. Vérifier les comptes connectés et visiteurs.
    

41. Tester seulement la page d’accueil ne suffit pas

Un style peut sembler parfait sur l’index et être cassé ailleurs.

Après une mise à jour importante, vérifiez au minimum :

Index
Forum
Sujet
Création d’un sujet
Réponse
Profil
Connexion
Inscription
Messagerie privée
Recherche
Panneau utilisateur
Pages utilisées par vos extensions

Si votre communauté utilise fortement les mobiles, testez également sur petit écran.

42. L’accessibilité fait partie d’un bon style

Un thème visuellement joli peut être très mauvais à utiliser.

Vérifiez notamment :

• []la hiérarchie des titres ;
  []les vrais liens et boutons ;
  []les labels des formulaires ;
  []la navigation au clavier ;
  []la lisibilité ;
  []le contraste ;
  []l’ordre logique des contenus ;
  []l’utilisation avec un lecteur d’écran ;

• l’absence de débordement horizontal inutile sur mobile.

L’apparence ne doit pas rendre le forum plus difficile à utiliser.

43. Ne supprimez pas du HTML uniquement parce qu’il n’est pas visible

Un élément peut être important pour :

• []l’accessibilité ;
  []les lecteurs d’écran ;
  []la navigation clavier ;
  []les extensions ;
  []les moteurs de recherche ;
  []le fonctionnement JavaScript.

Avant de supprimer un élément d’un template, cherchez à comprendre sa fonction.

44. Un style doit rester utilisable sur mobile

Un forum est aujourd’hui consulté sur de nombreuses tailles d’écran.

Après une personnalisation, vérifiez :

ordinateur
tablette
téléphone
orientation portrait
orientation paysage si nécessaire

Une largeur fixe ajoutée pour résoudre un petit problème sur ordinateur peut rendre le forum inutilisable sur mobile.

45. Attention aux modifications trop globales du CSS

Une règle comme :

a {
…
}

concerne potentiellement énormément de liens.

Une règle très spécifique ne concerne qu’un composant.

Plus une modification CSS est générale, plus elle peut provoquer des effets ailleurs.

Lorsque vous corrigez un élément particulier, ciblez-le aussi précisément que nécessaire.

46. Comment savoir si le problème vient du style ?

Utilisez cette méthode.

1. Reproduire le problème.
2. Tester exactement la même action avec prosilver.
3. Si le problème disparaît :
    suspecter le style.
4. Vérifier les templates concernés.
5. Vérifier les fichiers CSS concernés.
6. Vérifier le cache.
7. Vérifier la compatibilité avec la version actuelle de phpBB.
8. Vérifier les interactions avec les extensions.
9. Modifier une seule chose.
10. Retester.
    

C’est beaucoup plus efficace que de réinstaller immédiatement le forum.

47. Mon forum fonctionne avec prosilver : est-ce une preuve ?

C’est une preuve très utile, mais pas nécessairement absolue.

Cela indique surtout que :

le problème est fortement lié à ce qui change entre prosilver et votre style.

Cela peut être :

• []un template ;
  []du CSS ;
  []un événement manquant ;
  []un fichier obsolète ;

• une incompatibilité avec une extension.

Vous avez donc considérablement réduit la zone de recherche.

48. Le style ne s’affiche plus après une erreur

Ne supprimez pas immédiatement le dossier.

Si possible :

• []repassez sur un style fonctionnel ;
  []conservez les fichiers défectueux pour comprendre la cause ;
  []regardez les logs ;
  []restaurez la dernière version fonctionnelle ;

• purgez le cache si nécessaire.

Supprimer les preuves du problème avant de les analyser complique souvent le diagnostic.

49. Garder prosilver comme solution de secours

Même si vous utilisez un style totalement personnalisé, conserver prosilver intact est très utile.

Il sert de :

• []référence ;
  []outil de comparaison ;
  []solution temporaire ;
  []base de diagnostic.

Si votre style personnalisé rencontre un problème critique, prosilver peut permettre de vérifier immédiatement si le forum lui-même reste fonctionnel.

50. Ne transformez pas un style en modification du cœur

Votre personnalisation doit idéalement rester dans :

styles/

Évitez de modifier des fichiers du cœur phpBB simplement pour changer l’apparence.

Sinon, vous perdez une partie des avantages du système de styles :

• []séparation du design et du moteur ;
  []mise à jour plus simple ;
  []retour à prosilver ;
  []comparaison facile ;

• maintenance plus propre.

51. Que fournir lorsqu’on demande de l’aide pour un style ?

Évitez :

Mon thème ne fonctionne plus.

Indiquez plutôt :

Version de phpBB :
Nom du style :
Version du style :
Style parent :
Version de PHP si pertinente :
Modification effectuée :
Page concernée :
Résultat attendu :
Résultat obtenu :
Problème présent avec prosilver : oui/non
Extensions liées au problème :
Message d’erreur éventuel :

Avec ces informations, quelqu’un peut réellement commencer à diagnostiquer.

52. Exemple d’installation propre

Vous téléchargez un style nommé :

modernforum

L’archive contient :

modernforum/
style.cfg
template/
theme/

Vous copiez ce dossier dans :

styles/

Vous obtenez :

styles/
prosilver/
modernforum/
style.cfg
template/
theme/

Vous ouvrez ensuite le PCA.

Vous installez le style.

Vous vérifiez sa compatibilité.

Vous le testez.

Puis, si tout fonctionne, vous pouvez éventuellement le définir comme style par défaut.

53. Exemple d’une mauvaise installation

Vous obtenez :

styles/
modernforum-1.3.zip

ou :

styles/
modernforum-1.3/
modernforum/
style.cfg

Dans le premier cas, l’archive n’a même pas été extraite.

Dans le second, un niveau de dossier inutile a été conservé.

Dans les deux cas, commencez par corriger l’arborescence avant de chercher un problème complexe.
54. Exemple d’une personnalisation difficile à maintenir

Vous copiez tout prosilver.

Vous modifiez :

2 templates
1 fichier CSS
1 logo

Mais votre style contient désormais des dizaines de fichiers copiés.

À la prochaine mise à jour, vous devrez déterminer lesquels sont devenus obsolètes.

Une meilleure architecture aurait consisté à conserver uniquement les différences nécessaires lorsque l’héritage du style le permet.

55. Exemple d’un bon diagnostic

Symptôme :

Le bouton Nouveau sujet n’apparaît plus.

Étape 1 :

Vérifier les permissions.

Étape 2 :

Tester avec prosilver.

Résultat :

Le bouton apparaît avec prosilver.

Étape 3 :

Tester le style personnalisé.

Le bouton manque.

Vous savez maintenant que le problème se situe très probablement dans le rendu du style et non dans le simple droit de créer un sujet.

C’est un diagnostic beaucoup plus utile que :

phpBB ne fonctionne pas.

56. Les erreurs les plus fréquentes avec les styles phpBB

Retenez particulièrement celles-ci :

• []ne pas extraire l’archive ;
  []conserver un dossier de version supplémentaire ;
  []placer le style au mauvais endroit ;
  []installer un style incompatible avec la version de phpBB ;
  []modifier directement prosilver sans conserver les changements ;
  []copier tous les fichiers alors que seuls quelques-uns doivent être personnalisés ;
  []oublier de purger le cache après certaines modifications ;
  []confondre cache phpBB et cache du navigateur ;
  []remplacer un fichier logo qui n’est pas réellement utilisé ;
  []modifier plusieurs templates en même temps ;
  []mettre un style à jour sans sauvegarder les personnalisations ;
  []tester uniquement la page d’accueil ;
  []conclure qu’une extension est cassée sans tester avec prosilver ;
  []ignorer l’affichage mobile ;

• sacrifier l’accessibilité pour obtenir un effet visuel.

57. Une méthode simple à retenir
Pour installer ou dépanner un style, suivez cette logique :

1. Quelle version de phpBB utilisez-vous ?
2. Le style est-il compatible ?
3. L’arborescence est-elle correcte ?
4. Le style est-il bien installé dans le PCA ?
5. Est-il réellement utilisé ?
6. Le problème existe-t-il avec prosilver ?
7. Les caches ont-ils été pris en compte ?
8. Quel fichier a été modifié ?
9. Une extension intervient-elle sur cette page ?
10. Le problème existe-t-il sur mobile et ordinateur ?
    

Ces dix questions permettent déjà de résoudre ou d’isoler une grande partie des problèmes de thèmes phpBB.

En résumé

Retenez surtout ceci :

• []Dans phpBB, l’apparence générale est gérée par les styles.
  []Un style peut contenir des templates, du CSS, des images et différents éléments de présentation.
  []Les styles s’installent dans

  Code : Tout sélectionner

  styles/

  .
  []Le fichier

  Code : Tout sélectionner

  style.cfg

  doit se trouver au bon niveau.
  []Un dossier supplémentaire dans l’archive est une cause fréquente de mauvaise installation.
  []Un style doit être compatible avec votre version de phpBB.
  []Prosilver constitue une excellente référence pour diagnostiquer les problèmes.
  []Si un problème disparaît avec prosilver, examinez attentivement le style personnalisé.
  []Modifier directement les fichiers d’origine rend les mises à jour plus difficiles.
  []Un style enfant ou une personnalisation limitée facilite la maintenance.
  []Purger le cache peut être nécessaire, mais ne corrige pas un fichier incorrect.
  []Une mise à jour de style doit préserver et réintégrer proprement vos personnalisations.

• Après une modification importante, testez plusieurs pages, les extensions, le mobile et l’accessibilité.

Le bon réflexe n’est donc pas de demander simplement :

Pourquoi mon thème ne fonctionne pas ?

mais de découper le problème :

Le style est-il correctement installé ?
Est-il compatible ?
Quel fichier intervient ?
Le problème existe-t-il avec prosilver ?
Une personnalisation ou une extension est-elle concernée ?

Une fois cette méthode adoptée, les problèmes de styles phpBB deviennent beaucoup plus faciles à comprendre, à reproduire et à corriger.