Guide du Webdesigner

Guide des widgets du service Cms

Ce widget très important affiche un extrait du contenu d'une page libre du Site web.

Il affiche les billets d´une page libre en ne conservant PAS le modèle de mise en page propre à chaque billet mais en appliquant un unique modèle de mise en page à tous les billets affichés.

Par défaut Kiubi propose 4 modèles graphiques différents pour ce widget :

  • Le modèle par défaut, qui intègre tous les éléments des billets.
  • avec_lien_vers_page, qui intègre un lien vers la page d´origine des billets.
  • sans_image, qui n´affiche pas les images des billets.
  • slideshow, qui affiche un carrousel d'image

Avertissement : l´apparence des billets affichés par le widget « Bloc d´extrait » sera donc déterminée par le modèle graphique du widget et non pas par les modèles graphiques des différents types de billets affichés.

Paramètres de configuration du widget

  • Modèle graphique : permet de choisir entre les différents modèles graphiques disponibles. Chaque modèle graphique détermine une apparence différente du widget.
  • Intitulé : afficher un intitulé, un titre, au widget.
  • Afficher le contenu : choix de la page dont le contenu doit être affiché ; page en cours, toutes les pages du Site web, page au choix.
  • Inclure les sous-pages : permet d'inclure le contenu des sous-pages de la page choisie au point précédent.
  • Afficher les billets : restreindre l´affichage aux seuls billets faisant partie d´un groupe. Tous les groupes de billet ou un groupe au choix. Choisir "Aucun" restreint l´affichage aux billets ne faisant partis d´aucun groupe.
  • Trier par : choix du critère de tri ; position, alphabétique ou aléatoire.
  • Limiter l´affichage aux X premiers billets : limite l´affiche aux X premiers billets disponibles en fonction de la configuration du widget. La valeur de X peut être choisie.
  • Afficher seulement les Y premiers caractères du contenu des billets : affiche les Y premiers caractères du contenu des balises {resume_texte1} et {resume_texte2}. La valeur de Y peut être choisie. Si Y est égale à 0, le contenu ne sera pas affiché. Si Y est non renseignée, tout le contenu sera affiché.
  • Afficher la navigation : afficher la navigation de page en page (page précédente/page suivante) si le nombre de billets à afficher est supérieur à la valeur de X du point précédent.

Répertoire

Le code source de ce widget se trouve à l'emplacement suivant :

theme/fr/widgets/site_web/bloc_extrait/index.html

Exemple du code source

<!-- BEGIN:main -->
<!-- BEGIN:intitule -->
  <h1>{intitule}</h1>
<!-- END:intitule -->
  
<!-- BEGIN:billet -->
  <div>
    <!-- BEGIN:texte10 -->
    <img src="{racine}/media/miniature/{texte10}" alt="{titre}" />
    <!-- END:texte10 -->
	 
    <!-- BEGIN:titre --><h2>{titre}</h2><!-- END:titre -->
    <!-- BEGIN:sstitre --><h3>{sstitre}</h3><!-- END:sstitre -->
    <!-- BEGIN:texte1 --><p>{resume_texte1}</p><!-- END:texte1 -->
  </div>
<!-- END:billet -->
  
<!-- BEGIN: nav2 -->
<div>
  <!-- BEGIN: premier -->
  <a href="{lien_premier}" title="première page">première page</a> |
  <!-- END: premier -->
  <!-- BEGIN: precedent -->
  <a href="{lien_precedent}" title="page précédente">page précédente</a> |
  <!-- END: precedent -->
  <!-- BEGIN: pages -->
  <a href="{lien_page}">{page}</a>
  <!-- END: pages -->
  <!-- BEGIN: suivant -->
  | <a href="{lien_suivant}" title="page suivante">page suivante</a>
  <!-- END: suivant -->
  <!-- BEGIN: dernier -->
  | <a href="{lien_dernier}" title="dernière page">dernière page</a>
  <!-- END: dernier -->
  <!--	
<br />
page {num_page} sur {nb_pages} <br />
({nb_resultats} billets trouvés)
-->
</div>
<!-- END: nav2 -->
<!-- END:main -->

Balises disponibles

Bloc main

Bloc racine tout le temps affiché.

La liste ci-dessous présente les différentes balises disponibles au sein du bloc <!-- BEGIN:main -->

new serial

Identifiant unique du widget dans la page. Permet d'identifier de manière unique le widget dans la page.

widget_modele

Nom du modèle utilisé par le widget (vide pour le modèle de base).

widget_page_optim

Nom optimisé de la page dont le contenu doit être affiché. Affiche "all" si le widget affiche les billets de toutes les pages.

