À koi k'ça sert ?

Ce greffon offre quelques fonctionnalités permettant de transformer un blog en un photoblog (en permettant principalement une navigation par vignettes des photos).

Ébauche de documentation

Cette nouvelle version n'est toujours pas fournie avec un thème adapté... ce sera à vous de le créer. Voici les fonctions mises à disposition par le greffon pour les templates :

  • PhotoblogNav : bloc englobant permettant d'afficher les vignettes de navigation. Accepte trois paramètres (tous optionnels) :
    • dir : indique si l'on doit récupérer les billets précédents (valeur : -1) ou suivants (valeur : 1). La valeur par défaut est 0, qui indique que l'on souhaite afficher la vignette du billet affiché.
    • nbEntries : nombre de billets à récupérer pour afficher la navigation. La valeur par défaut est 1.
    • reverse : inverse l'ordre « normal » de parcours des billets (utile par exemple avec une navigation présentée verticalement). La valeur par défaut est 0 (faux).
    • category : filtre par catégorie. Se comporte à l'identique de l'attribut category sur la méthode de template tpl:Entries.
    • no_category : filtre sur les billets n'ayant pas de catégorie. Se comporte à l'identique de l'attribut no_category sur la méthode de template tpl:Entries.
  • PhotoblogThumbURL : retourne la vignette du billet courant.[1] Accepte deux paramètre (optionnels) :
    • archive : 1 si on veut retourner les vignettes pour les archives, 0 (valeur par défaut) pour retourner les vignettes pour la navigation.[2]
    • type : type de la vignette, bw pour la vignette en noir / blanc, color pour la vignette en couleurs. La valeur par défaut est bw.
  • PhotoblogThumbSize : permet de trouver la taille des vignettes. Accepte deux paramètres (optionnels) :
    • archive : 1 si on veut la taille des vignettes utilisées pour les archives, 0 (valeur par défaut) pour la taille des vignettes utilisées pour la navigation.
    • dimension : height (valeur par défaut) pour obtenir la hauteur, width pour obtenir la largeur.
  • PhotoblogEntryExcerpt : retourne l'extrait du billet courant. Accepte les même paramètres que la fonction de Dotclear EntryExcerpt, avec un paramètre supplémentaire :
    • full_size : 1 si on veut laisser les images telles quelles dans l'extrait du billet, laisser vide si on veut remplacer les images par leur vignette.
  • PhotoblogEntryContent : retourne le contenu du billet courant. Accepte les même paramètres que la fonction de Dotclear EntryContent, avec un paramètre supplémentaire :
    • full_size : 1 si on veut laisser les images telles quelles dans le contenu du billet, laisser vide si on veut remplacer les images par leur vignette.

Information supplémentaire concernant les vignettes : les vignettes noir/blanc ont une hauteur double de ce qui est spécifié dans l'administration du greffon. Cela permet l'effet « d'activation » au survol que l'on voit sur mon photoblog.

Pour ce qui est du reste des fonctionnalités, elles n'ont que très peu évolué par rapport à la version du greffon pour DotClear 1.2. La seule vraie nouveauté est la possibilité de supprimer les vignettes utilisées par le greffon (qu'il s'agisse du greffon pour DotClear 1 ou DotClear 2).

Téléchargement

Hop, jetez un œil dans les annexes à ce billet...

Remarques, commentaires, rapports de bogues, ...

... sont toujours les bienvenus dans les commentaires de ce billet.

Si jamais vous réalisez un joli thème pour ce greffon, n'hésitez pas à me le proposer comme éventuel thème par défaut.

Notes

[1] « Courant » d'après le bloc PhotoblogNav qui parcourt les billets bien entendu.

[2] ... car je vous rappelle que l'on peut générer des vignettes différentes selon qu'elles jouent un rôle pour la navigation ou pour les archives.