Plugin breadcrumb 0.6.1 pour Dotclear

Une nouvelle et dernière version autonome de ce plugin qui sera intégré dans la future version 2.8 de Dotclear. Il permet maintenant d’activer l’affichage du fil d’Ariane par blog et d’inclure ou pas une balise d’encadrement du type <p id="breacrumb">…</p>.

N’oubliez pas d’activer le plugin pour chacun des blogs où vous l’utilisez si vous faites une mise à jour.

Présentation

Ce plugin indique en permanence la position de la page affichée par rapport à la page d’accueil du blog, communément appelé un fil d’Ariane.

Exemple lorsqu’on consulte ce billet qui appartient à la sous-catégorie Plugins de la catégorie Dotclear :

Accueil › Dotclear › Plugins › Plugin Breadcrumb 0.6 pour Dotclear

Installation et utilisation

Le plugin s’installe comme tout plugin de Dotclear, rien de nouveau ici. Par contre il faudra modifier le fichier template correspondant à l’endroit où vous souhaitez afficher le Breadcrumb. En général, le fichier _top.html est un bon choix car il permet d’obtenir l’affichage quelque soit le contexte courant.

La balise à ajouter est la suivante : {{tpl:Breadcrumb}}

Un paramètre optionnel, nommé separator, permet de spécifier si nécessaire la chaîne de caractère qui sépare les éléments du Breadcrumb. Par défaut c’est la chaîne (le est l’équivalent de l’entité HTML &rsaquo;).

Exemple :

{{tpl:Breadcrumb separator=" :: "}}

Le premier élément est doté d’un id afin que vous puissiez le styler, soit si je reprends l’exemple cité au début de ce billet :

<p id="breadcrumb">
<a id="bc-home" href="/">Accueil</a> &rsaquo; Dotclear &rsaquo; Plugins &rsaquo; Plugin Breadcrumb 0.6 pour Dotclear
</p>

Tous les éléments, hormis le dernier, sont bien évidemment dotés du lien idoine (page d’accueil, catégorie Dotclear, catégorie Plugins). De plus, l’ensemble des éléments est encadré par une balise <p id="breadcrumb"></p>, comportement que vous pouvez désactiver si nécessaire.

Une fois le plugin installé et la balise en place (si nécessaire), il faut activer l’affichage du fil d’Ariane pour le blog ; voir Paramètres du blog, section Fil d’Ariane pour l’activation et les options.

Extension

Le plugin prend nativement en charge les contextes suivants :

  • default et default-page : Page d’accueil (première page et pages suivantes)
  • category : Billets d’une catégorie
  • post : Billet seul
  • lang : Billets d’une langue sélectionnée
  • archive : Archives du blog
  • pages : Page seule
  • tags : Tous les mots-clés
  • tag : Billets comportant un mot-clé sélectionné
  • search : Billets résultant d’une recherche
  • 404 : Page d’erreur

Les autres plugins peuvent s’inviter dans la danse en gérant un behaviour publicBreadcrumb qui fournit en paramètre le type d’URL correspondant au contexte (voir la liste ci-dessus pour les contextes natifs) et le séparateur à utiliser si nécessaire pour séparer les différents éléments.

La valeur de retour de ce behaviour sera, si elle est non vide, ajoutée après le lien vers la page d’accueil et précédée comme il se doit par le séparateur.

Exemple pour un plugin de formulaire de contact :

$core->addBehavior('publicBreadcrumb',array('extContactMe','publicBreadcrumb'));

class extContactMe
{
	public static function publicBreadcrumb($context,$separator)
	{
		if ($context == 'contactme') {
			return __('Contact me');
		}
	}
}

L’affichage produit pour le Breadcrumb sera alors :

<p id="breadcrumb">
<a id="bc-home" href="http://www.example.com/">Accueil</a> &rsaquo; Formulaire de contact
</p>

À défaut de retour sur ce behaviour — ce qui peut indiquer que le contexte est inconnu — seul un lien vers la page d’accueil du blog sera affiché.

Conclusion

N’hésitez pas à me faire toutes les remarques que vous auriez au sujet de ce petit plugin, ce billet servira de support pour cette version du plugin.

Ajouter un commentaire

Les commentaires peuvent être formatés en utilisant une syntaxe wiki simplifiée.

Ajouter un rétrolien

URL de rétrolien : https://open-time.net/trackback/12348

Haut de page