Struktura katalogów patTemplate została wymodelowana zgodnie z koncepcją PEAR. Główna klasa patTemplate jest zlokalizowana w pliku patTemplate.php katalogu /root (lub w /pat, jeśli instalowałeś, korzystając z instalatora PEAR). Jest to jedyny plik, który należy załączać.

Znajdziesz również katalog patTemplate zawierający wszystkie moduły patTemplate. W tym katalogu znajduje się plik Module.php zawierający klasę patTemplate_Module, odgrywającą rolę podstawowej klasy dla różnego rodzaju modułów jak Functions, Modifiers, Readers itp. Oprócz tego znajdziesz plik dla każdego modułu, który może być wykorzystywany w patTemplate jak np. Reader.php, Function.php, TemplateCache.php itp. Powyższe pliki zawierają podstawowe klasy dla modułów, które możesz utworzyć.

W katalogu patTemplate jest kilka katalogów, które pomogą ci organizować istniejące moduły. Readers są w katalogu patTemplate/Readers, funkcje w patTemplate/Functions itp.

Drzewa klas

patTemplate jest w systemem w pełni obiektowym. Oznacza to mniej więcej tyle, że wszystko musi być klasą. Większość klas jest całkiem prosta i będziesz musiał zaimplementować jedną albo dwie metody. Ale pomimo tego muszą to być klasy, ponieważ globalne nazewnictwo nie może zostać naruszone.

Pliki i katalogi odwzorowują wprost nazwy klas. Oznacza to tyle, że patTemplate.php zawiera klasę nazwaną patTemplate, a plik patTemplate/Reader.php klasę patTemplate_Reader. Jeśli utworzysz czytnik (Reader), który powinien móc wczytywać szablony z bazy danych, powinieneś go umieścić w pliku patTemplate/Reader/DB.php, a klasę nazwać patTemplate_Reader_DB.

Jeśli nie będziesz przestrzegał tych prostych zasad patTemplate nie będzie w stanie wgrać i uruchamiać modułów i twoja aplikacja przestanie funkcjonować.

Uwagi, źródła

Jeżeli masz sugestie odnośnie treści lub chcesz zgłosić poprawki do tego rozdziału, skomentuj go albo umieść wiadomość na forum: Dokumentacja - Propozycje, zmiany, poprawki

Dziękujemy!

Stefan Wajda, Zespół Dokumentacji PCJ

Tłum. Adam Sobkowicz. Na podstawie: help.joomla.org