SPIP

|lignes_longues

denisb, Teddy — 2022-09-23T04:42:06Z

Avertissement : ce filtre historique est déprécié et il sera supprimé en SPIP 5. On pourra le remplacer avantageusement par une instruction CSS de type word-wrap:break-word;

Le filtre |lignes_longues, introduit des césures dans les mots « trops longs » en y insérant des espaces sécables qui permettent alors le passage à la ligne (utile, par exemple, pour afficher des urls dans une colonne étroite).

Ainsi, si le #TEXTE d'un article contient un lien comme :

http://www.spip.net/spip.php?page=recherche&recherche=lignes_longues

alors

 [(#TEXTE|lignes_longues{20})]

affichera

http://www.spip.net /spip. php?page=recherche& recherche=lignes_longues

Noter que la césure conserve les tag html ; dans l'exemple ci-dessus, tout le lien est cliquable comme on peut le voir dans le source html.

Ce filtre coupe par défaut à 70 caractères, mais on peut spécifier une autre longueur en passant un paramètre au filtre, par exemple :
[(#TEXTE|lignes_longues{40})]

|normaliser_date

Teddy — 2013-02-04T16:27:21Z

Le filtre |normaliser_date retournera une date sous la forme "Y-m-d H:i:s" (Année-mois-jour Heure:minutes:secondes).

Appliqué sur une balise retournant une date au format RFC 3339 (2012-03-27T22:54:10Z), le filtre |normaliser_date transposera la date sous la forme « Année-mois-jour Heures:minutes:secondes » (2012-03-28 00:55:41)

Exemple :
Votre champ date (#DATE) est enregistré au format « Y-m-d » et ne prend pas en compte les heures, minutes et secondes. Mais vous devez comparer cette date à une autre date qui, elle, prend en compte les heures. Pour que ces deux éléments soient comparables, vous devez mettre votre date au bon format en utilisant ce filtre :

[(#DATE|normaliser_date)]

Une possibilité supplémentaire est offerte par ce filtre :
en lui donnant un argument « true » le filtre transforme tous les « -00 » (donc mois ou jour non définis) en « -01 ».
Par exemple : [(#VAL{2012-00-00}|normaliser_date{true})],
affichera : « 2012-01-01 00:00:00 ».

|date_interface

denisb, Teddy — 2013-02-04T16:15:18Z

Sommaire

Voir aussi

Le filtre |date_interface appliqué à toute balise #DATE affichera la date sous une forme plus compréhensible par l'homme.

Exemple : Un article a été publié le lundi 18 avril 2011 à 8h15.
[(#DATE)] sans filtre affichera « 2011-04-18 08:15:00 »
[(#DATE|date_interface)] affichera « 18 avril 2011 à 08h15min ».

En fonction de la date courante, ce filtre retourne différents affichages :

Différence de la date par rapport à la date en cours	Valeur affichée
#DATE > 12 heures	« jj mmmm aaaa à xxhyymin »
#DATE < 12 heures	« il y a xx heures »
#DATE < 1 heure	« il y a xx minutes »
#DATE < 1 minute	« il y a xx secondes »
#DATE égale à la date en cours	« il y a 0 seconde »
#DATE postérieure à la date en cours	« jj mmmm aaaa à xxhyymin »

Voir aussi

|extraire_date

Teddy — 2013-02-04T16:04:28Z

Le filtre |extraire_date extrait la première date rencontrée dans la balise sur laquelle il s'applique.

Le filtre |extraire_date extrait une date de n'importe quelle balise contenant une date sous la forme AAAA-MM ou AAAA-MM-JJ. Si votre balise contient plusieurs dates sous l'une de ces formes le filtre n'extraira que la première date rencontrée.

Un exemple :
dans votre #DESCRIPTIF, vous avez

« En 2012-03, diverses discussions ont été lancées sur le devenir de l'écureuil et sa sortie post-hivernale »

Avec [(#DESCRIPTIF|extraire_date)], SPIP affichera « 2012-03-01 ». Le filtre ajoutera « -01 » à la date pour être au format AAAA-MM-JJ.

Attention : si votre #DESCRIPTIF contient une date sous la forme AAAA-MM-JJ comme dans :

« Le 2012-03-25, une grande discussion arriva à son apogée suite à une remarque anodine mais pertinente, »

le filtre remplacera « 25 » par « 01 » et affichera « 2012-03-01 ».

{noeud}

Teddy — 2013-02-04T15:53:55Z

Le critère {noeud} permet de sélectionner les rubriques qui ont des enfants.

Le critère {noeud} permet de sélectionner les rubriques qui ont des enfants (au moins une sous-rubrique).

Par exemple, avec l'arborescence ci-dessous :

Rubrique Racine 010
- Sous-Rubrique 011
  - Sous-Rubrique 011.01
  - Sous-Rubrique 011.02
- Sous-Rubrique 012
- Sous-Rubrique 013
- Sous-Rubrique 014
- Sous-Rubrique 015
Rubrique Racine 020
Rubrique Racine 030

la boucle suivante :

    #TITRE

affichera :

Rubrique Racine 010
Sous-Rubrique 011

voir aussi feuille

{feuille}

Teddy — 2013-02-04T15:53:35Z

Le critère {feuille} permet de sélectionner les rubriques sans enfants.

Le critère {feuille} permet de sélectionner les rubriques sans enfants (celles qui ne possèdent pas de sous-rubrique).

Par exemple, avec l'arborescence ci-dessous :

Rubrique Racine 010
- Sous-Rubrique 011
  - Sous-Rubrique 011.01
  - Sous-Rubrique 011.02
- Sous-Rubrique 012
- Sous-Rubrique 013
- Sous-Rubrique 014
- Sous-Rubrique 015
Rubrique Racine 020
Rubrique Racine 030

la boucle suivante :

   #TITRE

affichera :

Sous-Rubrique 011.01
Sous-Rubrique 011.02
Sous-Rubrique 012
Sous-Rubrique 013
Sous-Rubrique 014
Sous-Rubrique 015

voir aussi noeud

{si ...}

denisb, Teddy — 2012-06-03T09:15:50Z

Le critère {si ...} permet de conditionner l'exécution d'une boucle à la condition exprimée en argument dans le critère.

Sommaire

Voir aussi

Exemple :

 #TITRE

La boucle s'exécutera uniquement si, dans l'environnement d'exécution de la boucle, #ID_RUBRIQUE est égal à "8".

La partie conditionnelle de la boucle, celle inscrite entre et , sera quant à elle exécutée dans les deux cas où :

soit #ID_RUBRIQUE n'existe pas dans l'environnement ou n'est pas égal à 8 (prise en compte du critère {si ...} ;
soit #ID_RUBRIQUE est bien égal à 8 mais la boucle ne retourne aucun résultat.

Ce nouveau critère {si ...}, disponible depuis SPIP 3.0, permet de s'affranchir enfin de l'impossibilité d'utiliser une boucle dans la partie conditionnelle d'une balise.
Par exemple, là où il était nécessaire d'écrire

 [(#SESSION{statut}|=={1comite}|oui)  ... ]

parce que mapage.html contenait une boucle, il est désormais possible d'écrire directement dans le squelette appelant (sans INCLURE donc) :

...

Bien sûr, le critère {si ...} peut porter sur tout type de variables (#ENV, #GET,...)
Par exemple, une boucle dont l'exécution sera conditionnée par le résultat d'un calcul faisant intervenir une variable de l'environnement #ENV{var} (récupérée depuis l'url) et une variable #GET{val} (préalablement définie dans le squelette) :

#SET{val, 2}  ...

Voir aussi

La boucle CONDITION

|recuperer_numero

Teddy — 2012-04-29T21:05:55Z

Le filtre |recuperer_numero s'utilise pour n'afficher que le préfixe numéroté d'un titre [1].

Ainsi, pour le titre « 0118. Titre de mon article », [(#TITRE|recuperer_numero)] affichera « 0118 ».

En SPIP 2.1, il ne faut pas avoir déclaré préalablement dans un fichier mes_options.php ou mes_fonctions.php le code suivant : $table_des_traitements['TITRE'][] = test_espace_prive() ? '' : 'typo(supprimer_numero(%s))'; auquel cas il conviendra d'utiliser la balise #RANG.

En SPIP 3, en revanche, comme le traitement « supprimer_numero » est directement fait par spip, ce filtre est déprécié et [(#TITRE|recuperer_numero)] (qui ne retourne donc rien) est à remplacer par la balise #RANG. Ce dernier assurant le travail parfaitement.

[1] Le format des préfixes numérotés est : un nombre de n chiffres, suivi d'un point ou d'une parenthèse fermante, suivie d'un espace. exemples : 015. Le titre 51) Le titre

Voir aussi : |supprimer_numero

|filtrer_entites

Teddy — 2012-04-25T23:26:25Z

Le filtre |filtrer_entites appliqué à une balise permet de transformer tous les caractères spéciaux HTML dans le charset du site.

Exemple : si le charset de votre site est utf-8, « é » tout comme « é » sera transformé en « é » dans le source html de la page.

|echapper_tags

Teddy — 2012-04-25T23:18:52Z

Le filtre |echapper_tags encode en html du retour de la balise à laquelle il s'applique tous les tags html (<...>) tout en conservant le contenu de ces même tags.

Par exemple, pour une balise #DESCRIPTIF qui contiendrait :

William Shakespeare naquit à Stratford-sur-Avon, dans une maison sous les tuiles de laquelle était cachée...

retournera, une fois le filtre appliqué, exactement la même chose. Soit en code source de votre page :

William Shakespeare naquit à Stratford-sur-Avon,  dans une maison sous les tuiles de laquelle était cachée...

Voir aussi : |supprimer_tags