Busquedas Flickr en tu sitio web

Por patoxs el Dic.21, 2009, en tutoriales

flickr

En este tutorial mostraremos cómo crear una simple clase PHP para buscar en tú sitio web algunas fotografías de Flickr. Para obtener los datos utilizaremos la API de Flickr para realizar una búsqueda simple y devolver los resultados en una matriz.

Vamos a usar la función “file_get_contents” para recibir los datos de Flickr. Los datos que recibirá será una matriz de PHP serializada, luego debemos aplicar unserialized a la matriz y para poder utilizar los datos devueltos. Como alternativa se puede utilizar una función cURL para obtener los datos si por ejemplo la función “file_get_contents” no está permitido en tu webhosting.

API Authentication
El método de API que usaremos en este tutorial no requiere autenticación, pero tenemos que utilizar una clave API. Para conseguir tu clave de API en el sitio web de Flickr (Necesitas una cuenta de Yahoo para inicio de sesión).

1.- Solicitud de clave API

2.- Proporcionar alguna información sobre su solicitud

3.- Clave personal de API de Flickr

Flickr PHP Class
Primero creamos la estructura de nuestra clase, definiremos una variable privada para la “clave API”, el constructor de la clase y la función para buscar las imágenes.

1
2
3
4
5
6
7
8
9

class Flickr {
private $apiKey = 'YOUR API KEY HERE';

public function __construct() {
}

public function search($query = null) {
}
}

El método del API que va a utilizar es “flickr.photos.search”, que tiene un número posible de parámetros. Seremos capaces de buscar por etiquetas, textos completos y muchos más. Tú podrás encontrar una lista con los parámetros en la documentación de Flickr.

Así que vamos a realizar una búsqueda de texto completo y limitar el número de resultados a 50.

1
2
3
4
5

public function search($query = null) {
$search = 'http://flickr.com/services/rest/?method=flickr.photos.search&api_key=' . $this->apiKey . '&text=' . urlencode($query) . '&per_page=50&format=php_serial';
$result = file_get_contents($search);
$result = unserialize($result);
}

Los datos que se almacenan en la variable $result es una matriz serializada, tan sólo unserialize y devuelve los datos. Ponemos a tu disposición el código de clase completa y almacenar el código en un archivo llamado “flickr.php”

Como utilizar la clase PHP

Crea un nuevo script PHP y añade este código:

1
2
3
4
5
6
7
8

require_once('flickr.php');
$Flickr = new Flickr;
$data = $Flickr->search('design inspiration');
foreach($data['photos']['photo'] as $photo) {
// the image URL becomes somthing like
// http://farm{farm-id}.static.flickr.com/{server-id}/{id}_{secret}.jpg
echo '<img src="http://farm' . $photo["farm"] . '.static.flickr.com/' . $photo["server"] . '/' . $photo["id"] . '_' . $photo["secret"] . '.jpg">';
}

Este archivo incluye solo la clase de Flickr que escribimos, crea una nueva instancia para la clase.

Ahora finalmente coloca con los datos devueltos y envía la salida al Browser.