créer un thème - étape fichiers 01

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 archivesarticle.php
: gère les articlescategorie.php
: gère l’affichage des articles en fonction d’une catégoriecommentaires.php
: gère la partie commentaires des articleserreur.php
: gère la page d’erreurfooter.php
: gère le pied de page de votre siteheader.php
: gère l’entête de votre sitehome.php
: gère la page d’accueilsidebar.php
: gère la barre latérale de votre sitestatic.php
: gère les pages statiquestag.php
: gère l’affichage des articles en fonction d’un taginfos.xml
: regroupe les informations affichées sur la page Thèmes de l’administrationindex.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
Articles de la série: "créer un thème" |
articles connexes | Ressources externes |
---|---|---|
étape fichiers 01 | MAJ d'un vieux thème | |
étape fichiers 02 | ||
étape fichiers 03 | thème multilingue | |
étape fichiers 04 | affichage des commentaires. | |
étape fichiers 05 | le fil d'Ariane | |
étape fichiers 06 | ||
archive ZIP du thème construit dans ce tutoriel themedututo.zip. | ||
étape CSS 01 | meta "viewport" | |
étape CSS 02 | la balise "link" | |
étape CSS 03 | Outils de verification du W3C. | |
* * * | ||
étape intégration 01 | étape fichier 02 - étape fichier 03 - étape fichier 05 | |
Archive du theme du tutoriel massively-integration-01.zip | ||
étape intégration 02 | mettre en place un edito | |
Archive du theme du tutoriel massively.zip. | ||
Outils en ligne: Palette generateur - Font pairing | ||
Ressources en ligne: Fonts (telechargez les de preférences) - Faux contenus HTML - Photos gratuite |