Trzy podstawowe pliki szablonu

Niezbędne minimum stanowią trzy skrypty:

• plik templateDetails.xml,
• plik index.php,
• plik template_css.css.

Każdy z tych skryptów spełnia specyficzne funkcje:

• Plik templateDetails.xml jest skryptem XML. Zawiera instrukcje, które integrują szablon z Joomla! lub Mambo, określają instalatorowi, gdzie i jakie pliki szablonu umieścić podczas instalacji oraz udostępniają informacje o szablonie w panelu administracyjnym.
• Plik index.php jest skryptem PHP. Zawiera instrukcje generujące dokumenty HTML przesyłane z serwera do urządzeń odczytujących, np. przeglądarek internetowych, które wyświetlają czy odczytują strony Joomla.
• Plik template_css.css jest skryptem CSS - arkuszem stylów kaskadowych. Zawiera reguly określające sposób prezentacji materiałów na stronie: wygląd fontów krój, stopień, kolor, właściwości akapitów i nagłówków, sposób wyróżnienia znaczących słów i fragmentów, a także często granice, rozmiar, wielkość poszczególnych elementów.

Inne elementy szablonu

W skład szablonu wchodzą lub mogą wchodzić inne pliki:

• pliki obrazków, pozwalające uzyskać różne efekty estetyczne; umieszcza się je zwykle w katalogu /images,
• plik template_thumbnail.png - miniatura zrzutu ekranu ilustrująca szablon,
• plik editor_content.css zawierający alternatywny arkusz stylów dla edytora,

• plik print.css zawierający alternatywny arkusz stylów dla drukarki,

• pliki Javascript umożliwiające osiągnięcie specjalnych efektów (różnego typu, niekoniecznie graficznych).

Katalog szablonów

Pliki szablonu Joomla! i Mambo przechowywane są w jednym katalogu /templates, w odrębnym folderze nazwanym tak jak szablon /nazwa_szablonu. Zgodnie z konwencją stosowaną w systemach UNIX, nazwy katalogów powinny być zapisane bez spacji, a jeśli złożone są z kilku wyrazów, to należy zapisać je razem, np. używając łączników.

Ilustracja poniżej przedstawia drzewo katalogu /templates, w którym umieszczone są trzy szablony.

Lokalizacja plików szablonu

Pliki szablonu mają swoje w zasadzie ściśle określone miejsce:

• pliki templateDetails.xml oraz index.php muszą być umieszczone w głównym katalogu szablonu, a także nosić dokładnie takie właśnie nazwy (zwróć uwagę na wielką literę D w nazwie pierwszego z plików),

• plik template_css.css powinien znajdować się w katalogu nazwanym standardowo /css. Można go wprawdzie umieścić w katalogu nazwanym inaczej, ale trzeba się wówczas liczyć, że niektóre skladniki dodatkowe nie będą w stanie zlokalizować tego pliku samodzielnie,
• plik template_thumbnail.png również powinien być umieszczony w głównym katalogu szablonu (tam poszukuje go m.in. moduł Zmień szatę [Template Chooser]).

Oto przykładowa typowa struktura katalogów szablonu:

/templates
  /moj_szablon
     /css
         template_css.css
     /images
         logo.png
         list.png
         menu_bg.png
         belka.png
     index.php
     template_thumbnail.png
     templateDetails.xml

Ilustracja poniżej pokazuje podstawową zawartość katalogu szablonu Rhuk Solarflare II włączonego do dystrybucji Joomla:

Katalog z grafikami nie został na ilustracji rozwinięty, aby nie zaciemniać obrazu.

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