PHPBoost CMS

PHPBoost intègre un système de template. Référez vous à cette article pour en savoir plus: Classe Templates.
L'utilisation des templates a l'avantage de pouvoir laisser l'utilisateur modifier le code HTML/CSS de chacun de ses thèmes séparément, mais il permet en plus de clarifier le code PHP qui ne contient plus de HTML.




Faut-il des connaissances particulières ?
La mise en page de pages web utilise les langages XHTML et CSS. Il n'est pas nécessaire de connaître le XHTML pour faire son thème, en revanche il faut avoir quelques notions en CSS. Rassurez-vous, ce langage est très intuitif, il suffit d'avoir quelques notions en anglais pour le comprendre. Vous trouverez une liste des propriétés CSS sur le Site du Zéro. Si vous avez compris ces notions, avec un peu de bon sens et de volonté c'est à la porté de tout le monde.
Pour en savoir plus sur ces deux langages nous vous invitons à lire ce cours très bien fait, toujours sur le Site du Zéro.

Pour créer votre thème nous vous conseillons fortement de travailler sur un serveur local. Cela vous permettra de pouvoir travailler sur votre thème sans que ça n'ait un impact sur votre site en ligne.




Le mieux est d'abord de choisir un thème sur lequel vous allez vous baser pour que le votre prenne forme.
Dans ./templates/{theme}/
Vous trouverez plusieurs fichiers .css et .tpl et aussi les dossier suivants :

• admin : dans ce dossier vous trouverez les fichiers *.tpl relatifs au panneau d'administration.
• config dans lequel il y a un dossier par langue dans laquelle le thème est porté. Ils contiennent les fichiers de configuration, c'est-à-dire les informations qui s'affichent dans l'administration des thèmes (créateur, date, version, largeur de page...). Si vous avez décidé plus haut de créer votre propre thème il faudra adapter le contenu de ces fichiers.
• images dans lequel on trouve toutes les images relatives au thème.
  

Le fichier: ./templates/{theme}/config/{lang}/config.ini ::
:: vous permet de donner les information relative au thème comme votre contribution.

Son contenu:[code=php]name="heavy meta" //Nom du site
author="KONA" //Auteur
author_mail="team.freerider@free.fr" //e-mail de l'auteur
author_link="http://team.freerider.free.fre" //Site de l'auteur
version=1.0 //Version du thème
info="Un thème sur la musique métal" //Information sur le thème
date="28/12/07" // Date à laquelle le projet est commencé
compatibility=2.0 //La version de PHPBoost compatible avec le thème
html_version=1.0 Strict //Version HTML
css_version=2.1 //Version CSS
left_column=1 //colonne de droite, 1=afficher
right_column=0 //colonne de gauche, 0=ne pas afficher
main_color="Noir, rouge" //couleur principal du thème
variable_width=1
width=100% //900px par exemple signifie que le site n'est pas extensible mais fixe.[/code]

A noter que vous pouvez à partir de ce fichier choisir l'affichage des colonnes de gauche et de droite.





*.css : Communément appelé "Feuille de style" car en règle générale, on écrit le code CSS dans un fichier à part (à l'extension .css au lieu de .html). Ces fichiers servent à modifier l'apparence globale du site (couleurs, images, épaisseurs de traits, polices, tailles...).

Les principaux fichiers css:

• content.css : Classes propres au contenu du site (messages, modules).
• design.css : Eléments du design (conteneurs).
• global.css : Classes utilisées sur l'ensemble du site, aussi bien dans l'administration que dans les modules.
  
  
  Au fur et à mesure de l'avancement vous verrez que ça prend forme
  
  
  
  Les fichiers .tpl
  
  
  
  *.tpl : Les fichiers au format .tpl sont en réalité des fichiers HTML avec des marqueurs permettant d'indiquer des actions à accomplir par le parseur de templates. Une fois analysé par le parseur ces marqueurs sont remplacés par des instructions en PHP, c'est ce qu'on appelle la compilation des templates. voici un exemple avec les templates modifiés http://www.mussotrail.com. La modification de ces fichiers nécessite des connaissances en XHTML.
  

Pour un module, si le fichier n'est pas présent dans le dossier /templates/{theme}/{nomdumodule}/
Le fichier utilisé sera celui se trouvant par défaut dans /{nomdumodule}/templates/
Cela permet de modifier les templates séparément pour chaque thème, tout en s'assurant qu'il existe un template de base par défaut, qui sera chargé le cas échéant.
Si vous désirez modifier le style d'un module il est très important de procédé de cette façon.

Récapitulatif: Au moment de modifier un module, dans ../templates/{theme}/ , je créer un répertoire qui porte le même nom que le nom du répertoire qui contient le module.
À ce moment ci vous modifiez des fichiers dans ../{module}/templates/
Vous venez les placer dans ../templates/{theme}/




Un article a été créer dans le but d'expliquer le fonctionnement des fichiers LANG visant le développement de module. c.f. Article mentionné ci-dessus

Le texte propre au portail comme au module fonctionne de cette façon il peut être intéressant d'aborder ce sujet dans la personnalisation ou création de SITE.

Il est important de noter que cela peut personnaliser votre site mais ne peut être utiliser pour distribuer votre thème .
Pour la raison suivante, les fichiers LANG ne se trouve pas dans le répertoire du thème et donc les modifications que vous aurez ne seront pas effectués chez les utilisateurs lors de la publication du thème.




Finalement, les équipes de rédaction et de graphisme de PHPBoost ont décider de concevoir une suite de travaux pratique, qui devrait au fil du temps vous mener vers un thème complètement personnaliser.

Avant de commencer cet article il peut être intéressant de se rendre dans la section Téléchargements de PHPBoost, puis Utilitaires. Utiliser Notepad++ est un bonheur!

Pour assurer la cohérence de la documentation ces travaux pratique seront regroupés dans un article.
c.f. Travaux Pratique