Fonctions de template

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 : permet de filtrer les billets par catégorie. Vous pouvez indiquer plusieurs catégories (séparées par des virgules) et en exclure en utilisant '?not'. L'identifiant de la catégorie est son URL simple.
  • no_category : permet d'obtenir les billets n'ayant aucune catégorie. La valeur par défaut est 0 (faux).
• PhotoblogThumbURL : retourne la vignette du billet courant. (« Courant » d'après le bloc PhotoblogNav qui parcourt les billets bien entendu.) 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.

Divers

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.

Changelog

Version 0.1pre-alpha7

Released on 2010-11-26

• Added support for category filtering in templating function PhotoblogNav.
• Help is now compliant with Dotclear2 standards.

Version 0.1pre-alpha6

Released on 2010-07-03

• Compatibility update for Dotclear 2.2.

Version 0.1pre-alpha5.1

Released on 2010-01-04

• Corrected a bug of incorrectly read settings when using the same thumbnails for navigation and archives.

Version 0.1pre-alpha5

Released on 2007-09-17

• Renamed template function PhotoblogGetThumb to PhotoblogUrl to better suits Dotclear standards. (Thanks to (pyeb) for suggesting it.)
• Added a configuration option to activate the plugin.
• Added two template functions (PhotoblogEntryExcerpt and PhotoblogEntryContent) to display a post with the image replaced by a thumbnail.

Version 0.1pre-alpha4

Released on 2007-08-04

• Added a new attribute to the template function PhotoblogNav, which allows to reverse the ordrer of the posts. (Thanks to (pyeb) for suggesting it.)
• Reengineered most of the templating functions. (Warning: this means there's been some API changes.)

Version 0.1pre-alpha3

Released on 2007-08-01

• Corrected a bug when removing thumbnails and the plugin couldn't find any files. (Thanks to (pyeb) for reporting it.)
• Added two template functions returning the size of thumbnails. (Thanks to (pyeb) for suggesting it.)

Version 0.1pre-alpha2

Released on 2007-07-13

• Modified for compatibility with Dotclear2 beta 7.

Version 0.1pre-alpha

Released on 2007-06-25

• First public release compatible with DotClear2.

Version 0.1

Released on 2007-01-03

• First release compatible with DotClear2.
• Internal release only.
• Due to the nature of DotClear2's templating system, simplification of the admin interface.
• Added removal of the old thumbnails (both the photoblog's thumbnails and DotClear 1.2's own).

Copyright information

The icon used for this plugin is © 2004 by Miloszwl. All the code is © 2005-2010 by julien mudry and distributed under the terms of the GPL license.

The default photo theme was made by Kozlika and julien mudry, based on previous work by Samuel Latchman and Olivier Meunier.