# Nápověda Pub-Me CMS

## Základní syntaxe

Dříve než se seznámíte s konkrétními funkcemi CMS kódu, věnujte prosím pozornost formálnímu zápisu tohoto jazyka. Je to celkem jednoduché:

Veškeré příkazy CMS kódu zapisujete do XHTML šablon (ale klidně i do samotných dokumentů, pokud si zvolíte přímou editaci zdrojového kódu) a to v následující formě (pro příklad použijeme neexistující funkci `example`):

- Veškeré příkazy cms kódu uzavírejte do "závorek": `<%` ... `%>`, takže pokud chcete tyto "dvouznaky" vypsat na obrazovce, musíte použít zápis pomocí & (&lt;% popř. &gt;%)
- `<%example%>` nebo `<%example()%>` - funkce bez argumentů
- `<%example("hodnota")%>` - zápis funkce, která vyžaduje pouze jednu hodnotu a není potřeba definovat její název (např. `include`)
- `<%example("argument=hodnota")%>` - funkce, u níž je potřeba definovat jméno a hodnotu argumentu.
- `<%example("argument=hodnota|argument=hodnota")%>` - funkce s více argumenty (jednotlivé argumenty oddělujte pomocí znaku |)
- `<%example();anotherexample()%>` - jednotlivé funkce můžete řadit za sebe pomocí středníku. Koncový středník je nepovinný.
- Jména funkcí a proměnných zapisujte malými písmeny.
- POZOR, zápis podmínkových příkazů má své specifika, kterým je věnována samostatná kapitola.

### Potlačení chybového hlášení při neexistence funkce

Protože funkce example ve skutečnosti neexistuje, vygenerovaly by výše uvedené příklady chybovou hlášku s informací o volání neexistující funkce.

Mohou ovšem nastat případy, kdy chcete varování chcete potlačit. Provedete to přidáním speciálního argumentu `ignorefunctionnotfounderror`. Uveďme opravdový příklad:

Funkce poll_jslink vloží odkaz na soubor s javascriptem, který se stará o chování anket. Pokud při tvoření šablony nevíme, jestli bude nainstalován patřičný add-in, můžeme použít následující konstrukci:

    <%poll_jslink("ignorefunctionnotfounderror")%>

V případě, že příkaz poll_jslink existuje, bude v pořádku vykonán. Jinak je příkaz ignorován a šablona se chová, jako by v ní nebyl. Tento argument lze pochopitelně kombinovat s ostatními argumenty pomocí svislé čáry | (viz příklady). V případě, že funkce existuje, bude se chovat zcela standardně.

Potlačení chybového hlášení je dobré používat obezřetně - jeho účelem je upozornit na překlepy apod. Použijte jej tudíž pouze tam, kde chcete vytvořit univerzální šablonu, která má fungovat s nainstalovaným doplňkem i bez něj.

- Hlavní admin
  - Instalace
  - Nastavení
  - Administrátoři
  - XHTML šablony
  - CMS kód
    - Základní syntaxe
    - Podmínkové příkazy
    - Funkce
  - Jazykové verze
  - Export a záloha
  - Rozšíření

### Související témata

- Nebyla nalezena žádná související témata.

### Odkazy

- Domovské stránky Pub-Me CMS
- Malének webdesign (autor Pub-Me)