Crear feed de nuestra aplicación con feed_publishUserAction

El objetivo de este manual es el de poder crear feeds de nuestras acciones en la aplicación de Facebook que hemos desarrollado.

Se supone que tenemos creada nuestra aplicación en Facebook, por lo que nos saltamos todo el proceso.

MUY IMPORTANTE: Bajarse la última versión de la api de Facebook desde:
http://svn.facebook.com/svnroot/platform/clients/packages/facebook-platform.tar.gz


Una vez creada nuestra aplicación entramos en:

http://developers.facebook.com/tools.php?feed

En nuestro caso solo queremos que al realizar una acción en nuestra aplicación de facebook se actualice el feed de nuestro perfil con una sola linea. Para ello, escribimos en el campo 'One line template' la plantilla que seguirá nuestro feed.

Por ejemplo:

{*actor*} ha votado {*voto*} en la aplicación X.


En el campo 'Sample Template Data' escribimos valores para los parámetros de hemos escrito en 'One line template', en nuestro caso, el único parámetro que tenemos es {*voto*}. {*actor*} no se considerá parámetro porque se rellenará automáticamente con nuestro usuario. Esto es solo un ejemplo para que veamos como va a quedar cuando hagamos la vista previa.

Por ejemplo:

{"voto":"SI"}


Como solo queremos crear un feed de una sola línea, borramos todos los demás campos. En la siguiente imagen puedes ver un ejemplo de como quedaría:



El siguiente paso es pulsar en preview, lo que generará una vista previa de como quedará nuestro feed de una linea, rellenando los parámetros con el ejemplo que hemos puesto. En nuestro caso quedará así:

Jon ha votado SI en la aplicación X.

Si ha quedado como queríamos, el siguiente paso es pulsar en 'Register Template Bundle' para registrar este feed en nuestra aplicación. Una vez guardado, nos genera un número llamado 'Template Bundle Id', que usaremos para crear los feeds desde nuestra aplicación de facebook. Podemos ver la lista de plantillas de feeds registradas pinchando en la pestaña 'Registered Templates Console'.


Una vez hemos registrado la plantilla de feed en nuestra aplicación haremos uso de la función feed_publishUserAction() en nuestra aplicación para publicar los feeds.

Por ejemplo:

// La variable $voto contendra el voto del usuario en nuestra aplicacion $voto="SI"; // Es el Template Bundle Id que hemos generado anteriormente $template_bundle_id = 123456789; // En la variable $tokens creamos un array con los valores de los parámetros de nuestra plantilla de feed (el parámetro {actor} no hace falta declararlo ya que se rellenara automaticamente con nuestro usuario). $tokens = array( 'voto'=>$voto ); // Lista de usuarios a los que queremos mandar nuestro feed, lo dejamos vacio $target_ids = array(); // Es para incluir un texto adicional, también lo dejamos vacio $body_general = ''; // Llamamos a la funcion feed_publishUserAction para que cree nuestro feed $facebook->api_client->feed_publishUserAction( $template_bundle_id, json_encode($tokens) , implode(',', $target_ids), $body_general);
En el array $tokens pondremos todos los parámetros que hayamos definido anteriormente. En este caso solo tenemos el parametro voto pero si tuvieramos más parámetros los definiríamos en este array.

Cuando un usuario interactúe con nuestra aplicación y vote ('SI' o 'NO'), se generará un feed en su perfil con el voto realizado.