Psycho Side

En estos días comencé a probar la API de Facebook y me anime a crear este tip que consiste en crear una aplicación que muestra un “Hello World” en Facebook utilizando PHP.

Para poder crear aplicaciones en Facebook necesitamos estar registrados en la comunidad, ya registrados nos unimos al grupo de developers.  Al entrar al grupo nos va a preguntar si permitimos que acceda a nuestro perfil como cuando agregamos cualquier aplicación, luego de aceptar podremos crear aplicaciones, acceder al foro y otras funcionalidades.

Cuando creamos aplicaciones en Facebook hay que saber que la aplicación que creamos no residen en los servidores de Facebook(el código fuente), sino en un servidor publico común y corriente.  Cuando utilizamos aplicaciones creadas por terceros o creamos nuestras propias aplicaciones, Facebook lo que hace es pasar esas solicitudes a otros servidores que procesan los datos e imprimen una respuesta que es leída por Facebook y mostrada al cliente.

Este tip estará dividido en dos pasos:

1. Crear y configurar la aplicación en Facebook.
2. Subir archivos al servidor, configurar, programar y probar.

Paso 1: Crear y configurar la aplicación en Facebook

En la pagina de developers existe un botón que dice Set Up New Application, ese botón es el que nos permite crear y configurar nuestra aplicación.  Allí nos encontramos con un formulario que nos solicita el nombre que llevara nuestra aplicación y si aceptamos las políticas de uso.

Luego de crear la aplicación nos queda configurar ciertos parámetros como el URL de la aplicación en Facebook, la ruta del servidor en donde residen los archivos de la aplicación que va a responder a las peticiones hechas por Facebook, imagen e icono que identifica a la aplicación, etc.

Basic:

En esta sección asignamos el nombre de nuestra aplicación, descripción, icono, logo, idioma, desarrolladores que estan relacionados con la aplicación, etc.

También podemos notar que aparece un Application ID, API KEY y Secret

• Application ID: es el identificador único de nuestra aplicación.
• API KEY: llave privada para acceso al API.
• Secret: códido secreto de nuestra aplicación.

Autenticaction:

La primera opción indica a que tipo de perfil puede ser instalada la aplicación.

El punto mas importante a notar en esta sección es el campo Post-Authorize Callback URL, esta ruta indica en donde se encuentra alojada nuestra aplicación.

Canvas:

En el canvas configuramos la dirección de la aplicación en Facebook y el Callback URL de la aplicación.

Con la configuración de estos parámetros podemos continuar al siguiente paso que sera subir los archivos a nuestro servidor programar el mensaje y probar

Paso 2: Subir archivos al servidor, configurar, programar y probar.

Antes de comenzar a programar vamos a descargar las librerías PHP que nos permitirán interactuar con el API de Facebook.

La estructura en mi servidor es la siguiente:

En la carpeta includes se encuentran las librerías descargadas y un archivo llamado facebook_config.php creado por mi el cual tendrá como contenido el API KEY de nuestra aplicación, el código secreto(Secret), además una instancia de la clase “Facebook” seguido de una variable que tiene el id del usuario que este utilizando la aplicación.

Archivo facebook_config.php:

<?php
/**
* @Archivo que contiene los parametros de configuración "facebook_config.php"
* @versión: 1.0
* @autor: Psycho
*/

require_once 'facebook-platform/php/facebook.php';

// codigo(KEY) que identifica a nuestra aplicación y es utilizadas en cada llamada a Facebook
$appapikey = 'Coloca tu API Key aquí';

// llave privada para autenticar la aplicación en el servidor de Facebook
$appsecret = 'Coloca tu Application Secret aquí';

// Crear una instancia del objeto Facebook
$facebook = new Facebook($appapikey, $appsecret);

// Obtener el id del usuario que este utilizando la aplicación
$id_usuario = $facebook->require_login();
?>

El ultimo paso es crear el archivo index.php que sera la aplicación como tal, este archivo va a ser que el maneja la instancia del objeto Facebook que se encuentra en el archivo facebook_config.php e imprime “Hello World”.

Archivo index.php

<?php
/**
* @Archivo que imprime Hello Wold al usuario que utiliza la aplicación "index.php"
* @versión: 1.0
* @autor: Psycho
*/

// Llamar el archivo que contiene los parametros de configuración y obtine el id del usuario
require_once 'includes/facebook_config.php';
?>

Hello World <fb:name uid="<?php echo $id_usuario; ?>" useyou="false" />

Luego de configurar la aplicación en Facebook, programar los archivos y subirlos al servidor nos queda probarla, en mi caso voy a la dirección http://apps.facebook.com/psychotuto/ y lo primero que deberías es ver una pagina parecida a esta en donde aceptas que la aplicación accesa a tus datos.

Luego de aceptar allí nuestra primera aplicación en Facebook

En caso de cualquier duda deja un comentario.

Descargar Ejemplo