Jazyk MagicScript

Skriptovací jazyk MagicScript slouží ke snadnému a rychlému vytváření šablon. Dovoluje specifikovat, jaké prvky se jakým způsobem zobrazí redaktorovi stránky  k editaci na záložce obsah v modulu Struktura a stránky.

Jednotlivé značky jazyka jsou po zařazení šablony do systému okamžitě nahrazeny příslušnými bloky kódu v jazyce PHP, čímž odpadá nutnost opětovného parsování šablony při zobrazení stránky. Významně je tak zvýšena rychlost generování stránky.

V každé šabloně může být použito libovolné množství značek, což umožňuje vývojáři dát redaktorovi stránky do ruky takřka neomezenou paletu možností, jak „bezpečně“ ovlivnit obsah i vzhled stránky.

Značky jazyka mají následující obecnou syntaxi:

{|
<typ značky>?<identifikátor> 
   [&<parametr>=<hodnota>]
   [&<parametr>=<hodnota>]
   ...
|}

Kde:

<typ značky> určuje, jakou značku definujeme
<identifikátor> rozlišuje dané značky v rámci jedné šablony (v jedné šabloně může být více značek stejného typu, musí se však lišit identifikátorem)
[<parametr>=<hodnota>] nastavuje rozšiřující vlastnosti značky (nepovinné)

Vlastnosti značek jsou oddělovány znakem &. Následující kód ukazuje příklad jednoduché šablony, která dovolí uživateli na záložce obsah editaci nadpisu a textu stránky.

<h1>{|TEXT?nadpis&
  lang_cs=Nadpis stránky&
  lang=Page heading&
  hint_cs=Zadejte hlavní nadpis stránky&
  hint=Enter page heading.|}</h1>

<DIV class='magiced'>{|WYSIWYG?text&
  lang_cs=Text pod nadpis&
  lang=Text under heading&
  hint_cs=Prostřednictvím vizuálního editoru MagicEd vytvořte text stránky.&
  hint=Enter page text using visual editor MagicEd.|}</DIV>

Záložka obsah stránky vytvořené z této šablony má pak následující vzhled:

Text parametru lang se zobrazí uživateli jako název položky, kterou má zpřístupněnou k editaci. Parametr hint dovoluje definovat nápovědný text, který se uživateli zobrazí v bublinové nápovědě při najetí myši na ikonu otazníku.

Díky MagicScriptu je možné snadno vytvářet i mnohem složitější šablony. Následující obrázek znázorňuje vzhled záložky Obsah stránky, která dovoluje správci modifikovat vlastnosti formuláře Dotazy a připomínky.

Následující obrázek prezentuje ty nejdůležitější značky z více než 30 značek MagicScriptu. V hranaté závorce u popisku pole je vždy uveden název značky.