Pour utiliser un filtre qui est défini dans un plugin, quand on n’est pas certain que le plugin est installé et activé, il ne faut pas appeler directement le filtre
[(#BALISE|nom_du_filtre)] car cela générerait une erreur de compilation en cas d’absence du plugin, mais passer par un appel à appliquer_filtre :
[(#BALISE|appliquer_filtre{nom_du_filtre})]
Les arguments supplémentaires transmis à cette fonction sont utilisés comme arguments pour le filtre appelé.
[(#BALISE|appliquer_filtre{nom_du_filtre, arg1, arg2, ...})]
Exemple
// Applique le filtre minifier si on le trouve :
// Ne retourne rien si le filtre 'minifier' n'est pas trouvé
[(#INCLURE{fichier.js}|appliquer_filtre{minifier, js})]
// Retourne le contenu du fichier.js si 'minifier' n'est pas trouvé.
[(#INCLURE{fichier.js}|appliquer_si_filtre{minifier, js})]
Lorsque le filtre n’existe pas
- Lorsque le filtre passé en argument n’est pas défini, |appliquer_filtre renvoie une chaîne vide.
- À partir de SPIP 4.0, on peut préférer le filtre |appliquer_si_filtre, qui, lui, renvoie (dans ce même cas) le contenu inchangé de la balise
Cas des filtres d’image
Depuis SPIP 4.0, ces deux filtres peuvent être utilisés avec un filtre image_xxx en argument, auquel cas le filtre image_graver() est appelé en plus dans la foulée, de manière à péréniser les images temporaires créées.