Como Configurar Um Aplicativo Leitor de Feed RSS do Facebook Para Seu Blog

Versão 1.0
Autor: Falko Timme

Este guia mostra como você pode construir um aplicativo leitor de feed RSS para a rede social Facebook que exibirá o feed RSS do seu blog/site nas páginas de perfil dos usuários do Facebook (que instalaram o aplicativo leitor de feed RSS). Cada item do feed RSS terá um botão Compartilhar para que as pessoas possam compartilhar a história com seus amigos, e o aplicativo terá um link de Convite para que as pessoas possam convidar até dez amigos de uma vez para também instalar este aplicativo leitor de feed. Eu usarei PHP5 para construir o aplicativo leitor de feed RSS. Para analisar o feed RSS e gerar HTML a partir dele, usarei o Magpie RSS.

Você pode ver este aplicativo em ação instalando o Leitor de Feed RSS do HowtoForge para Facebook.

Este documento vem sem garantia de qualquer tipo! Eu não emito nenhuma garantia de que isso funcionará para você!

1 Nota Preliminar

Este guia é baseado em um exemplo do mundo real, o Leitor de Feed RSS do HowtoForge para Facebook, e eu usarei as URLs e scripts reais neste exemplo (substituindo apenas dados secretos como a chave da API e o Segredo).

Como mencionei antes, estou usando PHP5 para construir este aplicativo, usando a Biblioteca do Cliente PHP do Facebook. Teoricamente, você também pode usar PHP4, mas a plataforma do cliente é otimizada para PHP5, então você deve usar isso se possível.

Estou usando o host fb.howtoforge.com neste exemplo para hospedar o aplicativo; é um site compatível com PHP5.

Antes de começar a escrever seu próprio aplicativo do Facebook, você deve se registrar no Facebook (se ainda não tiver uma conta) e adicionar o Aplicativo de Desenvolvedor do Facebook à sua conta, conforme descrito em http://developers.facebook.com/get_started.php:

Depois, você deve começar com esses exemplos para se acostumar a criar aplicativos do Facebook. No entanto, usarei esses exemplos neste tutorial novamente (no início) para garantir que tudo esteja funcionando como esperado antes de tentar escrever minhas próprias coisas.

2 Configurar Um Novo Aplicativo

Antes de começarmos a programar nosso aplicativo, devemos informar ao Facebook sobre ele, e o Facebook nos dará uma Chave de API e um Segredo que precisamos para construir o aplicativo.

Agora que você adicionou o Aplicativo de Desenvolvedor do Facebook à sua conta, vá para sua página do Facebook - você deve agora ver o aplicativo de Desenvolvedor na navegação à esquerda. Clique nele. A página do Desenvolvedor se abre, onde você clica no botão + Configurar Novo Aplicativo (perto do canto superior direito):

Agora estamos na página Novo Aplicativo. Eu quero nomear meu aplicativo Leitor de Feed RSS do HowtoForge, então preencho isso como Nome do Aplicativo. Eu marco a caixa abaixo deste campo para mostrar que concordo com os termos da plataforma do Facebook. Em seguida, preencho um endereço de e-mail de suporte (deve ser um endereço onde você ou seus colegas desenvolvedores possam ser contatados). A URL de Retorno é o local onde o aplicativo será hospedado. O meu será hospedado em http://fb.howtoforge.com/fb/htf_feed_reader/, então preencho isso. A URL da Página Canvas é o endereço do Facebook que você gostaria que seu aplicativo tivesse. Preencha o endereço desejado (por exemplo, http://apps.facebook.com/htf_feed_reader), e o formulário então lhe dirá se o endereço ainda está disponível ou não. Em seguida, selecione Usar FBML e Site (ambos já devem ser a seleção padrão):

Uma nota importante sobre a URL de Retorno: É absolutamente importante que a URL termine com uma barra (/); se não terminar, as pessoas receberão mais tarde o famoso erro A URL … não respondeu. sempre que visitarem seu aplicativo em suas contas, como este:

Em seguida, ainda na página Novo Aplicativo, preencha as outras opções. Responda Pode seu aplicativo ser adicionado ao Facebook? com Sim. Você pode deixar o campo URL dos Termos de Serviço vazio se não tiver nenhum termo de serviço. Adicione desenvolvedores adicionais, se houver. Como URL de Pós-Adição, use a URL da Página Canvas (http://apps.facebook.com/htf_feed_reader no meu caso). Preencha uma descrição para seu aplicativo. A URL de Pós-Remoção também pode ser deixada em branco. No campo FBML Padrão, você pode inserir algum texto que gostaria que aparecesse nos perfis dos usuários se seu aplicativo não fornecer conteúdo para a página do perfil. Em seguida, selecione em qual coluna de perfil você gostaria que seu conteúdo aparecesse. Como há muito texto em feeds RSS, a coluna larga é uma boa escolha no nosso caso:

Mais abaixo na página Novo Aplicativo, há apenas um outro campo que devemos preencher, a URL de Navegação Lateral. Novamente, esta é a mesma que a URL da Página Canvas (http://apps.facebook.com/htf_feed_reader no meu caso). Todos os outros campos podem ser deixados em branco. Clique em Enviar depois:

Você deve agora estar na página Meus Aplicativos onde pode encontrar a Chave de API e o Segredo para seu aplicativo. Copie-os, precisaremos deles para nosso aplicativo mais tarde.

Mais abaixo na página Meus Aplicativos, você verá um link para a Biblioteca do Cliente PHP (4 e 5):