.. _template_loops:

.. highlight:: jinja

#####################
Loops
#####################

.. _for_loop:

**********
For loop
**********

This will split a list of comma separated Custom Fields and loop through them.

.. code::

    <ul>{% for key in "[post_custom_fields]"|split(',') %}
      <li>{{ key|trim }}</li>
    {% endfor %}</ul>

You can also use Post Status Notifier's placeholders ending with **"_array"** (which are PHP arrays internally) to loop through them directly.

.. code::

    <ul>{% for key in [post_custom_fields_array] %}
      <li>{{ key|trim }}</li>
    {% endfor %}</ul>

Three column design
~~~~~~~~~~~~~~~~~~~

This is an example of how to split an array into three parts and show the values in three columns. It uses PSN's custom filter :ref:`filter_divide`.

.. code::

    <div>
        {% for part in [post_categories_array]|divide(3) %}
            <div style="float: left; width: 33%;">
                <ul>
                    {% for column in part %}
                    <li>{{ column }}</li>
                    {% endfor %}
                </ul>
            </div>
        {% endfor %}
        <div style="clear: both;"></div>
    </div>

.. note::

    Check out the `Twig documentation page <https://twig.symfony.com/doc/tags/for.html>`_ for more details about the ``for`` loop.