Logo classes.scriptsphp.org PHP

go to nav bar

flickr

API Flickr, une autre façon de gerer ses photos.

Flickr qu'est-ce ?

Flickr est un site communautaire de photographies récemment racheté par Yahoo. Il permet de stocker et présenter ses photos sans trop de souci.
De nombreux outils permettent d'uploader ses photos rapidement et facilement (par ici).
Flickr met à disposition une API permettant d'utiliser flickr depuis son site web. La documentation de cette API se trouve ici.

Pré requis :

Pour stocker ses photos sur Flickr, un compte Flickr ou Yahoo est indispensable (un compte Yahoo.fr faisant aussi l'affaire). Pour utiliser l'API, il est nécessaire de récupérer une clef d'API en allant sur http://flickr.com/services/api/key.gne. Une fois cette clef obtenue, il suffit d'aller sur http://www.flickr.com/services/api/registered_keys.gne et d'obtenir l'API_secret en cliquant sur "Edit configuration". C'est sur ce même panneau qu'il faut déclarer l'URL de call-back nécessaire à toute authentification.

La classe Flickr :

Flickr propose plus de 70 méthodes, la classe Flickr en implémente quelques-unes. Chaque méthode de cette classe retourne une chaîne XML.

Les classes User, Album et Photo :

Celles-ci stockent les propriétés respectives des users, albums et photos. Avec de nombreuses méthodes ces classes procurent une bonne base d'outils pour la création d'un album photo.

Ces classes fonctionnent indifféremment en PHP4 et PHP5.

Exemple d'utilisation minimale

Les Méthodes

Exemples

  1. Exemple : Informations sur un user.
  2. Exemple : Afficher les photos d'un album.
  3. Exemple : Afficher une photo.

Description des Méthodes

User - Nouvelle instance.

User:: User( Flickr Flickr , string userId )

Nouvelle Instance de la classe User.

  • flickr : Instance de Flickr.
  • userId : Id de l'utilisateur.
  • $user = new User( $flickr , '19336866@N00' )
go to the top
User - Récupérer l'Id de l'utilisateur.

User::getId()

Retourne l'Id de l'utilisateur.

  • $user -> getId()
go to the top
User - Récupérer le pseudo de l'utilisateur.

User::getName()

Retourne le pseudo de l'utilisateur.

  • $user -> getName()
go to the top
User - Récupérer le nom réel de l'utilisateur.

User::getRealName()

Retourne le nom réel de l'utilisateur.

  • $user -> getRealName()
go to the top
User - Récupérer la localisation de l'utilisateur.

User::getLocation()

Retourne la localisation de l'utilisateur.

  • $user -> getLocation()
go to the top
User - Récupérer l'avatar de l'utilisateur.

User::getImgBuddyIcon()

Retourne l'image de l'avatar de l'utilisateur (sous forme <img src= ... />).

  • $user -> getImgBuddyIcon()
go to the top
User - Récupérer l'url Flickr du profil de l'utilisateur.

User::getProfilUrl()

Retourne l'url.

  • $user -> getProfilUrl()
go to the top
User - Récupérer l'url Flickr des photos de l'utilisateur.

User::getPhotosUrl()

Retourne l'url.

  • $user -> getPhotosUrl()
go to the top
User - Récupérer le nombre de photos de l'utilisateur.

User::getPhotosCount()

Retourne le nombre de photos.

  • $user -> getPhotosCount()
go to the top
User - Récupérer le nombre d'albums de l'utilisateur.

User::getAlbumsCount()

Retourne le nombre d'albums.

  • $user -> getAlbumsCount()
go to the top
User - Récupérer la liste des albums de l'utilisateur.

User::getAlbumsList()

Retourne un tableau contenant les différents albums.

  • $user -> getAlbumsList()
go to the top
Album - Nouvelle instance.

Album:: Album( Flickr Flickr, string setId , string userId )

Nouvelle Instance de la classe Album.

  • flickr : Instance de Flickr.
  • albumId : Id de l'album ou ALL pour toutes les photos de l'utilisateur ou RECENT pour les photos récemment uploadées (tout utilisateur confondu).
  • userId : Id du utilisateur.
  • $album = new Album( $flickr , '1183438' , '19336866@N00' )
  • $album = new Album( $flickr , 'ALL' , '19336866@N00' )
  • $album = new Album( $flickr , 'RECENT' , '19336866@N00' )
go to the top
Album - Récupérer l'Id d'un album.

Album::getId()

Retourne l'Id de l'album.

  • $album -> getId()
go to the top
Album - Récupérer le titre d'un album.

Album::getTitle()

Retourne le titre de l'album.

  • $album -> getTitle()
go to the top
Album - Récupérer la description d'un album.

Album::getDescription()

Retourne la description de l'albumr.

  • $album -> getDescription()
go to the top
Album - Récupérer le nombre de photos dans un album.

Album::getPhotosCount()

Retourne le nombre de photos dans l'album.

  • $album -> getPhotosCount()
go to the top
Album - Récupérer le pseudo du propriétaire d'un album.

Album::getOwnerName()

Retourne le pseudo du propriétaire de l'album.

  • $album -> getOwnerName()
go to the top
Album - Récupérer le nom réel du propriétaire d'un album.

Album::getOwnerRealName()

Retourne le nom réel du propriétaire de l'album.

  • $album -> getOwnerRealName()
go to the top
Album - Récupérer la localisation du propriétaire d'un album.

Album::getOwnerLocation()

Retourne la localisation du propriétaire de l'album.

  • $album -> getOwnerLocation()
go to the top
Album - Récupérer l'avatar du propriétaire d'un album.

Album::getOwnerBuddyIcon()

Retourne l'image de l'avatar du propriétaire de l'album (sous forme <img src= ... />).

  • $album -> getOwnerBuddyIcon()
go to the top
Album - Récupérer la liste des autres albums du propriétaire d'un album.

Album::getOwnerOtherAlbums()

Retourne un tableau contenant la liste des autres albums du propriétaire de l'album.

  • $album -> getOwnerOtherAlbums()
go to the top
Album - Récupérer la liste des photos d'un album.

Album::getPhotos()

Retourne un tableau contenant la liste des photos de l'album.

  • $album -> getPhotos()
go to the top
Photo - Nouvelle instance.

Photo:: Photo( Flickr Flickr, string photoId [, string setId] )

Nouvelle Instance de la classe Photo.

  • flickr : Instance de Flickr.
  • photId : Id de la photo.
  • albumId : Id de l'album.
  • Photo = new Photo( $flickr , '52662603' )
  • Photo = new Photo( $flickr , '52662603' , '1183438' )
go to the top
Photo - Récupérer l'Id d'une photo.

Photo::getId()

Retourne l'Id de la photo.

  • $photo -> getId()
go to the top
Photo - Récupérer le code d'une photo.

Photo::getSecret()

Retourne le "secret" de la photo.

  • $photo -> getSecret()
go to the top
Photo - Récupérer le titre d'une photo.

Photo::getTitle()

Retourne le titre de la photo.

  • $photo -> getTitle()
go to the top
Photo - Récupérer la description d'une photo.

Photo::getDescription()

Retourne la description de la photo.

  • $photo -> getDescription()
go to the top
Photo - Récupérer le pseudo du propriétaire d'une photo.

Photo::getOwnerName()

Retourne le pseudo du propriétaire de la photo.

  • $photo -> getOwnerName()
go to the top
Photo - Récupérer le nom réel du propriétaire d'une photo.

Photo::getOwnerRealName()

Retourne le nom réel du propriétaire de la photo.

  • $photo -> getOwnerRealName()
go to the top
Photo - Récupérer la localisation du propriétaire d'une photo.

Photo::getOwnerLocation()

Retourne la localisation du propriétaire de la photo.

  • $photo -> getOwnerLocation()
go to the top
Photo - Récupérer la date de prise d'une photo.

Photo::getTakenDate()

Retourne la date de prise de la photo (format dd-mm-yyyy).

  • $photo -> getTakenDate()
go to the top
Photo - Récupérer l'heure de prise d'une photo.

Photo::getTakenHour()

Retourne l'heure de la photo (format hh:mm:ss).

  • $photo -> getTakenHour()
go to the top
Photo - Récupérer les infos Exif d'une photo.

Photo::getExif Infos()

Retourne un tableau des infos exif (eXchangeable Image File Format) de la photo si existantes.

  • $photo -> getExifInfos()
go to the top
Photo - Récupérer les mots clés associés à une photo.

Photo::getTags()

Retourne un tableau des mots clés associés à la photo si existants.

  • $photo -> getTags()
go to the top
Photo - Récupérer l'Id de la photo suivante d'une photo.

Photo::getNextPhotoId()

Retourne l'Id de la photo suivante dans l'album si existante.

  • $photo -> getNextPhotoId()
go to the top
Photo - Récupérer le code de la photo suivante d'une photo.

Photo::getNextPhotoSecret()

Retourne l'Id de la photo suivante dans l'album si existante.

  • $photo -> getNextPhotoSecret()
go to the top
Photo - Récupérer le titre de la photo suivante d'une photo.

Photo::getNextPhotoTitle()

Retourne le titre de la photo suivante dans l'album si existante.

  • $photo -> getNextPhotoTitle()
go to the top
Photo - Récupérer l'image thumb de la photo suivante d'une photo.

Photo::getNextPhotoImg()

Retourne l'image thumb de la photo suivante dans l'album si existante (sous forme <img src= ... />).

  • $photo -> getNextPhotoImg()
go to the top
Photo - Récupérer l'Id de la photo précédente d'une photo.

Photo::getPreviousPhotoId()

Retourne l'Id de la photo précédente dans l'album si existante.

  • $photo -> getPreviousPhotoId()
go to the top
Photo - Récupérer le code de la photo précédente d'une photo.

Photo::getPreviousPhotoSecret()

Retourne l'Id de la photo précédente dans l'album si existante.

  • $photo -> getPreviousPhotoSecret()
go to the top
Photo - Récupérer le titre de la photo précédente d'une photo.

Photo::getPreviousPhotoTitle()

Retourne le titre de la photo précédente dans l'album si existante.

  • $photo -> getPreviousPhotoTitle()
go to the top
Photo - Récupérer l'image thumb de la photo précédente d'une photo.

Photo::getPreviousPhotoImg()

Retourne l'image thumb de la photo précédente dans l'album si existante (sous forme <img src= ... />).

  • $photo -> getPreviousPhotoImg()
go to the top
Photo - Récupérer la photo grand format.

Album::getImgLarge()

Retourne la photo grand format 1024 sur grand coté si possible (sous forme <img src= ... />).

  • $album -> getImgLarge()
go to the top
Photo - Récupérer la photo format moyen.

Album::getImgMedium()

Retourne la photo format moyen 500 sur grand coté (sous forme <img src= ... />).

  • $album -> getImgMedium()
go to the top
Photo - Récupérer la photo petit format.

Album::getImgSmall()

Retourne la photo format moyen 240 sur grand coté (sous forme <img src= ... />).

  • $album -> getImgSmall()
go to the top
Photo - Récupérer la photo format Thumb.

Album::getImgThumb()

Retourne la photo format moyen 100 sur grand coté (sous forme <img src= ... />).

  • $album -> getImgThumb()
go to the top
Photo - Récupérer la photo format vignette.

Album::getImgSquare()

Retourne la vignette de la photo format 75x75 (sous forme <img src= ... />).

  • $album -> getImgSquare()
go to the top
Flickr - Nouvelle instance.

Flickr::Flickr( string apiKey, string apiSecret )

Nouvelle Instance de la classe Flickr.

  • apiKey : Clé de l'API
  • apiSecret : Code de l'API
  • $flickr = new Flickr($apiKey, $apiSecret)
go to the top
Flickr - People : Récupérer les photos publiques d'un user.

Flickr::peoplegetPublicPhotos( string userId [, int per_page [, int page [, string extras ]]] )

Retourne la liste de toutes les photos d'un user.

  • userId : Id de l'utilisateur
  • per_page : Nombre de résultats par page (par défaut 100, maxi 500)
  • page : La page à récupérer (par défaut la première)
  • extras : Liste d'infos supplémentaire à récupérer.
  • $flickr -> peoplegetPublicPhotos( '19336866@N00' );
  • $flickr -> peoplegetPublicPhotos( '19336866@N00' , 10);
  • $flickr -> peoplegetPublicPhotos( '19336866@N00' , 10 , 3);
  • $flickr -> peoplegetPublicPhotos( '19336866@N00' , 10 , 3, 'license, owner_name');
go to the top
Flickr - People : Récupérer les infos d'un user

Flickr::peoplegetInfos( string userId )

Retourne les informations liées à un user

  • userId : Id de l'utilisateur
  • $flickr -> peoplegetInfos( '19336866@N00' );
go to the top
Flickr - Photos : Récupérer les photos récentes.

Flickr::photosgetRecent( [ int per_page [, int page [, string extras ]]] )

Retourne la liste des photos récement uploadé sur flickr (tous users confondus)

  • per_page : Nombre de résultats par page (par défaut 100, maxi 500)
  • page : La page à récupérer (par défaut la première)
  • extras : Liste d'infos supplémentaire à récupérer.
  • $flickr -> photosgetRecent( 10 );
  • $flickr -> photosgetRecent( 10 , 3 );
  • $flickr -> photosgetRecent( 10 , 3 , 'license, owner_name' );
go to the top
Flickr - Photos : Récupérer les informations générales d'une photo.

Flickr::photosgetInfo( string photoId, [string secret] )

Retourne les informations liées à une photo.

  • photoId : Id de la photo
  • secret : Code de la photo
  • $flickr -> photosgetInfo( '52662603' );
  • $flickr -> photosgetInfo( '52662603' , '80cac31fdc' );
go to the top
Flickr - Photos : Récupérer les informations Exif d'une photo.

Flickr::photosgetExif( string photoId, [string secret] )

Retourne les informations liées à une photo (si présentes).

  • photoId : Id de la photo
  • secret : Code de la photo
  • $flickr -> photosgetExif( '52662603' );
  • $flickr -> photosgetExif( '52662603' , '80cac31fdc' );
go to the top
Flickr - Photoset : Récupérer les albums d'un user

Flickr::photosetsgetList( string userId )

Retourne la liste des albums (photosets) d'un user.

  • userId : Id de l'utilisateur
  • $flickr -> photosetsgetList( '19336866@N00' );
go to the top
Flickr - Photoset : Récupérer les informations d'un album.

Flickr::photosetsgetInfo( string setId )

Retourne les informations liées à un album.

  • setId : Id de l'album
  • $flickr -> photosetsgetInfo( '1183438' );
go to the top
Flickr - Photoset : Récupérer les photos d'un album.

Flickr::photosetsgetPhotos( string setId )

Retourne la liste des photos d'un album.

  • setId : Id de l'album
  • $flickr -> photosetsgetPhotos( '1183438' );
go to the top
Flickr - Photoset : Récupérer les photos précédentes et suivantes.

Flickr::photosetsgetContext( string photoId, string setId )

Retourne les photos précédentes et suivantes d'une photo donnée à l'interieur d'un album.

  • photoId : Id de la photo
  • setId : Id de l'album
  • $flickr -> photosetsgetContext( '52662603' , '1183438' );
go to the top
Flickr - Auth : Récupérer une Url d'authentification.

Flickr:: getAuthUrl( string perm )

Retourne une URL permettant d'obtenir une autorisation sur Flickr. L'appel à cette URL dirrige sur le panneau de "Sign in" Flickr puis sur l'URL de callback en envoyant le "FROB" en GET.

  • perm : Permission demandée : read, write ou delete.
  • $flickr -> getAuthUrl( 'write' );
go to the top
Flickr - Auth : Récupérer un code d'authentification.

Flickr:: getFrobToken( string frob )

Retourne un code d'autentification (auth-token) à partir d'un frob.

  • frob : Code frob récupéré grace à l'URL d'authentification.
  • $flickr -> getFrobToken( '346608-6784cfab1b8dca79' );
go to the top
http://classes.scriptsphp(.org).net - ©tetsuo 2003 | banniere©FRAI2 | SDSL | tous les scripts présents sur ce site sont distribués sous license GPL.
Page valide XHTML 1 Strict, CSS2 et accessible AA. Politique d'accessibilité. Copyright et license.

Merci de ne pas suivre ce lien emails.

0.0987s | «»
PHP powered