widget_inclus

Affiche 1 si le contenu des sous-pages de la page choisie sont inclus. 0 dans le cs contraire

widget_groupe

Affiche le critère de restriction d'affichage à un groupe

widget_order_api

Critère de tri appliqués à l'API Front-office

widget_limit

Nombre maximum d'éléments affichés

widget_resume

Longueur maximale des résumés

widget_afficher_navigation

Affiche 1 si la navigation est affichée, 0 si elle est masquée

Bloc main.intitule

Ne s´affiche que si l´intitulé du widget est rempli.

La liste ci-dessous présente les différentes balises disponibles au sein du bloc <!-- BEGIN:intitule -->

intitule

Cet intitulé est paramétrable lors de l´édition d´un widget dans la gestion de l´Apparence de la Console d´administration de Kiubi.

Bloc main.billet

Le contenu du bloc s'affiche pour chaque billet.

La liste ci-dessous présente les différentes balises disponibles au sein du bloc <!-- BEGIN:billet -->

accueil

Affiche 1 si la page libre du billet est la page d'accueil, sinon affiche 0.

lien_billet

URL spéciale vers la page libre du billet. Les widgets "Contenu de la page libre" de la page libre du billet qui peuvent afficher ce billet n'afficherons que ce billet là, et tous les autres widgets fonctionneront normalement.

lien_page

URL vers la page libre du billet.

type_billet

Type du billet. Affiche le nom du répertoire du billet dans l´espace FTP.

titre

Titre du billet.

sstitre

Sous-titre du billet.

texte1 à texte15

Affiche le contenu des champs texte1 à texte15.

groupe_billet

Groupe du billet.

intitule_page

Intitulé de la page libre du billet.

nom_optim

Nom optimisé de la page libre du billet.

compteur
alterne

La balise affichera alternativement 1 ou 2.

alterne_3

La balise affichera alternativement 1,2 ou 3.

alterne_4

La balise affichera alternativement 1,2,3 ou 4.

alterne_5

La balise affichera alternativement 1,2,3,4 ou 5.

resume_texte1

Version tronquée du contenu du champ texte1. Configurable dans le widget.

resume_texte2

Version tronquée du contenu du champ texte2. Configurable dans le widget.

Bloc main.billet.resume_texte1

Le contenu du bloc ne s'affiche que si le resume_texte1 du billet n'est pas vide.

Bloc main.billet.resume_texte2

Le contenu du bloc ne s'affiche que si le resume_texte2 du billet n'est pas vide.

Bloc main.billet.titre

Le contenu du bloc ne s'affiche que si le titre du billet n'est pas vide.

Bloc main.billet.sstitre

Le contenu du bloc ne s'affiche que si le sous-titre du billet n'est pas vide.

Bloc main.billet.texte1 à texte15

Les contenus des blocs ne s'affichent que si les contenus des champs textes correspondants ne sont pas vides.

Bloc main.nobillet

Le contenu du bloc s'affiche s'il n'y a aucun billet à afficher.

Bloc main.nav1 et main.nav2

Bloc d'affichage de la navigation, voir guide du designer 1ere partie

Ce widget très important affiche le contenu d'une page libre du Site web.

Il affiche les billets d´une page libre tout en conservant le modèle de mise en page propre à chaque billet.

Pour plus d´informations sur les modèles de mise en page des billets, voir la section les types de billets.

Avertissement : l´apparence du widget « Contenu de la page libre » sera donc déterminée par les différents modèles de mise en page des différents types de billets affichés.

Paramètres de configuration du widget

  • Afficher le contenu : choix de la page dont le contenu doit être affiché ; page en cours, toutes les pages du Site web, page au choix.
  • Inclure les sous-pages : permet d´inclure le contenu des sous-pages de la page choisie au point précédent.
  • Afficher les billets : restreindre l´affichage aux seuls billets faisant partie d´un groupe ; tous les groupes de billet ou un groupe au choix. Choisir "Aucun" restreint l´affichage aux billets ne faisant partis d´aucun groupe.
  • Trier par : choix du critère de tri ; position, alphabétique ou aléatoire.
  • Limiter l´affichage aux X premiers billets : limite l´affiche aux X premiers billets disponibles en fonction de la configuration du widget ; la valeur de X peut être choisie.
  • Afficher la navigation : afficher la navigation de page en page (page précédente / page suivante) si le nombre de billets à afficher est supérieur à la valeur de X du point précédent.

Répertoire

Le code source de ce widget se trouve à l'emplacement suivant :

theme/fr/widgets/site_web/contenu_page_libre/index.html

Exemple du code source

