Cómo Configurar Una Aplicación Lectora de RSS de Facebook Para Tu Blog

Versión 1.0
Autor: Falko Timme

Esta guía muestra cómo puedes construir una aplicación lectora de RSS para la red social Facebook que mostrará el RSS de tu blog/sitio web en las páginas de perfil de los usuarios de Facebook (que han instalado la aplicación lectora de RSS). Cada elemento del RSS tendrá un botón de Compartir para que las personas puedan compartir la historia con sus amigos, y la aplicación tendrá un enlace de Invitar para que las personas puedan invitar a hasta diez amigos a la vez a instalar también esta aplicación lectora de feeds. Utilizaré PHP5 para construir la aplicación lectora de RSS. Para analizar el RSS y generar HTML a partir de él, usaré Magpie RSS.

Puedes ver esta aplicación en acción instalando el Lector de RSS de HowtoForge para Facebook.

¡Este documento se proporciona sin garantía de ningún tipo! No emito ninguna garantía de que esto funcionará para ti!

1 Nota Preliminar

Esta guía se basa en un ejemplo del mundo real, el Lector de RSS de HowtoForge para Facebook, y utilizaré las URL y scripts reales en este ejemplo (solo reemplazando datos secretos como la clave API y el Secreto).

Como mencioné antes, estoy usando PHP5 para construir esta aplicación, utilizando la Biblioteca de Cliente PHP de Facebook. Teóricamente, también puedes usar PHP4, pero la plataforma del cliente está optimizada para PHP5, así que deberías usar eso si es posible.

Estoy usando el host fb.howtoforge.com en este ejemplo para alojar la aplicación; es un sitio web compatible con PHP5.

Antes de que puedas comenzar a escribir tu propia aplicación de Facebook, debes registrarte en Facebook (si aún no tienes una cuenta) y agregar la Aplicación de Desarrollador de Facebook a tu cuenta, como se describe en http://developers.facebook.com/get_started.php:

Después, deberías comenzar con estos ejemplos para acostumbrarte a crear aplicaciones de Facebook. Sin embargo, usaré estos ejemplos en este tutorial nuevamente (al principio) para asegurarme de que todo funcione como se espera antes de intentar escribir mi propio contenido.

2 Configurar Una Nueva Aplicación

Antes de comenzar a programar nuestra aplicación, debemos informar a Facebook sobre ella, y Facebook nos dará una Clave API y un Secreto que necesitamos para construir la aplicación.

Ahora que has agregado la Aplicación de Desarrollador de Facebook a tu cuenta, ve a tu página de Facebook; ahora deberías ver la aplicación de Desarrollador en la navegación izquierda. Haz clic en ella. Se abre la página de Desarrollador, donde haces clic en el botón + Configurar Nueva Aplicación (cerca de la esquina superior derecha):

Ahora estamos en la página de Nueva Aplicación. Quiero nombrar mi aplicación Lector de RSS de HowtoForge, así que lo lleno como Nombre de la Aplicación. Marco la casilla debajo de este campo para mostrar que estoy de acuerdo con los términos de la plataforma de Facebook. Luego lleno una dirección de correo electrónico de soporte (debería ser una dirección donde tú o tus compañeros desarrolladores puedan ser contactados). La URL de Callback es la ubicación donde se alojará la aplicación. La mía se alojará en http://fb.howtoforge.com/fb/htf_feed_reader/, así que lo lleno. La URL de la Página Canvas es la dirección de Facebook que te gustaría que tuviera tu aplicación. Llena tu dirección deseada (por ejemplo, http://apps.facebook.com/htf_feed_reader), y el formulario te dirá si la dirección aún está disponible o no. Luego selecciona Usar FBML y Sitio Web (ambos deberían ser ya la selección predeterminada):

Una nota importante respecto a la URL de Callback: Es absolutamente importante que la URL termine con una barra ( /); si no lo hace, las personas recibirán más tarde el famoso error La URL … no respondió. cada vez que visiten tu aplicación en sus cuentas, así:

A continuación, aún en la página de Nueva Aplicación, completa las otras opciones. Responde ¿Puede tu aplicación ser añadida en Facebook? con Sí. Puedes dejar el campo de URL de TOS vacío si no tienes ningún término de servicio. Agrega desarrolladores adicionales si los hay. Como URL de Post-Add, usas la URL de la Página Canvas ( http://apps.facebook.com/htf_feed_reader en mi caso). Llena una descripción para tu aplicación. La URL de Post-Remove también puede dejarse vacía. En el campo FBML Predeterminado, puedes ingresar algún texto que te gustaría que apareciera en los perfiles de usuario si tu aplicación no entrega contenido para la página de perfil. Luego selecciona en qué columna de perfil te gustaría que apareciera tu contenido. Como hay mucho texto en los feeds RSS, la columna ancha es una buena elección en nuestro caso:

Más abajo en la página de Nueva Aplicación, hay solo un campo más que debemos completar, la URL de Navegación Lateral. Nuevamente, esta es la misma que la URL de la Página Canvas ( http://apps.facebook.com/htf_feed_reader en mi caso). Todos los demás campos pueden dejarse vacíos. Haz clic en Enviar después:

Ahora deberías estar en la página Mis Aplicaciones donde puedes encontrar la Clave API y el Secreto para tu aplicación. Cópialos, los necesitaremos para nuestra aplicación más adelante.

Más abajo en la página Mis Aplicaciones, verás un enlace a la Biblioteca de Cliente PHP (4 y 5):