######
Výpisy
######

==============
List-container
==============

Výpis produktů dle šablony *list-item*. Pokud nejsou nalezeny žádné produkty, použije se zpráva definovaná v *list-empty*.

Do **volitelného** *data-role="pagination"* je doplněn obsah definovaný přes *pagination* v souboru *_listing.tpl* (*_listing_article.tpl* pro články atd.). Různé šablony lze určit atributem *data-name*.

**POZOR!** Není možné obalovat stránkování podmínkou pro zobrazení. Takový kód by nefungoval při fitrování přes AJAX. Pokud je potřeba například skrýt stránkování u výpisů s jen jednou stranou, stačí přidat podmínku do *<i:list-pagination>*

.. code-block:: html+twig

    {# použije šablonu "default" (nebo bez jména) z _listing.tpl #}
    <i:list-container type="product">
        <div data-role="pagination"/>
        <div data-role="empty"/>
        <div data-role="list"/>
    </i:list-container>

.. code-block:: html+twig

    <i:list-container type="product">
        <div data-role="pagination"/>
        <div data-role="empty"/>
        <div data-role="list" data-name="short"/>
        <div data-role="pagination" data-name="simple" />
    </i:list-container>

.. code-block:: html+twig

    {# obalit boxy po třech do .wrap, proložit <hr> a přidat třídu "third" #}
    <i:list-container type="product" wrap="3:div.wrap" append="3:hr" box-class="3:third">
        <div data-role="empty"/>
        <div data-role="list"/>
    </i:list-container>

.. code-block:: html+twig

    {# obalit boxy po třech do .wrap a .www-rap, proložit <hr> a přidat třídu "third" #}
    <i:list-container type="product" wrap="3:div.wrap.www-rap" append="3:hr" box-class="3:third">
        <div data-role="empty"/>
        <div data-role="list"/>
    </i:list-container>

.. code-block:: html+twig

    {# použije šablonu "news" z _listing.tpl #}
    <i:list-container type="product" name="news">
        <div data-role="empty"/>
        <div data-role="list"/>
    </i:list-container>

.. csv-table:: Atributy **list-container**
    :header: "data-role", Povinný, "Popis"

    **type**, **ano**, typ výpisu
    source, *ne*, Twig object s parametry výpisu (nelze kombinovat s *collection*)
    collection, *ne*, seznam položek k vypsání (nelze kombinovat s *source* a nepodporuje stránkování)
    name, *ne*, šablona položky (dle *list-item*)
    analytics-name, *ne*, pojmenování pro měření (např "product.detail.bottom")
    wrap, *ne*, obalovat skupiny boxů
    append, *ne*, přidat tag za skupinu boxů
    box-class, *ne*, přidat třídu
    hide-empty, *ne*, "skýt celý container, pokud neobsahuje položky (bez hodnoty)"
    scroll-offset, *ne*, CSS selector pro započítání fixní hlavičky
    insert-before, *ne*, název šablony listing-insert pro vložení před každou položku
    insert-after, *ne*, název šablony listing-insert pro vložení za každou položku
    insert-arguments, *ne*, argumenty k předání do šablony prepend-insert - twig zapsán jako {{ {abc: product.id} }} bude zpracován přes json_encode, takže pouze jednoduché hodnoty (čísla, pole, jednoduché objekty)
    class, --- , třída

hide-empty - skrýt výpis bez položek
------------------------------------

Při uvedení atributu *hide-empty* (uvádí se bez hodnoty) se container vůbec nevypíše, pokud neobsahuje žádné položky. S tímto atributem se pak vůbec nepoužívá definice prázdného výpisu.

.. code-block:: html+twig

    <i:list-container type="product" source="{kategorie:123,limit:10}" hide-empty>
        <div data-role="list"/>
    </i:list-container>

source - parametry výpisu
-------------------------

Pokud není atribut *source* uveden, použije se defaultní výpis pro danou stránku. Například v kategorii se budou vypisovat produkty z kategorie atd. Výpis bez uvedeného *source* aktualizuje URL při změně (strana, filtr, ...)

V parametrech je možné použít globální proměnné, ale není možné použít žádnou lokální proměnou. Tzn. zápis musí fungovat úplně stejně, pokud se smaže zbytek šablony.

.. code-block:: html+twig

    <i:list-container type="product" source="{kategorie:123,limit:10}">
        <div data-role="empty"/>
        <div data-role="list"/>
    </i:list-container>

.. code-block:: html+twig

    <i:list-container type="product" source="{kategorie:kategorie.id,limit:10}">
        <div data-role="empty"/>
        <div data-role="list"/>
    </i:list-container>

wrap - obalení boxů do jednoho tagu
-----------------------------------

Atributem *wrap* lze definovat, jakým tagem s jakou třídou *(třída je nepovinná)* a z jakých podmínek se mají boxy obalit.

.. code-block:: html+twig

    <i:list-container source="zdroj_zbozi" wrap="3:ul.sublist" class="list">
        <div data-role="empty"/>
        <div data-role="list"/>
    </i:list-container>

.. code-block:: html

    <div class="list">
        <ul class="sublist">
            <li>product</li>
            <li>product</li>
            <li>product</li>
        </ul>
        <ul class="sublist">
            <li>product</li>
            <li>product</li>
            <li>product</li>
        </ul>
        <ul class="sublist">
            <li>product</li>
        </ul>
    </div>

append - přidání tagu dle pořádí
--------------------------------

Atribut *append* určuje tag, který se má vkládat za vypisované boxy dle podmínek. Podmínek lze zapsat i více a oddělit je čárkou - použije se první tag, který splňuje podmínku.

.. code-block:: html+twig

    <i:list-container append="3:hr.divider,last:hr.last" class="list">
        <div data-role="empty"/>
        <div data-role="list"/>
    </i:list-container>

.. code-block:: html

    <div class="list">
        <div class="item">product</div>
        <div class="item">product</div>
        <div class="item">product</div>
        <hr class="divider"/>
        <div class="item">product</div>
        <div class="item">product</div>
        <div class="item">product</div>
        <hr class="divider"/>
        <div class="item">product</div>
        <hr class="last"/>
    </div>

===============
List pagination
===============

Definice stránkování - vždy v souboru **_listing.tpl**. Definuje makro, které se následně využívá pro výpis produktů v *list-container*.

Obvykle obsahuje stránkování, informace o počtu záznamů atd.

Nelze přistupovat ke globálním proměnným a je dostupná pouze proměnná **pagination** a **filterActive**.

.. code-block:: html+twig

    {# _listing.tpl #}
    <i:list-pagination>
        {%if pagination.stran > 1%}
            {%trans%}celkem položek{%endtrans%}: <strong>{{pagination.nsum}}</strong>
            {%trans%}strana{%endtrans%}:  <strong>{{pagination.strany|raw}}</strong>
        {%endif%}
    </i:list-pagination>


.. code-block:: html+twig

    {# _listing.tpl #}
    <i:list-pagination>
        {# přidá další stranu do výpisu místo změny strany #}
        <button data-role="add-page">další produkty</button>
    </i:list-pagination>


.. csv-table:: Atributy **pagination**
    :header: "data-role", "Default", "Popis"

    **type**, --- , "typ položky *(product, article, ...)*"
    name, *default*, název boxu pro provázání s *list-container*


.. csv-table:: Atributy **pagination.strany**
    :header: Atribut, Hodnoty, "Popis"

    spaces, true/false , vkládat mezi stránky nedělitelnou mezeru
    size, 1/2/3/4/5/... , počet zobrazených odkazů
    label_next, 'string' , text odkazu na další stránku
    label_previous, 'string' , text odkazu na předchozí stránku
    hash, 'string' , do odkazu se doplní hash za #


.. code-block:: html+twig

    {# _listing.tpl #}
    <i:list-pagination>
        {{pagination.strany({spaces: true, label_next: 'next-page'|trans})}}
    </i:list-pagination>

==========
List empty
==========

Definice zpráv při prázdném výpisu - vždy v souboru **_listing.tpl**. Definuje makro, které se následně využívá pro výpis produktů v *list-container*.

Je dostupná pouze proměnná *url*.

.. code-block:: html+twig

    <i:list-empty type="product" name="short">
        Nebyly nalezeny žádné produkty
    </i:list-empty>

.. code-block:: html+twig

    <i:list-empty type="product">
        <div data-role="default">Nebyly nalezeny žádné produkty</div>
        <div data-role="filter">
            Filtr nenalezl žádné produkty.
            Zkuste upravit hledané vlastnosti nebo <a href="{{url.reset}}">zrušit filtr</a>.
            </div>
    </i:list-empty>

.. csv-table:: Atributy **list-empty**
    :header: "data-role", "Default", "Popis"

    **type**, --- , "typ položky *(product, article, ...)*"
    name, *default*, název pro provázání s *list-container*

.. csv-table:: Dostupné proměnné
    :header: "název", "hodnota"

    url.reset, URL bez filtru a strany

===========
List insert
===========

Definice šablony, která se vloží před (nebo za) každou vypisovanou položku - vždy v souboru **_listing.tpl**. Definuje makro, které se následně využívá pro výpis produktů v *list-container*.

.. code-block:: html+twig

    <i:list-insert type="product" name="banner">
        {% if limit == 16 and position % 5 === 0 %}
            {% set article = repository.article.findOneBy({id:arguments.id}) %}
            {{ article.name }}
        {% endif %}
    </i:list-insert>

    <i:list-container insert-after="banner" insert-arguments="{{ {id:article.id} }}">
        <div data-role="empty"/>
        <div data-role="list"/>
    </i:list-container>

.. csv-table:: Atributy **list-insert**
    :header: "data-role", "Popis"

    **type**, "typ položky *(product, article, ...)*"
    name, název pro provázání s *list-container*

.. csv-table:: Dostupné proměnné
    :header: "název", "hodnota"

    pagePosition, Pozice na stránce (počítáno od 1)
    page, Číslo stránky výpisu (počítáno od 1)
    limit, Počet záznamů na stránku (maximum)
    recordsOnPage, Počet záznamů na stránce (aktuální)
    arguments, vstupní data definovaná na listing-container - pouze skalární (prošla skrz json_encode)

=========
List Item
=========

Definice položky výpisu - vždy v souboru **_listing.tpl**. Definuje makro, které se následně využívá pro výpis produktů v *list-container*.

Nelze přistupovat ke globálním proměnným a nelze zjistit pozici ve výpisu.

.. code-block:: html+twig

    {# _listing.tpl #}
    <i:list-item>
        <h3>{{product.nazev}}</h3>
    </i:list-item>

.. code-block:: html+twig

    <i:list-item tag="li" name="news">
        <h3>{{product.nazev}}</h3>
    </i:list-item>

.. csv-table:: Atributy **list-item**
    :header: "data-role", "Default", "Popis"

    **type**, --- , "typ položky *(product, article, ...)*"
    tag, *div*, jakým tagem obalit výsledný box
    name, *default*, název boxu pro provázání s *list-container*
    class, --- , třída