The iterator: Pages iteration made easy

Undraw Building Websites I78t


iterator permits to loop over a content fragment in order to create a list of pages.

You may use it to generate any layout.

In particular, you may use it to generate the following layouts:

Layout Description
grid a grid of cells that adapt to the screen size
carrousel horizontal list navigation with control
simple list a vertical list with bullet points
table a table
masonry bricks that fill the wall



The below iterator example:

  • will generate the last 4 modified pages (defined by the page sql in the data node)
select order by date_modified desc limit 4

The iterator markup:

    <data>select where is_low_quality = 0 order by date_modified desc limit 6</data>

    <heading d3 align="center"> The last 6 Changes </heading>
            <card clickable>
            <page-image ratio="16:9"/>
            === $title ===
            <itext color="muted">${date_modified | format('MMM dd HH:mm')}</itext>
            ${description | head(100,'...')} [[$path| ]]

The Result:

The last 6 Changes
Excluded By Noindex Tag Google Console
Release 1.25.2

May 23 08:11

This page is the details of the release 1.25.2 The syntax analytics does not show the component anymore...

Undraw My Documents
How ComboStrap analyzes and replicates data ?

May 13 11:44

The analysis and replication of a webpage are the cornerstones of the quality and performance of a page....

Undraw Stepping Up
How to create a top menu bar?

May 12 14:06

The theme system supports the creation of a slot page called header slot in order to create a menu bar...

Extension Manager Dokuwiki Manual Install

May 04 21:14

This page lists the standard steps that need to be taken in order to update your ComboStrap installation...

Undraw My Documents
syntax_count - Analyse the syntax of your page

May 04 19:58

The syntax count statistic shows the number of occurrence of a component (syntax) on a page

Undraw Icon Design Re 9web
ComboStrap - Create your web footprint that lasts ForEver

May 04 10:35

Advertise yourself, your documentation or your company with a product that makes a qualitative website...


   <data>select where variable = 'xxx'</data>
   ... header  markup...
   <fragment>Fragment markup with $variable1 ... $variable2</fragment>
   ... footer  markup...


  • data contains a page sql
  • fragment is a content fragment that will be repeated for each data row.
  • If your iteration is time-based, you may need to set a page cache expiration frequency.
  • If the data does not return any rows, the iterator content is not printed (ie header and footer included)

Showcase yourself and your brand

Get free news, tips, and tricks
to create a remarkable experience for your readers.

Related HowTo's
Undraw Animating
How can I generate a list of pages?

This howto shows you how you can generate a list of pages with the iterator components. page sql a list element with a link created from: the path and the title variables
Undraw Animating
How to generate and layout a list of pages with a grid ?

This howto shows you how to use the page sql, a fragment, the iterator and to generate a grid layout.
Undraw Animating
How to get a serie of images with the same dimension (Width and Height) ?

When rendering a serie of images, you may want them to have the same dimension (width and height) in order to get a consistent and peaceful visual. To achieve it, you need to use the combine the ratio...

Recommended Pages
Backlink Action
Backlinks management in ComboStrap

Backlinks are important because they give extra-navigation possibilities and gives also more weight to pages. This article tell you everything about backlinks in ComboStrap
Undraw Growth Chart R99m
How ComboStrap tackles SEO to bring you more visitors?

How ComboStrap tackles SEO to bring you more visitors? seoSearch engine optimization (or SEO) is the process of making your website optimized for search/enginesearch engine (Google, Bing, ...) to...
Card Illustration
ComboStrap UI - Creating a card

A card is a box composed of an image, a text and a call to action
Combostrap Hierarchical Breadcrumb
ComboStrap UI - Hierarchical Breadcrumb

A Hierarchical Breadcrumb is a breadcrumb that shows where the page is located in the page system tree in hierarchical order. Combostrap offers two types of hierarchical breadcrumbs: navigation: the...
Undraw Website Builder Re Ii6e
ComboStrap UI - Masonry

masonry is a layout component. Its children are laid out like a mason-fitting stones in a wall (placing elements based on available vertical space). This layout is handy when you want to lay out a list...
Undraw My Documents
Descendant Pages

Descendant pages are pages that have the same or a higher level than the current page in the page system. The descendant's pages can be queried to create an illustrative list in index pages. You can...
Featured Icon

The featured icon is an illustrative image that you can render with the page-image tag. This is an illustrative icon for the page. You would use it generally within an iterator. With the page image...
First image

The first image is an illustrative image that you can render with the page-image tag. As its name indicates, this is the first image found on your page. You would use it generally within an iterator....
Undraw Website Builder Re Ii6e
How to create a carrousel layout

The carrousel component permits to layout and to scroll components horizontally.
How to define your data set with Sql

This page defines the sql that can be used to retrieve data from pages

Task Runner