Met het baken #FOREACH kan worden «gelust» op een inhoud zoals op een in een skelet berekende tabel en op ieder element kan een SPIP model worden losgelaten.
#FOREACH{baken, model}
In SPIP 3 werd dit baken vervangen door de lus DATA.
Voorbeelden
- In een skelet toont #FOREACH{env} alle variabelen van het baken #ENV op de volgende wijze:
- page=> test_lus
- date=> 2009-12-22 22:44:27
- date_default=> 1
- date_redac=> 2009-12-22 22:44:27
- date_redac_default=> 1
Anders gezegd, op elke element van de ze associatieve PHP tabel die het baken #ENV vertegenwoordigt, zal #FOREACH het model foreach.html toepassen (vgl. verderop).
- Wil je de inhoud van een ander baken weergeven, zoals #CONFIG, dan geef je de naam van dit baken als eerste parameter door:
#FOREACH{config} toont iets dergelijks:
- charset_sql_base=> utf8
- charset_collation_sql_base=> utf8_general_ci
- charset_sql_connexion=> utf8
- version_installee=> 14558
- nouvelle_install=> 1
- plugin=>
a:3:{s:3:"CFG";a:4:{s:3:"nom";s:90:"<multi> [fr]cfg: moteur de configuration [en]cfg: Configuratiemotor </multi>";s:4:"etat";s:6:"stable";s:3:"dir";s:8:"auto/cfg";s:7:"version";s:6:"1.14.1";}} - derniere_modif_rubrique=> 1260746188
- ...=> ...
En voor ieder SPIP baken dat een PHP tabel vertegenwoordigt, krijg je een soortgelijk resultaat (zie #ARRAY).
Een specifiek model maken
Standaard wordt het model foreach.html gebruikt. Het staat in de map squelettes-dist/modeles/. Je kunt het aanpassen, maar het is beter om zelf een model te maken dat specifiek gebruikt wordt voor een baken en dit te plaatsen in de map squelettes/modeles/.
Het model foreach_baken.html correspondeert met #FOREACH{baken}.
Je kunt ook andere algemene modellen maken en voor een of ander baken gebruiken.
Om bijvoorbeeld een model te maken voor een gewone lijst, maak je squelettes/modeles/foreach_ul_li.html, wat bevat: <li><a href="#ENV{waarde}">#ENV{sleutel}</a></li> zal worden toegepast met [<ul>(#FOREACH{ENV, foreach_ul_li})</ul>] en genereert deze HTML:
<ul>
<li><a href="test_boucle">page</a></li>
<li><a href="2009-12-22 22:54:40">date</a></li>
<li><a href="1">date_default</a></li>
<li><a href="2009-12-22 22:54:40">date_redac</a></li>
<li><a href="1">date_redac_default</a></li>
</ul>Meer waardes
In meer ingewikkelde situaties kun je meerdere waardes aan het model doorgeven door de volgende tabelstructuur voor het baken toe te passen:
array (
'cle' => array (
'val1' => 'valeur1'
'val2' => 'valeur2'
'val3' => 'valeur3'
'val4' => 'valeur4'
)
'cle2' => array (
'val1' => 'valeur1bis'
'val2' => 'valeur2bis'
'val3' => 'valeur3bis'
'val4' => 'valeur4bis'
)
)en daarvoor gebruik je een aangepast model:
#ENV{val1}, #ENV{val2}, #ENV{val3} en #ENV{val4}