poll

Vloží do stránky požadovanou anketu (verze => 1.3; vyžaduje instalaci add-inu Ankety, který není součástí základní instalace)

Funkce poll vloží do stránky požadovanou anketu. V rámci editace dokumentů lze ankety přidávat jako přílohy a pak se ankety vloží automaticky. Příkaz poll využijete v případě, že potřebujete anketu vložit ručně (např. do šablony, do níž se automaticky vybírá nejnovější anketa ze seznamu anket).

Parametry funkce

Proměnná Popis Výchozí
name(text) Alias konkrétní ankety, která se má vložit do stránky. Pokud alias ankety nevyberete, předpokládá se výběr ze skupiny anket. prázdná
group(text) Umožňuje vybrat anketu automaticky z konkrétní skupiny anket. Je-li definováno name je argument group ignorován. Není-li nastaven ani jeden z těchto dvou argumentů, vybere se anketa ze všech anket na webu. prázdná
orderby (text)

(Pouze pokud je výběr ze seznamu group.)

Možné hodnoty:

  • date
  • sort

Hodnota sort je přednastavená a respektuje řazení anket tak, jak jsou seřazeny v administraci. Hodnota date toto řazení ignoruje a řadí ankety podle data (zobrazí vždy poslední anketu).

 sort
showactive (bool)

(Pouze pokud je výběr ze seznamu group.)

True vybírá pouze z aktivních anket, false i z anket, které již byly uzavřeny.

 true
showname (bool) True vypíše jméno ankety jako záhlaví (nadpis h3; class="PollHeader"). False zakáže zobrazení jména ankety (vypíše pouze otázku a možnosti). true
hidebeforeactivation (bool) V případě, že vkládáte konkrétní anketu (argumentem name), umožňuje argument hidebeforeactivation potlačit informaci o tom, že anketa nebyla nalezena. Jinak se anketa, která ještě není aktivována chová jako neexistující a systém o tom uživatele varuje). Tento argument tudíž umožňuje anketu přidat na web dříve, než bude aktivována. Ankety přidávané pomocí příloh dokumentů mají nastaven tento argument na true. false
hidetotal (bool) Pokud je false zobrazí se na konci ankety informace o celkovém počtu hlasujících. false
barcolors (int) Počet barev jednotlivých sloupců s možnostmi. Standardní css soubor obsahuje definic jen jedné barvy, ale lze definovat neomezené množství těchto barev a systém podle nastavení barcolors přiřazuje patřičné třídy.  1
percent (bool) False vypisuje u jednotlivých možností počet hlasů (např. 10x), true vypisuje procento (např. 33%) false