@kiubi/mcp-designer 1.0.0

package/storage/documents/generated/integration/06_balises_globales.md

@@ -0,0 +1,201 @@
+## Balises globales
+
+Les balises globales sont disponibles et utilisables partout dans Kiubi (modèles
+graphiques, éditeurs de texte visuels, champs d'information, ...).
+
+#### Balises de base
+
+
+
+|Balise|Description|
+|---|---|
+| `{racine}` | Indique le chemin relatif vers la racine du site où que l'on soit situé dans l'arborescence. |
+| `{lg}` | Indique le code langue courant (toujours fr pour l'instant). Cette balise est également disponible dans les templates d'email |
+| `{baseLangue}` | Indique le chemin relatif vers la racine du site dans la langue courante. |
+| `{lien_pagecourante}` | URL de la page courante. |
+| `{intitule_pagecourante}` | Intitulé de la page courante. |
+| `{optim_pagecourante}` | Affiche le nom optimisé de la page courante. Affiche par exmple le nom optimisé du billet dans la page de détail de billet du blog, ou le nom optimisé de la catégorie dans la page de détail d'une catégorie du catalogue.<br /> |
+| `{contexte_pagecourante}` | Affiche le contexte de la page courante sous forme d'une liste qui reprends le service, le type et les informations permettant d'identifer l'objet principal de la page. Plus de détails dans la section "Contexte" ci-dessous. |
+| `{lien_pageparente}` | URL de la page parente (niveau hiérarchique supérieur dans l'arborescence). |
+| `{intitule_pageparente}` | Indique l'intitulé de la page parente. |
+| `{accroche_site}` | Affiche l'accroche du site figurant dans "Mon site / Apparence / Bloc-marque". Cette balise est également disponible dans les templates d'email |
+| `{desc_site}` | Affiche la description du site figurant dans "Mon site / Apparence / Bloc-marque". Cette balise est également disponible dans les templates d'email |
+| `{logo_site}` | Affiche l'identifiant du logo du site figurant dans "Mon site / Apparence / Bloc-marque". Cette balise est également disponible dans les templates d'email |
+| `{url_logo_site}` | Affiche l'url du logo du site figurant dans "Mon site / Apparence / Bloc-marque". Cette balise est également disponible dans les templates d'email |
+| `{domaine}` | Affiche le nom du domaine courant du site. |
+| `{schema}` | Affiche le schéma du site (http ou https). |
+| `{site_nom}` | Affiche le nom du site figurant dans "Mon compte / Préférences". Cette balise est également disponible dans les templates d'email |
+| `{g_vignette_l}` | Largeur en pixels des grandes vignettes de la médiathèque. |
+| `{vignette_l}` | Largeur en pixels des vignettes de la médiathèque. |
+| `{g_vignette_h}` | Hauteur en pixels des grandes vignettes de la médiathèque. |
+| `{vignette_h}` | Hauteur en pixels des vignettes de la médiathèque. |
+| `{g_miniature_l}` | Largeur en pixels des grandes miniatures de la médiathèque. |
+| `{miniature_l}` | Largeur en pixels des miniatures de la médiathèque. |
+| `{g_miniature_h}` | Hauteur en pixels des grandes miniatures de la médiathèque. |
+| `{miniature_h}` | Hauteur en pixels des miniatures de la médiathèque. |
+| `{balise}` | Affiche le code d'un balise sans qu'elle ne soit interpretée. Exemple : `{balise|site_nom}` affiche "{site_nom}". |
+| `{cdn}` | URL du CDN des ressources statiques de la Plateforme.<br /> |
+| `{referer}` | Affiche le referer du navigateur, remplacée par REQUEST.referer |
+| `{devise}` | Affiche le devise du site. Cette balise est également disponible dans les templates d'email |
+| `{devise_iso}` | Affiche le code iso (3 lettres) de la devise du site. Cette balise est également disponible dans les templates d'email |
+| `{theme}` | Affiche le code du thème graphique du site. Le code pour les thèmes graphiques personnalisés est "theme". Cette balise est également disponible dans les templates d'email |
+| `{canonical}` | Affiche le chemin canonique de la page en cours |
+| `{liste_domaines}` | Liste de tout les noms de domaines du site. |
+| `{FILE "fichier.html"}` | Cette balise est très spéciale car elle permet d'inclure un modèle graphique dans le modèle graphique courant. Il suffit pour cela d'indiquer le chemin du modèle graphique que vous voulez inclure. Ce fichier doit se trouver dans le thème courant. <br /><br />Cette balise est souvent utilisée pour inclure à différents endroits des bouts de page qui reviennent de manière récurrente. Par exemple, dans les thèmes Kiubi, le copyright en bas de page est inclus dans toutes les pages grâce à la balise : `{FILE "/fr/includes/copyright.html"}`<br /><br />Cette balise est également disponible dans les templates d'email<br />Attention : cette balise *n'est pas disponible* dans les contenus WYSIWYG.  |
+| `{illustration_pagecourante}` | Affiche le chemin vers l'illustration de le page courante. N'affiche rien si aucune illustration n'est disponible. |
+| `{illustration_pagecourante_miniature}` | Affiche le chemin vers la miniature de l'illustration de le page courante. N'affiche rien si aucune illustration n'est disponible. |
+| `{illustration_pagecourante_vignette}` | Affiche le chemin vers la vignette de l'illustration de le page courante. N'affiche rien si aucune illustration n'est disponible. |
+| `{illustration_pagecourante_g_vignette}` | Affiche le chemin vers la grande vignette de l'illustration de le page courante. N'affiche rien si aucune illustration n'est disponible. |
+| `{illustration_pagecourante_g_miniature}` | Affiche le chemin vers la grande miniature de l'illustration de le page courante. N'affiche rien si aucune illustration n'est disponible. |
+
+
+#### Détail de la balise contexte_pagecourante
+
+La balise contexte_pagecourante affiche des valeurs spécifique à la page dans laquelle est utlisée. Son utlisation est particulièrement appréciable avec certains frameworks CSS et Javascript.
+
+
+
+|Balise|Description|
+|---|---|
+| `{/}` | cms cms-accueil |
+| `{/[page].html}` | cms cms-page cms-page-[page] |
+| `{/blog/}` | blog blog-accueil |
+| `{/blog/[categorie]/}` | blog blog-categorie blog-categorie-[categorie] |
+| `{/blog/[categorie]/[yyyy]/[mm]/[dd]/}` | blog blog-categorie blog-categorie-[categorie] blog-y-[yyyy] blog-m-[mm] blog-d-[dd] |
+| `{/blog/[categorie]/[yyyy]/[mm]/[dd]/[billet].html}` | blog blog-billet blog-billet-[billet] blog-categorie-[categorie] blog-a-[yyyy] blog-m-[mm] blog-j-[dd] |
+| `{/catalogue/}` | catalogue catalogue-accueil |
+| `{/catalogue/[categorie]/}` | catalogue catalogue-categorie catalogue-categorie-[categorie] |
+| `{/catalogue/[categorie]/[tags:]/}` | catalogue catalogue-categorie catalogue-categorie-[categorie] catalogue-tag catalogue-tag-[tag1] catalogue-tag-[tag-2].... |
+| `{/catalogue/[categorie]/[produit].html}` | catalogue catalogue-produit catalogue-produit-[produit] catalogue-categorie-[categorie]  |
+| `{/compte/[page].html}` | compte compte-[page] |
+| `{/contact/}` | contact |
+| `{/ecommerce/[page].html}` | ecommerce ecommerce-[page] |
+| `{/recherche/[service]/}` | recherche recherche-[service] |
+
+
+#### Informations société
+
+Les balises ci-dessous sont utilisables dans tous les templates, widgets, contenu wysiwyg et templates d'email.
+
+|Balise|Description|
+|---|---|
+| `{SOCIETE.contact_nom}` | Affiche le nom du contact principal du site internet figurant dans "Mon compte / Préférences". |
+| `{SOCIETE.contact_prenom}` | Affiche le prénom du contact principal du site internet figurant dans "Mon compte / Préférences". |
+| `{SOCIETE.contact_email}` | Affiche l'e-mail du contact principal du site internet figurant dans "Mon compte / Préférences". |
+| `{SOCIETE.societe_nom}` | Affiche le nom de la société responsable du site internet figurant dans "Mon compte / Préférences". |
+| `{SOCIETE.societe_adresse}` | Affiche l'adresse de la société responsable du site internet figurant dans "Mon compte / Préférences". |
+| `{SOCIETE.societe_cp}` | Affiche le code postal de la société responsable du site internet figurant dans "Mon compte / Préférences". |
+| `{SOCIETE.societe_ville}` | Affiche la ville de la société responsable du site internet figurant dans "Mon compte / Préférences". |
+| `{SOCIETE.societe_pays}` | Affiche le pays de la société responsable du site internet figurant dans "Mon compte / Préférences". |
+| `{SOCIETE.societe_tel}` | Affiche le numéro de téléphone de la société responsable du site internet figurant dans "Mon compte /Préférences". |
+| `{SOCIETE.societe_mobile}` | Affiche le numéro de mobile de la société responsable du site internet figurant dans "Mon compte / Préférences". |
+| `{SOCIETE.societe_fax}` | Affiche le numéro de fax de la société responsable du site internet figurant dans "Mon compte / Préférences". |
+| `{SOCIETE.societe_cnil}` | Affiche le numéro de déclaration CNIL du site internet figurant dans "Mon compte / Préférences". |
+| `{SOCIETE.societe_capital}` | Affiche le capital de la société responsable du site internet figurant dans "Mon compte / Préférences". |
+| `{SOCIETE.societe_siret}` | Affiche le numéro siret de la société responsable du site internet figurant dans "Mon compte / Préférences". |
+| `{SOCIETE.societe_rcs}` | Affiche le RCS de la société responsable du site internet figurant dans "Mon compte / Préférences". |
+| `{SOCIETE.societe_ape}` | Affiche le code APE (ou NAF) de la société responsable du site internet figurant dans "Mon compte / Préférences". |
+| `{SOCIETE.societe_tva}` | Affiche le numéro de TVA intracommunautaire de la société responsable du site internet figurant dans "Mon compte / Préférences". |
+| `{SOCIETE.societe_forme}` | Affiche la forme juridique de la société responsable du site internet figurant dans "Mon compte / Préférences". |
+
+
+#### Horodatage
+
+Les balises ci-dessous sont utilisables dans tous les templates, widgets, contenu wysiwyg et templates d'email.
+
+|Balise|Description|
+|---|---|
+| `{num_jour_maintenant}` | Affiche le numéro du jour courant (01 - 31). |
+| `{jour_semaine_maintenant}` | Affiche le jour de la semaine courant (lundi - dimanche). |
+| `{num_mois_maintenant}` | Affiche le numéro du mois courant (01 - 12). |
+| `{mois_maintenant}` | Affiche le mois courant (janvier - décembre). |
+| `{mois_abrev_maintenant}` | Affiche le mois courant abrégé (jan - déc). Il vaut mieux utiliser `{mois_abrev_maintenant}` que<br />`{mois_maintenant|left|3}` car la découpe se fait plus intelligemment pour les mois en quatre lettres. |
+| `{annee_maintenant}` | Affiche l'année courante (2007). |
+| `{heure_maintenant}` | Affiche l'heure courante (00-23). |
+| `{minute_maintenant}` | Affiche les minutes courantes (00-59). |
+| `{seconde_maintenant}` | Affiche les secondes courantes (00-59). |
+| `{timestamp_maintenant}` | Affiche le timestamp courant |
+
+
+#### Informations client
+
+Les balises ci-dessous sont utilisables dans tous les templates / widgets et contenu wysiwyg
+
+|Balise|Description|
+|---|---|
+| `{CLIENT.client_id}` | Affiche l'identifiant interne du client. Requiert que le client soit connecté |
+| `{CLIENT.num}` | Affiche le numéro du client. Requiert que le client soit connecté |
+| `{CLIENT.nom}` | Affiche le nom du client. Requiert que le client soit connecté |
+| `{CLIENT.prenom}` | Affiche le prénom du client. Requiert que le client soit connecté |
+| `{CLIENT.genre}` | Affiche le genre ("H" ou "F") du client. Requiert que le client soit connecté |
+| `{CLIENT.email}` | Affiche l'email du client. Requiert que le client soit connecté |
+| `{CLIENT.pseudo}` | Affiche le pseudo du client. Requiert que le client soit connecté |
+| `{CLIENT.web}` | Affiche le site web du client. Requiert que le client soit connecté |
+| `{CLIENT.avatar}` | Affiche l'URL de l'avatar du client |
+| `{CLIENT.groupe_extranet}` | Affiche le groupe extranet du client |
+| `{CLIENT.groupe_extranet_id}` | Affiche l'identifiant numérique du groupe extranet du client |
+| `{CLIENT.page_extranet}` | Affiche la page du groupe extranet du client |
+
+
+#### Balises POST/GET
+
+Les balises ci-dessous sont utilisables dans tous les templates / widgets et contenu wysiwyg
+
+|Balise|Description|
+|---|---|
+| `{GET.*}` | Affiche la valeur d'un paramètre GET de la page. Exemple : `{GET.id}` affiche la valeur du paramètre GET "id". |
+| `{POST.*}` | Affiche la valeur d'un paramètre POST de la page. Exemple : `{POST.id}` affiche la valeur du paramètre POST "id". |
+| `{REQUEST.page}` | Affiche le nom de page de l'url courante |
+| `{REQUEST.repertoire}` | Affiche le chemin de l'url courante |
+| `{REQUEST.url}` | Affiche l'url courante |
+| `{REQUEST.domaine}` | Affiche le domaine courant |
+| `{REQUEST.referer}` | Affiche le referer du navigateur |
+
+
+#### API
+
+Les balises ci-dessous fournissent des informations sur l'API Front-office
+
+|Balise|Description|
+|---|---|
+| `{API.actif}` | Renvoie la chaine "true" si l'api du site est active. "false" dans le cas contraire. |
+
+
+
+
+### Filtres de balises
+
+Kiubi supporte un ensemble de filtres qui peuvent être appliqués aux balises.
+Ces filtres ont pour but de changer la valeur de la balise pour mieux répondre à
+un besoin précis.
+
+On utilise ces filtres en ajoutant une barre verticale | dans la balise. Exemple : `{balise|filtre}`.
+
+Certains filtres peuvent prendre des arguments, ils seront alors séparés par une
+autre barre. Exemple : `{balise|filtre|argument}`.
+
+|Filtre|Description|
+|---|---|
+| ucfirst | Met en majuscule la première lettre du texte |
+| strtoupper | Met en majuscule tout le texte |
+| strtolower | Met en minuscule tout le texte |
+| rawurlencode | Encode une chaîne en URL selon la [RFC 3986](http://www.ietf.org/rfc/rfc3986.txt). Supporte un argument "utf8" pour encode le résultat en UTF-8. |
+| htmlentities | Convertit tous les caractères éligibles en entités HTML. Supporte un argument "utf8" pour encode le résultat en UTF-8 |
+| left|x | Tronque le texte à gauche à strictement X caractères. |
+| stripText|x | Supprime les balises HTML puis tronque le texte à gauche sur X caractères au plus en conservant les mots entiers |
+| mot|x | Affiche le Xème mot du texte |
+| mapValue|x|y | Compare la valeur de la balise avec valeurs de références. Affiche X si la valeur est "1", "actif", "checked", "selected" ou "erreur". Affiche Y dans le cas contraire. Exemple si le contenu de la balise `{texte10}` est "actif", `{texte10|mapValue|active}` affiche "active". |
+| sanitize | Passe en minuscule,enlève tous les accents d'une chaine de caractères et convertis les espaces en tirets. Les tirets consécutifs sont fusionnés et les tirets finaux sont supprimés. Seuls les lettres, les chiffres et le tiret sont préservés. Exemple si le contenu de la balise `{titre}` est "C'est fin, c'est très fin, ça se mange sans faim !", alors `{titre|sanitize}` affichera "c-est-fin-c-est-tres-fin-ca-se-mange-sans-faim". Ce filtre fonctionne sur des chaines de texte jusqu'à 120 caractères. |
+| alternate|x | Associé par exemple à la balise `{compteur}`, affiche de façon cyclique des nombre de 1 à `x`. |
+| formatFloat|nb | Formate une valeur décimale brute à `nb` chiffres après la virgule pour la rendre plus lisible en ajoutant un séparateur de milliers et en utilisant la virgule comme séparateur décimal. Un balise qui aurait la valeur "1520.25" sera affichée "1 520,25". |
+| empty|x|y | Affiche X si la valeur est vide. Affiche Y dans le cas contraire. Exemple si le contenu de la balise `{texte10}` est vide, `{texte10|empty|vide}` affiche "vide". |
+| slice|separator|start|length | Affiche une portion d'un texte qui est segmenté par `separator` (au choix `-` ou `_`). La portion commence à la partie `{start}` du texte, pour une longueur de `{length}` parties. Exemple si le contenu de la balise `{titre}` est "a-b-c-d" : <br/><br />`{titre|slice|-|1}` affiche "b-c-d"<br /><br />`{titre|slice|-|1|2}` affiche "b-c"<br /><br />`{titre|slice|-|-2}` affiche "c-d"<br /><br />Il est également possible de séparer le texte avec des espaces en indiquant `space` comme séparateur. Par exemple : `{titre|slice|space|1|2}` |
+| escapejson | Echappe le texte qui peux être utilisé dans une chaine json. |
+| date | Extrait des informations d'un champ `date` ou `datetime`. Ce filtre prend un argument obligatoire parmis les suivants :  <br /><br />`{texte10|date|annee}` Affiche l'année courante (2022).<br /><br />`{texte10|date|num_mois}` Affiche le numéro du mois courant (01 - 12).<br /><br />`{texte10|date|num_jour}` Affiche le numéro du jour courant (01 - 31).<br /><br />`{texte10|date|mois}` Affiche le mois courant (janvier - décembre).<br /><br />`{texte10|date|mois_abrev}` Affiche le mois courant abrégé (jan - déc). Il vaut mieux utiliser nov que nov car la découpe se fait plus intelligemment pour les mois en quatre lettres.<br /><br />`{texte10|date|jour_semaine}` Affiche le jour de la semaine courant (lundi - dimanche).<br /><br />`{texte10|date|heure}` Affiche l'heure courante (00-23).<br /><br />`{texte10|date|minute}` Affiche les minutes courantes (00-59).<br /><br />`{texte10|date|seconde}` Affiche les secondes courantes (00-59).<br /><br /><br /><br />Le champ doit contenir une date valide au bon format. Dans le cas contraire le filtre retourne une chaine vide. |
+
+
+Ainsi `{intitule_pagecourante|strtoupper}` affichera le nom de la page courante en
+majuscule. Tandis que `{SOCIETE.societe_cp|left|2}` affichera le numéro de
+département extrait du code postal du contact principal du site.
+
+

package/storage/documents/generated/integration/07_balises_widget.md

@@ -0,0 +1,257 @@
+##  Balises des Widgets
+
+Un certain nombre de widgets possèdent des fonctionnalités et des balises
+communes.
+
+###  `{alterne}`
+
+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.
+
+Exemple : le widget `Blog / Liste des Billets` :
+
+	<!--BEGIN:main -->
+	<ul>
+	<!--BEGIN:billet -->
+	<li class="color_{alterne}">{alterne}, {titre}</li>
+	<!-- END:billet -->
+	</ul>
+	<!-- END:main -->
+
+Si on a 5 billets dans son blog, le résultat sera :
+
+<pre markdown="0">
+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
+</pre>
+
+Cela vous permet, par exemple, d'appeler alternativement l'un ou l'autre style
+pour changer la couleur de fond et rendre ainsi vos listings plus lisibles.
+
+Les balises `{alterne_3}`, `{alterne_4}` et `{alterne_5}` sont également disponibles
+et renvoient respectivement les valeurs :
+
+<pre markdown="0">
+1, 2, 3
+1, 2, 3, 4
+1, 2, 3, 4, 5
+</pre>
+
+###  `{compteur}`
+
+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.
+
+Exemple : le widget `Blog / Liste des Billets` :
+
+	<!-- BEGIN:main -->
+	<ul>
+	<!-- BEGIN:commentaire-->
+	  <li>{compteur}. {commentaire}</li>
+	<!-- END:commentaire-->
+	</ul>
+	<!-- END:main -->
+
+Si on a 3 commentaires pour un billet de son blog, le résultat sera :
+
+<pre class="prettyprint">
+1. Premier commentaire
+2. Deuxième commentaire
+3. Troisième commentaire
+</pre>
+
+Chaque ligne est numérotée automatiquement.
+
+###  `{intitule}`
+
+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 -->
+
+Le bloc `<!-- BEGIN:intitule -->` `<!-- END:intitule -->` ne s'affiche que si
+l'intitulé du widget est rempli. 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.
+
+###  `{ctl}`
+
+La balise `{ctl}` est présente dans certain widgets qui utilisent un formulaire. Elle
+n'a qu'une utilité technique et est présente sous la forme :
+
+	<input type="hidden" name="ctl" value="{ctl}">
+
+**Il ne faut pas la supprimer, sinon le formulaire ne fonctionnera plus !**
+
+###  La navigation
+
+La navigation est une fonctionnalité que l'on retrouve dans les widgets qui
+génèrent des listings et dont la configuration permet l'affichage. C'est un
+ensemble de blocs qui permet d'afficher des barres de navigations complètes. 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 correspondant.
+
+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 (une barre en haut et une en bas du listing, par exemple). Les
+balises et blocs ci-dessous fonctionnent dans les blocs `<!-- BEGIN: nav1 -->
+<!-- END: nav1 -->` et `<!-- BEGIN: nav2 --> <!-- END: 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 donnera cela :
+
+<pre class="prettyprint">
+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
+</pre>
+
+#### Balises disponibles
+
+#### Arborescence des blocs
+
+```
+├── nav1     // Le bloc est affiché si la navigation est active et comporte plusieurs pages.
+│   ├── pages     // Le contenu du bloc s'affiche pour chaque page.
+│   ├── premier     // Le contenu du bloc s'affiche si on n'est pas sur la première page du listing.
+│   ├── dernier     // Le contenu du bloc s'affiche si on n'est pas sur la dernière page du listing.
+│   ├── precedent     // Le contenu du bloc s'affiche si on n'est pas sur la première page du listing.
+│   └── suivant     // Le contenu du bloc s'affiche si on n'est pas sur la dernière page du listing.
+└── nav2     // Le bloc est affiché si la navigation est active et comporte plusieurs pages.
+    ├── pages     // Le contenu du bloc s'affiche pour chaque page.
+    ├── premier     // Le contenu du bloc s'affiche si on n'est pas sur la première page du listing.
+    ├── dernier     // Le contenu du bloc s'affiche si on n'est pas sur la dernière page du listing.
+    ├── precedent     // Le contenu du bloc s'affiche si on n'est pas sur la première page du listing.
+    └── suivant     // Le contenu du bloc s'affiche si on n'est pas sur la dernière page du listing.
+```
+#### Balises 
+
+Bloc|Balise|Description
+---|---|---
+| nav1 | lien_premier | URL vers la première page. |
+| nav1 | lien_dernier | URL vers la dernière page. |
+| nav1 | nb_pages | Nombre de page du listing. |
+| nav1 | nb_resultats | Nombre d'élément dans le listing. |
+| nav1 | num_page | Numéro de la page courante. |
+| nav2 | lien_premier | URL vers la première page. |
+| nav2 | lien_dernier | URL vers la dernière page. |
+| nav2 | nb_pages | Nombre de page du listing. |
+| nav2 | nb_resultats | Nombre d'élément dans le listing. |
+| nav2 | num_page | Numéro de la page courante. |
+| pages | lien_page | URL vers la page |
+| pages | page | Numéro de la page. |
+| pages | selected | Affiche "selected" si la page est la page courante. Sinon n'affiche rien. |
+| pages | lien_page | URL vers la page |
+| pages | page | Numéro de la page. |
+| pages | selected | Affiche "selected" si la page est la page courante. Sinon n'affiche rien. |
+| precedent | lien_precedent | URL vers la page précédente. |
+| precedent | lien_precedent | URL vers la page précédente. |
+| suivant | lien_suivant | URL vers la page suivante. |
+| suivant | lien_suivant | URL vers la page suivante. |
+
+
+
+

package/storage/documents/generated/integration/08_types_billets.md

@@ -0,0 +1,154 @@
+##  Types de billets
+
+Un billet permet d'ajouter du contenu à une page libre du Site web. Chaque
+billet peut être considéré comme un paragraphe, un bloc de contenu, pouvant
+contenir du texte, des images, des liens, des vidéos, du code HTML, etc. Lors de
+l'ouverture d'un site, Kiubi propose plusieurs types de billets différents en exemple.
+
+Chaque type de billet peut être structuré de manière différente et permet
+d'intégrer et de présenter du contenu suivant ses besoins.
+
+**Si vous utilisez un thème graphique personnalisé, vous pouvez modifier les types de billets par défaut et créer autant 
+de types de billet que souhaité.**
+
+### Principe de fonctionnement
+
+Le principe de fonctionnement d'un type billet du Site web est très simple. Tous
+les types de billets de votre site sont regroupés dans le répertoire `theme/fr/billets/`
+ de votre espace FTP. Chaque sous-répertoire correspond à
+un type de billet.
+
+Un billet est composé, en plus d'une structure HTML de votre choix, d'un maximum
+de 17 champs d'information :
+
+ - `titre`
+ - `sstitre`
+ - `texte1` à `texte15`
+
+Chaque champ peut contenir n'importe quel type de donnée. Par convention (mais
+ce n'est pas obligatoire), les champs `texte10` à `texte15` sont utilisés pour
+stocker des éléments de la médiathèque (image, fichier, etc.), plus précisément
+l'identifiant faisant référence à l'élément de la médiathèque.
+
+Ces champs sont à définir dans le fichier `config.xml` de chaque type de
+billet, ce qui permet de générer automatiquement le formulaire de saisie utilisé
+dans la console d'administration. **Ce fichier est obligatoire.**
+
+Chaque champ pourrait être par la suite affiché dans le fichier `index.html`
+de chaque type de billet ou dans chaque widget affichant des billets, en
+fonction de ses besoins. **Ce fichier est obligatoire.**
+
+**Comme tous les éléments de Kiubi, un billet (ou plutôt une liste de billet) 
+est affiché grâce à un widget. C'est principalement les widgets "Contenu de la 
+page libre" et "Bloc d'extrait" qui sont utilisés pour afficher les billets dans votre site internet.**
+
+### Le fichier `config.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.
+
+#### Exemple de code source
+
+	<?xml version="1.0" encoding="iso-8859-1"?>
+	<type tri="2">
+		<desc>Titres, texte et image (à gauche)</desc>
+		<listechamps>
+			<champ champ="titre" type="text" 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>
+
+#### Description
+
+Ce fichier contient une seule balise principale `<type>` qui possède un seul
+attribut :
+
+- `tri` : nombre qui sert à définir l'ordre dans le quel vont apparaître les
+types de billet dans les listes déroulantes de la console d'administration.
+
+A l'intérieur, 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 : `titre`,
+`sstitre`, `texte1` à `texte15`.
+- `type` : le type du champ indique quelle sorte d'information est stockée dans
+le champ.
+- `intitule` : intitulé du champ qui va être repris dans la console
+d'administration dans le formulaire de saisie d'un billet.
+
+Il existe dix types de champ :
+
+ - `text` : champ de saisie simple
+ - `textarea` : champ de saisie multiligne
+ - `wysiwyg` : éditeur de texte visuel
+ - `image` : fichier image de la médiathèque
+ - `fichier` : fichier quelconque de la médiathèque
+ - `select` : champ de liste déroulante
+ - `color` : couleur hexadécimale
+ - `date` : date au format `dd/mm/YYYY`
+ - `datetime` : date au format `dd/mm/YYYY hh:mm:ss`
+ - `checkbox` : champ de type case à cocher
+
+Les champs de type `select` ou `checkbox` comportent une liste de valeurs qui est construite
+de la manière suivante :
+
+	<champ champ="texte2" type="select" intitule="Liste">
+	   <option value="Valeur1">Label1</option>
+	   <option value="Valeur2">Label2</option>
+	   <option value="Valeur3">Label3</option>
+	</champ>
+
+Dans cet exemple, le contenu de l'attribut `value` est stocké dans le champ `texte2`.
+L'attribut `value` doit **obligatoirement avoir une valeur** (un simple espace `value=" "` est possible). Pour
+les champs de type `checkbox`, la valeur affichée dans le site est la concanénation de toutes les `value` sélectionnées, 
+séparées par le caractère `|` (par exemple `Valeur1|Valeur3`).
+
+Le label n'est affiché que dans le détail du billet dans la console d'administration.
+
+Afin de faciliter l'utilisation des champs de type `date` et `datetime`, il est prévu d'utiliser le filtre `date` suivi
+de l'information à extraire, comme par exemple :
+
+    Le {texte5|date|jour_semaine} {texte5|date|num_jour} {texte5|date|mois} à {texte5|date|heure}h{texte5|date|minute}
+
+Si `texte5` contient la valeur `06/12/2022 15:12:35`, le site affichera :
+
+    Le dimanche 06 novembre 2022 à 15h12
+
+Si la date est invalide ou que le valeur du champ est vide, ce filtre affiche toujours une chaine vide.
+
+
+### Template d'un type de billet
+
+Le fonctionnement détaillé du template d'un type de billet ainsi que la liste 
+exhaustives de ses balises sont accessibles dans la [documentation des balises du 
+service CMS](/design-site-web.html#type-de-billet).
+
+### Ajouter un nouveau type de billet
+
+Pour ajouter un type de billet, il suffit de créer un nouveau sous-répertoire au
+répertoire `theme/fr/billets/` et d'y copier les fichiers `config.xml` et `index.html` 
+correspondant à votre nouveau type de billet. Le nouveau type de
+billet sera alors automatiquement proposé dans le service Site web de la console
+d'administration.
+
+### Types de billets du Blog
+
+Les types de billet du blog fonctionnent selon le même principe que les billets du Site web mais **uniquement pour ajouter des informations complémentaires aux billets du Blog**.
+
+Contrairement aux types de billets du Site web, les types de billets du blog ne déterminent pas le template du billet, mais seulement si des champs `texte1` et `texte15` sont ajoutés au billet.
+
+Le principe de configuration des types de billets du Blog est le même que pour les billets du Site web, mais avec les différences suivantes :
+
+- les types de billets du blog sont regroupés dans le répertoire `theme/fr/billets_blog/`
+- il n'y a pas de champs `titre` et `sstitre`, seuls les champs `texte1` et `texte15` sont disponibles
+- seul le fichier `config.xml` est disponible, les templates sont dans le répertoire `theme/fr/widgets/blog/`, en fonction des widgets utilisés
+
+