PluxThèmes

La création d'un thème n'est pas aussi difficile qu'il n'y parait., il y a quelques règles à suivre et à connaître pour qu'il soit reconnu par PluXml et qu'il fonctionne dans tout les modes d'affichage de PluXml.

La premiere étape est de créer un nouveau dossier pour votre théme dans le dossier themes/ de PluXml.

Ces règles concernent principalement des noms de fichiers que PluXml va utiliser selon la page demandée, la première étape est donc de connaître et respecter ces règles en faisant l'inventaire ces fichiers requis dans un premier temps avant de les créer.

Un premier travail de préparation est nécessaire pour mettre en place votre projet de création de thème en créant simplement ces fichiers requis et en les laissant vide pour commencer. Ces fichiers sont à placer dans le dossier que vous avez créer pour votre thème.

L'inventaire des fichiers

Ces fichiers sont à minima :

• archives.php : gère les pages des archives
• article.php : gère les articles
• categorie.php : gère l’affichage des articles en fonction d’une catégorie
• commentaires.php : gère la partie commentaires des articles
• erreur.php : gère la page d’erreur
• footer.php : gère le pied de page de votre site
• header.php : gère l’entête de votre site
• home.php : gère la page d’accueil
• sidebar.php : gère la barre latérale de votre site
• static.php : gère les pages statiques
• tag.php : gère l’affichage des articles en fonction d’un tag
• infos.xml : regroupe les informations affichées sur la page Thèmes de l’administration
• index.html : n’a aucune utilité pour le thème (présent par mesure de sécurité)

Ces fichiers servent de template/gabarits qui afficheront les contenus demandés à l’exception de infos.xml.

Vous pouvez dans chaque fichier avec l'extension .php insérer comme première ligne ce code:

<?php if (!defined('PLX_ROOT')) exit; ?>

C'est fichier ne seront alors utilisable uniquement par PluXml.

Certains de ces gabarits peuvent être déclinés en plusieurs versions pour personnalisé certaines pages. Les gabarits article.php, categorie.php et static.php peuvent être déclinés en plusieurs versions.

Le thème par défaut embarque par exemple des gabarits qui n'afficheront pas la barre latérale, les noms de ces gabarits ont comme préfixe -full-width, ce qui donne par exemple article-full-width.php. Ce nouveau gabarit pourra être sélectionné pour un ou plusieurs de vos articles.

Inventaire des dossiers.

Sans que cela soit une obligation bien que conseillé, votre thème peut également contenir plusieurs dossiers importants et à minima :

un dossier lang/ : contient les fichiers prenant en charge les différentes langues gérées par le thème. Voir : thème multilingue.

D'autres dossiers utiles au tri des autres ressources de votre thème ont également une importance.

Un dossier css/ pour vos feuilles de styles avec un fichier style.css pour recevoir vos premiers styles

Un dossier img/ pour les images de votre thème.

Un dossier js/ pour vos éventuels JavaScript

Les modes PluXml qui sollicitent vos fichiers.

Les différents modes d’affichage sont :

• home : gère la page d’accueil de votre site (dans votre thème : home.php),
• categorie : gère l’affichage des articles par catégories (dans votre thème : categorie.php),
• tag : gère l’affichage des articles par tags (dans votre thème : tags.php),
• archive : gère l’affichage des articles par archives (dans votre thème archives.php)
• articles : gère le contenu des articles (dans votre thème article.php),
• statique : gère le contenu des pages statiques (dans votre thème static.php),
• erreur : gère la page d’erreur de votre site (dans votre thème erreur.php)

Selectionner un thème depuis l'administration

Pour sélectionner un thème depuis l'administration il est nécessaire de pouvoir l'identifier et c'est le rôle du fichier infos.xml où sont stockés: le nom du thème, le nom ou pseudo de l'auteur, le site du thème ou de l'auteur, un numéro de version et une date de publication.

Base de ce fichier à mettre à jour avec vos informations

<?xml version="1.0" encoding="UTF-8"?>
	<document>
	<title>
	<![CDATA[ NOM DU THÈME ]]>
	</title>
	<author>
	<![CDATA[ NOM AUTEUR ]]>
	</author>
	<version> N° VERSION </version>
	<date> DATE </date>
	<site> SITE </site>
	<description>
	<![CDATA[ DESCRIPTION COURTE DU THÈME ]]>
	</description>
</document>

Interlude

Nous savons maintenant que nous avons besoin d'un minimum de fichiers pour la création d'un thème et pourquoi.

Pour continuer à développer ce thème et le tester, il nous faut le dossier au nom du thème avec au minimum nos 8 fichiers dans le dossier thèmes de PluXml dont le fichier infos.xml avec au minimum le nom du thème pour l'identifier et l'activer depuis l'administration.

Ceci fait, il est temps de continuer ou de prendre une pause avant le prochain article.

Votre dossier contient maintenant un nouveau thème activable qui n'affichera qu'une page blanche. Le prochain article vous indiquera quoi mettre dans vos fichier pour afficher vos pages et contenus.

Vue d'ensemble