PhpBB-Power

Aramiil · Dernière édition par Aramiil le Dim 23 Jan 2005 à 22:02; édité 1 fois

Bonjour,

Durant ce tutorial, nous allons nous pencher sur les principes de la création de templates phpBB. Lorsqu'il sera terminé, vous serez à même, je l'espère, de créer et de modifier à votre convenance, afin d'obtenir un forum réellement personnalisé.

Sommaire:

_________________

Jeu en ligne .:. Mon blog

Aramiil · Posté le: Dim 23 Jan 2005 à 21:50 Sujet du message:

1) Conditions d'utilisation

Comme durant mes précédents tutoriaux, la lecture et l'utilisation des informations contenues dans ce tutorial implique l'acceptation des conditions suivantes. Vous devez:

a ) Supporter mon humour pourri tout le long de ce tutorial
b ) Ecrire en français correct les commentaires éventuels sur ce petit texte
c ) Accepter de laisser le copyright phpBB et le lien éventuel de traduction
d ) Accepter de décharger de toutes responsabilités phpbb-power et moi-même des erreurs que vous pourriez faire lors de la création et/ou de la modification de templates.

Je souhaite tout particulièrement revenir sur ce dernier point: la création et/ou la modification d'un template peut entraîner des problèmes d'affichage de votre forum. Si tel est le cas, n'hésitez pas à venir demander de l'aide ici.

Par ailleurs, le système des templates étant écris en HTML, vous ne pouvez espérer suivre et pouvoir utiliser ce tutorial sans des bases minimums en ce langage. Pour acquérir les rudiments nécessaires à la création d'une page web quelconque, je vous conseille ce tutorial écrit par xtouch, qui vous permettra de comprendre ce cours. Par ailleurs, il est évidement nécessaire d'avoir installé un forum phpBB. Si vous avez besoin d'aide sur ce point, voyez ici ou là.

Enfin, nous nous baserons lors de ce tutorial sur le template par défaut de phpBB: subSilver.

Si vous acceptez ces petites conditions, nous pouvons passer à la suite!
_________________

Jeu en ligne .:. Mon blog

Aramiil · Posté le: Dim 23 Jan 2005 à 21:53 Sujet du message:

2) Définitions

Avant de passer à la création et/ou la modification de template, il pourrait être intéressant de définir ce qu'est un template. Un template - ou thème - est un ensemble de fichier ayant l'extension .tpl qui servent à définir l'aspect extérieur de votre forum. Ces fichiers sont écris en HTML et sont liés à deux fichiers particuliers: le fichier .css et le fichier .cfg, qui permettent de préciser encore l'aspect du forum. Mais nous traiterons ces deux points ultérieurement. Vous devez également savoir que ces fichiers .tpl sont stockés dans le répertoire templates/nom_du_theme de votre forum. Le thème par défaut de phpBB se nomme subSilver, ses fichiers se trouvent donc dans le dossier templates/subSilver de phpBB.

Par ailleurs, nous devrions aussi définir à quoi sert exactement ces templates, car "l'aspect extérieur" n'est pas très précis. Pour cela, je vous propose un petit exemple. Voici le forum phpbb-power, dont le thème est un subSilver standard, et mon forum, dont le design est lui aussi basé sur subSilver, mais a subi de nombreuses modifications. Vous saisissez la différence Wink

? Et bien, bientôt, vous pourrez faire exactement la même chose!
_________________

Jeu en ligne .:. Mon blog

Aramiil · Posté le: Dim 23 Jan 2005 à 21:54 Sujet du message:

3) Généralités

Je vous propose à présent d'ouvrir un fichier template. Nous allons commencer par un fichier extrait de subSilver et qui sert à définir l'aspect extérieur de la page qui contient les conditions d'utilisation du forum. Ouvrez donc le fichier \templates\subSilver\agreement.tpl avec votre éditeur de texte préféré (par exemple le bloc-note Wink

)

Vous devriez alors vous retrouver face à un fichier qui ressemble à ceci:

Aramiil · Posté le: Dim 23 Jan 2005 à 21:55 Sujet du message:

4) Les variables de thème

Un des plus gros avantages de phpBB est qu'il est multilingue. En d'autres termes, il peut facilement être traduit en n'importe quel langage, simplement en modifiant quatre fichiers. Mais ceci ne serait pas possible si les informations étaient inscrites en clair dans les fichiers! Car vous devriez alors modifier les 45 fichiers de thème correspondant aux parties ouvertes au public.

