Nota Um loop
RUBRIQUESsó exibe as seções «ativas», ou seja, que contêm matérias publicadas, documentos anexos, sites publicados — ou subseções que estejam elas mesmas ativas. Dessa maneira, evita-se de mostrar «becos sem saída» nas seções, que não oferecem nenhum elemento de navegação. É possível forçar a exibição de seções vazias (ver abaixo, o critério{tout}).
Os critérios de seleção
Usa-se um ou outro dos seguintes critérios para definir como os elementos são selecionados.
- {id_rubrique} seleciona a seção cujo identificador é id_rubrique. Como o identificador de cada seção é único, este critério retorna uma ou zero, como resposta.
- {id_secteur} seleciona as seções deste setor. (Pode-se igualmente, por extensão, usar o critério {branche} descrito em O loop ARTICLES).
- {id_parent} seleciona a lista de seções contidas numa seção.
- {racine} seleciona a lista de setores (rigorosamente idêntico a {id_parent=0}).
- {id_enfant} seleciona a seção que contém a seção (uma única resposta, ou zero resposta se a seção corrente se encontrar na raiz do site).
- {meme_parent} seleciona a lista de seções que dependem da mesma seção que a seção corrente. Permite exibir as seções «irmãs», que estão no mesmo nível na hierarquia.
- As seções podem estar vinculadas a palavras-chave:
-
{id_mot},{titre_mot=xxx}recupera as seções vinculadas à palavra-chave cujo identificador é id_mot ou cujo título é titre_mot; -
{id_groupe},{type_mot=yyyy}recupar as seções vinculadas às palavvras-chave do grupo id_groupe, ou do groupe cujo título é type_mot.
- {recherche} seleciona as seções correspondentes às palavras indicadas na interface de pesquisa (motor de busca incorporado ao SPIP). Ver a página dedicada ao motor de busca.
- {lang} seleciona as seções do idioma solicitado no endereço da página.
- {tout} seleciona todas as seções, ou seja: as seções vazias além das seções que contêm elementos publicados.
Deve-se reservar esta opção a necessidades bem específicas; com efeito, por padrão o SPIP não exibe no site público as seções que não contêm nenhum elemento ativo, para garantir que o site não disponibilize «becos sem saída» (navegação para páginas que não oferecem nenhum conteúdo).
Os critério 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.
- {exclus} permite excluir do resultado a seção não qual já se encontra (útil com meme_parent).
As tags deste loop
As tags extraídas da base de dados
As tags a seguir correspondem aos elementos diretamente extraídos da base de dados. Você pode usá-los igualmente como critério de ordenação (geralmente: {par titre}).
- #ID_RUBRIQUE exibe o identificador único da seção.
- #TITRE exibe o título da seção.
- #DESCRIPTIF exibe a descrição rápida.
- #TEXTE exibe o texto principal da seção.
- #ID_SECTEUR exibe o identificador do setor ao qual a seção pertence (setor é a seção situada na raiz do site).
- #ID_PARENT exibe o identificador da seção que contém a seção corrente. Se a seção estiver situada na raiz do site, retorna 0.
- #LANG exibe o idioma da seção corrente.
- #PROFONDEUR retorna a profuncidade de uma seção na hierarquia
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.)
- #NOTES exibe as notas de pé de página (calculadas a partir da análise do texto).
- #INTRODUCTION exibe os 600 caracteres iniciais do texto; os enriquecimentos tipográficos (negrito, itálico) são removidos.
- #URL_RUBRIQUE exibe o URL da página da seção.
- #DATE exibe a data da última publicação realizada na seção e/ou suas subseções (matérias, notas...).
- #FORMULAIRE_FORUM monta e exibe o formulário que permite postar uma mensagem de resposta a esta seção. Para saber mais, ver também «Os formulários».
- #PARAMETRES_FORUM monta e exibe a lista de variáveis usadas pelos formulário que permite responder a esta seção. Por exemplo:
[<a href="spip.php?page=forum&(#PARAMETRES_FORUM)">Responder a esta seção</a>]
Pode-se também incluir um parâmetro adicional para especificar 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 seção</a> direcionará o visitante para a página atual, uma vez que a mensagem seja validada.
- #FORMULAIRE_SITE monta e exibe um formulário que permite aos visitantes do site propor o referenciamento de sites. Este sites aparecerão como «propostos» na área restrita, aguardando validação pelos administradores.
Este formulário só será exibido se a opção «Gerir um diretório de sites» estiver ativada na Configuração do site na área restrita, e se tiver selecionado em «Quem pode propor os sites referênciados» a opção «os visitantes do site público».
O logo
- #LOGO_RUBRIQUE o logo da seção, eventualmente com a gestão do hover.
Se não houver logo para esta seção, o SPIP irá procurar automaticamente se existe um logo para a seção a que ela pertence, e assim sucessivamente, de maneira recursiva.
É possível desativar esta herança com _LOGO_RUBRIQUE_DESACTIVER_HERITAGE.
#LOGO_RUBRIQUE_NORMAL exibe o logo «sem hover» ; #LOGO_RUBRIQUE_SURVOL exibe o logo de hover: estas duas tags permitem, por exemplo, quando se está numa seção, gerir um logo «com hover» para os links para outras seções, e deixar o logo de hover apenas na seção corrente.
Ver também: sintaxe completa das tags #LOGO_XXX