Le BBCode est un langage de balises, entre crochets, qui permet de mettre en forme les messages sans écrire de HTML. Lorsqu'un membre publie, phpBB convertit les balises en mise en forme à l'affichage. Ce tutoriel explique le principe, les balises courantes, les BBCodes plus récents (médias intégrés, BBCodes système) et les réglages de l'ACP qui permettent de les contrôler.
1. Principe de fonctionnement
- Une balise s'ouvre avec une balise d'ouverture entre crochets (par exemple ) et se ferme avec la même balise précédée d'une barre oblique (par exemple
Code : Tout sélectionner
[b]). Le texte placé entre les deux est mis en forme.Code : Tout sélectionner
[/b] - Certaines balises prennent un paramètre après le signe égal, par exemple .
Code : Tout sélectionner
[color=red]texte[/color] - Si une balise n'est pas fermée ou est mal écrite, elle s'affiche telle quelle au lieu d'être interprétée.
- Les boutons au-dessus de la zone de saisie insèrent les balises à votre place, mais vous pouvez aussi les taper à la main.
Code : Tout sélectionner
[b]gras[/b]
[i]italique[/i]
[u]souligné[/u]
[quote="Nom"]texte cité[/quote]
[list][*]point 1[*]point 2[/list]
[list=1][*]étape 1[*]étape 2[/list]
[url=https://exemple.org]texte du lien[/url]
[img]adresse de l'image[/img]
[size=150]texte plus grand[/size]
[color=#FF0000]texte rouge[/color]La liste exacte dépend de la configuration de votre forum : les boutons affichés à l'écran de rédaction correspondent à ce qui est disponible chez vous.
3. Les BBCodes plus récents
a) Médias intégrés aux messages
Votre forum dispose d'un module de médias intégrés, qui permet d'afficher dans un message le contenu de certains services externes (vidéos, par exemple) à partir de leur adresse. Il se gère dans Publication › Médias intégrés aux messages, avec deux pages :
- Paramètres : réglages généraux du module.
- Gestion des services : liste des services pris en charge, que l'on peut activer ou désactiver.
b) BBCodes système
La page Outils › Fonctionnalité › BBCodes système est dédiée à des BBCodes fournis par la plateforme. Je ne connais pas avec certitude la liste ni les options de cette page : ouvrez-la pour voir ce qu'elle propose, et testez le rendu dans un message avant de communiquer dessus aux membres.
c) Pièces jointes dans le texte
Lorsqu'un membre ajoute une pièce jointe, il peut la placer à l'endroit voulu du message avec le bouton Placer dans le texte de l'onglet des pièces jointes. Cela insère une balise attachment dans le message. Les réglages se trouvent dans Publication › Pièces jointes › Paramètres des pièces jointes.
4. Activer ou désactiver le BBCode
Le BBCode se contrôle à plusieurs niveaux :
- Par forum, via les permissions : il n'y a pas, dans les paramètres d'un forum, d'interrupteur général du BBCode. Les options d'analyse du BBCode, des URL et des émoticônes que l'on voit dans Forums › Gérer les forums › Gérer les forums lors de la modification d'un forum ne concernent que la description de ce forum. Pour autoriser ou refuser le BBCode (ainsi que les images ou les signatures) dans un forum, passez par Permissions › Permissions liées aux forums › Permissions des forums aux groupes (ou Permissions des forums), choisissez le forum et le groupe, puis cherchez les permissions liées au BBCode, aux images et aux signatures. Je ne peux pas garantir leur libellé exact : lisez les intitulés affichés.
- Pour la publication en général : consultez Publication › Messages › Paramètres de la publication (aussi accessible via Général › Configuration du forum › Paramètres de la publication). Vous y trouverez notamment des limites sur la taille de police, le nombre d'images ou de liens, etc.
- Dans les signatures : Général › Configuration du forum › Paramètres des signatures permet d'autoriser ou non le BBCode et certaines balises dans les signatures.
- Dans les messages privés : Publication › Messages › Paramètres des messages privés contient des réglages similaires pour les MP.
- Par permissions générales : l'usage des signatures ou du BBCode dans les messages privés dépend aussi des permissions des utilisateurs et des groupes. Passez par Permissions › Permissions générales › Permissions des groupes et cherchez les permissions liées à la publication, aux signatures et aux messages privés.
La page Publication › Messages › BBCode liste les BBCodes personnalisés de votre forum et permet d'en ajouter. Un BBCode personnalisé repose sur deux éléments :
- un modèle d'utilisation qui décrit la balise saisie par le membre, avec des jetons tels que {TEXT}, {SIMPLETEXT}, {NUMBER}, {URL} ou {COLOR} pour représenter le contenu ;
- un modèle de remplacement qui définit le rendu final en HTML, en réutilisant ces mêmes jetons.
Code : Tout sélectionner
Utilisation du BBCode : [surligne]{TEXT}[/surligne]
Remplacement : <span style="background-color:yellow">{TEXT}</span>Les BBCodes ajoutés par la plateforme (médias, BBCodes système) peuvent apparaître à côté des vôtres : évitez de créer une balise portant le même nom qu'une balise existante.
6. Pièges courants
- Une balise non fermée ou mal imbriquée (par exemple gras ouvert, italique ouvert, puis gras fermé avant l'italique) peut casser l'affichage.
- Si le BBCode n'est pas autorisé par les permissions du groupe dans un forum, les balises restent affichées en clair dans les messages.
- Les membres peuvent cocher l'option de désactivation du BBCode à la rédaction d'un message : pensez-y si un message semble non formaté.
- Dans la balise code, le BBCode n'est pas interprété : c'est voulu, pour pouvoir montrer des balises.
- Un média intégré qui ne s'affiche pas vient souvent d'un service désactivé dans Publication › Médias intégrés aux messages › Gestion des services, d'une adresse incorrecte ou du BBCode non autorisé dans le forum.
- Les limites (nombre d'images, taille de police, longueur des signatures) peuvent refuser un message contenant trop de mises en forme.
- Après modification d'un BBCode personnalisé, d'un réglage de médias ou d'une permission, testez toujours dans un message d'essai, idéalement dans un forum privé, avant de l'annoncer aux membres.