ElementsDeGrammaireSpip

La doc officielle décrit les contours de la grammaire de SPIP et constitue un mode d’emploi pour démarrer.

Cette page vise à compléter la doc avec plus de détails sur ce qui est possible pour chacune des expressions intervenant dans la syntaxe des boucles SPIP et autres éléments du langage.

Intro

Cette liste des possibles et des impossibles devrait éviter de longues et stériles heures de debuging à des codeurs aventuriers mais mal renseignés.

Eléments de grammaire SPIP

Pas de langage spécialisé, juste du français pour décrire ce qui pose problème.

régle : ne pas mettre les crochets parenthèses pour appeler un filtre en critère

exemple :

{date_birth < #ENV{agemin,9999-99-99}|approxdate}
{date_birth != #ENV{agemin}|?{0000-00-00, 9999-99-99}}

régle : ne pas mettre les crochets parenthèses dans la partie valeur d’un #SET

exemple :

#SET{dater,[(#DATE|affdate{'m-d'})]}      <!-- ne marche pas -->
#SET{dater,#DATE|affdate{'m-d'}}           <!-- marche -->

régle : pas trop compliquer les expressions

<:une_chaine|image_typo{police=[(#CONFIG{dir/police})]}:>
ne sera pas compris par spip, tandis que :
<:article|image_typo{police=#CONFIG{dir/police}}:>
le sera.
(nov 08)

ce qui suit date...

règle : pas de boucles SPIP ni de <INCLURE> à l’intérieur d’un filtre.

Ainsi, par exemple :
[(#POPULARITE_ABSOLUE|<{'3'}|?{'',<INCLURE(inclusions/inc_article_decompte_popularite.php3){id_article}>})]

n’est pas possible, mais ce qui suit est possible :

régle : pas de filtres dans les critères

Depuis la 1.9, on peut par contre utiliser des fonctions SQL dans les criteres (notamment par fct(titre).

règle : parenthèse parfois nécessaires dans les critères

Il faut écrire {par (#ENV{x})}    
car ce n’est pas accepté comme ça : {par #ENV{x}}