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
Combostrap Default Theme File Explorer
How to create your own theme?

Sep 06 08:27

This page shows you how to create your own theme. You can then apply advanced design and logic to your...

Page Explorer List Name To Ui Region
Page-explorer: adding page navigation easily to your website

Aug 27 12:33

With the page-explorer component, you can add an explorer like panel that will list your pages in a list...

Release 1.25 - Layout all the way!

Aug 24 15:46

The release 1.25 is a big release that brings theming and slot management. contact me Due to...

Extension Manager Dokuwiki Manual Install
How to update Combo or a third party-plugin?

Aug 24 09:24

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

Fatal Exception Exhausted Memory
How to resolve the memory error when updating?

Aug 24 09:16

When trying to update Combstrap or a third-party plugin, you may get an exhausted memory error. This...

Dokuwiki Parser Execution Time
Parsing performance

Aug 11 15:29

1.25 When installing combo, people may see a degradation in performance during the initial rendering...


   <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 and their image?

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
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 Growth Chart R99m
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 get to the top of their result. On a website level, it means:...
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