Nuestra primera aplicación

Finalmente vamos a ver un poco de código!

El objetivo de este post, es crear una primera aplicación que luego de conectarse a twitter via OAuth, nos muestre un cuadro de texto en el cual podamos introducir un texto que se convertirá en nuestra primera actualización desde nuestra aplicación.

Luego de descomprimir la librería twitteroauth, dentro de nuestro directorio web, tenemos varios archivos:

• config.php: en este archivo almacenamos las claves de acceso de la aplicación (CONSUMER_KEY, CONSUMER_SECRET) y opcionalmente podemos especificar un callback al cual redireccionar el navegador una vez realizada la autenticación via OAuth. Recordar que si no especificamos una dirección de callback, se utilizará por omisión la dirección que especificamos al registrar la aplicación.
• redirect.php: este es el archivo que realiza todo el proceso de obtención del access token y redirecciona hacia nuestro callback.
• callback.php: este archivo verifica si se otorgó o no el permiso y redirecciona hacia la página principal, si la autenticación fue exitosa.
• index.php: este la página principal de nuestro sitio.
• clearsessions.php: borra de la sesión del navegador los datos de conexión a twitter.

Lógicamente, debemos modificar el archivo config.php, para almacenar los tokens correspondientes a nuestra aplicación, y especificar nuestro callback. Los archivos redirect.php, callback.php y clearsessions.php no los he modificado.

Sí he modificado el index.php, he quitado todo el contenido que allí se encontraba, y he colocado un enlace hacia update.php, que será la página desde donde haremos nuestra actualización.

En update.php vamos a colocar un formulario con un campo de texto y un botón. El action del formulario va a ser el mismo update.php. La idea es que al cargar la página, en PHP se verifique si se ha recibido el texto del formulario via POST y en caso afirmativo, realice la actualización a twitter (previa verificación de que tenemos permiso de conectarnos a twitter).

Luego, sólo nos queda definir nuestra página HTML, incluir el formulario (y todo el adorno que queramos ponerle). Al principio verificamos que tengamos los datos suficientes para poder realizar la conexión ($connection), verificamos si tenemos un mensaje que twittear o no, y en caso afirmativo, finalmente es que utilizamos nuestra conexión para realizar un post tipo 'statuses/update' con nuestro mensaje.

No explico acá el resto del código de update.php, ya que se trata de un formulario común y corriente en HTML, más sí dejaré el código para su descarga. En este enlace se puede descargar el sitio completo, incluyendo las modificaciones realizadas sobre los archivos originales de twitteroaut. Sólo se debe modificar el archivo config.php para colocar nuestros consumer tokens.

Y eso fue todo! Ahora sólo queda hacer las pruebas. Al ir a http://localhost/tutuitero/index.php, verificará que no estamos autenticados, así que nos redireccionará a redirect.php, el cual se conectará con twitter, twitter nos preguntará si queremos o no que TuTuitero utilice nuestros datos para funcionar, le diremos que sí (en el caso de que no tengamos abierta una sesión twitter en el navegador, nos mostrará un formulario para loguearnos), inmediatamente se invocará callback.php, el cual al verificar que nos logueamos correctamente nos redireccionará a index.php, desde donde podremos ir a update.php mediante el enlace. Una vez en update.php, exitosamente logueados, podremos realizar finalmente nuestros updates!

En los siguientes posts trataremos de mejorar un poco la interfaz de nuestra aplicación y jugaremos con las funciones del API.