<tpl:Widget>

Permet l'affichage d'un widget en dehors des bandeaux paramétrables dans l'interface d'administration.

Le marqueur <tpl:Widget> ne possède qu'un attribut id et un contenu ne contenant qu'un ou plusieurs marqueurs setting ayant un attribut obligatoire name et un contenu.

Pour ajouter un widget dans votre template, vous devez écrire un code comme ceci :

<tpl:Widget id="Identifiant du widget">
  <setting name="Nom du paramètre">Valeur du paramètre</setting>
  ...
</tpl:Widget>

La liste des paramètres possibles pour ce marqueur est disponible dans l'aide en ligne de la page d'administration des widgets de présentation et dépend des plugins que vous avez installés.

Note :

Le widget est automatiquement placé dans un bloc <div>. Dans la majorité des cas, un attribut class correspondant à l'id dudit widget est ajouté à ce bloc. Il peut arriver que cet attribut class ne corresponde pas (un widget remplaçant un widget de base par exemple). Une vérification du rendu HTML est donc nécessaire pour contrôler la valeur de l'attribut.

Exemples

Billets sélectionnés

<!-- # Billets sélectionnés -->
<tpl:Widget id="bestof">
	<setting name="title">À retenir</setting> <!-- # Titre : (texte) -->
	<setting name="orderby">asc</setting> <!-- # Ordre : (liste), valeurs autorisées : (asc|desc) -->
	<setting name="homeonly">0</setting> <!-- # Page d'accueil uniquement (booléen), valeurs autorisées : (0|1) -->
</tpl:Widget>

Derniers billets

<!-- # Derniers billets -->
<tpl:Widget id="lastposts">
	<setting name="title">Derniers billets</setting> <!-- # Titre : (texte) -->
	<setting name="category"></setting> <!-- # Catégorie : (liste), valeurs autorisées : (|null) -->
	<setting name="limit">10</setting> <!-- # Nombre de billets maximum : (texte) -->
	<setting name="homeonly">0</setting> <!-- # Page d'accueil uniquement (booléen), valeurs autorisées : (0|1) -->
</tpl:Widget>

Derniers commentaires

<!-- # Derniers commentaires -->
<tpl:Widget id="lastcomments">
	<setting name="title">Derniers commentaires</setting> <!-- # Titre : (texte) -->
	<setting name="limit">10</setting> <!-- # Nombre de commentaires maximum : (texte) -->
	<setting name="homeonly">0</setting> <!-- # Page d'accueil uniquement (booléen), valeurs autorisées : (0|1) -->
</tpl:Widget>

Langues du blog

<!-- # Langues du blog -->
<tpl:Widget id="langs">
	<setting name="title">Langues</setting> <!-- # Titre : (texte) -->
	<setting name="homeonly">0</setting> <!-- # Page d'accueil uniquement (booléen), valeurs autorisées : (0|1) -->
</tpl:Widget>

Lecteur de fils de nouvelles

<!-- # Lecteur de fils de nouvelles -->
<tpl:Widget id="feed">
	<setting name="title">Ailleurs</setting> <!-- # Titre : (texte) -->
	<setting name="url">http://fr.dotclear.org/blog/feed/atom</setting> <!-- # URL du fil (texte) -->
	<setting name="limit">10</setting> <!-- # Nombre de billets maximum : (texte) -->
	<setting name="homeonly">0</setting> <!-- # Page d'accueil uniquement (booléen), valeurs autorisées : (0|1) -->
</tpl:Widget>

Liens

<!-- # Liens -->
<tpl:Widget id="links">
	<setting name="title">Liens</setting> <!-- # Titre : (texte) -->
	<setting name="category"></setting> <!-- # Catégorie (liste), valeurs autorisées : () -->
	<setting name="homeonly">0</setting> <!-- # Page d'accueil uniquement (booléen), valeurs autorisées : (0|1) -->
</tpl:Widget>

Liens d'abonnement

<!-- # Liens d'abonnement -->
<tpl:Widget id="subscribe">
	<setting name="title">S'abonner</setting> <!-- # Titre : (texte) -->
	<setting name="type">atom</setting> <!-- # Types de fil : (liste), valeurs autorisées : (atom|rss2) -->
	<setting name="homeonly">0</setting> <!-- # Page d'accueil uniquement (booléen), valeurs autorisées : (0|1) -->
</tpl:Widget>

<!-- # Liens de navigation -->
<tpl:Widget id="navigation">
	<setting name="title">Navigation</setting> <!-- # Titre : (texte) -->
</tpl:Widget>

Liste des catégories

<!-- # Liste des catégories -->
<tpl:Widget id="categories">
	<setting name="title">Catégories</setting> <!-- # Titre : (texte) -->
	<setting name="postcount">0</setting> <!-- # Afficher le nombre de billets (booléen), valeurs autorisées : (0|1) -->
</tpl:Widget>

Moteur de recherche

<!-- # Moteur de recherche -->
<tpl:Widget id="search">
	<setting name="title">Rechercher</setting> <!-- # Titre : (texte) -->
</tpl:Widget>

Pages

<!-- # Pages -->
<tpl:Widget id="pages">
	<setting name="title">Pages</setting> <!-- # Titre : (texte) -->
	<setting name="homeonly">0</setting> <!-- # Page d'accueil uniquement (booléen), valeurs autorisées : (0|1) -->
	<setting name="sortby">post_dt</setting> <!-- # Trier par : (liste), valeurs autorisées : (post_title|post_position|post_dt) -->
	<setting name="orderby">asc</setting> <!-- # Ordre : (liste), valeurs autorisées : (asc|desc) -->
</tpl:Widget>

Texte

<!-- # Texte -->
<tpl:Widget id="text">
	<setting name="title">Titre</setting> <!-- # Titre : (texte) -->
	<setting name="text">Texte</setting> <!-- # Texte : (texte) -->
	<setting name="homeonly">0</setting> <!-- # Page d'accueil uniquement (booléen), valeurs autorisées : (0|1) -->
</tpl:Widget>