De plus, si vous observez les liens entre les différentes pages, vous noterez qu'ils sont de la forme: http://www.adresse.com/page?sid=xxxxxxxxx . Le nombre suivant SID est l'id de session, qui permet de vous maintenir connecté sur le forum. Encore une fois, ce genre de chose est incompatible avec la possibilité de moduler complètement un forum: impossible de créer un template si pour le modifier il faut modifier les fichiers PHP.

Alors les programmeurs du phpbb group ont décidé d'utiliser ce que l'on appelle des variables de thème. Ce sont des petites choses présentent dans les fichiers .tpl comme celui que vous regardez, et qui se présente sous la forme: {NOM_DE_LA_VARIABLE} (par convention, le nom de la variable est toujours écris en majuscule).

Ces variables de thèmes sont primordiales pour votre template: en effet, ce sont elles qui contiendront toutes les informations affichées sur votre forum, et plus simplement tout ce qui n'est pas de la mise en forme. Par convention à nouveau, on fait généralement commencer par U_ le nom de la variable si elle contient une URL (adresse Internet).

En théorie, un template ne devrait contenir aucune information qui ne passe par une de ces variables. En pratique, vous pouvez bien sur en ajouter: c'est votre forum! Faites néanmoins attention à ne pas modifier les noms de ces variables et à ne pas les supprimer, ou vous risquez de voir disparaître certaines informations importantes.

Arrivé à ce stade, vous voulez sûrement un petit exemple de ce qu'on peut faire simplement en modifiant le template. Nous allons donc nous amuser à modifier l'affichage de la page des conditions d'utilisations qui stipule "j'accepte et j'ai plus de 13 ans" et "j'accepte et j'ai moins de 13 ans" par un simple "j'accepte", puisque cette différence d'âge est inutile hors des Etats-unis. En étudiant les différentes variables du thème ci-dessus, nous en remarquons une
au nom éloquent: {AGREE_UNDER_13} . Le lien dans lequel elle est contenue est le suivant:

Aramiil · Posté le: Dim 23 Jan 2005 à 21:56 Sujet du message:

5) Les switchs

Nous savons maintenant comment les programmeurs de phpBB ont pu s'arranger pour que leur forum soit multilangues. Mais il reste un petit problème: l'affichage du forum peut changer suivant les moments. Un exemple? Il peut y avoir plusieurs sujets d'affilée, un utilisateur peut être ou non connecté, etc... C'est à cela que servent les switchs.

Pour mieux vous expliquer, je vous propose d'utiliser un autre fichier. Ouvrez donc le fichier \templates\subSilver\posting_smilies.tpl . Comme son nom l'indique, ce fichier sert à générer la jolie table de smileys que vous voyez lorsque vous cliquez sur le lien "plus de smileys" en composant un message.

Voici une reproduction des lignes 25 à 38 de ce fichier, qui sont celles qui vont nous intéresser ici:

Aramiil · Posté le: Dim 23 Jan 2005 à 21:59 Sujet du message:

6) Trucs et astuces

Voici une petite liste d'astuces bien utiles lorsqu'on crée un thème, et pas forcément évidentes!

a) Les templates phpBB normaux (et notamment subSilver) utilisent comme style pour les colonnes trois classes: row1, row2 et row3. N'hésitez pas à jouer sur ces classes si vous voulez obtenir des résultats harmonieux.

b) Certains templates (et, là encore, notamment subSilver), font une utilisation déplorable des feuilles de style (comprenez: aucune!!). Le style correspondant au template est codé en dur dans les fichiers overall_header.tpl et simple_header.tpl . Pour corriger cette "erreur", ouvrez ces deux fichiers, remplacez ceci:

Aramiil · Posté le: Dim 23 Jan 2005 à 21:59 Sujet du message:

7) Création de templates

La création de template se rapproche beaucoup d'une simple modification. Il est fortement conseillé de se baser sur le thème subSilver, plutôt que de tenter de recréer totalement un thème. A ce petit détail près, il s'agit exactement de la même chose.
_________________

Jeu en ligne .:. Mon blog

Aramiil · Posté le: Dim 23 Jan 2005 à 22:00 Sujet du message:

