(depuis SPIP 2.1)
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, ...})]
Lorsque le filtre passé en argument n’est pas défini, |appliquer_filtre
renvoie une chaîne vide. À partir de SPIP 3.3, on pourra préférer le filtre |appliquer_si_filtre
, qui, lui, renvoie le contenu inchangé de la balise
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})]