Os critérios de seleção
Pode-se usar um ou mais dos critérios a seguir para definir como os elementos serão selecionados.
- {tout} (tudo) as palavras-chave são selecionadas por todo o site.
- {id_mot} (id palavra-chave) retorna a palavra-chave com o identificador {id_mot}.
- {id_groupe} (id grupo) retorna as palavras-chave associadas ao grupo de palavras-chave com o identificador id_groupe .
- {id_article} (id matéria) retorna as palavras-chave associadas à matéria (é o uso mais comum deste loop).
- {id_rubrique} (id seção) retorna as palavras-chave associadas a uma seção.
- {id_breve} (id nota) retorna as palavras-chave associadas a uma nota.
- {id_syndic} (id sindicação) retorna as palavras-chave associadas a um site referenciado.
- {id_forum} (id fórum) retorna as palavras-chave associadas a uma mensagem de fórum (atenção, o uso é bem específico).
- {titre=portugal} (título) retorna a palavra-chave com o título portugal (por exemplo).
- {type=país} (tipo) retorna as palavras-chave que pertencem ao grupo de palavras-chave com o título país (por exemplo).
Os critérios de exibição
Os critérios comuns a todos os loops são aplicáveis.
As tags deste loop
As tags extraídas da base de dados
As tags a seguir correspondem aos elementos extraídos diretamente da base de dados. Pode usá-las igualmente como critério de ordenação (geralmente: {par titre}).
- #ID_MOT exibe o identificador único da palavra-chave.
- #TITRE exibe o título (a palavra-chave, propriamente dita).
- #DESCRIPTIF exibe a descrição da palavra-chave.
- #TEXTE exibe o texto principal da palavra-chave.
- #TYPE exibe a categoria a que pertence a palavra-chave (por exemplo, a palavra-chave «Portugal» pode pertencer à categoria «País»).
- #LOGO_MOT exibe o logo associado à palavra-chave.
- #URL_MOT exibe o endereço — a página — da palavra-chave.
- #ID_GROUPE exibe o identificador do grupo de palavras-chave ao qual a palavra-chave pertence.
O loop (GROUPES_MOTS)
Com um uso marginal, o loop GROUPES_MOTS, merece ser citado aqui: permite, se tiver vários grupos de palavras-chave, selecionar esses grupos e organizar, por exemplo, uma página listando todas as palavras-chave ordenadas por grupo, seguido de ordem alfabética, dentro de cada grupo, como no exemplo do código abaixo:
<BOUCLE_grupos(GROUPES_MOTS){par titre}>
<h1>#TITRE</h1>
<BOUCLE_palavras(MOTS){id_groupe}{par titre}{" - "}>
#TITRE
</BOUCLE_palavras>
</BOUCLE_grupos>
As tags e critérios associados a este loop são:
- #ID_GROUPE é o identificador único do grupo de palavras-chave;
- #TITRE é o título do grupo [dentro do loop (MOTS), pode usar #TYPE para exibir este valor].
- #DESCRIPTIF exibe a descrição do grupo.
- #TEXTE exibe o texto principal do grupo.
- #LOGO_GROUPE exibe o logo associado ao grupo de palavras-chave.