hiszpański gliwice
szkolenia z joomla, wordpress i drupal

Tworzenie szablonu dla Joomla! Część II

26 października 2010 | Joomla!,Szablony,aPorady

Zacznijmy od stworzenia pliku czyli index.php. Jest to główny plik z którego jest sklejany cały  szablon. Jego najważniejsze elementy to:

<?php

defined( ‘_JEXEC’ ) or die( ‘Restricted access’ );

?>

Te trzy linijki kodu zabezpieczają bezpośrednie odwołanie się do tego szablonu.

Przykład:

Jeżeli ten kod wpiszesz. Wtedy po wpisaniu http://Twojastrona.pl/templates/tabelkowaty/index.php

Dostaniesz napis:

Restricted access

Jeżeli pominiesz ten kod. Szablon oczywiście będzie działał. Ale umożliwiłeś bezpośrednie odwołanie się do tego pliku. Możliwość bezpośrednich odwołań powoduje zwiększenie niebezpieczeństwa.

Kolejny element to:

<!DOCTYPE html PUBLIC „-//W3C//DTD XHTML 1.0 Transitional//EN” „http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”>

Te linie definiują standard XHTML. W uproszczeniu ten standard definiuję jakie znaczniki mają być użyte i w jaki sposób. Generalnie są trzy główne standardy

  • Transitional – przejściowy. Jeden z najczęściej stosowany. Oznacz, że kod jest napisany zgodnie ze standardem ale pozwala także używać elementy HTML niezalecane.
  • Strict- ścisły. Czyli można deklarować tylko elementy zgodne ze standardem.
  • Frames –ramki. Kod dla ramek napisany zgodnie ze standardem. Jest to odmiana Transitional ale z zezwoleniem na użycie ramek.

Żeby uchronić kod przed błędami najlepiej użyć tryb Transitional.  Możesz podpatrzyć, wszystkie szablony załączone do J! stosują tą deklarację.

<html xmlns=”http://www.w3.org/1999/xhtml” xml:lang=”<?php echo $this->language; ?>” lang=”<?php echo $this->language; ?>” dir=”<?php echo $this->direction; ?>” >

Deklaracja rodzaju dokumentu, języka i kierunku tekstu (ltr – left to right, rtl- right to left).

Na końcu trzeba dodać podstawowe elementy dokumentu typu html czyli znaczniki <head>, <body>.

Nasz dokument powinien wyglądać tak:

Stuktura szablonu Joomla

Jeżeli edytujesz stronę w zwykłym notatniku to odradzam z wielu powodów. Najlepiej wyposażyć się w jakiś zaawansowany notatnik, który nie dość, że wyróżni kod HTML to jeszcze doda numer linii etc. Osobiście polecam PSPad-a.

Tak więc główny plik index.php został stworzony. Teraz musimy stworzyć plik templateDetails.xml który będzie zawierał wszystkie szczegóły odnośnie szablonu jak:

  • Autor szablonu
  • Data stworzenia
  • Licencja
  • Wersja (nie mylić z wersją Joomli!)
  • Pliki wchodzące w skład
  • Parametry szablonu

Najprostszym rozwiązaniem jest skopiowanie tego pliku z innego szablonu. I tak też zrobimy. Na potrzeby tego szablonu skopiowałem plik templateDetails.xml z szablonu Ja_purity

Szczegóły szablonu

Po otwarciu powinien wyglądać tak jak przedstawia to obrazek powyżej. Jest on stworzony w XML czyli składa się z serii znaczników które informują:

  • <?xml version=”1.0″ encoding=”utf-8″?> wersja XML i kodowanie
  • <name>- nazwa szablonu. Powinna być taka sama jak nazwa folderu, czyli w naszym przypadku tabelkowaty.
  • <version>- wersja szablonu, że to nasz pierwszy nazwijmy go 1.0.0
  • <creationDate> – data utworzenia
  • <author>- autor
  • <autor Email> – e-mail do autora
  • <autorURL>- adres strony autora
  • <copyright>- prawa autorskie
  • <license>- rodzaj licencji
  • <filename>- spis wszystkich plików tworzących szablon
  • <position>- wszystkie  pozycje dostępne w szablonie. Uwaga, mogą się także znajdować pozycje nie wyświetlane w szablonie.
  • <param>- parametry szablony. Przykładowo, można ustawić tak parametry aby zmiana koloru witryny nie odbywała się przez zmianę plików CSS a tylko zmianę parametrów w szablonie

To zaczynamy tworzyć plik templateDetails.xml. Załóżmy, że na początek będzie zawierał standardowe pozycje:

  • Left- czyli lewa strona
  • Right- prawa strona
  • Top- góra
  • footer- dół

Nazwy są dowolne. Jednak utarło się aby stosować takie nazewnictwo co wynika ze sposoby budowy szablonów dla wersji Joomla! 1.0.X. Dzięki używaniu takich nazw, nawet jak zaczniesz przeglądać szablony innych twórców od razu zorientujesz się gdzie dany moduł się wyświetla. Po wprowadzeniu danych do pliku templateDetails.xml powinien on wyglądać tak:Szczegóły nowego szablonu Joomla

Jeżeli zalogujesz się do zaplecza strony, to możesz sprawdzić, że twój szablon pokazał się w spisie szablonów. Ustaw go jako domyślny.

Wybór szablonu Joomla

Po uruchomieniu naszej strony powinien pojawić się biały ekran. Czyli wszystko działa. Teraz stwórzmy pozycje dla komponentów i modułów.

Losowe artykuły


Leave a Reply