Accueil Boite à Outils Syndication de contenu Lecteur RSS/Atom pour votre site 1/2

Publié le : 30 août 2005
Imprimer Imprimer cet article

Auteur :
Alain Sichel

Alain Sichel
Lecteur RSS/Atom pour votre site 1/2
1) Lecteur avec interface simple

Cet article fait suite à la présentation de La syndication de contenu RSS et d’Afficher un fil RSS/Atom sur votre site 1/3, 2/3 et 3/3. Il propose de réaliser un lecteur permettant à vos visiteurs d’afficher le fichier de syndication de leur choix [1].

Le choix pour ce lecteur

J’avais présenté un lecteur de ce type il y a quelque mois [2] qui utilisait MagpieRSS et EasyRSS.

Ces lecteurs sont efficaces, mais avec la version 2 de fil_LE on dispose d’un lecteur plus rapide, plus efficace et plus facile à mettre en œuvre.

Le lecteur de fichier de syndication proposé ici est simple d’emploi pour le visiteur, avec simplement un formulaire pour saisir l’adresse du fichier de syndication à afficher et un bouton radio pour sélectionner le choix du script (MagpieRSS ou EasyRSS).

Je demande au script d’afficher le titre du site (avec un lien), le logo du site, les 20 derniers articles publiés (il ne présentera que ceux qui ont été trouvés si le fichier de syndication contient moins de 20 articles), et pour chaque article d’indiquer (si ces données sont disponibles) :
- la date de publication,
- l’auteur,
- le titre de l’article (avec lien),
- la catégorie de l’article,
- la description de l’article (pour simplifier l’affichage, les images sont supprimées).

Le code complet

Le principe de ce lecteur de fichiers de syndication applique ce qui est décrit dans Afficher un fil RSS/Atom sur votre site 1/3, je vous renvoie donc à cet article si vous voulez des explications sur le code, avec en plus un formulaire pour indiquer l’URL du fichier à lire. Voici le code pour installer dans une de vos pages [3] :

<?php
if(isset($_POST["adresse"])) {
$adresse = ($_POST["adresse"]);
if (preg_match("#^http://.([\w./-]+)$#i",$adresse,$ret)) {
$fil = $ret[0];

// fonctions de nettoyage du texte récupéré

function clean_text($text) {
        $text = str_replace('&lt;','<',$text);
        $text = str_replace('&gt;','>',$text);
        $text = str_replace('&quot;','"',$text);
        $text = str_replace('&','&',$text);
        if ($encodage == 'utf-8') {
                $text = utf8_decode($text);
        }
        return $text;
}

function clean_date($date)
{
        // si 'AAAA-MM-JJTHH:MM:SS+00:00' ou 'AAAA-MM-JJTHH:MM:SSZ'
   if (ereg("^[0-9]",$date) and  ereg("(([[:digit:]]|-)*)T(([[:digit:]]|:)*)[^[:digit:]].*",$date,$temp)) {
                $date = $temp[1].' '.$temp[3];
        }
        $date = date('d/m/Y', strtotime($date));
        return $date;       
}

include 'rss_read.inc.php';

// créer l'instance
$rss = new rss_read();

// caractères parasites pouvant être contenus dans le fils rss et à remplacer par d'autres, doit être invoqué avant parsefile
// cette fonction est optionnelle et ne doit être utilisée que pour certains fils.
$avant = array('&#8217 ;', '&bull;');
$apres = array("'", '- ');
$rss -> to_replace_with($avant, $apres);

// parser le fichier news avec éventuellement un nombre max
$rss -> parsefile($fil,20);

if (!$rss) {
        exit('</a>Fichier rss incorrect !<sup>[<a href="#note1">1</a>]</sup>');
}

// recupération de l'encodage du fil iso ou utf vide si celui-ci n'est pas indiqué
$encode = $rss -> get_encoding();

// recupération des données sur le channel
$channel = $rss -> get_channel();

if ($rss -> exist_image()) {
        $image = $rss -> get_image();
        echo '<table width="100%" border="0"><tr><td width="50%"><h4 align="center"><a href="'.$channel['link'].
                '" target="_blank" title="Lien externe">'.clean_text($channel['title'], $encode)."</a></h4></td>\n<td><center><a href=\""
                .$image['link'].'" target="_blank" title="Lien externe" class="ext"><img src="'.$image['url'].
                '" border="0" alt="'.$image['title']."\"></a></center></td></tr></table>\n"; }
else { echo '<h4 align="center"><a href="'.$channel['link'].'" target="_blank" title="Lien externe">'.clean_text($channel['title'], $encode)."</a></h4>\n"; }

// nombre d'items    
$nbnews = $rss -> get_num_items();

// recup array des données
$items = $rss -> get_items();

// pour affichage des dates au format français
echo "<ul>\n";
for($i = 0; $i < $nbnews; $i++) {
        echo '<li>';
        if (trim($items[$i]['pubdate'])!='') {
                echo '<b>',clean_date(trim($items[$i]['pubdate'])),'&nbsp;:</b> ';
        }
        if (trim($items[$i]['author'])!='') {
                echo '<span class="vert">',clean_text($items[$i]['author'], $encode),'&nbsp;:</span> ';
        }
        elseif (trim($items[$i]['dc:creator'])!='') {
                echo '<span class="vert">',clean_text($items[$i]['dc:creator'], $encode),'&nbsp;:</span> ';
        }
        echo '<a class="ext" title="Lien externe" href="',$items[$i]['link'],'" target="_blank">',clean_text($items[$i]['title'], $encode),'</a>';
        if (trim($items[$i]['category'])!="") { echo " <b>(".clean_text($items[$i]['category'], $encode).")</b>"; }
        if (trim($items[$i]['description'])!='') {
                echo '&nbsp;:<br />'.clean_text($items[$i]['description'], $encode);
        }
        echo "</li>\n";
}
echo "</ul>\n";

// formulaire si textinput existe
if($rss -> exist_textinput()) {
        $textinput = $rss -> get_textinput();
                echo '<form  method="get" action="',$textinput['link'],'">',
                $textinput['description'],'&nbsp;
                <input type="text" name="',$textinput['name'],
                '"size="10" maxlength="10">&nbsp;<input type="submit" name="Submit"
                value="',$textinput['title'],'">
                </form>';
}             

}
else {echo "<p class=\"rouge\">L'adresse indiquée n'est pas valide, essayez à nouveau :</p>\n<br />";}
}
?>
<br /><form action="<?php echo $PHP_SELF ?>" method="post"><center>
         <table border="0" class="tourvert" cellspacing="0" cellpadding="10">
           <tr>
             <td>Adresse du fichier de syndication :
                 <input type="text" name="adresse" size="50" value="<?php if(isset($_POST["adresse"])) {echo $fil;
                        $nouv="<p>Pour lire un nouveau fichier de syndication, tapez son adresse ci-dessus.</p>";} ?> onfocus="this.value='http://'" /></td>
           </tr>
           <tr>
             <td><center><input type="submit" name="Submit" value="Envoi" alt="Envoi" style="background-color:#00ff00" title="Envoi"  />
               </center></td>
           </tr>
         </table>
