Zend_Service_Flickr
ist eine einfache API um den Flickr REST Web Service zu nutzen.
Für die Benutzung des Flickr Web Service, benötigt man einen API Schlüssel.
Um diesen Schlüssel zu bekommen und für weitergehende Informationen über den Flickr REST Web Service
besuchen Sie bitte die Flickr API Dokumentation.
Im folgenden Bespiel benutzen wir die tagSearch()
Methode um Photos zu suchen welche
"php" im Tag haben.
Beispiel 15.8. Simple Flickr Photo Suche
<?php require_once 'Zend/Service/Flickr.php'; $flickr = new Zend_Service_Flickr('MY_API_KEY'); $results = $flickr->tagSearch("php"); foreach ($results as $result) { echo $result->title . '<br />'; } ?>
Anmerkung | |
---|---|
tagSearch() aktepziert als optionalen zweiten Parameter ein Array mit Optionen.
|
Zend_Service_Flickr
stellt 3 unterschiedliche Wege zur Verfügung um Informationen
über Flickr Benutzer zu bekommen:
userSearch()
: Akzeptiert ein String Abfrage von mit Leerzeichen getrennten Tags
und als optionalen zweiten Parameter ein Array mit Such Optionen. Zurückgegeben wird ein
Zend_Service_Flickr_ResultSet
Objekt.
getIdByUsername()
: Gibt die Benutzer ID als String zurück, welcher mit dem
übergebenen String des Benutzernamens verknüpft ist.
getIdByEmail()
: Gibt die Benutzer ID als String zurück, welcher mit dem übergebenen
String der Email Adresse verknüpft ist.
Beispiel 15.9. Finden eines Flickr Benutzers durch seine E-Mail Adresse
In diesem Beispiel haben wir die E-Mail adresse eines Flickr Benutzers und wir holen uns die
Benutzer Informationen durch Verwendung der userSearch()
Methode:
<?php require_once 'Zend/Service/Flickr.php'; $flickr = new Zend_Service_Flickr('MY_API_KEY'); $results = $flickr->userSearch($userEmail); foreach ($results as $result) { echo $result->title . '<br />'; } ?>
Zend_Service_Flickr
erlaubt es schnell und einfach an Details zu Bilders zu kommen,
basieren auf einer übergebenen ID des Bildes. Einfach durch benutzen der getImageDetails()
Methode,
wie im folgenden Beispiel:
Beispiel 15.10. Empfangen von Details zu Bildern durch Flickr
Sobald man eine Flickr Bild ID hat, ist es eine einfache Angelegenheit, Informationen über ein Bild zu bekommen:
<?php require_once 'Zend/Service/Flickr.php'; $flickr = new Zend_Service_Flickr('MY_API_KEY'); $image = $flickr->getImageDetails($imageId); echo "Bild ID $imageId ist $image->width x $image->height Pixel groß.<br />\n"; echo "<a href=\"$image->clickUri\">Klicken für das Bild</a>\n"; ?>
Die folgenden Klassen werden durch tagSearch()
und userSearch()
zurückgegeben:
Repräsentiert ein Set von Ergebnissen von einer Flickr Suche.
Anmerkung | |
---|---|
Implementiert einen
|
int totalResults();
Gibt die Gesamt Anzahl der Ergebnisse für dieses Ergebnis Set zurück.
Ein einzelnes Bild Ergebnis von einer Flickr Suche
Tabelle 15.11. Zend_Service_Flickr_Result Eigenschaften
Name | Typ | Beschreibung |
---|---|---|
id | int | Image ID |
owner | int | Die NSID des Eigentümers des Photos. |
secret | string | Ein Schlüssel welcher beim URL Aufbau benutzt wird. |
server | string | Der Servername welcher beim URL Aufbau benutzt wird. |
title | string | Die Überschrift des Bildes. |
ispublic | boolean | Ist das Bild öffentlich ? |
isfriend | boolean | Das Bild ist sichtbar, weil man ein Freund des Eigentümers ist. |
isfamily | boolean | Das Bild ist sichtbar, weil man Familienmitglied des Eigentümers ist. |
license | string | Die Lizenz des Bildes ist erreichbar unter. |
date_upload | string | Das Datum an dem das Bild hochgeladen wurde. |
date_taken | string | Das Datum an dem das Bild gemacht wurde. |
owner_name | string | Der Bildschirmname des Eigentümers. |
icon_server | string | Der Server welcher benutzt wurde um die Icon URL zu erstellen. |
Square | Zend_Service_Flickr_Image | Ein 75x75 Thumbnail des Bildes. |
Thumbnail | Zend_Service_Flickr_Image | Ein 100 Pixel Thumbnail des Bildes. |
Small | Zend_Service_Flickr_Image | Eine 240 Pixel Version des Bildes. |
Medium | Zend_Service_Flickr_Image | Eine 500 Pixel Version des Bildes. |
Large | Zend_Service_Flickr_Image | Eine 640 Pixel Version des Bildes. |
Original | Zend_Service_Flickr_Image | Das Original Bild. |
Repräsentiert ein Bild welches durch eine Flickr Suche zurückgegeben wird.