Argumenty podmínkových příkazů

Následující tabulka přináší přehled všech argumentů, které můžete v podmínkách použít. Způsob zápisu a celková logika podmínkových výrazů je popsána ve zvláštní kapitole.

V popisu jsou popsány stavy, kdy podmínka vrací true, false se vrací v případě, že je pravdou opak.

Argument Popis
accessdenied Vrací true, pokud je k dané stránce odepřen přístup.
accessgranted Vrací true, pokud má návštěvník povolen číst danou stránku.
activepage=hodnota Aktivní stránka má alias hodnota. Tzn. že "activepage=/cs" vrací true na úvodní stránce české verze (alias /cs), jinde je false.
activeorchildof=hodnota Totéž jako active active page, ale vrací true i u všech potomků (podřízených dokumentů).
addcommenterror Komentář se nepodařilo přidat (To znamená, že false značí úspěšné přidání komentáře).
admin Vrací true, pokud je přihlášen administrátor.
allowcommentreply Je povoleno javascriptové rozšíření, pomocí něhož je možné reagovat na jednotlivé komentáře tak, že se po stisku tlačítka zobrazí formulář přímo pod komentářem.
allowfakeantispam Vrací true v případě, že je v nastavení webu povoleno obcházet antispamové otázky javascriptem.
annotation Vrací true, pokud není prázdná anotace.
childof=hodnota Totéž jako activepage, ale true nevrací u právě aktivního dokumentu ale jen u jeho potomků (podřízených dokumentů).
comments Je povolen výpis komentářů (true i v případě, že jsou komentáře uzamčeny).
commentsallowed Je povoleno vkládat komentáře (true pouze pokud je možné vkládat nové komentáře)
commentslocked Komentáře jsou uzamčeny (true pouze v případě, že je možné zobrazit komentáře, ale ne vkládat nové).
export Vrací true v případě, že se jedná o výstup do html exportu. Při dynamickém generování stránek je hodnota false.
false Vždy vrací false (má smysl pro testovací účely, nebo když chcete určitou část šablony dočasně zneaktivnit bez mazání - narozdíl od html komentáře se kód uzavřený do podmínky vůbec neexportuje do html).
firstpage Dokument (rozdělený na stránky pomocí příkazu page) je na poslední stránce.
forgottenpassword Vrací true v případě, že se má zobrazit stránka s požadavkem na zapomenuté heslo (je nastaven argument forgottenpassword).
forgottenpasswordsent Vrací true v případě, že se bylo odesláno zapomenuté heslo.
hassubs=úroveň Totéž jako hassubmenu (viz níže), s tím rozdílem, že dokumenty musí být pouze součástí stromu dokumentů a nemusí se jednat o položky menu.
hassubmenu=úroveň

Tato podmínka se chová dvojím způsobem, podle toho, jestli zadáme argument nebo nikoliv.

Bez argumentu podmínka kontroluje, jestli má právě prohlížený dokument podřazené dokumenty, které jsou součástí menu (mají nastaveno Zobrazit v menu na Ano).

Pokud je argument zadán (jedná se o celé číslo vetší nebo rovno 0), nezjišťuje se, jestli má podmenu samotný aktivní dokument, ale dokument, který je nadřazený (nebo roven) aktivnímu dokumentu a ve stromu dokumentů je na úrovni rovné argumentu úroveň.

home Aktivní stránka je stránkou úvodní (pro danou jazykovou verzi nebo pro celý web, tzn. že stránek vracející true může být více).
lang=hodnota Jazyková verze rovná se hodnota. V české verzi bude "lang=cs" true, v jiných jazykových verzích bude vracet false.
mobile Vrací true, pokud se jedná o mobilní zařízení povolené v nastavení webu a je povolené zobrazení mobilní verze stránek.
ipblocked IP adresa, ze které je stránka volána je v seznamu zakázaných IP adres.
isinmultilevelmenu=úroveň

Aktuálně pročítaný dokument je součástí víceúrovňového menu, jinými slovy má nadřazené nebo podřazené dokumenty, které jsou také v menu.

Argument úroveň definuje, na jaké úrovni má víceúrovňové menu začínat (0 = úvodní stránka, 1 = první úroveň menu, 2 = první zanoření atd.)

False se tudíž vrátí, pokud dokument není součástí menu nebo menu nemá více úrovní.

Jako příklad je možno použít tuto nápovědu. Postraní menu se zobrazuje na základě podmínky isinmultilevelmenu=1. Na úvodní stránce se postraní menu nezobrazí, protože je v menu na úrovni 0, v obsahu se rovněž nezobrazí, protože se stránka Obsah je sice na úrovni 1, ale nám podřazené položky (a tudíž by se nejednalo od úrovně 1 o víceúrovňové menu).

Podmínka se chová velice podobně jako výše zmíněná podmínka hassubmebu=argument, jediným rozdílem je, že v tomto případě musí být samotný aktivní dokument součástí menu, v případě hassubmenu stačí, aby v menu byl nadřazený dokument.

languages Existuje více než 1 jazyková verze.
lastpage Dokument (rozdělený na stránky pomocí příkazu page) je na první stránce.
logged Je přihlášený registrovaný uživatel.
loginfailed Pokus o přihlášení byl neúspěšný. (To znamená že false značí úspěšné přihlášení).
mailformsent Byl odeslán e-mail pomocí formuláře na stránkách.
paidonly Článek je přístupný pouze pro uživatele se zaplaceným předplatným.
registration Zobrazená stránka je stránkou s registračním formulářem v dané jazykové verzi.
registrationpass Registrace nového uživatele proběhla úspěšně.
search Je zadán hledaný výraz.
sendlinkbymail Je umožněno poslat odkaz na článek e-mailem.
showrelated Mají se zobrazovat související články.
topichasitems=rubrika Vrací true v případě, že v dané rubrice jsou nějaké aktivní články.
true Vždy vrací true (má smysl jen pro testovací účely).
val:

Speciální podmíněný příkaz, který umožňuje pracovat s uživatelskými proměnnými, definovanými v nastavení dokumentu. Podmínka má následující tvar zápisu:

val:jmenopromenne popř. val:jmenopromenne=hodnota. V prvním případě se vrací true, pokud je daná proměnná definována a není nastavena na false, v druhém případě se vrací true pouze v případě, že je daná proměnná definována a její hodnota odpovídá požadované hodnotě.

valchildof: Totéž jako val, jen s tím rozdílem, že proměnná se nehledá v samotném dokumentu ale v dokumentech nadřazených.
valselforchildof:

Totéž jako val, vrací true, když hodnotě odpovídá samotný dokument nebo některý z dokumentů nadřazených.