|appliquer_filtre

Le filtre |appliquer_filtre applique un filtre s’il existe, sinon retourne une chaîne vide.

(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})]

Auteur JLuc Publié le : Mis à jour : 24/03/21

Traductions : català, English, français, Nederlands