<!-- BEGIN: main -->

<!-- BEGIN: nav1 -->
<!-- <div>
<a href="{lien_precedent}" title="Page précedente">page précedente</a>
 | 
 <a href="{lien_suivant}" title="Page suivante">page suivante</a>
 
</div> -->
<!-- END: nav1 -->

{liste_billets}

<!-- BEGIN: nav2 -->
<div>
 
 	<!-- BEGIN: premier -->
	<a href="{lien_premier}" title="première page">première page</a> |
	<!-- END: premier -->
	  
	<!-- BEGIN: precedent -->
	<a href="{lien_precedent}" title="page précédente">page précédente</a> | 
	<!-- END: precedent -->
	 
	<!-- BEGIN: pages -->
	<a href="{lien_page}">{page}</a>
	<!-- END: pages -->	 
	 
	 <!-- BEGIN: suivant -->
	 | <a href="{lien_suivant}" title="page suivante">page suivante</a> 
	<!-- END: suivant -->
	 
	 <!-- BEGIN: dernier -->
	  |  <a href="{lien_dernier}" title="dernière page">dernière page</a>
	<!-- END: dernier -->
</div>
<!-- END: nav2 -->

<!-- END: main -->

Balises disponibles

Bloc main

Bloc racine tout le temps affiché

La liste ci-dessous présente les différentes balises disponibles au sein du bloc <!-- BEGIN:main -->

liste_billets

Affiche la liste des billets, c'est à dire le contenu d'une page libre du Site web.

new serial

Identifiant unique du widget dans la page. Permet d'identifier de manière unique le widget dans la page.

widget_page_optim

Nom optimisé de la page dont le contenu doit être affiché. Affiche "all" si le widget affiche les billets de toutes les pages.

widget_inclus

Affiche 1 si le contenu des sous-pages de la page choisie sont inclus. 0 dans le cs contraire

widget_groupe

Affiche le critère de restriction d'affichage aux groupes

widget_order_api

Critère de tri appliqués à l'API Front-office

widget_limit

Nombre maximum d'éléments affichés

widget_afficher_navigation

Affiche 1 si la navigation est affichée, 0 si elle est masquée

Bloc main.nobillet

Le contenu du bloc s'affiche s'il n'y a aucun billet à afficher.

Mise en forme d'un type de billet

Exemple du code source

<!-- BEGIN: main -->
  <header>
    <!-- BEGIN: titre --><h1>{titre}</h1><!-- END: titre -->
    <!-- BEGIN: sstitre --><h2>{sstitre}</h2><!-- END: sstitre -->
  </header>
  <!-- BEGIN: texte1 -->{texte1}<!-- END: texte1 -->
<!-- END: main -->

Balises disponibles

Bloc main

Bloc racine tout le temps affiché

La liste ci-dessous présente les différentes balises disponibles au sein du bloc <!-- BEGIN:main -->

type_billet

Type du billet : affiche le nom du répertoire du billet dans l´espace FTP.

titre

Titre du billet.

sstitre

Sous-titre du billet.

texte1 à texte15

Affiche les champs texte1 à texte15.

groupe_billet

Groupe du billet.

intitule_page

Intitulé de la page libre dans laquelle se trouve le billet.

nom_optim
lien_page

URL vers la page libre dans laquelle se trouve le billet.

lien_billet
compteur
alterne

La balise affichera alternativement 1 ou 2.

alterne_3

La balise affichera alternativement 1,2 ou 3.

alterne_4

La balise affichera alternativement 1,2,3 ou 4.

alterne_5

La balise affichera alternativement 1,2,3,4 ou 5.

new serial

Identifiant unique du widget dans la page. Permet d'identifier de manière unique le widget dans la page.

widget_page_optim

Nom optimisé de la page dont le contenu doit être affiché. Affiche "all" si le widget affiche les billets de toutes les pages.

widget_inclus

Affiche 1 si le contenu des sous-pages de la page choisie sont inclus. 0 dans le cs contraire

widget_groupe

Affiche le critère de restriction d'affichage aux groupes

widget_order_api

Critère de tri appliqués à l'API Front-office

widget_limit

Nombre maximum d'éléments affichés

widget_afficher_navigation

Affiche 1 si la navigation est affichée, 0 si elle est masquée

Bloc main.titre

Le contenu du bloc ne s'affiche que si le titre du billet n'est pas vide.

Bloc main.sstitre

Le contenu du bloc ne s'affiche que si le sous-titre du billet n'est pas vide.

Bloc main.texte1 à texte15

Les contenus des blocs ne s'affichent que si les contenus des champs textes correspondants ne sont pas vides.