Rôle

La boucle GEOTEST sert à tester si un objet est géolocalisé et/ou a des descendants géolocalisés. Elle permet également de tester si le plugin est actif.

Elle peut être utilisée dans les squelettes autour d'un balise #GEOMAP pour tester s'il y a lieu, ou non, d'afficher une carte.

Utilisation

La syntaxe est la suivante :

<B_geo>
<BOUCLE_geo(GEOTEST){identificateur d'objet}[{recursif}]>
...
</BOUCLE_geo>
</B_geo>

Le critère {identificateur d'objet} est obligatoire, il permet d'identifier l'objet que l'on est en train de tester. Il peut s'agir de critère faisant référence au contexte des boucles, comme {id_article}, ou une indication explicite comme {id_rubrique=2}, ou encore un couple {objet=document}{id_objet=123}.

Le critère {recursif} indique qu'il faut également tester si l'objet possède des descendants géolocalisés.

Il suffit que l'objet lui-même ou qu'un seul de ses descendants soit géolocalisé pour que le contenu de la boucle s'exécute.

Exemple

<B_geo>
<BOUCLE_geo(GEOTEST){id_article}>[
	(#GEOMAP{id_article,markers=query})
]</BOUCLE_geo>
</B_geo>

Limitations

Par rapport aux possibilités offertes pour l'ajout des marqueurs, le test effectué est assez limité.

Par exemple, il arrive assez souvent que l'on veuille afficher une carte contenant les descendants mais pas l'objet lui-même, il faudrait donc tester si au moins un descendant est géolocalisé, indépendemment de l'objet lui-même.