Tags definidas na configuração
O conteúdo destas tags é definido na área restrita, quando o seu site é configurado.
- #NOM_SITE_SPIP exibe o nome do site.
- #URL_SITE_SPIP exibe o endereço do site. Ela não inclui o / final, permitindo que crie um link do tipo #URL_SITE_SPIP/hello.php
- #DESCRIPTIF_SITE_SPIP exibe, como o seu nome indica, a descrição do site, definida na página de confifiguração geral do site.
- #EMAIL_WEBMASTER exibe o endereço de e-mail do webmaster. Por padrão, o SPIP presume o endereço de e-mail de quem instalou o site (o administrador principal).
- #LOGO_SITE_SPIP exibe o logo do site. Esta tag envia o logo do site 0.
- #CHARSET exibe o conjunto de caractéres usado pelo site. O seu valor padrão é utf-8.
- #LANG: usado fora dos loops ARTICLES, RUBRIQUES, BREVES e AUTEURS, esta tag exibe o idoma principal do site.
- #LANG_DIR, #LANG_LEFT, #LANG_RIGHT : estas tags definem o sentido de escrita do idioma do contexto corrente (por exemplo, da matéria que será exibida). Ver a matéria «Criar um site multilíngue» para mais informações.
- #MENU_LANG (et #MENU_LANG_ECRIRE): estas tags montam e exibem um menu de idiomas que permite ao visitante obter a página corrente no idioma escolhido. A primeira tag exibe a lista dos idiomas do site; a segunda a lista de idiomas da área restrita (ela é usada na página de conexão à área restrita).
Tags de layout
- #DOSSIER_SQUELETTE Permite obter o caminho do diretório onde está armazenado o template usado.
Podemos, então, colocar os ficheiros «acessórios» (folha de estilo, javascript etc.) do template no diretório do template e simplesmente distribuir este diretóeio para trocar os seus templates. Escreve-se, então, por exemplo, para incluir uma folha de estilo do diretório template:
<link rel="stylesheet" href="#DOSSIER_SQUELETTE/meu_estilo.css" type="text/css" />
A tag #CHEMIN substitui e melhora #DOSSIER_SQUELETTE. #CHEMIN{xxx} fornecerá o caminho completo para o ficheiro xxx, quer esteja na raiz, na pasta templates, em dist/ etc.
<link rel="stylesheet" href="#CHEMIN{meu_estilo.css}" type="text/css" />
- #PUCE que exibirá um marcador de lista, como o que está à esquerda.
- #FORMULAIRE_ADMIN é uma tag opcional que permite inserir os botões de administração («recompor esta página» etc.) nos seus templates. Quando um admnistrador navega pelo site, se esta tag estiver presente, ela exibirá os botões de administração, senão, os botões serão exibidos no local habitual.
Pode-se também alterar a folha de estilo spip_admin.css para controlar a posiç#ao dos botões.
- #DEBUT_SURLIGNE, #FIN_SURLIGNE são duas tags que indicam ao SPIP em que parte da página colorir as palavras-chave procuradas. Ver : «Os loops e as tags de busca».
- A tag #INSERT_HEAD deve ser colocada entre as tags <head> e </head> dos seus templates. Ela permite ao SPIP, bem como a eventuais plugins, incluir conteúdo entre essas duas tags HTML.
Tags técnicas
Atgenção, estas tags destinam-se a utilizadores experientes do SPIP.
- A tag #REM não produz nenuma exibição: ela permite comentar o código dos templates, da seguinte maneira: [(#REM) Isto é um comentário. ]. Estes comentários não aparecem no código gerado para o site público. Ver também: Como desativar uma parte de um template?
- #SELF retorna o URL da página solicitada, limpa de variáveis próprias à execução do SPIP. Por exemplo, para uma página com o URL: spip.php?article25&var_mode=recalcul a tag #SELF retornará: spip.php?article25
Por exemplo, para fazer um formulário:
<form action="#SELF" method="get">
Nota: a tag #SELF representa o endereço da página, ela não é compatível com os <INCLURE()> (excepto se o $delais dai inclusão for definido como 0).
- #URL_PAGE retorna um URL do tipo «página» (veja os URLs do SPIP), para a página passada em parâmetro e que poderá ser usada dentro de um link. Por exemplo, para aceder à página gerada pelo template toto.html, situado na sua pasta de templates, #URL_PAGE{toto} gerará automaticamente o URL spip.php?page=toto. Um segundo parâmetro é permitido para incluir parâmetros ao URL. Exemplo #URL_PAGE{toto,id_article=#ID_ARTICLE} gerará o URL spip.php?page=toto&id_article=XXX.
- [(#ENV{xxxx, zzzz })] permite aceder à variável de nome xxxx passada pela solicitação HTTP. zzzz é uma parte opcional que permite retornar um valor, mesmo se a variável xxxx não existir. Pode-se encontrar uma explicação detalhada em Spip-Contrib
Por padrão, a tag #ENV é filtrada por htmlspecialchars. Se se desejar obter o resultado bruto, o asterísco «*» pode ser usado como para uma das tags [(#ENV*{xxxx})].
Por exemplo, para limitar a lista de autores exibidos:
<BOUCLE_auteurs(AUTEURS) {nom == #ENV{letra,^A}}>
Retorna a lista de autor correspondente à expressão regular passada no URL pela variável letra (spip.php?page=lista_autor&letra=^Z) ou os autores que tenham um nome iniciado por um ’A’ se não houver variável no URL.
- A tag #SET{ variável,valor } e a sua contraparte #GET{variável} . A tag #SET{xxx,yyy} atribui um valor yyy à variável xxx própria do template calculado. Este valor pode ser recuperado pela tag #GET{xxx}. As variáveis criadas deste modo não são transmitidas ao template incluído.
Atenção! Se se atribuir um valor à variável na parte facultativa anterior a um loop, não será possível recuperar este valor dentro do loop. Isto deve-se ao modo como o SPIP calcula os templates.
- A tag #HTTP_HEADER{argumento} permite alterar o cabeçalho HTTP da página retornada pelo SPIP. Exemplo:
#HTTP_HEADER{Content-Type: text/css}. Atenção! O facto de usar esta tag suprime os botões de administração. Esta tag não pode ser usada em templates incluídos com a sintaxe <INCLURE>.
- A tag #VAL{argument} retorna o argumento entre chavetas. Por exemplo #VAL{toto} retorna "toto".
- A tag #CONST{nome_de_constante} retorna o valor da constante passada no argumento.
- A tag #EVAL{argumento} avalia a expressão PHP entre chavetas. Por exemplo, #EVAL{1+1} exibirá 2, #EVAL{_DIR_IMG_PACK} exibirá assim o caminho para o diretório ecrire/img_pack/. Atenção, é fortemente aconselhável de usá-la com moderação.
- A tag #CACHE{tempo} permite determinar o período ao fim do qual o template será reinterpretado. O tempo é expresso em segundos e pode ser informado como cálculo. Por exemplo: #CACHE{24*3600}.