Návod na vytvorenie šablóny pre NanoCMS

Vytvorenie šablóny pre NanoCMS je veľmi jednoduché. Vytvoríme si v html stránku. Stránku zmeníme na súbor index.php. Do tohoto súboru musíme doplniť o niekoľko príkazov v php. Po doplnení nám vznikne šablóna pre NanoCMS. Do šablóny nám php príkazy budú automaticky vkladať text. Odpadá teda nutnosť vytvoriť v html každú stránku zvlášť, a my sa môžeme zaoberať len písaním textov.

Tri základné php príkazy vkladané do šablóny (nad tým nemusíme premýšľať):
(Modrou je uvedený príkaz, a k nemu vysvetlenie, kde musí byť v šablóne)
<?php require_once("data/setting.php");?> - MUSÍ byť na 1.riadku stránky
<?php runTweak('head'); ?> - hneď za ním MUSÍ nasledovať tag </head >
<?php runTweak('end-body'); ?> hneď za ním MUSÍ nasledovať tag </body></html>

Pre výpis textu do stránky sa používa niekoľko typov príkazov:

- príkaz, ktorý vypíše názov stránky
- príkaz, ktorý vypíše navigačné menu (sidebar)
- príkaz, ktorý vypíšenavigačného menu, ale my si ho môžeme prispôsobiť (ďalší sidebar)
- príkaz, ktorý vypíše obsah stránky
- príkaz, ktorý vypíše text zadaný do polí v administračnej časti "Content Areas" (napr. text patičky)

Popis príkazov:

názov stránky:
<?php show_title(); ?> - vypíše názov stránky, vložiť do tagu <title> </title>

navigácia stránky:
<?php show_sidebar(); ?> - vypíše hlavný sidebar (hlavné navigačné menu, v administračnej časti nazvané "Sidebar")

Ďalšia navigácia stránky:
<?php show_links('top-navigation'); ?> * - vypíše ďalší sidebar (navigačné menu)s názvom top-navigation. Slovo napísané zelenou je názov, ktorý môžeme zmeniť.
Po prihlásení do administrácie sa nám automaticky vytvorí možnosť zaradiť stránky aj do menu s názvom napr. top-navigation. Ak sa pozrieme tam ako sa píše článok, mali by sme mať možnosť ich tam odkliknúť.

Navigácia stránky, u ktorej môžeme zvoliť tagy:
<?php show_links('top-navigation','<li> %s </li>'); ?>* **-
za top-navigation napíšeme názov. Na mieste, ktoré je označené fialovou, napíšeme tagy, aké potrebujeme, napr. tagy pre zoznam tj. <li> a </li>. Na mieste %s sa budú vypisovať jednotlivé položky menu.

Pr:
Do zdrojového súboru index.php napíšeme:
<ul> <?php show_links('top-navigation','<li> %s </li>'); ?> </ul>

Príkaz vypíše:
<ul>
<li> top-navigation1 </li>
<li> top-navigation2 </li>
<li> top-navigation3 </li>
<ul>

pre výpis polí s textom sú tieto príkazy:
<?php show_content_slug(); ?> - výpis textu našej stránky (tam ako je políčko Content)
<?php show_content_area('WebSite Name'); ?>* - výpis textu v políčkach v Content Areas

Tým sme pripravili šablónu pre NanoCMS. Náš nový súbor index.php nahráme do hlavného adresára, namiesto pôvodného index.php. Tým sa šablóna automaticky aktivuje.

* POZN: polia sa automaticky vytoria v administračnom rozhraní, stačí ich vpísať do šablony a administračné rozhranie ich samo vytvorí, nedeste sa toho že to v adm. rozhraní nieje.
** POZN nezabudnúť uviest príkaz medzi tagy ul aby bol zoznam korektne označený

Čo nefunguje: Zdalo by sa, že nahraním súboru niečo.php do složky data/areas/ vznikne dalšie políčko Concent areas s názvom niečo, ale prakticky pridaním ďalšieho súboru sa nezmeni nič.

>>------------------- ukážka šablóny, zdrojjový kód v súbore index.php -------------------------<<

<?php require_once("data/setting.php"); ?> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN">
<html>
<head>
<title><?php show_content_area('WebSite Name'); ?> 
»
<?php show_title(); ?> 
</title>
<link rel="stylesheet" type="text/css" href="style.css" />

<?php runTweak('head'); ?>    
</head>
<body>
<div id="wrapper">

<div id="header">
    <h1><?php show_content_area('WebSite Name'); ?></h1> 
    <h2><?php show_content_area('WebSite slogan'); ?></h2> 
</div>

    <div id="topnav">
      <?php show_links('top-navigation','<li>%s</li>'); ?> 
    </div>

<div id="main">

    <div id="left">
      <h2>Navigation</h2>

    <div id="leftnav">
          <ul>
        <?php show_sidebar(); ?> 
        </ul>
        <?php show_content_area('Below Navigation'); ?> 
    </div>
    </div>

    <div id="right">
    <?php show_content_slug(); ?> 

    </div>

</div>

<div class="break"> </div>

<div id="footer">
     <div style="float:right">
<?php show_links('Footer-Right', ' | %s'); ?> 
</div>
    <?php show_content_area('Copyright Notice'); ?> 
powered by <a href='http://NanoCMS.in'>NanoCMS</a>

</div>
</div>
<?php runTweak('end-body'); ?> 
</body>
</html>