# Nápověda Pub-Me CMS

## 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.

- CMS kód
  - Základní syntaxe
  - Podmínkové příkazy
    - Argumenty
  - Funkce

### Související témata

- Podmínkové příkazy

### Odkazy

- Domovské stránky Pub-Me CMS