Como atribuir notícias RSS ao seu site usando ATOM e PHP

Colaboração: Roberson Carlos Fox

Data de Publicação: 04 de Julho de 2006

Atom é o nome dado a um estilo baseado em conteúdo XML e meta data, ou seja, é um protocolo em nível de aplicação para publicar e editar fontes web que são periodicamente atualizados, um exemplo para isto são os blogs.

Os feeds devem ser formados em formato XML e são identificados como application/atom+xml media type.

O funcionamento dele não difere das Markup Languages tradicionais, com cabeçalhos, títulos e corpo, como no HTML 4.0.

Elementos do Feed (Cabeçalho)

Um feed consiste de alguns Metadata seguidos por alguns números de entrada. Todo feed deve conter um cabeçalho.

  <?xml version="1.0" encoding="utf-8"?>
  <feed xmlns="http://www.w3.org/2005/Atom">
  
  <title>Genova Home Page - News Feed</title>
  <link href=http://www.genova.einet.com.br/>
  <updated>2006-01-05 3:05:47</updated>
  
  <author>
  <name>Roberson Carlos Fox</name>
  <email>robersonfox@genovaengine.com</email>
  <uri>http://www.genova.einet.com.br/about-me</uri>
  </author>
  
  <id>http://www.genova.einet.com.br</id>
  <icon>http://www.genova.einet.com.br/img/genova.ico</icon>
  <logo>http://www.genova.einet.com.br/img/G3.jpg</logo>
  <rights> © 2002-2006 Roberson Carlos Fox </rights>
  <subtitle>Esteja atualizado com o que há de melhor na web</subtitle>
  <category term=Informática/>
  </feed>

Elementos requeridos do cabeçalho:

Abaixo se segue uma lista com os principais elementos requeridos em um feed e um exemplo.

• ID, Identifica o Feed usando um universal e permanente URL, você pode colocar seu Nome de Domínio nesta parte. Ex.:

    <id>http://www.genova.einet.com.br</id>
  

• Title, contem o título do Feed, este valor não pode ser deixado em branco de maneira alguma. Ex.:

    <title>Genova Home Page - News Feed</title>
  

Elementos recomendados:

• Author, nome do autor do Feed, um feed pode ter inúmeros autores e um feed precisa ter ao menos um autor. Ex.:

    <author>
    <name>Roberson Carlos Fox</name>
    <email>robersonfox@genovaengine.com</email>
    <uri>http://www.genova.einet.com.br/about-me</uri>
    </author>
  

• Link, identifica uma HP relacionada, o tipo de relação é atribuído pode atributo rel. Ex.:

    <link rel="self" href=" http://www.genova.einet.com.br/" />
  

Elementos (Entradas) do Corpo (ENTRY)

Um exemplo de uma entrada seria um único post em um site.

  <entry>
  <title>Título do artigo</title>
  <link href=http://www.genova.einet.com.br/artigos.php?id=46/>
  <id>http://www.genova.einet.com.br/artigos.php?id=46/</id>
  <updated>05-01-2006 02:56:00</updated>
  <summary>Descrição do artigo</summary>
  <author>
  <name>Roberson Carlos Fox</name>
  </author>
  </entry>

Elementos requeridos do corpo:

Aqui esta uma lista de elementos requeridos para o Feed, cada um tem uma breve descrição e é seguido de um exemplo, como no tópico acima.

• ID, Title, tem o mesmo significado que o do cabeçalho, salvo que eles se referem ao artigo e não ao Feed. Ex.:

    <id>http://www.genova.einet.com.br/artigos.php?id=46</id>
  

• Updated, Indica quando foi a ultima vez que a entrada foi modificada. Ex.:

    <updated>05-01-2006 02:56:00</updated>
  

Neste parte ainda cabem os elementos link e author que funcionam da mesma forma que no cabeçalho e como já foi dito, salvo que eles fazem referencia ao artigo e não ao Feed.

Uma entrada interessante é a:

Source, ela, a entrada, é usada para se referir a documentos copiados de outros Sites, assim seria como se falássemos que a fonte foi de outro local. Ex.:

  <source>
  <id>http://example.org/</id>
  <title>Fourty-Two</title>
  <updated>2003-12-13T18:30:02Z</updated>
  <rights>© 2005 Example, Inc.</rights>
  </source>

