ElementsDeGrammaireSpip

Version 7 — Avril 2010 — 82.126.xx.xx

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.

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
- Exemples d’expressions composées

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}}

Note : Depuis SPIP 1.9, on peut utiliser des fonctions SQL dans les critères, notamment pour le tri :
{par FCT(titre)}

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 [1], tandis que :
<:article|image_typo{police=#CONFIG{dir/police}}:>
le sera.

Ce qui suit date et doit être vérifié ou actualisé :

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 : 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}}

</blockquote>

Exemples de codes composés

1) #SET imbriqués et appels de filtre [2] :

[(#ENV{retour}|=={'./'}|?{
              [(#SET{retour,../})],
              [(#SET{retour,[(#VAL{../}|concat{#ENV{retour,''}})]})]  
})]

Peut en l’occurence également s’écrire :

[(#ENV{retour}|=={./}|?{
              #SET{retour, ../},
              #SET{retour, ../#ENV{retour, ''}}    
})]

Tentative de théorisation

Le 15 avril 2010 à 00h40, Maïeul théorise les étrangèretés du compilateur :

si j’ai bien compris, le compilateur ne semble pas compter le nombre d’accolades fermantes — tout comme il s’arrete dans certaines expressions à la première parenthèse fermante.

En pratique, ne fonctionnent pas sous SPIP2.1
[(#STATUT|=={publie}|oui)#FORMULAIRE_EDITER_ARTICLE{#ID_ARTICLE, #ID_RUBRIQUE, [(#URL_ARTICLE|parametre_url{var_mode,calcul})]}]

[(#STATUT|=={publie}|oui)#FORMULAIRE_EDITER_ARTICLE{#ID_ARTICLE, #ID_RUBRIQUE, (#URL_ARTICLE|parametre_url{var_mode,calcul})}]

Par contre les deux exemples ci-dessous fonctionnent :

[(#STATUT|=={publie}|oui)#FORMULAIRE_EDITER_ARTICLE{#ID_ARTICLE, #ID_RUBRIQUE, #URL_ARTICLE|parametre_url{var_mode,calcul}}]

[(#STATUT|=={publie}|oui)#FORMULAIRE_EDITER_ARTICLE{#ID_ARTICLE, #ID_RUBRIQUE, #URL_ARTICLE|parametre_url{var_mode,calcul}]