Adresarová štruktúra CMS TYPO3

Rozhodol som sa napísať zopár článkov o základoch práce s cmskom TYPO3. Preto som sa na začiatok rozhodol popísať adresarovú štruktúru - popis čo sa kde nachádza a na čo sú uerčené jednotlivé adresáre.

CMS TYPO3 je rozdelené do rôznych balíčkov. Balík source je základný balík. Obsahuje všetky potrebné zdrojové kódy cmska. Na tento balíček treba pre reálne použitie aplikovať ešte nejaký ďalší poďla toho čo chceme robiť. Kedysi existovalo oficiálnych balíčkov viacero, dnes je udržiavaný asi len jeden - dummy package. Tento balík len rozširuje základnú adresárovú štruktúru a pridáva zopár súborov. Takže najjednoduchšia cesta ako nainštalovať TYPO3 je rozbaliť si niekde TYPO3 source a potom do neho rozbaliť TYPO3 dummy(tak aby súbory z dummy balíku prepísali tie zo source prirodzene). Je možné si vytvoriť aj vlastný balíček namiesto dummy balíčka a pripraviť si tam moduly, ktoré zvykneme použiť vo väčšine inštalácii spolu s predpripravnými nastaveniami. Dummy package je vhodné použíť v prípade, keď ideme vytvárať stránku samy.

Po nainštalovaní by mala vzniknuť takáto adresárová štruktúra:

• [D] fileadmin
• [D] misc
• [D] t3lib
• [D] typo3
• [D] typo3conf
• [D] typo3temp
• [D] uploads
• [F] index.php
• [F] _.htaccess

Značkou [D] sú označené adresáre a značkou [F] sú označené súbory. Ďalej sú tam ešte súbory typu README, clear.gif atď ktoré asi netreba popisovať, takže som ich vynechal.

FILEADMIN

Adresár fileadmin je určený pre ukladanie súborov. Je rozdenlé na viaceré podadresáre:

• [D] template
• [D] user_upload
• [D] _temp_

Adresár template(alebo aj templates) sa tam od začiatku nenachádza, ale zvyknú sa prave do tohto adresára ukladať html šablóny. Spolu s nimi aj csská, javascripty, obrázky a napriklad aj swfka. Jednoducho všetky staticke súbory.

Adresár user_upload je primárne určený ako adresár, do ktorého môže používateľ uploadovať, čo len bude chcieť, taktiež si tam môže vytvárať ďalšiu adresárovú štruktúru. Jednotlivé adresáre sa dajú sprístupniť pre rôzne skupiny/používateľov cez file mount-y.

Adresár _temp_ je podobný adresáru user_upload. Je určený na dočasné uchovávanie súborov. V každom prípade nikdy by sa nemalo nič linkovať na hocičo z tohto adresára, kedže ide iba o “temp”!

MISC

Tento adresár je určený pre veci ktoré sa inde nevošli Dajú sa tam napríklad nájsť rôzne varianty súboru .htaccess pre TYPO3, alebo pravidlá pre prácu s TYPO3 SVN ak by ste chceli prispieť niečim do jadra CMSka. Nič nevyhnutné pre beh aplikácie tam nie je, ale odporúčam sa tam aspoň jedným okom pozrieť Niekedy sa môže zísť…

T3LIB

Veľmi dôležitý adresár. Obsahuje triedy, ktoré používa TYPO3, či už v backende alebo frontende. Každý súbor predstavuje jednu triedu. Napríklad v súbore ‘class.t3lib_db.php’ je trieda s metódami pre prácu s databázou. Tiež napríklad ‘class.t3lib_cs.php‘ obsahuje triedu s metódami pre konverziu textu medzi rôznymi kódovaniami. Je dobré sa naučiť používať tieto triedy. Dokážu ušetriť čas.

TYPO3

Objemom ide o najväčší adresár. Obsahuje celý backend a tiež aj frontend so všetkými základnými modulmi. Bližšie to tu popisovať nemá význam, lebo by to bolo zbytočne veľmi rozsiahle. Možno o ňom nabudúce napíšem celý článok:-)

TYPO3CONF

Adresár, kde sú uložené všetky lokálne moduly a nastavenia. Zvyčajne má nasledujúcu štruktúru:

• [D] ext
• [D] l10n
• [F] localconf.php
• [F] temp_

EXT - tu sú uložené všetky lokálne moduly (tie, ktoré tam doinštaloval privilegovaný používateľ a sú potrebné pre danú inštaláciu). Každý modul je potom v samostanom podadresári.
L10N - adresár, kde sa ukladajú XML súbory s prekladmi popisných textov pre všetky lokálne moduly aj systémové moduly. Štruktúra týchto adresárov je nasledovná: Jazyk -> modul -> plugin -> jazyk.locallang.xml.
localconf.php - základný súbor s nastaveniami cms TYPO3. Obsahuje informácie potrebné pre pripojenie k databáze, zoznam aktívnych modulov atď… Niektoré nastavenia sa dajú konfigurovať cez TYPO3 inštalačný nástroj (123 install tool)
temp_* - súbor kde sú nacechované a pospajané configy z modulov aby ich nebolo nutné zakaždým spracovávať zvlášť.

TYPO3TEMP

Adresár určený pre ukladanie cache súborov. Obsah tohto adresára môže byť kedykoľvek vymazaný. Pri najbližšom requeste na stránku sa vygeneruje nový obsah. Obsahuje naparsovné XMLka, vygenerované javascripty a iné dočasné súbory.

UPLOADS

Veľmi dôležitý adresár, kde sa ukladajú všetky reálne použité súbory na stránke na ktoré sa ničo linkuje. Napríklad používateľ si do fileadmin/user_upload uploadne nejaký obrázok. Tento obrázok potom použije pri nejakom článku. TYPO3 tento obrázok nakopíruje do adresára uploads/EXTENSION_KEY/obrazok.jpg na ktorý to potom aj linkuje a zobrazuje na stránke. Tento prístup k správe súborov zabraňuje zmazaniu už použitého súboru na stránke. Čiže v prípade že si používateľ omylom tento obrázok zmaže z adresára user_upload, tak na stránke sa bude zobrazovať stále.

index.php a _.htaccess

Myslim, že žiaden špeciálny komentár netreba k týmto súborom netreba. Snáď len, že súbor .htacces má na začiatku v mene znak ‘_’, ktorý treba zmazať ak ho chceme použiť.