Exemplo de feed

  <?xml version="1.0" encoding="utf-8"?>
  
  <feed xmlns="http://www.w3.org/2005/Atom">
  
  <title>Genova Home Page - News Feed</title>
  <link href=http://www.genova.einet.com.br/>
  <updated>2006-01-05 3:05:47</updated>
  
  <author>
  <name>Roberson Carlos Fox</name>
  <email>robersonfox@genovaengine.com</email>
  <uri>http://www.genova.einet.com.br/about-me</uri>
  </author>
  
  <id>http://www.genova.einet.com.br</id>
  <icon>http://www.genova.einet.com.br/img/genova.ico</icon>
  <logo>http://www.genova.einet.com.br/img/G3.jpg</logo>
  <rights> © 2002-2006 Roberson Carlos Fox </rights>
  <subtitle>Esteja atualizado com o que há de melhor na web</subtitle>
  <category term=Informática/>
  
  <entry>
  <title>Título do artigo1</title>
  <link href=http://www.genova.einet.com.br/artigos.php?id=46/>
  <id>http://www.genova.einet.com.br/artigos.php?id=46/</id>
  <updated>05-01-2006 02:56:00</updated>
  <summary>Descrição do artigo1</summary>
  <author>
  <name>Roberson Carlos Fox</name>
  </author>
  </entry>
  
  <entry>
  <title>Título do artigo2</title>
  <link href=http://www.genova.einet.com.br/artigos.php?id=47/>
  <id>http://www.genova.einet.com.br/artigos.php?id=47/</id>
  <updated>06-01-2006 01:36:00</updated>
  <summary>Descrição do artigo2</summary>
  <author>
  <name>Roberson Carlos Fox</name>
  </author>
  </entry>
  
  </feed>

Colocando as coisas para funcionar com PHP

Como você pode notar, as entradas em um Feed podem vir de um banco de dados e ocupar muito espaço no feed, o bom seria pegar os últimos 15 posts do site em questão e enviá-los para uma variável fazendo uso de um loop como no exemplo:

  <?php
  $tabela := "artigos";
  $data=date("Y-d-m G:i:s");
  
  // Conecta ao banco de dados MySQL
  $db=mysql_connect($host, $sql_login ,$sql_passwd);
  mysql_select_db ($nome_bd);
  
  //estou assumindo que a tabela
  //chame-se artigos na variável $tabela
  $sql="SELECT * FROM $tabela ORDER by ID desc";
  
  $resultado = mysql_query($sql,$db);
  
  if (mysql_numrows($resultado)){
  $a1=0;
  while (($linha = mysql_fetch_row($resultado)) and ($a1!=15)) {
  $a1=$a1+1;
  $conteudo.="
  <entry>
  <title>$linha[4]</title>
  <link href=http://www.genova.einet.com.br/artigos.php?id=$linha[0]/>
  <id>http://www.genova.einet.com.br/artigos.php?id=$linha[0]/</id>
  <updated>$linha[3]</updated>
  <summary>$linha[5]</summary>
  <author>
  <name>$linha[1]</name>
  </author>
  </entry> ";
  }
  }
  
  mysql_free_result($resultado);
  if ($db){
  mysql_close($db);
  }
  ?>
  //Estou assumindo que a
  //Linha 4 = Título
  //Linha 0 = ID do artigo
  //Linha 3 = Data
  //Linha 5 = Descrição
  //Linha 1 = Autor
  //Faça as alterações de forma que seu script funcione. ?>

Este simples script irá pegar os dados do banco de dados e criar as entradas, uma por uma, até um total de 15 entradas de acordo com a variável $a1. Em seguida você deverá adicionar o cabeçalho do Feed:

  <?php
  header("Content-Type: text/xml");
  echo" <?xml version="1.0" encoding="utf-8"?>
  <feed xmlns="http://www.w3.org/2005/Atom">
  <title>Genova Home Page - News Feed</title>
  <link href=http://www.genova.einet.com.br/>
  <updated>$data</updated>
  
  <author>
  <name>Roberson Carlos Fox</name>
  <email>robersonfox@genovaengine.com</email>
  <uri>http://www.genova.einet.com.br/about-me</uri>
  </author>
  
  <id>http://www.genova.einet.com.br</id>
  <rights> © 2002-2006 Roberson Carlos Fox </rights>
  <subtitle>Esteja atualizado com o que há de melhor na web</subtitle>
  <category term=Informática/>
  
  $conteudo;
  
  </feed>"
  ?>

Por fim, uma atenção especial para a variável "conteudo", ela é gerada no primeiro script e armazena as entradas do Feed.

Com estas poucas informações você com certeza será capaz de criar um RSS em seu site.