|appliquer_filtre et |appliquer_si_filtre

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

  • Apparu en : 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, ...})]

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.

Auteur JLuc Publié le : Mis à jour : 22/07/23

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