You can either use it inside a SITES loop (the outer loop lists the referenced sites, and the inner loop lists each article for those sites), or simply inside a section (this recovers directly all the syndicated articles in a section, bypassing the list of the sites).
(SPIP 1.3) Starting from version 1.3 of SPIP, the SITES loop (or the SYNDICATION loop) no longer displays syndicated sites alone, instead it now displays all referenced sites (the syndication of referenced sites being an option). You could, for example, obtain a more graphical display, by using a SYNDIC_ARTICLES loop inside a SITES loop using the criterion {syndication=oui}
.
Selection Criteria
You can use one or other of the following criteria to indicate which articles are selected.
- {tout}
, for all syndicated articles.
- {id_syndic_article}
returns the syndicated article identified by id_syndic_article. (In practice, it is of little interest to create a page for a syndicated article, normally you would link directly to the article in question.)
- {id_syndic}
returns a list of the articles for the syndicated site identified by id_syndic.
- {id_rubrique}
returns a list of the syndicated articles in this section.
- {id_secteur}
returns a list of the syndicated articles in this sector.
Display Criteria
You can use any of the criteria applicable to all loops.
Tags of this loop
- Tags drawn from the database
The following tags correspond to the elements directly drawn from the database. You can generally use them as sorting criteria too (for example {par titre}
to sort by title).
- #ID_SYNDIC_ARTICLE
displays the unique identifier of the syndicated article.
- #ID_SYNDIC
displays the unique identifier of the syndicated site containing the article.
- #TITRE
displays the title of the article.
Note: It is preferable here to use the raw title of the syndicated article - by using square brackets notation [(#TITRE*)]
- in order to bypass the typographical engine. Indeed, titles are supposed to be "typographically correct" in the back-end files and passing them through the typographical engine may affect the title, especially for English titles or those including expressions such as "The ~/.tcshrc files".
- #URL_ARTICLE
displays the address (URL) of the syndicated article on its original site.
- #DATE
displays the publication date of this article.
- #LESAUTEURS
displays the authors of the syndicated article.
- #DESCRIPTIF
displays the description of the syndicated article.
- #NOM_SITE
displays the name of the syndicated site containing this article.
- #URL_SITE
displays the URL address of the site containing this article.