IV - Thème

Nous allons voir ici comment réaliser un thème pour XP-Blog.


  4.1 - Introduction

XP-Blog utilise les fast-template pour générer les pages à afficher. Pour plus de renseignement, reportez-vous au chapitre consacré au fast-template.
Pour résumer, le texte qui sera remplacé est représenté par des variables du type { MAVARIABLE }.


  4.2 - Les variables globales

Les variables globales sont des variables définies dasn toutes les pages. Elle sont aux nombre de six :

Nom des variables Signification
THEME Donne le répertoire du thème qui est utilise. Cela permet de référer les images fournit avec le thème.
VERSION Indique la version de XP-Blog du type "XP-Blog version 0.7"
URL_SITE Donne l'url du site qui à été entrée dans le fichier de configuration.
REP_IMAGE_CATEGORIE Donne le répertoire contenant les images des catégories
REP_IMAGE_TYPE Donne le répertoire contenant les images des types


  4.3 - Squelette.htm

Le fichier squelette.htm est le fichier qui va être "chargé" d'afficher toutes les pages. C'est à dire que la variable { PAGE } va être subtituée par les news, l'interface d'administration, etc... La page contient cinq variables :

Nom des variables Signification
PAGE Contient le résultat des pages à afficher
LISTE_ARCHIVE Contient la liste des liens sur les archives. La dernière année voit ses mois affichés. Les autres seulement l'année
LIEN_PRECEDANT Contient le lien sur la page précédente des news(1)
LIEN_SUIVANT Contient le lien sur la page suivante des news(1)
LISTE_INDEX Contient la liste des pages des news(1)

(1) : uniquement quand se sont les news qui sont affichées.


  4.4 - lang.tpl

Le fichier lang.tpl contient des variables prédéfinies qui vont être utilisées pour afficher par exemple les liens sur les archives, etc... Il peut aussi contenir vos variables.
Le fichier contient obligatoirement les douze variables ci-dessous :

Nom des variables Signification
MESSAGE_LOGIN_FAILED Message affichant que l'identification a échoué
ID_DEJA_UTILISE Message s'affichant quand l'id entrée est déjà utilisé
ERREUR_ECRITURE_NEWS Message s'affichant quand XP-Blog n'arrive pas à écrire les news.
ERREUR_LECTURE_REP_NEWS Message s'affichant quand XP-Blog n'arrive pas à lire les news.
ERREUR_LECTURE_NEWS_PRECISEE Message s'affichant quand le mois demandé est introuvable
ERREUR_FORMAT_DATE_INVALIDE Message s'affichant quand la date passée en paramètre est incorrecte
ADMINISTRATION_NEWS S'affiche quand on est connecté. Contient les liens pour supprimer, éditer les news.
PRECEDANT Lien pour la page précédante
SUIVANT Lien pour la page suivante
ERREUR_LECTURE_BROUILLON Message s'affichant quand XP-Blog n'arrive pas à lire les brouillons
ADMINISTRATION_BROUILLON S'affiche quand on est connecté. Contient les liens pour supprimer, éditer les brouillons
MODEL_LIEN_ARCHIVE Lien sur les archives


  4.5 - news.htm

Pour l'affichage des news, il y a neuf variables :

Nom des variables Signification
TITRE_NEWS Contient le titre de la news
DATE_NEWS Contient la date de la news
HEURE_NEWS Contient l'heure de la news
TEXTE_NEWS Contient le texte de la news
CATEGORIE_NOM_NEWS Contient le nom de la catégorie
CATEGORIE_IMAGE_NEWS Contient uniquement le nom de l'image ! N'oubliez pas d'ajouter { REP_IMAGE_CATEGORIE }
TYPE_NOM_NEWS Contient le nom du type
TYPE_IMAGE_NEWS Contient uniquement le nom de l'image ! N'oubliez pas d'ajouter { REP_IMAGE_TYPE }
ADMIN_NEWS Contient les liens pour l'administration


  4.6 - auth.htm

Ce fichier est afficher lorsqu'on veut se connecter à l'administration.

Nom des variables Signification
MESSAGE_LOGIN Contient le message d'erreur quand la connexion à échoué.


  4.7 - admin.php

Ce fichier représente le pannea de configuration.


  4.8 - acces.refuse.htm

Ce fichier affiche le messsage indiquant que l'accès est refusé.


  4.9 - erreur.sessionid.htm

Ce fichier s'affiche quand vous essayer de vous connecter et qu'il est impossible d'écrire le numéro de session dans le fichier data/sessionid.php. Vérifier les droits d'accès du fichier et du répertoire.


  4.10 - message.htm

Ce fichier affiche les messages d'erreurs, par exemple pour indiquer que l'id saisie est déjà utilisé.

Nom des variables Signification
MESSAGE Contiendra le message


  4.11 - news/addnews.htm

Ce fichier est affiché pour saisir l'entrée d'une nouvelle news. Il contient deux variables :

Nom des variables Signification
TYPE_NEWS Contient la liste des types
CATEGORIE_NEWS Contient la liste des catégories


  4.12 - news/editnews.htm

Le fichier editnews.htm sert à afficher une news en vue de la modifier. Il y a cinq variables :

Nom des variables Signification
ID_NEWS Représente l'id de la news.
TITRE_NEWS Représente le titre de la news
TEXTE_NEWS Représente le texte de la news
TYPE_NEWS Contient la liste des types disponibles. Sera positionné sur le type de la news.
CATEGORIE_NEWS Contient la liste des catégories disponibles. Sera positionné sur la catégoriede la news.


 4.13 - news/editnews.htm

Le fichier types.htm affiche la liste des types disponible, avec leurs catactéristiques, ainsi qu'un formulaire pour en créer un nouveau. Il y a trois variables :

Nom des variables Signification
MESSAGE_TYPES Affiche les messages d'erreur
IMAGE Affiche la liste des images disponibles pour les types.
LISTE_TYPES Affiche la liste de type. Cette variables est le résultat de l'interprétation de la variable LIGNE_TABLEAU_TYPES se trouvant dans le fichier types/vars.tpl

Dans le fichiers types/vars.tpl on trouve aussi les variables :

Nom des variables Signification
ERREUR_LECTURE_TYPES Message d'erreur quand la lecture des types est impossible
ERREUR_ECRITURE_TYPES Message d'erreur quand l'écriture des types est impossible

Pour la variable LIGNE_TABLEAU_TYPES, quatre autres variables sont utilisées :

Nom des variables Signification
ID Représente l'id du type
NOM Nom du type
DESCRIPTION Description du type
IMAGE Image représentant le type


  4.14 - types/edittype.htm

Ce fichier va éditer le type choisi. Il y a quatre variables :

Nom des variables Signification
ID Représente l'id du type
NOM Nom du type
DESCRIPTION Description du type
IMAGE Image représentant le type


  4.15 - Les catégories

Comme toujours, il n'y a pas de différence entre catégories et types. Pour la gestion de catégories, prennez les types et remplacer TYPES par CATEGORIES, editcategorie.php?type=1 par editcategorie.php?type=0, categories.php?type=1 par categories.php?type=0.


$ Bubule - 0.8 - 22/05/2003 14h05 $