|appliquer_filtre e |appliquer_si_filtre

O filtro |appliquer_filtre aplica um filtro caso exista, senão devolve uma string vazia.

  • Apparu en : SPIP 2.1

Para usar um filtro que seja definido num plugin, quando não está certo de que o plugin esteja instalado e ativo, não é precisso chamar diretamente o filtro
[(#BALISE|nome_do_filtro)] já que isso pode gerar um erro de compilação, no caso da ausência do plugin, mas passar um chamado a appliquer_filtre:

[(#BALISE|appliquer_filtre{nome_do_filtro})]

 

Os argumentos suplementares transmitidos a esta função são usado como argumentos para o filtro chamado.

[(#BALISE|appliquer_filtre{nome_do_filtro, arg1, arg2, ...})]

Exemplo

// Aplica o filtro minifier se for encontrado:
// Não devolve nada se o filtro 'minifier' não for encontrado
[(#INCLURE{fichier.js}|appliquer_filtre{minifier, js})]

// Devolve o conteúdo do ficheiro fichier.js se 'minifier' não for encontrado.
[(#INCLURE{fichier.js}|appliquer_si_filtre{minifier, js})]

Se o filtro não existir
-  Quando o filtro passado como argumento não estiver definido, |appliquer_filtre devolve uma string vazia.
-  A partir do SPIP 4.0, pode-se optar pelo filtro |appliquer_si_filtre, que devolve (no mesmo caso) o conteúdo inalterado da tag

Caso dos filtros de imagem
Após o SPIP 4.0, estes dois filtros podem ser usados com um filtro image_xxx como argumento, caso em que o filtro image_graver() é chamado adicionalmente, de forma a tornar permanentes as imagens temporárias criadas.

Autor Ricardo Porto Publié le : Mis à jour : 10/03/25

Traductions : català, English, français, Nederlands, Português