Utilisation des valves, génération du site web de l'ULB - format xml
sommairesommaireindexindexdébutdébutpage précédentepage précédentepage suivantepage suivanteimprimerimprimerenvoyerenvoyermarquermarquer

Un flux RSS comme source: <source-rss>

L'élément <source-rss> permet de sélectionner des actualités dans un flux RSS.

Attributs de <source-rss>

L'élément <source-rss> doit au minimum posséder l'attribut suivant:

  • href: qui donne l'URL de la source RSS;

Cet attribut peut être remplacé par tout autre attribut de lien hypertexte, pourvu que l'URL qui en résulte amène à un document au format RSS.


Dans notre exemple (voir le code ci-dessous), l'adresse mentionnée est celle de la "Une" du journal Le Soir.

Exemple
<valves maximum="2" style="class1">
  <source-rss href="http://www.lesoir.be/feed/La Une/destination_une_block"/>
</valves>
loading...ajax1

On peut également utiliser les attributs suivants (qui sont communs à toutes les sources):


  • maximum: qui indique le nombre d'information maximal à lire en une fois dans la source;

  • ordre: qui indique comment ordonner les informations (ordre chronologique, chronologique inverse, alphabétique, etc.) avant de les lire dans la source;

  • options: qui indique d'utiliser cette source de manière optionnelle, sur base d'une ou plusieurs options qui peuvent notamment être liées à l'Intranet;

  • catégories: pour aller chercher des informations dans une des catégories mentionnées;

  • identificateurs: pour aller chercher des informations précises, à l'aide de leur identificateur;

  • codes: pour aller chercher des informations précises, sur base d'un code placé dans leur titre;

  • mots-clés: pour aller chercher des informations qui contiennent l'un des mots-clés mentionnés;

  • priorités: pour aller chercher des informations dont la priorité est égale ou supérieure à celle mentionnée;

  • dates-publication: pour aller chercher des informations dont la date de publication est supérieure, égale ou inférieure à celle(s) mentionnée(s);

  • dates-modification: pour aller chercher des informations dont la date de modification est supérieure, égale ou inférieure à celle(s) mentionnée(s);

  • dates: pour aller chercher des informations dont la date de début et/ou la date de fin sont supérieures, égales ou inférieures à celle(s) mentionnée(s);


Sous-éléments de <source-rss>

Un élément <source-rss> peut contenir l'un ou l'autre des éléments suivants (qui sont communs à toutes les sources):



Les données disponibles dans un flux RSS

Dans un flux RSS, les données disponibles qui peuvent être sélectionnées pour l'affichage sont:


  • l'identificateur de l'actualité (en RSS, il est donné par l'élément <guid> de l'élément <item>. Il prend la forme d'une URL).

  • le titre de l'actualité (en RSS, il est donné par l'élément <title> de l'élément <item>);

  • le contenu de l'actualité (en RSS, il est donné par l'élément <description> de l'élément <item>). Celui-ci contient du code HTML. Ce code est "nettoyé" afin de rendre la mise en page homogène avec le reste du site de l'ULB;

  • l'aperçu de l'actualité n'est pas géré en RSS. Il est donc identique au contenu de l'actualité;

  • la vignette de l'actualité est recherchée dans le contenu. La première image trouvée dans le code HTML servira de vignette. Les autres images sont automatiquement effacées;

  • l'illustration sera identique à la vignette;

  • un ou plusieurs fichiers attachés à l'information (en RSS, ils sont donnés par l'attribut url des éléments <enclosure> contenus dans <item>);

  • le type de l'information sera toujours égal à "actualité". C'est le seul type d'information géré en RSS;

  • la priorité n'est pas gérée en RSS. Elle aura toujours la valeur 1;

  • une ou plusieurs familles de catégories (en RSS, elles sont donnés par l'élément <category> de l'élément <item>. Si cet élément <category> possède un attribut domain, celui-ci va servir à déterminer la famille de catégories à utiliser);

  • l'auteur de l'actualité (en RSS, il est donné par l'élément <author> de l'élément <item>);

  • la date de publication de l'actualité (en RSS, il est donné par l'élément <pubDate> de l'élément <item>);

  • la date de modification n'est pas gérée en RSS. Elle aura la même valeur que la date de publication;

  • la date de début n'est pas gérée en RSS. Elle aura la même valeur que la date de publication;

  • la date de fin n'est pas gérée en RSS. Elle aura la même valeur que la date de publication;

  • le lien de l'actualité (en RSS, il est donné par l'élément <link> de l'élément <item>);


Au niveau de la source, on retrouve également les données suivantes (ces données, qui peuvent être affichées pour chaque information, ne varient pas d'une information à l'autre):


  • le titre de la source (en RSS, il est donné par l'élément <title> de l'élément <channel>);

  • la description de la source (en RSS, il est donné par l'élément <description> de l'élément <channel>);

  • le lien de la source (en RSS, il est donné par l'élément <link> de l'élément <channel>);

  • la vignette de la source (en RSS, il est donné par l'élément <url> de l'élément <title> de l'élément <channel>);

  • la date de publication de la source (en RSS, il est donné par l'élément <pubDate> de l'élément <channel>);

  • la date de modification de la source (en RSS, il est donné par l'élément <lastBuildDate> de l'élément <channel>);

  • la date de lecture de la source est la date et l'heure à laquelle la source a été interrogée pour la dernière fois, qui peut différer de la date de publication (à cause du mécanisme de mise en cache).

Vous pouvez également donner une valeur par défaut ou forcer la valeur du titre, de la description, du lien et de la vignette de la source.


Catégories dans un flux RSS

Une information peut être classées dans une ou plusieurs catégories organisées en une ou plusieurs familles. Parmi ces familles, une joue le rôle de la famille principale (elle s'utilise sans identificateur).

Dans le cas de RSS, les catégories sont données par des éléments <category> de l'élément <item>. Ces éléments peuvent avoir un attribut domain qui spécifie un domaine pour ces catégories. La valeur de cet attribut domain sert à créer des familles différentes dans Sitemanager.

Les éléments <category> dont l'attribut domain est vide ou n'est pas présent servent à alimenter la famille principale.
sommairesommaireindexindexdébutdébutpage précédentepage précédentepage suivantepage suivante
ULB - entreprise écodynamique