Failų struktūra

client

Katalogas, kuriame rekomenduojama saugoti visą sistemai reikalingą statinę informaciją. Pavyzdžiui: paveikslėlius, skriptus ar stilių aprašus ir pan. šio katalogo egzistavimas ir/ar jo pavadinimas nėra būtinas. Tačiau, jei neturite rimtų priežasčių elgtis kitaip, rekomenduojame naudoti būtent šią struktūrą.


plugins

Katalogas skirtas įskiepių įdiegimui JustPageIT sistemoje. Jo egzistavimas nebūtinas. 


plugins/smarty

Įskiepį, skirti praplėsti smarty šablonų varikliuką, katalogas. Šie įskiepai yra automatiškai įkraunami į sistemą ir juos galima panaudoti savuose šablonuose. Funkciją sąrašo praplėtimo įskiepo pavyzdys:

{*
failas:root/plugins/smarty/function.mytest.php
*}
function smarty_function_mytest($params, &$smarty)
{
$smarty->assign($params["assign"],'Hello ' . $params['name']);
}


{*
failas:root/templates/guest/index.html
*}
{mytest name="world" assign="myresult"}
{$myresult}
{*
Bus sugeneruota: 'Hello world'
*}


plugins/system

Katalogas, kuriame laikomi įskiepai skirti praplėsti JustPageIT TVS funkcionalumą.


plugins/translate.php

Naudojamas išversti JustPageIT TVS administratoriaus pusėje. Viešo puslapių generavime nenaudojamas! Skirtas JustPageIT TVS lokalizacijai ir/ar suteikti prasmės įvairiems magiškiems pavadinimams.

<?

// failas:root/plugins/translate.php

$translate['ProjectObjectPicture']['lt'] = 'Projekto objekto nuotrauka';

// Nuo šiol administratoriai, lietuviškoje TVS aplinkoje,

// vietoje keisto pavadinimo: 'ProjectObjectPicture' matys

// logišką: 'Projekto objekto nuotrauka'

?>


templates

B?tinas katalogas.


templates/font

Katalogas, kuriame dedami nestandartiniai šriftai, kurie gali būti naudojami smarty šablonuose. Šio katalogo egzistavimas neprivalomas.


templates/guest

B?tinas katalogas.


templates/guest/index.html

Smarty šablonas. šio failo egzistavimas yra b?tinas. Jis vienintelis yra įkraunamas kiekvienos užklausos metu. Savaime suprantama savyje jis gali įterpti daugiau failų.
Iš esmės JustPageIT puslapiai gali būti generuojami naudojanti tik šiuo vienu failu. Tačiau taip elgtis nerekomenduojame, nes dėl išsipūtusios failo apimties būtų sunku jį sukontroliuoti ir išvengti klaidų.


templates/guest/blocks

Katalogas, kuriame laikomi JustPageIT TVS infromacinių blokų šablonai. Šablonai saugomi pakatalogiuose, pavadintuose taip pat kaip ir informacinių blokų tipų pavadinimai. Šio katalogo egzistavimas teoriškai nėra būtinas, tačiau tik tuo atveju, jei nėra naudojama informacinių blokų sistema, kas yra mažai tikėtina. Galimų informacinių blokų vardų pavyzdžiai: block_img_only, block_img_url, block_text, block_text_url, block_container, block_form, block_flash_only, block_flash_url, block_img_url_text.

Pavyzdys kaip iššaukti blokų šablonų įprastuose smarty šablonuose JustPageIT sistemoje:

{*
failas:/root/templates/guest/blocks/block_text/default.html
*}
{$block.data.block_text.value}


{*
failas:/root/templates/guest/index.html
ext->block parametrai
type: bloko tipas.
name: informacinio bloko vardas, siejasi su tvs.
id: informacinio bloko id.
template: naudojamas sablonas tokio bloku tipo sablonas (nes ju galibuti ir nevienas)
*}
{ext->block type="block_text" name="test_name" id=$data.page.id template="default.html"}


templates/guest/main

Rekomenduojamo pobūdžio katalogas. Jame siūlome laikyti tokius failus: print.html, main.html, titile.html, inner.html, selector.html.


templates/guest/main/print.html

Puslapio spausdinimo versijos šablonas. Žinoma, jei tokia yra. Nepamirškite, kad čia tik rekomendacijos.


templates/guest/main/main.html

Šablonas, atsakingas už bendrą puslapio turinį. Jis savyje, priklausomai nuo situacijos, įtraukia titile.html arba inner.html šablonus.


templates/guest/main/title.html

Šablonas, atsakingas už titulinį puslapį. Naudojamas tada, kai titulinis puslapis kardinaliai skiriasi nuo vidinių puslapių.


templates/guest/main/inner.html

Šablonas, atsakingas už vidinius puslapius. Jame rekomenduojame laikyti bendruosius vidinių puslapių elementus, o esminį turinį įtraukti pasinaudojant selectoriumi, aprašytu žemiau.


templates/guest/main/selector.html

Esminio turinio šablono parinkėjas. Standartinis jo variantas atrodytų taip:

{*
failas:root/templates/guest/main/selector.html
*}
{if $data.page.type}
    {assign var="tipas" value=$data.page.type}
    {include file=guest/body/$tipas.html}
{/if}
{*
žinoma, guest/body/$tipas.html turi egzistuoti ir būti sukurtas pačio diegėjo. 
*}


templates/guest/body

Rekomenduojamo pobūdžio katalogas. Jame laikomi šablonai skirti puslapio turinio atvaizdavimui. Naudojamas kartu su selectoriumi arba panašiu principu veikiančia sistema. Pavyzdžiui:

{*
failas:root/templates/guest/body/text01.html
*}
{$data.content.text_content01.value}

templates/guest/mail

Katalogas, kuriame laikomi automatiškai siunčiamų elektroninių laiškų šablonai. Naudojami kartu su informaciniai blokais (konkre?iai - formomis). Pavyzdys:

{*
failas:root/templates/guest/blocks/block_form/dafault.html
*}
<form action="index.php?id={$data.page.id}"
            enctype="multipart/form-data"
            method="post"
            name="form{$block.id}">
    <!-- Daug visokiu formos lauk? -->
    <input type="hidden" name="form_template" value="mail.html" />
    <!-- Daug visokiu formos lauk? -->
</form>


{*
failas:root/templates/guest/mail/mail.html
*}
Esu bevertis elektroninio laiško šablonas.

templates/smarty

Būtinas katalogas. Jame laikoma smarty šablonų varikliukui reikalinga kešavimo informacija.