Conseils d'utilisation

Dans les templates, il y a deux types de variables : les variables dites d'affichage {VARIABLES} qui contiennent généralement une seule donnée (exemple, une statistique : 5 messages) et les variables dites de bouclage <!-- BEGIN --> qui répètent tout un élément (exemple : un message entier).

Attention, les variables de bouclage qui commencent par <!-- BEGIN...--> et finissent par
<!-- END...--> tandis que les les commentaires HTML sont simplement écrit ainsi <!--  -->, en français. Ce sont généralement des ajouts de ma part. Si votre forum n'affiche plus correctement une liste de sujet ou un message, c'est probablement parce que la variable de bouclage est mal placée. Assurez-vous d'encadrer correctement vos éléments par ces variables si elles sont présentes.

Dans le Blank Theme, les variables de bouclages sont commentées pour savoir à quoi elles correspondent.

Si avez un doute sur ce que représente une variable, une admin de Forumactif, Etana, a listé une majorité des variables avec une description. Avec une simple recherche Ctrl+F, vous devriez vous y retrouver.

Vous trouverez par moments des variables d'affichage dans un ID, de la sorte :
<div id="{VARIABLE}">. C'est ce qui sert d'IDentification d'un élément HTML, généralement utilisé sur Forumactif pour les messages. Les supprimer peut provoquer des erreurs de renvoi (accéder au dernier message posté, récupérer le lien d'un message spécifique...).

Les nouvelles versions de Forumactif (phpBB3, ModernBB...) ne sont plus construites par le display <table> trop souvent utilisé à tort (car dépassé et contraignant). Elles utilisent d'autres attributs, que je vous conseille : float, flex, et grid. Elles offrent plus de possibilités et réduisent le nombre de lignes de code à écrire. Il existe des dizaines et des dizaines de tutoriels à leur propos pour les adopter facilement.

Utilisez l'inspecteur d'élément de votre navigateur (clic droit › Inspecter) : il vous donnera toutes les informations nécessaires pour comprendre des variables, la structure de Forumactif ou repérer des bugs ou des erreurs.

Attention aux scripts, ils ont été modifiés pour correspondre aux .class et ID spécifiques au Blank Theme. Si vous changez le HTML, il se peut que les scripts cessent de fonctionner. N'oubliez donc pas de les adapter à vos modifications en suivant les explications fournies par la personne l'ayant mis à disposition.

Sauf indication contraire (dans le CSS), sentez-vous libre de faire ou refaire des .class qui correspondent mieux à votre future personnalisation.

Pour cibler directement une image (généralement comprise dans une variable, comme les images des avatars) en CSS, il faut la sélectionner de la sorte : .conteneur img { }

Vous rencontrerez certainement des éléments positionnés avec l'attribut float. Aussi pratique soit-il, il peut contraindre les éléments situés à la suite (et créer un effet cascade). Pour rompre l'effet, vous pouvez utiliser l'attribut clear: both sur les éléments situés à la suite.

Cette partie mériterait des explications bien plus développées, mais en attendant de vrais tutoriels, voici quelques points essentiels :

Pour réaliser un design cohérent, tant dans ses visuels que son accessibilité, prenez le temps de concevoir une maquette des principales pages de votre forum. C'est un travail supplémentaire, mais c'est un effort qui portera ses fruits au moment de passer à la réalisation technique.
Exemple : voir la maquette du Blank Theme.

Certains éléments ou certaines parties du forum se répètent à plusieurs endroits. Repérez-les, ce sont des patterns que vous pourrez reproduire avec un simple copier/coller plutôt de devoir les coder un par un.
Exemples : la chaîne de navigation (catégorie > forum > sous-forum), la pagination, les bouttons d'interactions...

Pensez à adapter votre forum à tous les types d'écran ! Demandez à des proches ou bien utilisez des sites qui simulent différentes résolutions.