SPIP

_CACHE_CONTEXTES_AJAX

denisb — 2012-05-12T23:36:59Z

La constante _CACHE_CONTEXTES_AJAX permet de passer outre une des limitations imposées par Suhosin (le système de protection pour PHP).

Quand « suhosin » empêche les variables GET d'avoir des valeurs de plus de 512 caractères, il arrive que les contextes des paginations ajax soient impossibles à retrouver. Une redirection en erreur se produit alors : « NetworkError : 414 Request-URI Too Large ».

Définir la constante _CACHE_CONTEXTES_AJAX à true (par défaut : « false ») force le stockage de ces valeurs de contexte dans un fichier écrit dans tmp/cache/contextes/ et n'en passe qu'un « hash » de 32 caractères dans l'url.

Il est possible de définir cette constante dans votre fichier config/mes_options.php (voir l'article qui lui est consacré)

- Valeur par défaut : false

exemple :

// contrer les limitations de suhosin sur la taille des variables GET
define('_CACHE_CONTEXTES_AJAX', true);

{par ...}

denisb — 2012-05-05T10:35:08Z

Le critère {par ...} spécifie un ordre de présentation des résultats d'une boucle.

Le critère {par ...} spécifie un ordre de présentation des résultats d'une boucle. Par exemple, on pourra ordonner les articles {par date}, {par date_redac} ou encore {par titre}…

Ordonner par numéro

Depuis SPIP 1.3 il est possible d'ordonner l'affichage des éléments en fonction du préfixe numérique d'un de leurs champs (titre, sur-titre, ps…) [1]. Pour cela, le critère s'écrit :
{par num champ}.
Par exemple pour ordonner suivant le préfixe numérique associé au titre, {par num titre} affichera les éléments dans l'ordre croissant des préfixes numériques de leur titre, en commençant (s'il y en a) par les titres non préfixés (qui, eux, ne seront pas ordonnés).

À noter :

le critère {par num ...} prend aussi en compte toutes les valeurs du champ commençant par un chiffre ; ainsi {par num surtitre} tiendra compte du surtitre « 14 juillet 1789 » et le placera entre « 10. surtitre quelconque » et « 20. Autre surtitre ».
pour les préfixes commençant par des 0 (zéro), l'ordre rendu par {par num titre} sera du préfixe comportant le plus grand nombre de zéros vers le préfixe en comportant le moins : 00000. Titre…, 0000. Titre…, 000. Titre…, 0. Titre…

Ordonner par langue et ordre alphabétique

Dans le cadre d'un site multilingue le critère {par multi ...} permet de trier par ordre alphabétique dans chaque langue séparemment ; par exemple : {par multi titre}. Sans l'ajout de multi la boucle renverrait le tri par ordre alphabétique toutes langues mélangées.

Ordonner selon plusieurs champs

