Partie 3 - Étape 1: Comprendre le fonctionnement d'un Template

   

Un Template

Un Template est une partie codée de votre forum. Il faut savoir que votre forum génère sa structure grâce à plusieurs Templates. En effet, son codage est divisé en plusieurs parties générant un morceau bien spécifique. Ainsi, lorsque vous allez dans Affichage> Templates> Général, vous atteignez une page avec les templates dits "généraux" puisque ce sont les templates les plus utilisés et les plus importants, mais également parce qu'ils concernent des éléments de votre page d'accueil.Vous pouvez y retrouver Index_box qui gère l'affichage de vos catégories, Index_body qui prend en charge l'affichage de votre page d'accueil, des Chatbox du haut et du bas, du Qui est en Ligne, des boites de connexions, à vrai dire un tas de choses déductible par la description du template qui figure à droite de son nom !


   

Pourquoi comprendre les Templates ?

Comprendre son Template avant d'entamer sa modification est essentiel. Tout d'abord parce que vous ne pouvez pas travailler les Templates sans savoir ce qu'il affiche. Prenons l'image d'une télécommande : si vous voulez changer les piles mais que vous ne savez pas comment le faire, vous allez chercher à les changer à tout prix, même s'il faut pour cela la démonter entièrement alors que vous auriez juste pu enlever le cache derrière. Et bien les Templates, ça fonctionne de la même manière. Chaque ligne de code appelle la création de quelque chose sur votre forum et est essentielle dans sa structure, même si, entendons-nous bien, certaines lignes peuvent être supprimées.

Quel intérêt dans l'apprentissage du codage ?

L'intérêt des Templates dans l'apprentissage du codage se trouve essentiellement dans le fait que si vous voulez modifier une ligne de votre Template pour voir ce que ça fait sur votre forum, vous pouvez le faire car vous avez la possibilité de le remettre à zéro ! Cependant, comme il a été précisé dans l'introduction du cursus, La logique de ce guide s'applique à ForumActif ! Donc il est de notre ressort de vous faire une partie sur les Templates puisque le codage s'y fait en majorité dans ces parties.

Possible composition d'un Template

Les variables :

La plupart des Templates, si ce n'est pas tous, sont composés de ce qu'on appelle des Variables. En réalité, ces variables introduisent des éléments dans les pages de vos forums qui se répètent et qui ne peuvent pas être mises manuellement. Par exemple, l'heure actuelle, le dernier message, le nombre de d'utilisateurs présents sur le forum. Elles s'introduisent par un { et se terminent par un }. Récemment, un listing a été réalisé par le FDF (Forum des ForumActifs) par Etana, vous pouvez le trouver ici. La plupart des variables y sont expliquées

Si vous voulez plus d'informations, un tutoriel excellemment bien fait sur le FDF est rédigé : Direction le tutoriel

Les lignes :

Depuis Octobre 2012, ForumActif a facilité considérablement le travail des codeurs. En effet, une fonctionnalité a été ajouté faisant apparaître dans les Templates le numéro des lignes ! De plus, une coloration syntaxique a été ajouté dans la feuille CSS et dans les Templates et enfin un moteur de recherche pour arriver plus rapidement à la ligne que nous désirons. Ainsi, il est désormais plus simple de s'y retrouver dans les Templates et donc plus simple pour apprendre à coder ces derniers.

Les commentaires :

Le screen que vous voyez au-dessus est un commentaire HTML. Chez ForumActif, la plupart ont pour but d'appeler une fonctionnalité spéciale. Ils parsèment tous les Templates (ou presque) et ont une conséquence sur le codage de votre forum. Il est donc nécessaire de comprendre que les commentaires de Forum Actif sont parfois la source de problème lors de la publication du Template modifié.

Les scripts:

De même que les commentaires, les scripts parsèment vos Templates. Certains sont simplement appelés par la variable :

Code:

{JAVASCRIPT}

Ce sont donc des codes qui peuvent être modifiés mais auquel il ne faut pas toucher si on y connait pas grand chose !

Modifier et valider un Template

Pour modifier un Template il vous suffit d'être le fondateur de votre forum et d'avoir cliqué sur le mode avancé du panel administratif :

Ensuite, il vous suffit d'aller dans Affichage> Templates et vous aurez la liste des catégories de Templates. Dirigeons-nous par exemple vers les Templates classés dans "Général". Pour modifier un Template, il vous suffit de cliquer sur son nom. Cliquons donc sur Index_box, Template qui gère l'affichage des catégories.

Vous êtes maintenant face à 85 lignes de code (s'il n'a pas été modifié). Vous pourrez donc faire les modifications que vous voulez dans le code mais il ne faudra pas oublier de cliquer sur Enregistrer en dessous de la fenêtre de code. Quand ceci sera fait, il faudra cliquer sur le .

Yop !

Je crois avoir fini cette étape, si vous voyez d'autres choses à renseigner, n'hésitez pas à me le dire ^^

Oh! Cool x) Merci Tako'

J'ai remarqué que les "commentaires" sont particuliers sur FA, normalement c'est juste des indicateurs qui ne servent pas, mais dans les templates si t'enlèves ces marqueurs ça ne t'affiche plus le bloc contenu à l'intérieur, même si le code lui-même y est bien. Il faudrait le préciser peut-être ?

J'ajouterais aussi un petit mot sur les Variables car beaucoup de personnes veulent les déplacer, mais il faut bien savoir qu'elles ne peuvent être déplacées qu'à l'intérieur de LEUR template, donc celui où elles sont à l'origine. On ne peut pas, par exemple, mettre la variable de l'affichage du contenu de la page d'accueil dans le template "Overall_header".

Sinon je ne vois rien d'autre, tout est parfait^^

Yopidou =)

Oui, c'est pas faux je vais y préciser pour les commentaires et je pense même que ça peut renforcer la césure entre le fait qu'on apprend le codage pour ForumActif spécialement ^^

Pour les variables, il faut aussi dans ce cas préciser que les variables de Template ne peuvent pas être utilisées dans les messages ?

D'ac ^^

Oui par la même occasion ça serait bien, et ajouter que les variables des messages (genre USERNAME & co) ne peuvent pas fonctionner tels quels dans les templates (il y a une astuce FA pour les utiliser quand même cela dit...).

Hey,

Beau boulot encore :p

En fait, ces commentaires sont des boucles. Entre le BEGIN et le END, il y a leur contenu. Si on enlève la boucle, il ne s'affichera pas.
Personnellement, je pense qu'il ne vaut d'ailleurs mieux pas enlever les boucles, juste le contenu si on ne veut rien afficher.
Je ne sais pas exactement comment ça marche derrière (PHP ?) mais ça permet soit d'introduire un élément de condition (genre pour correspondre aux éléments demandés dans le panneau d'admin comme quand on demande de mettre des images et non des liens en navigation) soit d'aller chercher des données (CATROW qui va chercher tout ce qui concerne les forums).

Et il y a quelques variables qui peuvent se déplacer n'importe où (cf. le listing des variables globales d'Etana) alors que les autres sont dans un nombre limié de templates (c'est indiqué au cas par cas après "Disponible dans": https://github.com/Etana/template/blob/master/var/L_WEBSITE.md#readme mais je pense que, en général, si c'est dispo c'est déjà affiché. Jamais vérifié)

Merci beaucoup pour cette explication :3
J'ai toujours eu du mal avec les templates x.x

Cette petite mise au point sur les templates est vraiment utile ! Je vais tenter de comprendre comment fonctionnent ces fourbes pour pouvoir les modifier et avoir un beau forum tout propre e.e

merci !