Mise à jour du 11 avril 2008 : mise à jour pour le passage en version 1.2
(entre autres, ajout du support de l'affichage d'un groupe)

Le code de ce plugin est sommaire, intensivement basé sur l'exemple du tutorial de DC2. Ce widget s'appuie sur phpFlickr 2.1.0, une fort sympathique librairie d'interface en PHP pour l'API Flickr.


Clé API Flickr
Avant toute chose, il vous faut une clé API Flickr. Ce qui implique également qu'il faut d'abord créer un compte Flickr (ou Yahoo, c'est pareil). J'imagine que si vous voulez afficher des images Flickr, c'est qu'a priori, vous avez déjà un compte. La demande de clé API Flickr se fait par ici.


Installation de wFlickr
L'installation de ce widget se fait normalement. Par exemple, connectez-vous en tant qu'administrateur de votre blog sous Dotclear 2, allez dans "Système/Extensions" puis l'onglet "Ajouter une nouvelle extension". Choisissez alors, soit le paquet en tar.gz que vous aurez préalablement copié sur votre machine, soit le lien vers le paquet zip ou pkg selon votre version de Dotclear (cf. en fin de billet).


Configuration de wFlickr
Sous Dotclear 2, allez dans la partie "Blog/Widgets de présentation". Choisissez "wFlickr" dans la colonne "Widgets disponibles" et glissez le dans bandeau de votre choix. Cliquez ensuite sur le "+" pour afficher les options :
Configuration de wFlickr
Je pense que les options parlent d'elles-même. J'ai déjà évoqué le problème de la clé API Flickr. Pour les autres options :

  • Vous pouvez choisir d'afficher
    • toutes les photos d'un utilisateur quelconque
    • seulement les photos d'un album
    • seulement les photos d'un groupe
    • rien

      Configuration de wFlickr

  • En fonction de votre choix d'affichage :
    • Pour trouver le "User ID" Flickr, regardez l'URL d'une photo : "http://www.flickr.com/photos/21108291@N06/2050445357/". Il faut prendre la chaîne de caractères entre les "/" après "photos". Ici "21108291@N06" (c'est moi), mais cela peut aussi être un pseudo de personnes. Il faut impérativement utiliser l'identifiant de la personne sous la forme chiffrée. Si vous avez uniquement le pseudo dans l'url, utiliser alors idgettr (merci à Digenvez pour cette astuce).

    • Dans le cas d'un album, seuls des albums appartenant à l'utilisateur qui a permis de générer la clé API peuvent être visualisés. Il n'est pas possible de filtrer sur les albums d'un utilisateur quelconque. Le nom à utiliser est dans l'URL de l'album après "sets" : "http://www.flickr.com/photos/suricat/sets/72157603248521610/". Ici "72157603248521610".

    • Pour trouver l'id d'un groupe, même principe que l'id d'un utilisateur. Repérez l'URL d'un groupe et utilisez idgettr Par exemple, "http://www.flickr.com/groups/meerkats/" devient "19621373@N00".
  • L'affichage de "rien" permet comme son nom l'indique de ne rien afficher tout en n'ayant pas à supprimer le widget de la liste des widgets actifs, donc en gardant en mémoire sa configuration.
  • Les champs "Style" sont facultatifs, aussi bien pour le bloc que pour les images. Ils vous permettent d'ajouter une chaîne de caractères de votre choix dans le tag <div> encadrant tout le bloc, ou dans le tag <img> de chaque miniature. Cela peut tout aussi bien être une définition de classe, comme dans l'exemple, que vous surchargez ensuite dans votre fichier css, ou directement un style inline, ou rien du tout.
    Vous n'avez rien compris à cette phrase ? Ne touchez pas :-)
  • Nombre de photos et nombre de colonnes doivent être des entiers.
  • Essayez les deux tailles d'images et choisissez.
  • Le champs "Texte sous les photos" peut rester vide et peut contenir des tags HTML (qui eux-mêmes peuvent casser la mise en page de votre page...) Dans le doute, ne rien mettre.
  • La dernière case à cocher ne sert à rien, mais je n'ai pas trouvé comment mettre un lien vers cette documentation autrement...

N'oubliez pas de cliquer sur "Mettre à jour les bandeaux" et allez voir le résultat.

Vous pouvez avoir une idée du rendu sur le blog de Nathalie et et Olivier, Voyage de l'autre côté de l'océan.

Vous pouvez également mettre plusieurs widgets wFlickr pour afficher les photos de plusieurs utilisateurs, toutes les photos de l'un de vos albums, sur plusieurs colonnes, etc.

La modification de l'ordre d'affichage des photos se fait directement sous Flickr, dans les caractéristiques d'un album, onglet "organiser" (astuce par Titi)


Cela ne fonctionne pas

  • Si cela affiche "Oups" :
    • vérifiez votre clé API Flickr
    • vérifiez l'ID de l'utilisateur Flickr
    • vérifier l'ID du groupe
    • N'oubliez pas, idgettr est votre ami
  • Si il n'y a aucune photo, et par exemple seulement le titre, vérifiez les paramètres "Nombre de photos" ou "Nombre de colonnes". Il faut saisir des entiers à cet endroit.
  • Si il n'y a rien, vérifiez que vous n'avez pas demandé l'affichage de "rien". Chercher "wflickr" dans le code source de la page web vous amènera à la bonne section avec dans ce cas "affichage de rien volontaire !"
  • phpflickr utilise des modules de la librairie PEAR qui ne sont pas distribués avec wflickr car ils sont en général disponibles chez les hébergeurs. Si toutefois ce n'était pas le cas, voir ce commentaire (merci à Rodolphe d'avoir essuyé les plâtres)
  • Lisez les commentaires du billet !

Sinon, laissez un commentaire sous ce billet. N'oubliez pas votre email et votre site web si vous voulez que je puisse jeter un oeil !


Téléchargement

Version 1.2 20080411
Testé avec Dotclear 2 béta 7
Distribué sous licence CC-BY-SA

Ce widget est également disponible à partir de Dotaddict


TODO

  • améliorer les contrôles (notamment le nombre de photos ou de colonnes)
  • permettre de n'afficher qu'un album d'un utilisateur
  • support de plusieurs langues dans l'interface d'administration
  • des idées ?


Historique

  • Version 1.2 (11/04/2008)
    • Correction
    • Ajout
      • encadrement du bloc d'images par un div au style personnalisable
      • afficher seulement les photos d'un groupe
      • possibilité de suspendre l'affichage du widget sans en perdre la configuration (option "afficher rien")

  • Version 1.1 (04/03/2008)
    • Ajout
      • afficher seulement les photos d'un album
  • Version 1.0 (24/01/2008)
    • Livraison initiale, affichage des photos d'un utilisateur quelconque


Ils utilisent ou ont utilisé wFlickr

Par ordre d'apparition :

Si vous utilisez ce widget, merci de laisser un commentaire ici indiquant l'adresse de votre blog que je vous ajoute à la liste :-)