|
SPIP |
Article validé
L’article « |appliquer_filtre e |appliquer_si_filtre » vient d’être publié par Ricardo Porto.
|appliquer_filtre e |appliquer_si_filtre
quinta-feira 6 de Março de 2025, por Ricardo Porto
O filtro |appliquer_filtre aplica um filtro caso exista, senão retorna uma string vazia.
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 retorna nada se o filtro 'minifier' não for encontrado
[(#INCLURE{fichier.js}|appliquer_filtre{minifier, js})]
// Retorna 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.
— Enviado por SPIP