8 ) FAQ

J'ai fait une bêtise, et plus rien ne s'affiche comme je le veux! que faire?
Cool

Pas de problèmes! Si plus rien ne marche, le plus simple est de reprendre le fichier du thème subSilver original (il est conseillé d'en garder un non modifié sur son pc) et de remplacer le vôtre.

Question

J'essaye d'afficher une variable de switch mais rien ne s'affiche
Cool

L'utilisez-vous bien dans son switch? Une variable de switch ne sera définie qu'a l'intérieur de celui-ci. Vous ne pouvez donc pas l'utiliser en dehors.

Question

Est-ce légal, de modifier ainsi le thème subSilver
Cool

Vous pouvez, selon les termes de la licence concernant subSilver, l'utiliser dans un cadre sctrictement personnel de cette manière. En d'autres termes, vous pouvez le modifier pour l'utiliser dans votre forum phpBB, mais pas en extraire des éléments pour l'utiliser hors de votre forum, ni le redistribuer séparément du dit forum.

Question

Quelles sont les classes CSS utilisées par phpBB?
Cool

Il y en a beaucoup, mais les plus importantes sont les différentes row (row1, row2 et row3) pour les balises <td>, les classes thTop et thHead pour la balise <th> et les classes bodyline et forumline pour les balises <table>

Question

Comment puis-je remercier l'auteur de ce merveilleux tutorial?
Cool

Si tu es un garçon, un merci en réponse suffira. Si tu es une (jolie) fille, en revanche, tu peux m'envoyer ton numéro de téléphone par MP ^^ Wink

Voici qui conclut ce petit (si si!) tutorial sur la création de templates. N'hésitez pas à demander si vous avec besoin d'aide pour modifier les vôtres!

Ps: Je dédicace (mais en ai-je vraiment le droit? tant pis, je le prend Razz

) ce petit tutorial à Pomme, pour qui je l'ai écrit.

Ps 2: Merci à Pomme pour les corrections des fautes!!
_________________

Jeu en ligne .:. Mon blog

startoof · Posté le: Jeu 30 Nov 2006 à 1:07 Sujet du message:

Je commence à m'amuser à bidouiller mon phpbb...
J'ai changé la tête de mon chat, refait le thème à ma sauce et je suis plutot content du résultat malgré tous les petits boutons qu'il me reste à changer (et accessoirement tout le site pour tout harmoniser Crying or Very sad

).
Mon thème marche au poil... enfin presque sur quelques page il ya un petit décalage sur la droite de quelques pixels.
Voyez plutot : http://touskigliss.fr/toutterrain/forum/ (parfait)
http://touskigliss.fr/toutterrain/forum/viewforum.php?f=19 (bug)

Si vous voyez de quoi ça pourrait venir... Ca fait ça sur plusieurs pages.
En tout cas je trouve ce site super, vraiment sympa les tutoriaux !!! Merci phpbb-power !
_________________
Président de l'association touskigliss : http://touskigliss.fr

Alcazarfr · Posté le: Jeu 30 Nov 2006 à 17:23 Sujet du message:

Merci

Je n'ai vu aucun décalage, peut tu precisier ?
_________________
Je n'utilise en aucun cas MSN Messenger & je ne participe pas au projet de site

// En vacances

startoof

Le fond de ma page à droite, il y a un petit décalage.
_________________
Président de l'association touskigliss : http://touskigliss.fr

Iclode · Polichinelle Inscrit le: 25 Fév 2007 Messages: 4

bonjour,
je voudrais changer la valeur d'une des variables de thèmes, comment dois-je faire ?
merci d'avance

Alcazarfr

Salut,

tu dois ouvrir et modifier ta feuile de style, c'est à dire tontemplate.css,dans le dossier templates/tontemplate/.
Par defaut, il s'agit du fichier templates/subSilver/subSilver.css.
_________________
Je n'utilise en aucun cas MSN Messenger & je ne participe pas au projet de site

// En vacances

Iclode · Polichinelle Inscrit le: 25 Fév 2007 Messages: 4

je me suis fais mal fais comprendre.
je vais prendre un exemple.
quand j'utilise la variable thèmes U_INDEX me conduit vers index.php mais je vais désormais qu'elle contiennent forum.php.
merci d'avance