Découvrez Kiubi pas à pas

Nous allons aborder ici la création de nouveaux types de billets. Le guide le l’utilisateur vous rafraîchira la mémoire sur l’utilité des types de billets.

Une fois connecté à votre espace FTP, allez dans le répertoire "theme" puis "fr" puis "billets". Les fichiers qui nous intéressent sont ici et, suivant le thème que vous avez copié, il y a plusieurs sous répertoires. Chacun de ces sous répertoires est un type de billet. Ils contiennent tous les fichiers suivants :

desc.xml

Ce fichier contient des informations descriptives du type de billet qui seront utilisée à la fois dans la console d'administration et le site internet. Il indique à Kiubi de quels champs est composé le type de billet. Voici un exemple :

<?xml version="1.0" encoding="iso-8859-1"?>
<type tri="2">
    <desc>Titres, texte et image (à gauche)</desc>
    <listechamps>
        <champ chmap="titre" type="texte" intitule="Titre"/>
        <champ champ="sstitre" type="text" intitule="Sous-titre" />
        <champ champ="texte10" type="image" intitule="Image" />
        <champ champ="texte1" type="wysiwyg" intitule="Contenu" />
    </listechamps>
</type>

Ce fichier contient une seule balise principale <type> qui possède 1 attribut :

• tri : nombre qui sert à définir l'ordre dans le quel vont apparaître les types de billets dans les listes déroulantes.
  

A l'intérieur, nous avons une seule balise <desc> qui contient la description du type de billet qui sera repris dans la console d'administration. La balise <listechamps> sert à déclarer tous les champs qui seront utilisés dans ce type de billet. Il existe alors une balise <champ> par champ qui contient les attributs suivants :

• champ : code du champ qui sera aussi utilisé dans les templates. Ce code peut prendre les valeurs "titre", "sstitre", "texte1" à "texte15". Un billet est composé d'un maximum de 17 champs.
  
  
• type : le type du champ indique quelle sorte d'information est stockée dans le champ.  Il en existe quatre :
  
  • type "texte" : champ de saisie simple
    
  • type "wysiwyg" : éditeur de texte visuel
    
  • type "image" : fichier image de la médiathèque
    
  • type "fichier" : fichier quelconque de la médiathèque
    
• intitule : intitulé de du champ qui va être repris dans la console d'administration lors de l'édition d'un billet.

index.html

Le fichier "index.html" contient le code HTML du type de billet. Voici un exemple :

<!-- BEGIN: main -->
    <!-- BEGIN: titre -->
        <h2>{titre}</h2>
    <!-- END: titre -->
    <!-- BEGIN: sstitre -->
        <h3>{sstitre}</h3>
    <!-- END: sstitre -->
    <!-- BEGIN:texte10 -->
        <img src="/media/vignette/{texte10}" alt="{titre}"/>
    <!-- END:texte10 -->
    <!-- BEGIN: texte1 -->
        <p>{texte1}</p>
    <!-- END: texte1 -->
<!-- END: main -->

Les balises {titre}, {sstitre}, etc, servent à indiquer où injecter le contenu des champs du billet. Vous trouverez ici la liste complète des balises utilisable dans ce template.