Os critérios de seleção
Usa-se um ou outro dos seguintes critérios para definir como os elementos são selecionados.
- {tout}: as matérias são selecionadas em todo o site (em todas as seções). Especialmente útil para exibir as matérias mais recentes (de todo o site) na página inicial. [Na realidade, o critério «tout» não é processado de maneira informática: é um lembrete para o webmaster; pode-se obter o mesmo resultado quando não se aplica nenhum dos critérios a seguir.]
- {id_article}seleciona a matéria em que o identificador é id_article. Como o identificador de cada matéria é único, este critério retorna um ou zero resposta.
- {id_rubrique} seleciona as matérias que pertencem à seção corrente.
- {id_secteur} seleciona as matérias do setor corrente (um setor é uma seção que não depende de nenhuma outra seção, ou seja, situada na raiz do site).
- {branche} seleciona as matérias da seção corrente e das suas subseções. É uma espécie de extensão do critério {id_secteur}. No entanto, em vez de {id_secteur=2}, não é possível chamar diretamente uma ramificação usando, por exemplo {branche=2}: em termos técnicos, é preciso que a seção em questão figure no contexto corrente. Este critério deve ser usado com parcimónia: se o seu site estiver bem estruturado, não deverá precisar dele, excepto em casos muito particulares.)
- {id_auteur} seleciona as matérias correspondentes a este identificador de autor (útil para definir a lista das matérias escritas por um autor).
- {id_mot} seleciona as matérias vincuoladas à palavra-chave com este identificador (útil para definir a lista das matérias que tratam de um determinado assunto).
- {titre_mot=xxxx}, ou {type_mot=yyyy} seleciona respectivamente as matérias vinculadas à palavra-chave com o nome «xxxx», ou vinculadas às palavras-chave do grupo de palavras-chave «yyyy». Se usar vários critérios {titre_mot=xxxx} (ou vários {type_mot=yyyy}), serão selecionadas aquelas que possuam todas essas palavras-chave de uma vez.
- {id_groupe=zzzz} permite selecionar as matérias vinculadas a um grupo de palavras-chave; é o mesmo princípio do {type_mot} precedente, mas como é usado um identificador (número do grupo), a sintaxe é mais «limpa». [Nota: Este critério não pode ser usado conjuntamente com o precedente {type_mot=yyyy}]
- {lang} seleciona as matérias do idioma estabelecido pelo endereço da página.
- {traduction} seleciona as traduções da matéria corrente nos idiomas disponíveis.
- {origine_traduction} seleciona a matéria de referência da qual a matéria corrente foi traduzida.
- Os critérios {date} (ou {date=...} ou {date==...}) permitem selecionar uma matéria em função da data passada no URL.
- {recherche} seleciona as matérias correspondentes às palavras indicadas na interface de busca (motor de busca incorporado ao SPIP). Ver a página dedicada ao motor de busca.
O status da matéria
Como todos os loops do SPIP, um loop ARTICLES só retorna matérias publicadas; no caso do site estar configurado de modo a não publicar as matérias «pós-datadas», outro teste é feito na data da matéria. O critério {statut} permite outras seleções:
-
{statut IN prop,prepa,publie,refuse,poubelle}seleciona as matérias em função do seu status de publicaçã: -
{statut=prepa}seleciona as matérias em fase de redação na área restrita; -
{statut=prop}seleciona as matérias propostas para publicação; -
{statut=publie}seleciona as matérias publicadas no site, inclusive as matérias «pós-datadas»; -
{statut=refuse}seleciona as matérias que tiveram sua publicação recusada; -
{statut=poubelle}seleciona as matérias que foram enviadas para o lixo.
Os critérios de exibição
Uma vez definido um dos critérios acima, pode-se incluir os critérios a seguir para restringir o número de elementos exibidos.
Os critérios comuns a todos os loops são aplicáveis, evidentemente.
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 (por exemplo: {par date} ou {par titre}).
- #ID_ARTICLE affiche l’identifiant unique de l’article. Utile pour fabriquer des liens hypertextes non prévus (par exemple vers une page «Afficher au format impression»).
- #SURTITRE exibe o subtítulo da matéria.
- #TITRE exibe o título da matéria.
- #SOUSTITRE exibe o subtítulo da matéria.
- #DESCRIPTIF exibe a descrição da matéria.
- #CHAPO exibe o texto de introdução (cabeçalho) da matéria.
- #TEXTE exibe o texto principal da matéria.
- #PS exibe o post-scriptum da matéria.
- - As tags de data: #DATE, #DATE_REDAC, #DATE_MODIF são detalhadas na documentação sobre «a gestão das datas».
- #ID_RUBRIQUE exibe o identificador da seção a que a matéria pertence.
- #ID_SECTEUR exibe o identificador do setor a que a matéria pertence (sendo o setor a seção ascendente situada na raiz do site).
- #NOM_SITE e #URL_SITE exibem o nome e o URL do «link hipertexto» da matéria (se esta opção estiver ativada).
- #VISITES exibe o número total de visitas a esta matéria.
- #POPULARITE exibe a porcentagem de popularidade desta matéria; ver a documentação sobre «a «popularidade» das matérias».
- #LANG exibe o idioma desta matéria.
As tags calculadas pelo SPIP
Os elementos a seguir são calculados pelo SPIP (Não podem ser usados como critério de ordenação).
- #URL_ARTICLE exibe o URL da página da matéria.
- #NOTES exibe as notas de rodapé (calculadas a partir da análise do texto).
- #INTRODUCTION exibe a descrição rápida da matéria, senão exibe os 600 caracteres iniciais da matéria (cabeçalho mais texto).
- #LESAUTEURS exibe os autores da matéria, com link para as suas respectivas páginas públicas (para poder escrever-lhes diretamente ou consultar a lista das matérias que eles publicaram). Isto evita ter de criar um loop AUTEURS para obter o mesmo resultado.
- #PETITION exibe o texto da petição, caso exista.
Se existir mas o texto estiver vaxio, retorna um espaço (uma string não vazia, sem incidência numa página HTML).
- #FORMULAIRE_SIGNATURE monta e exibe o formuláriuo que permite assinar a petição associada à matéria.
- #FORMULAIRE_FORUM monta e exibe o formulário que permite postar uma mensagem de resposta à matéria. Para saber mais, ver também «Os formulários».
- #PARAMETRES_FORUM monta e exibe a lista de variáveis usadas pelo formulário que permite responder à matéria. Por exemplo:
[<a href="spip.php?page=forum&(#PARAMETRES_FORUM)">responder a esta matéria</a>]
Pode-se também incluir um parâmetro adicional para especificar o endereço de retorno após a postagem da mensagem.
[<a href="spip.php?page=forum&(#PARAMETRES_FORUM{#SELF})">Responder a esta matéria</a>]
direcionará o visitante para a página atual, uma vez que a mensagem seja validada.
Os logos
- #LOGO_ARTICLE exibe o logo da matéria, eventualmente com a gestão do hover.
- #LOGO_RUBRIQUE exibe o logo da seção da matéria.
- #LOGO_ARTICLE_RUBRIQUE exibe o logo da matéria, eventualmente substituído pelo logo da seção, caso não exista um logo específico da matéria.
Além disso, duas tags permitem recuperar um único dos dois logos:
- #LOGO_ARTICLE_NORMAL exibe o logo sem hover;
- #LOGO_ARTICLE_SURVOL exibe o lofo de hover.
Ver também: sintaxe completa das tags #LOGO_XXX