Création / modification d'un flux RSS

Définition

Créer un flux RSS pour un objet polymod permet de générer un flux RSS contenant un ensemble de données.
Généralement il s'agit d'afficher la liste des derniers éléments publiés.

Pour accéder à l'édition d'un flux RSS, sélectionnez un objet depuis l'interface de gestion des modules, puis cliquez sur "nouveau", ou "modifier".

Flux RSS : fenêtre

 

Il est possible de créer plusieurs flux RSS pour chaque objet créé avec le générateur de modules Polymod : leur nombre n'est pas limité.

Propriétés

Lors de l'édition d'un flux RSS, les champs suivants sont disponibles :

Flux RSS : propriétés

Titre :

Permet de donner un nom au flux RSS. Cela permettra de désigner le flux parmi l'ensemble des flux disponibles pour un objet polymod.

Description :

Permet de décrire plus précisément le flux RSS. Chaque flux possède souvent un affichage différent, la description peut par exemple être utile pour désigner l'affichage qui correspond au flux.

Adresse vers le site du fil :

Un flux RSS peut être utilisé en dehors de votre application, dès lors, si un utilisateur souhaite accéder à l'information source, il clique généralement sur le lien présent sur un élément du flux. Ce lien est défini avec le champ « Adresse vers le site du fil ».
Par défaut le site correspond à l'adresse du site actuel.

Auteur :

Permet d'indiquer l'auteur du flux RSS.
Vous pouvez par exemple indiquer le nom de votre site, ou le nom du responsable du flux.

Email de l'auteur :

Permet d'indiquer l'email de l'auteur pour que les utilisateurs puissent le contacter si nécessaire.

Copyright :

Permet de spécifier un copyright.

Catégories :

Liste de termes séparés par des virgules permettant de catégoriser le fil RSS.

Intervalle de mise à jour et fréquence :

Permet aux lecteurs de fils RSS d'avoir une valeur indicative concernant la fréquence de mise à jour du fil.
Par défaut : 1 fois par jour, minimum : 2 fois par heure

Définition XML :

Permet de définir les informations à afficher par le flux RSS.

Il s'agit du coeur du flux RSS : lorsque l'utilisateur accède au flux via un lien ou via un lecteur de flux, les informations qu'il récupère sont le résultat de cette définition XML.

Par exemple on peut choisir d'afficher la liste des dernières actualités publiées.
Pour cela il suffit d'effectuer une recherche sur l'objet Actualites, puis d'ordonner les résultats par date de publication inversée.

Il est commun de mettre un lien vers une page de détail de l'actualité, au cas où le lecteur souhaiterait en savoir davantage.

 

Une aide dynamique est présente sur la page d'édition d'un flux RSS, pour créer votre flux en toute simplicité.

Exemple de définition XML :

<atm-rss language="fr">
    <atm-search what="{Blog}" name="rss">
        <atm-search-order search="rss" type="publication date after" direction="desc" />
        <atm-result search="rss">
            <atm-rss-item>
                <atm-rss-item-url>{page:5:url}?item={Blog:id}</atm-rss-item-url>
                <atm-rss-item-title>{Blog:Titre:value}</atm-rss-item-title>
                <atm-rss-item-content>
                    {Blog:Introduction:htmlvalue}
                    <atm-if what="{Blog:Texte:value}">
                        <a href="{page:5:url}?item={Blog:id}" title="En savoir plus concernant '{Blog:label}'">Lire la suite</a>
                    </atm-if>
                </atm-rss-item-content>
                <atm-rss-item-date>{Blog:formatedDateStart|rss}</atm-rss-item-date>
            </atm-rss-item>
        </atm-result>
    </atm-search>
</atm-rss>

Utilisation :

Une fois qu'un flux RSS a été créé, il est intéressant de créer un lien pour l'utiliser et/ou indiquer aux utilisateurs du site qu'un tel flux existe. Cela leur permettra notamment de s'y abonner.

Le lien est construit de la forme suivante :

http://votreSiteWeb/rss/rss.php?id=idDuFluxRSS
Le paramètre "id" indiqué dans l'URL permet de définir quel flux le fichier rss.php devra afficher.

Vous trouverez la liste des identifiants disponibles pour un objet depuis l'aide dynamique de cet objet : consultez l'aide de cet objet (depuis une rangée quelconque) et cliquez sur cet objet pour voir s'afficher l'aide sur les flux RSS.

Par exemple, pour un objet « Actualite », je me rend sur une rangée quelconque, puis dans  "Definition XML", puis je clique sur "Aide" et enfin je clique sur l'onglet correspondant au module "Actualites".
Là je sélectionne mon objet « Actualite » dans la liste déroulante. Une aide dynamique s'affiche et je peux voir, sous la rubrique « Fonctions de l'objet : » , la liste des flux RSS disponibles avec leurs identifiants respectifs.

Créer le lien vers un flux RSS

Le lien vers le fichier rss.php est généralement intégré depuis une rangée polymod au moyen du tag suivant :

<atm-function function="rss" object="{Actualites}" selected="rssId" attributeName="attributeValue">
    <a href="{url}" title="{description}">{label}</a>
</atm-function>

En exemple, voici le lien vers le flux RSS du site d'Automne : Lire tous les billets RSS

 



Ajouter une contribution :

Les contributions servent à compléter la documentation en détaillant des points précis ou pour donner des exemples. Elles sont modérées et peuvent être supprimées sans préavis.
Pour poser des questions, merci d'employer le forum et pour rapporter un bug, le BugTracker est à votre disposition.








Vous pouvez employer les balises bbcode suivantes :
  • [code-xml] votre code ... [/code-xml] : Pour mettre en forme du code XML / XHTML
  • [code-php] votre code ... [/code-php] : Pour mettre en forme du code PHP
  • [code-js] votre code ... [/code-js] : Pour mettre en forme du code Javascript

Date de votre contribution : 24/04/2017   15:24:01

Haut