Découvrez Kiubi pas à pas

Un certain nombre de widgets  possèdent des fonctionnalités communes qui sont regroupées dans cette page. Le paragraphe "Balises supplémentaires" de chaque widget indique quelles fonctionnalités peuvent y être utilisées.

La balise {alterne} est utilisée dans les widgets qui génèrent des listings comme par exemple le widget du "Blog" : "Liste des billets". La balise affichera alternativement "1" ou "2" si on la place dans le bloc qui est répété dans le widget.
Prenons par exemple le widget "Blog / Liste des Billets" avec un template très simplifié :

<!-- BEGIN:main --> 
<!-- BEGIN:billet -->
<ul>
    <li>{alterne}, {titre}</li>
</ul>
<!-- END:billet -->
<!-- END:main -->

Si on a 5 billets dans son blog, le résultat sera :

- 1, Titre du premier billet
- 2, Titre du deuxième billet
- 1, Titre du troisième billet
- 2, Titre du quatrième billet
- 1, Titre du cinquième billet

A quoi ça sert ? Imaginons que vous créez deux styles, "ligne1" et "ligne2" et que vous changez la balise <li> en : <li class="ligne{alterne}">, cela vous permet d'appeler alternativement l'un ou l'autre style pour changer la couleur de fond par exemple et rendre ainsi vos listing plus lisibles.

La balise {compteur} est utilisée dans les widgets qui génèrent des listings comme par exemple le widget du "Blog" :  "Liste des commentaires". La balise affichera un compteur commençant à 1 et qui sera incrémenté de 1 à chaque fois.

Prenons par exemple le widget "Blog / Liste des commentaires" avec un template très simplifié :

<!-- BEGIN:main --> 
<!-- BEGIN:commentaire-->
<ul>
    <li>{compteur}. {commentaire}</li>
</ul>
<!-- END:commentaire-->
<!-- END:main -->

Si on a 3 commentaires pour un billet de son blog, le résultat sera :

- 1. Premier commentaire ...
- 2. Deuxième commentaire ...
- 3. Troisième commentaire ...

Et voila, chaque ligne est numérotée automatiquement.

Cette fonctionnalité est une association entre un bloc et une balise. Les widgets pouvant utiliser la fonctionnalité "Intitulé" ont un bloc supplémentaire à placer dans le bloc "main" :

<!-- BEGIN:main --> 
    <!-- BEGIN:intitule -->
        {intitule}
    <!-- END:intitule -->
<!-- END:main -->

Ce bloc ne s’affiche que si l’intitulé du widget est rempli. Cet intitulé est configurable dans le widget. Pour cela, aller dans "Apparence / Mises en page" et cliquez sur la page qui contient ce widget pour la configurer. Là, cliquez sur le widget désiré, une fenêtre de configuration s’ouvrira ou vous pourrez modifier la champ "Intitulé". Validez et enregistrez la page pour voir le résultat dans votre site web.

La navigation est encore une fonctionnalité qu'on retrouve dans les widgets qui génèrent des listings. C'est un ensemble de bloc qui permet d'afficher des barres de navigations complètes. L'utilisation le plus courante est dans le widget de résultat du moteur de recherche. Les résultats sont affichés sur plusieurs pages et la navigation permet de passer d'une page à l'autre.

Les options de navigation (nombre d'élément par page, afficher ou cacher la navigation) sont toujours configurables dans le widget. La barre de navigation comprend :
 - des liens vers les pages suivantes et précédentes
 - des liens vers la première et dernière page
 - une liste de numéro de page comprenant un lien pour arriver directement sur la page en question.

Pour plus de souplesse, il est possible de mettre deux barres de navigation dans un même widget, typiquement pour mettre un barre en haut et une en bas du listing. C'est pour ça que les balises et bloc ci dessous fonctionnent aussi bien dans les blocs nav1 et nav2. Voici un exemple de ce que cela peux donner en HTML :

<!-- BEGIN: nav1 -->
   <!-- BEGIN: premier -->
   <a href="{lien_premier}">premiere page</a> |
   <!-- END: premier -->
   <!-- BEGIN: precedent -->
   <a href="{lien_precedent}">page precedente</a> |
   <!-- END: precedent -->
   <!-- BEGIN: pages -->
   <a href="{lien_page}" class="{selected}">{page}</a>
   <!-- END: pages -->
   <!-- BEGIN: suivant -->
   | <a href="{lien_suivant}">page suivante</a>
   <!-- END: suivant -->
   <!-- BEGIN: dernier -->
   | <a href="{lien_dernier}">derniere page</a>
   <!-- END: dernier -->
 <!-- END: nav1 -->
<br />
<br />
 page {num_page} sur {nb_pages} ({nb_resultats} billets trouvés)<br />
<br />
[listing ....]<br />
<br />
<!-- BEGIN: nav2 -->
  <!-- BEGIN: premier -->
  <a href="{lien_premier}">premiere page</a> |
  <!-- END: premier -->
  <!-- BEGIN: precedent -->
  <a href="{lien_precedent}">page precedente</a> |
  <!-- END: precedent -->
  <!-- BEGIN: pages -->
  <a href="{lien_page}" class="{selected}">{page}</a>
  <!-- END: pages -->
  <!-- BEGIN: suivant -->
  | <a href="{lien_suivant}">page suivante</a>
  <!-- END: suivant -->
  <!-- BEGIN: dernier -->
  | <a href="{lien_dernier}">derniere page</a>
  <!-- END: dernier -->
<!-- END: nav2 -->

Ce qui donnerai cela :

premiere page | page precedente | 1 2 3 4 5 | page suivante |  derniere page

 page 2 sur 5 (53 billets trouvés)

[listing ...] 

 premiere page | page precedente | 1 2 3 4 5 | page suivante |  derniere page 

Liste des balises