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í & (<% popř. >%) <%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.