Os critérios de seleção
Usa-se um ou outro dos seguintes critérios para definir como os elementos são selecionados.
- {id_forum} retorna a mensagem com o identificador id_forum. Como o identificador de cada mensagem é único, este critério retorna um ou zero resposta.
- {id_article} retorna as mensagens correspondentes à matéria.
- {id_rubrique} retorna as mensagens correspondentes à seção. Atenção, não se trata das mensagens das matérias da seção, e sim das mensagens da seção. Com efeito, é possível ativar na área restrita foruns para cada seção.
- {objet}{id_objet} retorna as mensagens correspopndentes a um certo tipo e identificador de objeto.
- {statut} retorna as mensagens com um determinado status
- {id_breve} retorna as mensagens correspondentes à nota.
- {id_syndic} retorna as mensagens correspondentes ao site.
- {id_thread} retorna as mensagens correspondentes a este tópico.
Nota: id_thread é o identificador id_forum da mensagem que origina a discussão (também chamada de «pé» da discussão).
- {id_parent} retorna as mensagens dependentes de uma outra mensagem. Indispensável para gerir o fluxos de discussão («threads») nos fóruns.
- {id_enfant} retorna a mensagem a que pertence a mensagem atual (permite «subir» na hierarquia dos threads de discussão).
- {meme_parent} retorna as outras mensagens respondendo a uma mesma mensagem.
- {plat} ou {tout}: exibe todas as mensagens de fórum sem levar em conta a hierarquia: com este critério, você popde selecionar todas as mensagens, seja qual for a sua posição num thread (no limite dos outros critérios, claro). Isto permite, por exemplo, exibir as mensagens por ordem estritamente cronológica, ou contar o número total de contribuições num fórum.
Nota: Na ausência do critério {id_forum} ou {id_parent}, como {plat} não é usado, apenas as mensagens que não têm ascendente (i.e. na raiz de um thread) são exibidas.
- {id_secteur} retorna as mensagens correpondentes ao setor. A priori, pouco útil; mas permite, por exemplo, fazer um grande fórum temático, reagrupando todas as mensagens de um setor, seja qual for o lugar em que se encontram.
- As mensagens dos fóruns podem ser vinculadas a palavras-chave. Os critérios de palavras-chave podem ser usados nos loops (FORUMS):
-
{id_mot},{titre_mot=xxx}recuperam as mensagens ligadas à palavra-chave com o número id_mot ou cujo título é titre_mot; -
{id_groupe},{type_mot=yyyy}recupera as mensagens vinculadas às palavras-chave do grupo id_groupe, ou do grupo cujo título é type_mot.
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 diretamente aos elementos extraídos da base de dados. Voce pode usá-las igualmente como critério de ordenação (geralmente {par titre}).
- #ID_FORUM exibe o identificador único da mensagem.
- #ID_THREAD exibe o identificador da thread de discussão à qual a mensagem pertence. (trata-se do id_forum do pé da discussão.)
- #URL_FORUM dá o endereço canónico da página que exibe a mensagem de fórum (por exemplo, com os URLs normais do SPIP, /spip.php?article8#forum15 para a mensagem 15 associada à matéria 8).
- #ID_BREVE exibe o identificador da nota à qual a mensagem está vinculada. Atenção, isto não é recursivo: uma mensagem que corresponda a uma mensagem vinculada a uma nota não contém, em si, o número da nota.
- #ID_ARTICLE é o identificador da matéria a que a mensagem responde.
- #ID_RUBRIQUE é o identificador da seção a que a mensagem responde.
- #ID_SYNDIC é o identificador do site a que a mensagem responde.
- #DATE é a data de publicação.
- #TITRE é o título da mensagem.
- #TEXTE é o texto da mensagem.
- #NOM_SITE é o nome do site indicado pelo autor.
- #URL_SITE é o endereço (URL) desse site.
- #AUTEUR (antigamente #NOM) é o nome do autor da mensagem.
- #EMAIL é o endereço de e-mail do autor, na forma direta de envio (o mailto: está integrado). Usa-se assim [(#EMAIL)] para obter simultaneamente o endereço de e-mail aparente e, diretamente, o link a clicar sobre esse endereço.
- #STATUT é o status do fórum. Segundo a origem e o status do fórum, pode ser
-publie: legível no espaço público
-off: excluído
-prive: escrito como reação a uma matéria na área restrita
-privoff: mensagens rejeitadas ("no lixo") de um fórum privado relativo a uma matéria
-privrac: mensagem do fórum interno dos redatores, na área restrita (este deve estar ativado na configuração)
-privadm: mensagem do fórum dos administradores (este deve estar ativado na configuração)
-prop: mensagem proposta para publicação, aguardando validação (se a moderação dos fóruns estiver configurada como "a priori" ou por efeito do plugin "nospam").
-spam: rejeitada como spam (plugin "nospam").
- #IP é o IP do autor da mensagem, no momento do envio da sua contribuição.
- As tags calculadas pelo SPIP
- #FORMULAIRE_FORUM monta a interface que permite postar uma mensagem de resposta. Para saber mais, ver também «Os formulários».
- #PARAMETRES_FORUM monta a lista das variáveis usadas pela interface do formulário que permite responder à mensagem. Por exemplo:
[<a href="spip.php?page=forum&(#PARAMETRES_FORUM)">Responder a esta mensagem</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 atual, uma vez que a mensagem seja validada.