Se houverem sites referenciados, este loop é usado, naturalmente, associado a um loop SYNDIC_ARTICLES, que permite recuperar a lista de matérias desses sites.
Os critérios de seleção
Usa-se um ou outro dos seguintes critérios para definir como os elementos são selecionados.
- {tout} seleciona todos os sites referenciados.
- {id_syndic} seleciona o site referenciado com o identificador {id_syndic}.
- {id_rubrique} seleciona os sites referenciados da seção corrente.
- {id_secteur} seleciona os sites referenciados do setor corrente.
- {id_mot} seleciona todos os sites vinculados à palavra-chave indicada pelo contexto (boucle (MOTS) envolvente, parâmetro do URL etc.).
- {titre_mot=xxxx}, ou {type_mot=yyyy} seleciona os sites vinculados à palavra-chave cujo nome é «xxxx», ou vinculados às palavras-chave do grupo de palavras-chave «yyyy». Se usarmos vários critérios {titre_mot=xxxx} (ou vários {type_mot=yyyy}), serão selecionados de uma vez os sites que estejam vinculados a todas essas palavras-chave.
- {id_groupe=zzzz} permite selecionar os sites vinculados a um grupo de palavras-chave; mesmo princípio do {type_mot}precedente, mas como se usa um identificador (número de grupo), a sintaxe será mais «limpa».
Os critérios de exibição
Os critérios comuns a todos os loops são aplicáveis.
- {syndication=oui}, ou {syndication=non} permite exibir apenas os sites referenciados que são sindicados, ou os sites não sindicados. Um eventual valor off assinala que um erro de sindicação foi detectado.
- {moderation=oui} exibie os sites sindicados em que os links são bloqueados a priori («moderados»); o inverso deste critério é {moderation!=oui}.
As tags deste loop
As tags extraídas da base de dados
As tags a seguir correspondem diretamente aos elementos extraídos da base de dados. Voce pode usá-las igualmente como critério de ordenação (geralmente {par nom_site}).
- #ID_SYNDIC exibe o identificador único do site referenciado. Por exemplo, para remeter para a página que descreve o site (site.html em /dist) com o código a seguir:
<BOUCLE_sites(SITES) {id_rubrique} {par nom_site}>
<li><a href="[(#ID_SYNDIC|generer_url_entite{site})]">#NOM_SITE</a></li>
</BOUCLE_sites>
- #NOM_SITE exibe o nome do site referenciado.
- #URL_SITE exibe o endereço (URL) do site referenciado.
- #DESCRIPTIF exibe a descrição do site referenciado.
- #ID_RUBRIQUE exibe o número da seção a que pertence o site referenciado.
- #ID_SECTEUR exibe o número do setor (na raiz do site) a que pertence o site referenciado.
Outras tags
- #LOGO_SITE exibe o logo atribuído ao site.
- #URL_SYNDIC exibe o endereço (URL) do ficheiro de sindicação do site.
- #FORMULAIRE_FORUM monta e exibe o formulário que permite postar uma mensagem de fórum a propósito do site. Para saber mais, veja também «Os formulários».
- #PARAMETRES_FORUM monta a lista devariáveis usadas pela interface do formulário que permite postar uma mensagem de fórum a propósito do site. Por exemplo:
[<a href="spip.php?page=forum&(#PARAMETRES_FORUM)">Responder a este fórum</a>]
Pode-se passar um parâmetro especificando o endereço de retorno após a postagem da mensagem.
Por exemplo:
<a href="spip.php?page=forum&(#PARAMETRES_FORUM{#SELF})">Responder a esta mensagem</a>
direcionará o visitante para a página corrente, uma vez que a mensagem seja validada.
Ver também: o loop SYNDIC_ARTICLES.