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.