Malý návod, ako sa zorientovať pri zisťovaní funkčnosti modulu

Slovenský užívateľ ma tak trochu smolu, že CMS Made Simple, je iba čiastočne poslovenčený a pomocníkov (nápovedy) ku všetkým modulom, zväčša nájde v angličitne. Výhoda je, že vloženie každého modulu do stránok je väčšinou vždy dosť podobné a ako sa zorientovať vo vkladaní nových modulov si ukážeme po kliknutí.

Vybraný modul si treba najprv nainštalovať. Užívateľ má tri možnosti ako získať daný modul do svojho systému

• najednoduchší priamo z administrácie: Rozšírenia » Správa modulov
• stiahnutím xml z dev.cmsmadesimple.org a jeho inštalácium cez: Rozšírenia » Moduly » Inštalovať modul cez XML
• stiahnutím balíka z dev.cmsmadesimple.org a jeho rozbalením do adresára modules a jeho inštaláciu cez Rozšírenia » Moduly

Po nainštalovaní si môžete aktuálny stav a prehľad modulov pozrieť cez Rozšírenia » Moduly, kde si treba všimnúť svojho modulu a jeho nápovedu.

Každý modul sa do stránok vkladá pomocou značky {cms_module module="nazovmodulu"}, ku ktorému pomocou parametrov definujeme ďalšie nastavenia. Krásnym príkladom je novinkový modul a jeho základné použitie {cms_module module="news" number="5" category="pivo"}, ktorý nám hovorí, že má zobraziť prednastavenú akciu (pri novinkách je to výpis) z kategórie "pivo" s maximálnym počtom 5 položiek. Pokiaľ si otvorím nápovedu k novinkovému modulu, tak úplne na konci si vieme pozrieť prehľad všetkých použitých parametrov, ktoré môžme použiť. Smelo môžme nastaviť začiatok výpisu pomocou parametra start="0", pomocu summarytemplate="nazov sablony" môžem nadefinovať šablónu pre výpis, pomocou sortasc="true" nastaviť zobrazenie noviniek od najstaršieho po najnovšie atď.

Reálne nasadenie

Reálne nasadenie modulu si môžeme ukázať u nového, jednoduchého ajaxové mini-chatu Shootbox Made Simple, ktorého ukážku si môžete pozrieť na týchto stránkach.

Klinutím na nápovedu sa dozvedáme, že modul na stránky vložím pomocou {cms_module module='shootbox'}. Nižšie v parametroch vidím, čo všetko môžem modulu nastaviť. Takže, keď do stránok vložím nasledujúci kód (ukážka na konci článku):

{cms_module module='shootbox' maxInScreen='20' maxInDb='100' refresh='1000' timeFormat='d.m H:i:s' delayOfLastShoot='0' sort='asc' url='odkaz'}

Tak nám modul na stránke vypíše box

• s maximálnym počtom 20 záznamov na stránku (maxInScreen)
• do databázy si zapíšem len posledných 100 položiek (maxInDb)
• obsah boxu sa aktualizuje každú sekundu refresh
• dátum sa bude zobrazovať v tvare deň.mesiac hodina:minúta:sekunda (timeFormat)
• užívateľ môže prispievať neobmedzene  (delayOfLastShoot)
• položky sa budú zobrazovať od najstaršieho po najnovšie (sort)
• odkazy sa budú zobrazovať klikateľné v s textom "odkaz" (url)

Neviem ako budú rozumieť parametrom neangličtinári, ale myslím, že aj so základnými znalosťami angličtiny a otvorenou mysľou budú popisky zväčša zrozumiteľné. Keď nie, tak potom ostáva už len jediné, a to metóda pokus-omyl.

Ukážka