#INFO_XXX{objet_type, id_objeto} é uma tag que permite recuperar o valor de um campo da base de dados, sem necessariamente fazer um boucle.
Ela recebe três parâmetros obrigatórios:
- XXX: o nome do campo
- objet_type: é o tipo do objeto [1] que corresponde à tabela SQL que quer interrogar (ex : article para a tabela spip_articles, forum para a tabela spip_forum etc.).
- id_objeto: é o identificador do objeto pretendido.
Utilização fora de loop
#INFO_TITRE{article, 13}
#INFO_NOM{auteur, 2}
Esta funcionalidade está otimizada para não fazer várias consultas SQL à mesma tabela. Pode usar várias vezes a tag sobre o mesmo objeto sem problema.
#INFO_TITRE{article, 13}
#INFO_SOUSTITRE{article, 13}
#INFO_CHAPO{article, 13}
Pode-se também passar parâmetros dinamicamente:
#SET{id_breve, 3}
#INFO_TITRE{breve, #GET{id_breve}}
Utilização dentro de loop
<BOUCLE_materia(ARTICLES){id_article}>
Este é a matéria #TITRE da seção #INFO_TITRE{rubrique, #ID_RUBRIQUE}
</BOUCLE_materia>
…funciona corretamente, visto que #ID_RUBRIQUE é, de facto, um campo da tabela spip_articles
Tratamentos automáticos
A tag aplica os tratamentos automáticos habituais sobre as informações solicitadas, exatamente como quando se pede #TITRE ou #TEXTE num loop de objeto. As tags multi ou a sintaxe SPIP em determinados campos são assim consideradas.
Para não aplicá-los, é preciso incluir o asterísco [2], como para as outras tags: #INFO_TEXTE*{article, 123}.
Particularidades
Para TITRE, a tag vai buscar a definição do campo de título na descrição do objeto editorial [3], que permite usar a mesma sintaxe seja qual for o conteúdo, mesmo se na base for o campo "nom" que é importante.
Assim #INFO_TITRE{auteur, 123} devolverá o pseudónimo desse utilizador, armazenado no campo "nom" de "spip_auteurs".
Ver também
- As tags específicas do site
- #CHAMP_SQL
- A criação de uma tag #INFO_CHAMP para aceder ao valor no ambiente corrente de um campo variável