SPIP

[ar] [ast] [bg] [br] [ca] [co] [cpf] [cs] [da] [de] [en] [eo] [es] [eu] [fa] [fon] [fr] [gl] [id] [it] [ja] [lb] [nl] [oc] [pl] [pt] [ro] [ru] [sk] [sv] [tr] [vi] [zh] Espace de traduction

Télécharger

La boucle SITES (ou SYNDICATION)

Mai 2001 — mis à jour le : Décembre 2012

Toutes les versions de cet article :

La boucle SITES retourne une liste de sites référencés.

<BOUCLEn(SITES){critères...}>


Si l’on a syndiqué des sites référencés, cette boucle s’utilise, naturellement, associée à une boucle SYNDIC_ARTICLES qui permet de récupérer la liste des articles de ces sites.

Historique : Avant SPIP 1.3, cette boucle était nommée SYNDICATION, car seuls des sites syndiqués pouvaient être référencés.
<BOUCLEn(SYNDICATION){critères...}>
Les deux dénominations sont rigoureusement équivalentes (mais « SITES » correspond mieux au fait que, depuis la version 1.3 de SPIP, il s’agit d’un système de référencement de sites, la syndication étant une option).

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} sélectionne tous les sites référencés.

-  {id_syndic} sélectionne le site référencé dont l’identifiant est id_syndic.

-  {id_rubrique} sélectionne les sites référencés dans cette rubrique.

-  {id_secteur} sélectionne les sites référencés dans ce secteur.

-  {id_mot} (depuis SPIP 1.3) sélectionne toutes les sites liés au mot-clé indiqué par le contexte (boucle (MOTS) englobante, paramètre d’URL etc).

-  {titre_mot=xxxx}, ou {type_mot=yyyy} (depuis SPIP 1.3) sélectionne les sites liés au mot-clé dont le nom est « xxxx », ou liés à des mots-clés du groupe de mots-clés « yyyy ». Si l’on donne plusieurs critères {titre_mot=xxxx} (ou plusieurs {type_mot=yyyy}), on sélectionnera ceux qui auront tous ces mots à la fois (nouveauté de SPIP 1.9).

-  {id_groupe=zzzz} (depuis SPIP 1.4 ) permet de sélectionner les sites liés à un groupe de mots-clés ; principe identique au {type_mot} précédent, mais puisque l’on travaille avec un identifiant (numéro du groupe), la syntaxe sera plus « propre ».

Les critères d’affichage

Les critères communs à toutes les boucles s’appliquent.

-  {syndication=oui}, ou {syndication=non} (depuis SPIP 1.3) permet de n’afficher que les sites référencés faisant l’objet d’une syndication, ou les sites non syndiqués.

-  {moderation=oui} (depuis SPIP 1.4 ) affiche les sites syndiqués dont les liens sont bloqués a priori (« modérés ») ; l’inverse de ce critère est {moderation!=oui}.

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 nom_site}).

-  #ID_SYNDIC affiche l’identifiant unique du site référencé. Par exemple pour renvoyer vers la page décrivant le site (site.html sur la /dist) avec le code suivant :

<BOUCLE_sites(SITES) {id_rubrique} {par nom_site}>
<li><a href="[(#ID_SYNDIC|generer_url_entite{site})]">#NOM_SITE</a></li>
</BOUCLE_sites>

Attention ! : Ce code n’est valable que pour les versions de SPIP > 2.0.0. Pour les versions antérieures de SPIP, il faudra utiliser le code suivant :

<BOUCLE_sites(SITES) {id_rubrique} {par nom_site}>
<li><a href="[(#ID_SYNDIC|generer_url_site)]">#NOM_SITE</a></li></BOUCLE_sites>

-  #NOM_SITE affiche le nom du site référencé.

-  #URL_SITE affiche l’adresse (URL) du site référencé.

-  #DESCRIPTIF affiche le descriptif du site référencé.

-  #ID_RUBRIQUE affiche le numéro de la rubrique contenant ce site.

-  #ID_SECTEUR affiche le numéro de la rubrique-secteur (à la racine du site) contenant ce site.

Autres balises

-  #LOGO_SITE affiche le logo attribué au site.

-  #URL_SYNDIC affiche l’adresse (URL) du fichier de syndication de ce site.

-  #FORMULAIRE_FORUM fabrique et affiche le formulaire permettant de poster un message de forum à propos de ce site. Pour en savoir plus, voir aussi « Les formulaires ».

-  #PARAMETRES_FORUM fabrique la liste des variables exploitées par l’interface du formulaire permettant de poster un message de forum à propos de ce site. Par exemple :
[<a href="spip.php?page=forum&(#PARAMETRES_FORUM)">Répondre à ce forum</a>]

Depuis [SPIP 1.8.2] on peut lui passer un paramètre spécifiant l’adresse de retour après avoir posté le message. Par exemple : <a href="spip.php?page=forum&(#PARAMETRES_FORUM{#SELF})">Répondre à ce message</a> renverra le visiteur sur la page actuelle une fois que le message a été validé.

Historique : Dans les versions antérieures à SPIP 1.9 il aurait fallu écrire forum.php3? et non spip.php?page=forum&

De façon générale jusqu’à SPIP 1.9, les urls des pages générées par SPIP étaient de la forme http://monsite.net/xxx.php3 et non pas http://monsite.net/spip.php?page=xxx.


Voir le squelette de cette page Site réalisé avec SPIP | Espace de traduction | Espace privé