- La balise <TEXTE>
- Balises utilisables partout
- Les balises 'Langue'
- Balises plutôt destinées aux menus
- Balise pour le pied de page
- Balises réservée aux rubriques et articles
- Lister les articles d'une rubrique
- Lister les sous-rubriques
Si les feuilles de styles permettent des changements profond dans l'apparence du site, les squelettes vous donnent encore d'avantage de possibilités.
Les fichiers squelettes sont situé dans le répertoire style/ et ont pour extension ".html". Lorsque vous modifiez un squelette, il vous faut le valider (grâce au menu "Administration | Valider une modification de squelette") pour que les changements deviennent visibles.
Pour le moment, le système en comporte 3 (il est possible d'en créer d'autres):
- article.html
- rubrique.html
- defaut.html : gère l'organisation de toutes les autres pages, telles que le plan.. (sauf les pages d'administration dont le squelette est fixe pour le moment)
Un fichier squelette est donc un fichier HTML qui gère tout ce qui est commun à toutes les pages de la même famille. Plus exactement, il s'agit d'une portion de fichier HTML, puisqu'il ne contient que ce qui est situé entre les balises <body> et </body>, pour ceux qui connaissent ce langage. La partie <head></head> est gérée par le fichier header.php qui se trouve dans le répertoire racine du système.
Dans un squelette, vous pouvez utiliser toutes les balises xHTML, ou inclure des scripts javascript. Vous disposez également d'un certain nombre de balises propres à Si2Ra qui vous permettent de gérer le contenu de la page. Ce sont ces balises, que nous allons voir maintenant, qui seront interprété par le moteur de template.
Les balises propres de Si2Ra
Retour en haut de page
La balise <TEXTE>
C'est probablement la seule à être indispensable dans tout squelette, puisqu'elle permet d'afficher les principales informations de la page, le texte d'un article ou d'une rubrique, ou le script pour les pages utilisant le squelette defaut.html.
Retour en haut de page
Balises utilisables partout
- <PSEUDO> : le pseudo (identifiant) du membre connecté.
- <RACINE> : le chemin relatif vers la racine du système. Très utile si vous voulez insérer une image qui n'est pas située dans le répertoire de la page, par exemple. Pensez que tous les articles ne se trouvent pas au même niveau, il n'est donc pas possible d'entrer directement des chemins relatifs dans un squelette.
- <SITE> : le nom que vous avez donné au site lors de l'installation.
- <STYLE_LIST> : Permet à l'utilisateur de choisir le style de la page s'il en existe plusieurs.
- <TITRE> : le titre de la page (c'est à dire la valeur de la variable $S2R_Titre.
- <USER> : le nom complet (Prénom + Nom) du membre connecté.
- <WEBMASTER> : Lien vers le formulaire de contact du Webmaster.
- <WELCOME> : le message d'acceuil affiché lors qu'un membre vient de se connecter.
Retour en haut de page
Les balises 'Langue'
Toutes les balises du type par <LG_...> seront remplacées par la constante correspondante définie dans le fichier de langue "commun". Par exemple <LG_HOME> sera remplacé par la valeur de la constante LG_HOME, c'est à dire "Accueil". Ces balises peuvent également être utilisées en tout endroit du squelette.
Pour le moment, ce n'est pas très utile puisque seul le français est défini. Si vous n'avez pas usage d'un site multilingue, il est probablement meilleur d'écrire directement le texte voulu dans le squelette.
Retour en haut de page
Balises plutôt destinées aux menus
- <ADMIN> : Série de lien vers Administration, Messagerie et Déconnexion pour les membres connecté. Pour les visiteurs anonymes, lien vers le formulaire de connexion.
- <ACCUEIL> : Lien vers la page d'accueil.
- <AIDE> : Lien vers les pages d'aide (pour le moment, le dossier aide est presque vide... Ce lien ne s'affiche que si l'on est connecté.
- <CHAPITRES> : liste des liens vers les sous-rubriques principales (les sous-dossiers directes du dossier pub/).
- <DOWNLOAD> : Lien vers la page télécharger.
- <PLAN> : Lien vers le plan du site.
- <PUB> : Lien vers le répertoire pub/ qui contient tous les articles publiés.
Observation, pour les listes de liens (<ADMIN> et <CHAPITRES>), chaque lien est encadré par les balises <li> et </li>. Pour les autres balises, il vous appartient de rajouter ces balises si elles sont nécessaires.
Retour en haut de page
Balise pour le pied de page
- <STATISTIQUES> : Informations sur la date de mise à jour d'une page, le temps d'élaboration de celle-ci, le nombre de requêtes SQL nécessaires, la quantité de mémoire utilisée. Ces dernières informations seraient évidemment fausses si cette balise était utilisée ailleurs qu'en fin de page !
Retour en haut de page
Balises réservée aux rubriques et articles
- <ABSTRACT> : Pour les articles uniquement. Affiche le sous-titre.
- <AUTEUR> : Pour les articles uniquement. Signature avec lien pour écrire à l'auteur.
- <CHEMIN> : position de l'article ou de la rubrique dans le plan. Permet de remonter jusqu'au premier niveau grâce à des liens "clicables".
- <EDITART> : Pour les articles uniquement. Permet d'éditer l'article si on en est l'auteur.
- <EDITRUB> : Pour les rubriques uniquement. Permet d'éditer la rubrique si l'on est habilité. (introduite avec la version 0.69)
- <NOUVART> : Ecrire un nouvel article dans la rubrique.
Retour en haut de page
Lister les articles d'une rubrique
Ces balises sont réservées aux rubriques (articles de la rubrique) et articles (articles de la même rubrique).
- <IF_ARTICLE> : (balise facultative)
- Le code que vous insérerez ici sera affiché si il y a au moins article
- <ARTICLES> : Liste les artciles du dossier en cours sous la forme "<li><a href="lien vers l'article">Titre de l'article</a></li>". Il vous revient d'encadrer <ARTICLES> par les balises HTML <ul></ul> si vous souhaitez une liste à puce, ou <ol></ol> pour une liste numérotée.
- Le code que vous insérerez ici sera affiché si il y a au moins une sous rubrique
- <NO_ARTICLE> : (balise facultative, doit être précédé par une balise IF_ARTICLE)
- Le code que vous insérerez ici sera affiché en l'absence d'articles
- </ARTICLE> (ferme obligatoirement les balises <IF_ARTICLE> et <NO_ARTICLE>)
La balise <ARTICLES> accepte les paramètres suivants:
- ABSTRACT : affiche les sous-titres éventuels des articles
- LIMIT=x : N'affiche que les x premiers articles
- IMG=Nom_de_l'image : Affiche une image devant chaque item. Attention, cela doit toujours être le DERNIER paramètre, l'image doit être dans le répertoire /img.
Retour en haut de page
Lister les sous-rubriques
Ces balises n'ont bien sûr de sens que pour le squelette des rubriques !
- <IF_RUBRIQUE> : (balise facultative)
- Le code que vous insérerez ici sera affiché si il y a au moins une sous rubrique
- <RUBRIQUES> : Liste les sous-dossiers du dossier en cours sous la forme "<li><a href="lien vers la rubrique">Nom de la Rubrique</a></li>".
Il vous revient d'encadrer <RUBRIQUES> par les balises HTML <ul></ul> si vous souhaitez une liste à puce, ou <ol></ol> pour une liste numérotée. - Le code que vous insérerez ici sera affiché si il y a au moins une sous rubrique
- <NO_RUBRIQUE> : (balise facultative, doit être précédé par une balise IF_RUBRIQUE)
- Le code que vous insérerez ici sera affiché en l'absence de sous rubrique
- </RUBRIQUE> (ferme obligatoirement les balises <IF_RUBRIQUE> et <NO_RUBRIQUE>)
La balise <RUBRIQUES> accepte les paramètres suivants:
- LIMIT=x : N'affiche que les x premiers items
- IMG=Nom_de_l'image : Affiche une image devant chaque item. Attention, cela doit toujours être le DERNIER paramètre, l'image doit être dans le répertoire /img.
Exemple : <RUBRIQUES IMG=dos_ferme.gif>
écrit avec 