abr 1 2010

PHP: Integrando o Twitter ao seu site – Parte 1


Saudações a todos, ao contrário do que parece, o blog não morreu ou foi esquecido, apenas as velhas desculpas de sempre (problemas, trabalho, faculdade… mimimi). Mas não vou perder tempo explicando por menores, lógico!

Iniciaremos hoje uma série de 3 artigos sobre como integrar o twitter ao seu site. Os artigos vão ser divididos da seguinte maneira:

  1. Mostrar seus tweets (updates) no seu site de maneira simples;
  2. Atualizar sua timeline (a.k.a “twittar”) diretamente do seu site;
  3. Implementar uma biblioteca para simplificar o uso em seus projetos;

Ok ok, já existem várias bibliotecas para isso, mas a intenção aqui é ir desde a tarefa mais simples (listar os tweets) até as mais complexas, como projetar um biblioteca orientada a objetos. Sempre é bom treinar OO, então vamos usar isto aqui.

Parte 1 : Mostrando seus tweets

Nada melhor para iniciar do que algo simples, mas não um mero Hello World, um simples útil, legal, que vai trazer o efeito UAU ao sei site. Ok, exagerei, menos enrolação e mais ação.

O processo para mostrar seus tweets envolve basicamente 2 coisas, o RSS da sua timeline e a biblioteca SimpleXML que já vem integrada ao PHP (pelo menos nas versões mais recentes).

Usando o RSS da sua timeline

Apesar de existirem várias maneiras de ter acesso a seus updates, a mais fácil delas é usando o RSS disponível na sua home. É possível fazer isso via a API do twitter, mas vamos deixar isso para mais adiante, afinal, a parte 1 tem que ser fácil.

Para evitar de você sair do artigo agora, acessar a home do twitter e ainda correr o risco de dar de cara com a Fail Whale, vou simplificar as coisas:

http://twitter.com/statuses/user_timeline/kidh0.rss

onde logicamente, você irá substituir o “kidh0″ pelo seu usuário do twitter.

Com isso, irá listar listar seus últimos 15 twits (pelo que pude contar). Claro, muitas vezes temos um espaço muito pequeno para mostrar os updates, por isso, vamos limitar esse número usando o parametro “count” na URL do RSS:

http://twitter.com/statuses/user_timeline/kidh0.rss?count=5

Pronto, agora irá retornar somente os 5 últimos updates.

Brincando com XML usando o SimpleXML

SimpleXML é uma biblioteca do PHP que permite fazer a manipulação de XML, tanto de strings quanto de arquivos, fazendo o parse para um objeto.

O uso básico dela, que no caso é o mesmo que nós iremos fazer, é o seguinte:

$url = 'http://twitter.com/statuses/user_timeline/kidh0.rss?count=5';
$xml = simplexml_load_file($url);

Pronto, com isto já temos um objecto preenchido com os 5 post que requisitamos. Fácil não?

Juntando tudo e fazendo a mágica acontecer

Agora vem a parte mais legal da história, juntar tudo e mostrar o resultado.

Não tem como ser mais descritivo do que mostrando o próprio código:

$url = 'http://twitter.com/statuses/user_timeline/kidh0.rss?count=5';
$xml = simplexml_load_file($url);
echo '<ol>';
foreach($xml->channel->item as $node){

    printf('<li><a href="%s">%s</a></li>',
            $node->link,
            $node->title
    );
}
echo '</ol>';

Explicando:

  • Linha 1: simples atribuição da URL do RSS do twitter, para simplificar;
  • Linha 2: Fazemos o parse da URL em questão para um objeto usando o método simplexml_load_file()
  • Linha 3: Percorremos o objeto SimpleXML para pegar os dados para mostrar, neste caso usamos só title e o link para o update, mas existem outras opções como pubDate.

Com isso, está pronto o script para integrar os updates do twitter ao seu site, simples não?

Aguarde as próximas partes, elas virão…

24 comments   |  tags: