Jak stworzyć własny szablon dla Joomla 1.5?

Co nam będzie potrzebne do stworzenia własnej, autorskiej templatki? Jakie wymagania stawia Joomla? Otóż bardzo niewielkie – wystarczy znajomość HTML + CSS. Pisząc ten tutorial, zakładam iż właśnie minimum te dwa języki znasz, i biegle się nimi posługujesz.

    · folder „template” :

o index.php

o index.htm

o templateDetails.xml

o template_thumbnail.png

 

o podfolder „css” :

 

§ podfolder „images” 

§ template.css

• index.php – główny plik szablonu, zawiera całą strukturę strony (nasz kod HTML + wstawki PHP w miejscach, gdzie ma się pojawiać treść generowana przez Joomlę)
• index.htm – plik opcjonalny, lecz zalecany ze względów bezpieczeństwa. Zawiera jedynie kilka linijek kodu.
• templateDetails.xml – bardzo ważny element szablonu, zawiera wskazówki (i nie tylko) dla Joomli podczas instalacji szablonu.
• template_thumbnail.png – miniaturka graficzna
• template.css – deklaracje stylów w języku CSS, umieszczone w podfolderze „css”

Na początku szablonu wymagany jest krótki kod PHP – służy on do nadzoru bezpieczeństwa strony. Następnie jest deklaracja DOCTYPE oraz języka strona (z elementami PHP). Są to wartości stałe, a więc wystarczy je… przekopiować

W sekcji HEAD widzimy deklarację jdoc:include type=”head” . Zastępuje ona standardowe znaczniki meta danych. Słowa kluczowe, opis i tytuł strony możemy ustawić w konfiguracji strony w Panelu Administracyjnym Joomli, już po instalacji szablonu.

Widzimy tam również łączę do naszego stylu CSS. Myślę, że nie trzeba tu wiele objaśniać – znając ten język, doskonale wiesz jakie ma możliwości.

 

 

Jak widać deklaracja modułów I komponentów (bo tak naprawdę wyłącznie na tym opiera się budowa szablonu Joomli) jest bardzo prosta – wszystko mieści się w 4-5 słowach!

 

Dla modułów:

 jdoc:include type=”modules” name=”top” /> 

Gdzie name oznacza nazwę modułu (jest ona dowolna – w tym przypadku moduł nazwałem “top”). Oczywiście liczba modułów na stronie może być różna – może ich nie być w ogóle, a jednocześnie nic nie stoi na przeszkodzie aby zadeklarować kilkanaście czy kilkadziesiąt różnych modułów (każdy musi mieć jednak unikalną nazwę!). W powyższym kodzie zadeklarowaliśmy 3 moduły (left, top i right).

Dla komponentów wszystko odbywa się analogicznie – z tą różnicą, iż możemy pominąć nazwę:

 

Dla komponentów:

 jdoc:include type=component /> 

 

I już mamy zadeklarowane miejsce na wyświetlanie wszelkich komponentów na stronie!

 

A co najlepsze - cała reszta to wyłącznie czysty kod HTML + CSS!

 

Plik index.php dostępny do pobrania - klik!

 

Budowa pliku templateDetails.xml

 

Plik templateDetails.xml generalnie rzecz biorąc, instruuje Joomlę jak zainstalować szablon. Jest plikiem wymaganym i umieszczamy go w folderze głównym szablonu, obok index.php.

 Plik templateDetails.xml dostępny do pobrania - klik!

 

Budowa opcjonalnego pliku index.htm

Dzięki plikowi index.htm dodatkowo zabezpieczymy naszą stronę przed niepowołanymi działaniami osób trzecich. Jego budowa jest niezwykle prosta, wszystko ogranicza się do stałych kilku linijek, dzięki czemu nie musimy za każdym razem na nowo go budować - wystarczy go skopiować. Jego kilkulinijkowy kod jest dostępny pod tym linkiem:

Plik index.htm dostępny do pobrania - klik!

 

Zakończenie

No dobrze, skończyłem budować szablon. Co teraz? Jak go zainstalować?

Otóż wystarczy go spakować w archiwum ZIP. Przyda się tu np. WinRAR, 7ZIP lub inny podobny program archiwizujący. Następnie wystarczy w panelu administracyjnym Joomli za pomocą domyślnego instalatora szablonów zainstalować nasz szablon, po czym ustawić go jako domyślny. Voila, koniec!

 

 

Pliki, które zostały omówione powyżej, są w całości dostępne do pobrania:

template.zip (pobierz)