On peut soit l’utiliser à l’intérieur d’une boucle SITES (cette dernière récupère une liste de sites référencés, ensuite on récupère chaque article de ces sites), soit directement à l’intérieur d’une rubrique (on récupère directement tous les articles syndiqués dans une rubrique, en court-circuitant le passage par la liste des sites).
La boucle
SITES(ouSYNDICATION) n’affiche pas uniquement des sites syndiqués, mais plus généralement des sites référencés (la syndication de certains sites référencés étant une option). On pourra donc, pour obtenir une présentation graphique plus précise, utiliser une boucleSYNDIC_ARTICLESuniquement à l’intérieur d’une boucleSITESutilisant le critère{syndication=oui}.
Les critères de sélection
On utilisera l’un ou autre des critères suivants pour indiquer comment on sélectionne les éléments.
- {tout}, tous les sites syndiqués.
- {id_syndic_article} retourne l’article syndiqué dont l’identifiant est id_syndic_article. (Dans la pratique, il y très peu d’intérêt à fabriquer une page pour un article syndiqué, puisqu’on préférera renvoyer directement vers l’article en question.)
- {id_syndic} retourne la liste des articles du site syndiqué dont l’identifiant est id_syndic.
- {id_rubrique} retourne la liste des articles syndiqués dans cette rubrique.
- {id_secteur} retourne la liste des articles syndiqués dans ce secteur.
Les critères d’affichage
Les critères communs à toutes les boucles s’appliquent.
Les balises de cette boucle
Les balises tirées de la base de données
Les balises suivantes correspondent aux éléments directement tirés de la base de données. Vous pouvez les utiliser également en tant que critère de classement (généralement : {!par date}).
- #ID_SYNDIC_ARTICLE affiche l’identifiant unique de l’article syndiqué.
- #ID_SYNDIC affiche l’identifiant unique du site syndiqué contenant cet article.
- #TITRE affiche le titre de l’article.
Remarque : il est préférable d’utiliser ici le titre « brut » de l’article syndiqué - via le code [(#TITRE*)] -, pour éviter le moteur typographique. En effet les titres sont censés être déjà « typographiquement corrects » dans les backends, et on ne souhaite pas passer la correction typographique sur des titres en anglais ou sur des titres comprenant des expressions du genre « Les fichiers ~/.tcshrc ».
- #URL_ARTICLE affiche l’URL de l’article syndiqué (sur son site d’origine).
- #DATE affiche la date de publication de cet article.
- #LESAUTEURS affiche les auteurs de l’article syndiqué.
- #DESCRIPTIF affiche le descriptif de l’article syndiqué.
- #NOM_SITE affiche le nom du site syndiqué contenant cet article.
- #URL_SITE affiche l’adresse (URL) du site
- #TAGS affiche les tags de l’article syndiqué, voir la balise #TAGS. Des filtres dédiés s’appliquent à cette balise et en facilitent l’usage :
- #SOURCE et #URL_SOURCE contiennent respectivement le nom et l’url de la véritable source de l’article, qui peuvent être différents de #NOM_SITE et #URL_SITE (par exemple lorsque le site syndiqué est un agrégateur de contenus). Ces 2 champs ne sont pas toujours renseignés.
- #RAW_DATA renvoie l’ensemble de la partie du flux RSS relative à l’article courant
-
#RAW_DATA*renvoie l’item brut, au format texte, tel que lu dans le flux -
#RAW_DATArenvoie l’item au format tableau structuré, s’il a pu être décodé sous cette forme -
#RAW_DATA{x}renvoie#RAW_DATA|table_valeur{x} -
#RAW_DATA{a/b}renvoie#RAW_DATA|table_valeur{a/b}