Depuis SPIP 1.8 il est possible d'ordonner les éléments selon plusieurs champs. En écrivant {par champ1, champ2} on indique les ordres de tri consécutifs : les résultats sont d'abord triés selon le champ1, puis selon le champ2 pour les champs1 identiques. Il est possible de spécifier autant de champs que nécessaire.
Par exemple : {par date, titre} affichera les résultats triés par date (de la plus ancienne à la plus récente), puis les résultats ayant la même date seront triés par titre (dans l'ordre alphabétique).

Depuis SPIP 1.8.2 il est possible de spécifier plusieurs critères {par ...} pour une boucle. Par exemple : {par date} {par titre} est équivalent à l'exemple précédent {par date, titre}.

Attention :
Quand on utilise plusieurs critères de tri, le critère {inverse} ne s'applique qu'au critère de tri placé juste avant. Ainsi {par date} {par titre} {inverse} n'appliquera le tri inversé que sur le champ titre (de Z à A), la date conservant son tri par défaut (de la plus ancienne à la plus récente).

C'est pourquoi SPIP 1.8.2 a introduit la notation {!par ...} qui inverse un critère de tri en particulier. Par exemple : {!par date} {par num titre} ordonne les résultats par date décroissante (de la plus récente à la plus ancienne) puis par numéro croissant pour les titres ayant la même date.
Cependant : {!par date, num titre} ordonne les résultats par date décroissante (de la plus récente à la plus ancienne) puis par numéro décroissant pour les titres ayant la même date ; cette écriture est donc équivalente à {!par date} {!par num titre} mais est différente de {par date, num titre} {inverse} (où {inverse} ne s'applique que sur date).
Attention donc à bien choisir votre écriture des critères en fonction des résultats que vous attendez.

Ordonner dynamiquement

Le critère {par ...} accepte aussi des noms de champs SQL spécifiés dynamiquement, notamment par la balise #ENV. Par exemple : {par #ENV{variable}} ordonnera sur la valeur de « variable » passée en url &variable=titre à condition que cette valeur soit un champ SQL de la table concernée par la boucle : ainsi &variable=num titre ne fonctionnera pas puisque aucun champ SQL ne se nomme num titre.

Ordre aléatoire

Il est possible d'obtenir une liste présentée dans un ordre aléatoire en utilisant le critère {par hasard}.

Ordonner les éléments d'une recherche par pertinence

Afin de classer les résultats d'un formulaire de recherche par pertinence, on utilisera le critère {par points} {inverse} ; un simple {par points} ordonnant les résultats de la plus petite à la plus grande pertinence.

[1] Le format du préfixe numérique est :
un nombre de n chiffres, suivi d'un point ou d'une parenthèse fermante, suivie d'un espace.
exemples :
015. Un titre
51) Un autre titre

Voir aussi le critère {inverse}

{inverse}

denisb — 2012-05-05T10:35:04Z

Le critère {inverse} provoque l'affichage dans l'ordre inverse de celui demandé dans le critère le précédant.

Le critère {inverse} provoque l'affichage dans l'ordre inverse de celui demandé dans le critère le précédant. Par exemple : alors que {par date} affichera les éléments en commençant par les plus anciens, {par date}{inverse} affichera la liste en commençant par les plus récents.

Le critère {inverse} s'utilise donc toujours associé à un critère de tri préalablement spécifié. Voir aussi la page du critère {par ...}.

Dans le cas où le critère de tri est multiple, par exemple : {par titre, date} qui demande d'abord un tri alphabétique des titres (de A à Z) puis, pour les titres identiques un (sous) tri par date (de la plus ancienne à la plus récente), l'application du critère {inverse} (en écrivant donc {par titre, date} {inverse}) n'inversera l'ordre que sur le premier champ de tri spécifié (ici : titre qui sera ordonné de Z à A) et conservera l'ordre par défaut sur le second (ici : date qui restera ordonné de la plus ancienne à la plus récente).

Si l'on veut spécifier un ordre inverse pour les deux champs concernés, il faudra écrire :
{par titre} {inverse} {par date} {inverse}.

Depuis SPIP 1.9, le critère {inverse} peut prendre en paramètre n'importe quelle balise pour faire varier dynamiquement le sens du tri.
Par exemple, il est possible d'écrire :

ce qui permet de choisir la colonne de tri et le sens du tri donnés par l'url ; par exemple : tri=titre&senstri=1 qui équivaudra à {par titre} ou tri=date&senstri=0 qui équivaudra à {par date} {inverse}.

Voir aussi le critère {par ...}

|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

#RANG

Jean-Baptiste Pressac — 2012-04-29T20:56:47Z

La balise #RANG retourne, s'il existe, le préfixe numérique utilisé au début du titre d'un objet SPIP (article, rubrique, auteur, mot clé…)

Renvoie le préfixe numérique utilisé au début du titre d'un objet SPIP (article, rubrique, auteur, mot clé…)

Rappel : Les préfixes sont généralement utilisés pour classer les objets entre eux. Par exemple, pour classer des articles selon un ordre imposé, on peut numéroter leurs titres, depuis l'espace privé, par un numéro suivi d'un point et d'un espace : « 10. Premier article », « 20. Deuxième article », etc.

Exemple d'utilisation de la balise #RANG :
pour afficher dans une liste uniquement les rubriques dont le préfixe existe et est supérieur ou égal à 100 :


 



[(#RANG|>={100}|oui)#TITRE
]

_IMG_GD_QUALITE

denisb — 2012-04-26T07:01:45Z

Si vous avez choisi en configuration avancée d'utiliser la librairie GD pour le traitement des images, cette constante définit le taux de qualité qu'utilisera GD pour le rendu des images traitées (filtres image, génération des vignettes…).

Les effets de la constante _IMG_GD_QUALITE ne sont visibles que sur les images qui subissent un traitement spécifique (filtres d'images, génération de vignette, #LOGO_DOCUMENT… voir Traitement automatisé des images). Cette constante n'aura aucun effet sur l'affichage des images non filtrées (directement appelées avec par exemple).

Il est possible de définir cette constante dans votre fichier config/mes_options.php (voir l'article qui lui est consacré)

Les valeurs peuvent aller de 0 à 100 (sachant que plus la valeur sera élevée, plus de ressources serveur —temps, mémoire, cpu— seront nécessaires pour le traitement des images ).

- Valeur par défaut : 85

exemple :

// réduire fortement la qualité des images traitées par GD
// (économie de ressources serveur)
define('_IMG_GD_QUALITE', 50);

Télécharger

Quelques exemples de rendus :

define('_IMG_GD_QUALITE', 100) ;

define('_IMG_GD_QUALITE', 85) ; (par défaut)

define('_IMG_GD_QUALITE', 50) ;

define('_IMG_GD_QUALITE', 20) ;

define('_IMG_GD_QUALITE', 0) ;

|antispam

Teddy — 2012-04-25T23:51:57Z

Pour ne pas être spammé par des robots, SPIP fournit le filtre |antispam

Le filtre |antispam maquille une adresse email pour éviter que celle-ci ne soit collectée par un robot spammeur.
Le filtre remplace le "@" par 3 caractères générés de façon aléatoire.

Exemple : vous avez renseigné l'email du webmestre, #EMAIL_WEBMASTER, dans la configuration du site avec la valeur mon.nom@domaine.fr. En appliquant le filtre dans un squelette de la façon suivant : [(#EMAIL_WEBMASTER|antispam)], vous obtiendrez à l'affichage de la page mon.nom KzL domaine.fr

|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

|heures_minutes

Teddy — 2012-04-23T07:51:29Z

Le filtre |heures_minutes (depuis SPIP 1.2, SPIP 1.2.1) affiche l'heure avec les minutes de la date sur laquelle il s'applique.
[(#DATE|heures_minutes)]

L'heure retournée varie de 00h00min à 23h59min.

Ainsi si vous indiquez [(#VAL{2009-10-24 15:24:13}|heures_minutes)], le filtre retournera 15h24min.

voir aussi les filtres |heures, |minutes et |secondes