Dernière mise à jour : 25/01/2020 à 08h18
Table des matières
Comment ça marche ?
Lors de l'affichage d'une page, le framework de PHPBoost teste dans un premier temps la présence des fichiers .tpl et .css nécessaires, dans le dossier du thème actuel.
Si ces fichiers ne sont pas présents, il va ensuite les chercher dans leurs dossiers d'origine.
Ainsi, tout fichier copié dans le dossier de votre thème sera utilisé à la place du fichier d'origine.
Que peut-on modifier ?
Avec cette méthode, il est possible de modifier absolument tous les templates.
Cela comprend donc :
- Les modules
- Le framework
- L'administration
C'est ce que nous détaillerons dans la suite de cet article.
Les templates
L'arborescence est la seule contrainte à respecter. Ne vous inquiétez pas, elle est très simple.
Elle diffère légèrement selon le type de templates à modifier :
Les modules
Les fichiers relatifs aux modules se trouvent à la racine de PHPBoost, dans le dossier nomdumodule/templates.
Si vous souhaitez modifier un template de module, il faut à la racine de votre thème créer un dossier appelé 'modules' s'il n'existe pas encore.
Dans le dossier précédemment créé, il suffit de créer un nouveau dossier portant le nom du module dont vous souhaitez modifier les templates.
Ce qui nous donne par exemple : monthème/modules/forum/
Dans ce nouveau dossier,il suffit de copier les fichiers TPL que vous avez besoin.
Le framework
Le framework est en fait le noyau de PHPBoost autour duquel les modules sont rattachés. Ainsi, il y a de nombreuses fonctionnalités qui font partie du framework, telles que les menus, les commentaires etc.
Les templates du framework se trouvent dans le dossier templates/default/framework.
Pour personnaliser un de ces éléments, il faut au préalable créer un dossier nommé /default/framework dans le dossier de votre thème.
Il suffit ensuite de copier les éléments souhaités dans ce nouveau dossier, en respectant l'arborescence d'origine.
Par exemple : templates/mon_theme/default/framework/menus/feed/feed.tpl
L'administration
Le panneau d'administration est aussi géré par le même système. Ainsi, il est tout à fait possible de redessiner complètement l'architecture de cette partie du site.
Les templates de l'administration se trouvent dans le dossier templates/default/admin.
Pour personnaliser un de ces éléments, il faut au préalable créer un dossier nommé /default/admin dans le dossier de votre thème.
Il suffit ensuite de copier les éléments souhaités dans ce nouveau dossier, en respectant l'arborescence d'origine.
Par exemple : templates/mon_theme/default/admin/updates/detail.tpl
Les CSS
Nous avons vu jusqu'à présent qu'il était possible de modifier les fichiers TPL en les mettant dans les dossiers de votre thème.
Mais vous pouvez également modifier les fichiers CSS se trouvant dans les modules.
Les fichiers de styles des modules sont positionnés dans le dossier nomdumodule/templates.
Il suffit ensuite de faire un copier/coller du fichier CSS afin d'en faire une copie dans le dossier monthème/modules/nomdumodule/.
Il est alors possible de modifier tous les styles de vos modules, afin qu'aucun élément ne fasse 'dépareillé'.
NB : Dans certains modules, les images sont appelées par le CSS, comme le module 'forum'. Si vous choisissez de modifier le CSS du module, le chemin indiqué dans le fichier de style ne sera plus bon. Il faudra alors copier l'intégralité du dossier images contenu dans le module ou redéfinir chaque URL du CSS.