Os formulários inserem-se nos templates por uma simples tag; o SPIP encarrega-se de gerir o comportamento (frequentemente complexo) desses formulários em função do ambiente e das configurações realizadas na área restrita.
Funções interativas
- #FORMULAIRE_RECHERCHE
É o formulário do motor de busca integrado do SPIP. Ele é apresentado na matéria sobre os loops de busca.
- #FORMULAIRE_FORUM
O #FORMULAIRE_FORUM gere a interface que possibilita postar mensagens nos fóruns públicos. Ele diz respeito, primeiramente o loop FORUMS mas podeser usado em todos os loops que aceitam um fórum:
O formulário depende evidentemente da opção de fóruns moderados a posteriori, a priori ou por assinatura.
Por padrão, após postar a mensagem, o visitante é encaminhado para a página do elemento [1] ao qual respondeu. Pode-se decidir encaminhar o visitante a outra página, passando um URL como parâmetro a essa tag. Por exemplo:
-
[(#FORMULAIRE_FORUM{'spip.php?page=obrigado'})]encaminhará para a página spip?page=obrigado.
-
[(#FORMULAIRE_FORUM{#SELF})]ecaminhará para a página em que o formulário de fórum foi inserido (ver a tag #SELF).
No caso (muito específico) em que se autorizou o uso de palavras-chave nos fóruns públicos, pode-se ajustar o comportamento deste formulário com as variáveis de personalização.
- #FORMULAIRE_SIGNATURE
A tag #FORMULAIRE_SIGNATURE exibe um formulário que permite aos visitantes do site de assinar petições associadas às matérias. Esta tag deve ser colocada num loop ARTICLES.
A assinatura das petições exige obrigatoriamente uma validação das assinaturas por e-mail. Este formulário só é interessante se o alojamento do seu site autorizar o envio de e-mails via PHP.
- #FORMULAIRE_SITE
A tag #FORMULAIRE_SITE exibe um formulário que permite aos visitantes do site propor sites referenciados. Estes sites aparecerão como «propostos» na área restrita, aguardando uma validação pelos administradores.
Este formulário só é exibido se a opção «Gerir um diretório de sites» estiver ativada na Configuração do site na área restrita, e se você selecionou, em «Quem pode propor sites referenciados», a opção «os visitantes do site público».
Como os sites referenciados no SPIP estão vinculados às seções, a tag #FORMULAIRE_SITE só pode ser colocada no interior de um loop RUBRIQUES.
- #FORMULAIRE_ECRIRE_AUTEUR
Colocado dentro de um loop AUTEURS, esta tag exibe o formulário que permite enviar um e-mail ao autor. Isto permite escrever aos autores sem divulgar os seus endereços de e-mail no site público.
Colocado num boucle ARTICLES, este formulário permite enviar um e-mail a todos os autores dessa matéria.
Colocado num boucle FORUMS, este formulário permite enviar um e-mail diretamente ao autor da mensagem, se o autor estiver registado no site.
Inscrição, autenticação...
- #FORMULAIRE_INSCRIPTION
Sem dúvida a mais importante, a tag #FORMULAIRE_INSCRIPTION exibe i formulário que permite a inscrição. Ver a documentação sobre esta tag.
- #FORMULAIRE_LOGIN
Após o SPIP 3.0, esta tag generaliza e substitui as tags #LOGIN_PRIVE e #LOGIN_PUBLIC. Ela pode receber 3 argumentos:
- O URL de destino, após a identificação. Caso específico:a valor @page_auteur permite dirercionar, após conexão, para o template público do autor que se conectou;
- o login da pessoa a identificar, se for conhecido;
- um valor que indica se o login encaminha para a área restrita (se não estiver vazio) ou pública (se for uma string vazia).
Por exemplo,no template distribuído com o SPIP, o ficheiro login.html contém a chamada a segur:
[(#FORMULAIRE_LOGIN{#ENV{url}|sinon{#URL_ECRIRE{accueil}}})]
Após o SPIP 4.0, esta tag pode receber parâmetros sob uma nova forma:
- O URL de destino;
- uma matriz de opções em que os valores podem ser:
-
login -
prive -
autofocus: se este valor for falso (uma string vazia), o campo login não terá d’autofoco (caso contrário, ele receberá o foco automaticamente).
Neste exemplo teórico, o login encaminha para a página ’alvo’ da área restrita, o identificador sugerido é ’toto’ e não tem autofoco:
#FORMULAIRE_LOGIN{cible,#ARRAY{login,toto,prive,1,autofocus,""}}
- #LOGIN_PRIVE (excluído no SPIP 4.0)
Esta tag está obsoleta: em seu lugar, use #FORMULAIRE_LOGIN.
Ela exibe o formujlário de acesso à área restrita (a parte «/ecrire» do site).
Importante: esta tag deve imperativamente estar presente no template chamado pela página spip.php?page=login, ou seja, no template login.html. Com efeito, nos acessos diretos ao endereço «/ecrire» do seu site, é para spip.php?page=login que o SPIP o encaminhará.
- #LOGIN_PUBLIC (excluído no SPIP 4.0)
Esta tag está obsoleta: em seu lugar, use #FORMULAIRE_LOGIN.
De uso bem mais específico, a tag #LOGIN_PUBLIC exibe um formulário que permite aos seus utilizadores identificarem-se no site público (sem entrar na área restrita). Esta tag serve especificamente para identificar os visitantes nos sites que oferecem fóruns moderados por assinatura.
O #LOGIN_PUBLIC, por padrão, «faz loop em si mesmo», ou seja, o formulário retorna à página em que se encontra. Pode-se, no entanto, indicar uma página para onde o formulário encaminhará, no formato:
[(#LOGIN_PUBLIC{#URL_PAGE{minhapagina}})]
Se o seu site oferece uma inscrição automática à área restrita, os dados de conexão ao espaço público são idênticos aos da área restrita, ou seja, os dados enviados ao utilizador para iodentificar-se no espaço público permite-lhe igualmente aceder ao espaço privado. Se, ao contrário, você impediu a inscrição automática à área restrita, é imperativo ter ao menos uma matéria em que os fóruns sejam configurados no modo «por assinatura» para ativar esta tag; deste modo, o SPIP pode fornecer informações de conexão para o site público sem acesso ao espaço privado.
- #URL_LOGOUT
É a contraparte de #LOGIN_PUBLIC; fornece um URL que permite ao visitante autenticado de se desconectar.
Note que #URL_LOGOUT sendo uma tag dinâmica, ela devolverá sempre algum valor, de modo que as partes condicionais (A sintaxe das tags SPIP) da tag serão sempre exibidas. Assim, uma notação do tipo [<a href="(#URL_LOGOUT)">desconexão</a>] devolverá o código HTML <a href="">déconnexion</a> se o visitante não estiver logado. Para uma exibição condicional do link de desconexão, ver mais abaixo.
Pode-se passar um parâmetro a esta tag para especificar o endereço de retorno após a desconexão.
Por exemplo
[(#URL_LOGOUT{#URL_PAGE{sommaire}})]
retornará para a página principal.
Exemplo completo para gerir a conexão / desconexão
[(#SESSION{id_auteur}|non) #LOGIN_PUBLIC]
[(#SESSION{id_auteur}|oui)<a href="#URL_LOGOUT">desconexão</a>]
Estilos
Pode-se alterar consideravelmente a interface gráfica dos formulários por meio de folhas de estilo. Veja : «Que bonitos são os meus formulários!»