ibexa

Caution: This documentation is for eZ Publish legacy, from version 3.x to 5.x.

foreach

Summary

Iterates over arrays in different ways.

Usage

{foreach <array> as [ $keyVar => ] $itemVar  
         [ sequence <array> as $sequenceVar ]
         [ offset <offset>                  ]
         [ max <max>                        ]
         [ reverse                          ]}

    [ {delimiter}...{/delimiter} ]
    [ {break}    ]
    [ {continue} ]
    [ {skip}     ]
    
{/foreach}

Description

This construct makes it possible to iterate over arrays in different ways. The loop can be tweaked using parameters:

Parameter

Description

Value

sequence

Defines a sequence which is iterated together with the normal loop parameter (see example below)

array

offset

Determines the start of the loop array for the iterations

integer

max

Determines the maximum number of iterations

integer

reverse

The loop is performed in the reverse order if this is set

  

There are also a set of inline template loop control structures available, these need to be a direct child of the foreach structure:

 

Description

Value

delimiter

Determines a block of template elements which should be placed in between two iterations

mixed

skip

Jumps to next iteration, does NOT output delimiter

  

breaks

Breaks out of the foreach

  

continue

Jumps to next iteration, but outputs delimiter

  

Examples

Example 1

{foreach $objects as $object}
 
    {$object.name} <br />
 
{/foreach}

This example will print out the names of the objects that are stored in the $objects array. If this array stores 4 objects with the following names: "Emmett Brown", "Marty McFly", "Lorraine Baines" and "Biff Tannen", the following output will be produced:

Emmett Brown
Marty McFly
Lorraine Baines
Biff Tannen

Example 2

{foreach $objects as $index => $object}
 
    {$index} : {$object.name} <br />
 
{/foreach}

This example demonstrates how to create an iteration counter.

0: Emmett Brown
1: Marty McFly
2: Lorraine Baines
3: Biff Tannen

Example 3

{foreach $objects as $object sequence array( 'dark', 'light' ) as $style}
 
    <div class="{$style}">{$object.name}</div>
 
{/foreach}

This example demonstrates how to create a loop where the iterations are displayed using alternating styles (in this case dark, light, dark, light and so on).

Balazs Halasy (22/02/2005 1:11 pm)

Geir Arne Waaler (17/08/2010 3:27 pm)

Balazs Halasy, Geir Arne Waaler

Comments

  • Other parameters?

    Friday 08 July 2005 1:04:20 am

    Mindshare Tech

    Any chance you might update this piece to list out what all the other parameters do? Thanks!

    • Re: Other parameters?

      Wednesday 13 July 2005 3:06:32 pm

      Alimi Nabil

      Hi,

      Take a look at this : http://ez.no/ez_publish/documenta...plate_functions/program_flow/section

      The {foreach} statement is a replacement for the {section loop=..}.

      • Re: Other parameters?

        Wednesday 05 April 2006 1:20:26 pm

        Nathalie Grimaud

        offset :
        Determines the start of the loop array for the iterations, the value must be an integer.

        max :
        Determines the maximum number of iterations, the value must be an integer.

  • parameters

    Monday 16 January 2006 3:20:37 pm

    AtR

    These parameters is not explained here or in the section part, so I start some guessing..
    [ {break} ] guess this breakes out of the foreach ??
    [ {skip} ] and this jumps to next element ?
    [ {continue} ] ??

    • Re: parameters

      Friday 12 September 2008 8:50:42 am

      chs

      I was wondering the same about skip and continue.

      Extract from lib/eztemplate/classes/eztemplateloop.php:
      elseif ( $childFunctionName == 'continue' )
{
  $this->SkipSequenceIncrement = true;
  break;
}
elseif ( $childFunctionName == 'skip' )
{
  $this->SkipSequenceIncrement = true;
  $this->SkipDelimiter = true;
  break;
}


      So the difference seems to be that with "continue" {delimiter} will get displayed.

  • working without modulo

    Monday 30 January 2006 7:45:55 pm

    James Ward

    If you miss the delimiter modulo combination provided by the old section structure you can accomplish the same thing with code like this:
    {foreach $objects as $objectKey => $object}
 {if eq($objectKey|mod(2),0)}
  {node_view_gui view=line content_node=$object}
 {else}
  {node_view_gui view=line content_node=$object}
 {/if}
{/foreach}

  • Delimiter ?

    Friday 11 August 2006 12:51:19 pm

    Alimi Nabil

    is the {delimiter} statement deprecated ? It doesn't seem to work with foreach.

    • Re: Delimiter ?

      Monday 14 August 2006 1:54:51 pm

      Lenara Anafieva

      It works as expected.
      Tested using an example:
      foreach<br>
      {let $b=array( 1, 2, 3, 4, 5, 6, 7 )}
      {foreach $b as $bitem}
      {$bitem}
      {delimiter}
      <br>:DEL:<br>
      {/delimiter}
      {/foreach}
      {/let}

      I've got these on the output:
      foreach
      1
      :DEL:
      2
      :DEL:
      3
      :DEL:
      4
      :DEL:
      5
      :DEL:
      6
      :DEL:
      7

      And output results are expected

      • Are you sure ??

        Monday 06 November 2006 10:55:35 am

        André

         {foreach $module_result.path as $path}
  {if $path.url}
    [LT]a href={cond( is_set( $path.url_alias ), $path.url_alias,
                                        $path.url )|ezurl}[GT]{$path.text|wash}[LT]/a[GT]
  {delimiter}
		/
  {/delimiter}
  {else}
	{$path.text|wash}
  {/if}
  {/foreach}



        Warning: eZTemplate Oct 18 2006 18:16:03
        Function "delimiter" is not registered


        eZ Publish 3.8.5

        • Re: Are you sure ??

          Wednesday 18 October 2006 4:14:47 pm

          André

          update: It's because it's inside an if clause!!!

  • Get image width in Foreach loop

    Wednesday 28 February 2007 10:54:34 pm

    Paul Bolger

    Thanks Lukasz, for this answer on extracting an image width (useful for defining the width of a parent container in css).


    <div class="picleft" style="width:{$related.data_map.picture.content[portrait].width}px>
    {attribute_view_gui attribute=$related.data_map.picture image_class=portrait}
    </div>

    Gives you an image wrapped in a div of the same width as the image.

    'portrait' is the image alias.