</center></form><?php echo $nouv ?>

Avec en plus en bas de page la note :

<a name="note1"></a><ol>
<li>En cas de difficulté, il est possible que le fichier ne soit pas conforme. Pour le vérifier, voyez <a class="ext" title="Lien externe" href="http://feedvalidator.org/" target="_blank">Feed Validator</a> ou <a class="ext" title="Lien externe" href="http://rss.scripting.com/" target="_blank">RSS Validator</a>.</li>
         </ol>

Ce script est simple à mettre en œuvre, il est prêt à fonctionner, à condition de ne pas oublier :

- qu’il s’agit d’une page PHP [3],
- que vous avez téléchargé et installé rss_read.inc.php [4]
- le code indiqué suppose que la page est dans le même dossier que le fichier rss_read.inc.php [5],

Voilà, vous avez tout pour que cela fonctionne. Maintenant, si vous avez lu Afficher un fil RSS/Atom sur votre site 2/3 vous savez qu’on peut aller plus loin et corriger le code pour un meilleur affichage, nous verrons cette possibilité adaptée au lecteur proposé à vos visiteurs dans un second article.

 

 

[1] Ce script a été mis au point pour le site du CYES, il peut être testé sur la page Lecteur RSS. La page choix techniques présente aux webmestres les différentes techniques mises en œuvre pour ce site.

[2] Voir Un lecteur RSS pour votre site 1/2 et 2/2.

[3] Le code du script et de la note en bas de page peuvent être téléchargés en bas de cette page.
Bien sûr, pour que ce script fonctionne il faut le mettre sur une page avec l’extension .php ou .php3, elle-même placée sur un serveur interprétant le PHP.

[4] Les fichiers de la classe read de fil_LE sont téléchargeables ici.

[5] Sinon, il faut modifier include 'rss_read.inc.php'; en précisant le chemin vers ce fichier.


Document joint à l'article

Lecteur.zip - Ce document contient le script et la note de pas de page.

Cliquez ici pour réagir à cet article

 Imprimer Imprimer cet article


Réactions à l'article :