Makro "webnodeList"

Makro slouží k vytváření filtrovaného seznamu uzlů. Makro vypisuje seznam všech uzlů, které jsou potomkem zadaného rodičovského uzlu. Výsledkem je tabulka, ve jejímž prvním sloupci se zobrazí datum a ve druhém název uzlu s linkem na jeho obsah. Zobrazené uzly je možné filtrovat podle zadaných tagů a seřadit podle data nebo názvu uzlu.
Při řazení uzlů se využívá "Datum pro řazení", které se automaticky nastaví při založení uzlu a později je možné je měnit ručně.

Zápis a parametry makra:

{(webnodeList)}

Zobrazení seznamu je možné upravovat zadáním následujících parametrů:

  • parentName - nepovinný parametr. Název rodičovského uzlu, pod kterým jsou všechny uzly ze seznamu zařazeny. Pokud není specifikován ani parentName ani parentId, zvolí se aktuální uzel.
  • parentId - nepovinný parametr. ID rodičovského uzlu, pod kterým jsou všechny uzly ze seznamu zařazeny. Není-li nastaven parentName ani parentId, zvolí se aktuální uzel. Při zadání obou parametrů ma přednost parentName.
  • order - nepovinný parametr. Určuje způsob řazení podle data (date) nebo názvu (caption) a pomlčkou odděleného pořadí (asc, desc). Možné hodnoty jsou: 'date-desc', 'date-asc', 'caption-desc' nebo 'caption-asc'. Není-li parametr specifikován, použije se 'date-desc'.
  • tags - nepovinný parametr. Seznam tagů, podle kterých se filtrují výsledné uzly, oddělené čárkou. Například: 'tag1,tag2'. Výchozí logický vztah mezi tagy je OR, tzn. uzel je zahrnut do výpisu, pokud má nastavený alespoň jeden z tagů. Logiku lze změnit parametrem tagBoolOperator na AND, kdy musí mít uzel všechny uvedené tagy současně. Při tom se přihlíží k locale, takže v české verzi jsou anglické tagy ignorovány a naopak.
  • tagBoolOperator - nepovinný parametr. Logický vztah mezi tagy, specifikovanými v parametru tags. Výchozí hodnota je OR. Možné hodnoty jsou 'OR' a 'AND'
  • showDate - nepovinný parametr. Umožňuje skrýt sloupec s datem pro řazení. Možné hodnoty jsou 'true' a 'false', výchozí je 'true'.
  • twig - nepovinný parametr. Umožňuje explicitně specifikovat twig soubor šablony pro výpis. Výchozí je "@NaturWeb/templates/macro/webnode-list/webnode-list.twig".
  • itemsOnPage - nepovinný parametr. Pokud je předán, aktivuje se stránkování seznamu. Uvádí maximální počet řádků na jedné stránce.
  • locale - nepovinný parametr. Povolené hodnoty jsou "cs" nebo "en". Pokud je předán, načítá hodnoty v příslušné jazykové verzi.
  • htmlClass - nepovinný parametr. Třída class nastavená html elementu obsahujícímu tabulku. Využitelný pro specifické stylování nebo skriptování.
  • htmlId - nepovinný parametr, id nastavený html elementu obsahujícímu tabulku. Využitelný pro specifické stylování nebo skriptování.

Příklady použití:

1. {(webnodeList)}
2. {(webnodeList:parentName=VEDA_A_VYZKUM_GRANTOVA_AGENDA)}
3. {(webnodeList:parentId=480)}
4. {(webnodeList:itemsOnPage=10)}
5. {(webnodeList:tags=granty,seznam,grants,list;tagBoolOperator=OR)}
6. {(webnodeList:order=caption-asc;showDate=false)}
7. {(webnodeList:htmlClass=agenda;htmlId=agenda1;locale=en)}