--=REKLAMA=--

J2.5

Modyfikacja szablonu Joomla

Z Joomla!WikiPL

Szablony to grupa plików XML, PHP, HTML i graficznych, które są przechowywane w katalogu /templates twojej witryny. Pliki te można edytować bezpośrednio lub za pomocą menedżera szablonu.

Zanim zaczniesz

Zanim zaczniesz przerabiać zainstalowany szablon domyślny, musisz zdać sobie sprawę, że wszelkie aktualizacje plików rdzenia Joomla mogą zawierać nowsze wersje szablonów domyślnych. Zmiany, które wprowadzisz w plikach domyślnych szablonów, mogą więc być utracone podczas aktualizacji Joomla. Chyba, że podejmiesz kroki, które uchronią twoją pracę przed utratą modyfikacji.

Menedżer szablonów zawiera narzędzia do powielania i kopiowania istniejących stylów szablonu lub całego szablonu i plików szablonu. Należy pamiętać, że stworzenie jedynie kopii stylu szablonu nie chroni szablonu przed nadpisaniem. Kopia stylu jest po prostu kolejnym wpisem w tabeli #_template_styles bazy danych. Podczas kopiowania stylu szablonu pliki szablonu nie są powielane do katalogu o innej nazwie. Mogą wiec być podczas aktualizacji Joomla nadpisane.

Dla przykładu rozważmy przypadek, gdy na stronie menedżera szablonów powielamy domyślny styl szablonu Prostar, a następnie modyfikujemy plik /templates/protostar/css/template.css. Aktualizacja Joomla może zawierać pełny zestaw plików szablonu Prostar. Jeśli tak się zdarzy, twoje zmiany zostaną w wyniku aktualizacji utracone.

Aby uchronić się przed utratą wprowadzanych zmian, należy skopiować szablon ze wszystkimi stylami. W ten sposób po prostu tworzymy nowy szablon.

Kopiowanie istniejącego szablonu

Aby utworzyć nowy szablon, kopiując istniejący:

  1. Na zapleczu przejdź na stronę menedżera Szablony.
  2. Kliknij w menu lokalnym zakładkę Szablon (nie Style, ale Szablon – po prawej stronie)
  3. Z listy szablonów wybierz ten, który chcesz skopiować (kliknij jego nazwę)
  4. Na stronie szczegółów szablonu w sekcji Skopiuj szablon wpisz nazwę nowego szablonu.
  5. Kliknij przycisk Skopiuj szablon.

Można też skopiować szablon ręcznie:

  1. Utwórz nowy katalog templates/moj_szablon.
  2. Skopiować zawartość oryginalnego katalogu szablonu do katalogu moj_szablon.
  3. Przejdź z katalogu głównego do podkatalogu /language /en-GB.
    • Skopiuj plik 'en-GB.tpl_oryginalny_szablon.ini do pliku en-GBL.tpl_moj_szablon.ini
    • Skopiuj plik en-GB.tpl_oryginalny_szablon.sys.ini do pliku en-GB.tpl_moj_szablon.sys.ini
  4. W katalogu szablonu przejdź do katalogu /language/en-GB, jeśli istnieje:
    • Skopiuj plik en-GB.tpl_oryginalny_szablon.ini do pliku pl-PL.tpl_moj_szablon.ini
    • Skopiuj plik en-GB.tpl_oryginalny_szablon.sys.ini do pliku pl-PL.tpl_moj_szablon.sys.ini
  5. Otwórz plik templateDetails.xml w katalogu moj_szablon i zmień wszystkie odniesienia, jeżeli takie istnieją, do katalogu oryginalnego szablonu tak, aby odwoływać się do katalogu moj_szablon
<name>Moj_Szablon</name>
<language tag="en-GB">en-GB.tpl_moj_szablon.ini</language>
<language tag="en-GB">en-GB.tpl_moj_szablon.sys.ini</language>
 
<param name="theme_header" type="folderlist" directory="templates/moj_szablon/styles/header" default="" label="Header Themes" description="HEADER THEMES DESCRIPTION" />
<param name="theme_background" type="folderlist" directory="templates/moj_szablon/styles/background" default="" label="Background Themes" description="BACKGROUND THEMES DESCRIPTION" />
<param name="theme_elements" type="folderlist" directory="templates/moj_szablon/styles/elements" default="" label="Primary Elements" description="PRIMARY ELEMENTS DESCRIPTION" />

Wykrycie nowego szablonu

Teraz musimy zarejestrować (zameldować) nowy szablon w bazie danych. Posłużymy w tym celu narzędziem wykrywania niedokończonych instalacji.

  1. Przejdź na zapleczu na stronę Rozszerzenia → Instalacje → Wykrywanie
  2. Kliknij w przyborniku ikonę Wykryj.
  3. Na liście wykrytych rozszerzeń zaznacz nowy szablon.
  4. Kliknij przycisk Zainstaluj.

Jeśli wszystkie te operacje się powiodą, nowy szablon będzie dostępny na stronie menedżera szablonów w Rozszerzenia → Szablony.

W swoim nowym szablonie możesz dokonywać poprawek bez obawy, że zostaną utracone podczas aktualizacji Joomla.

  1. Ustaw nowy szablon jako szablon domyślny.
  2. Obejrzyj witrynę, aby sprawdzić, czy nie pojawiły się jakieś błędy.

Znajdywanie błędów

Po utworzeniu nowego szablonu metodą kopiowania innego istniejącego szablonu mogą się przytrafić problemy w działaniu. Jeden z nich może być spowodowany sposobem, w jaki obsługiwane są nazwy plików - w systemach opartych na Linuksie wielkość znaków w nazwach plików ma istotne znaczenie. Moj_Szablon i mój_szablon to dwie różne nazwy.

Joomla posiada kilka przydatnych narzędzi diagnostycznych. Aby zobaczyć, co dzieje się podczas pracy witryny, trzeba zmienić trzy ustawienia.

  • Zaplecze    Witryna    Konfiguracja globalna    System    Ustawienia    Diagnostyka    System    Tak (domyślnie = Nie )
  • Zaplecze    Witryna    Konfiguracja globalna    System    Ustawienia    Diagnostyka    Język    Tak (domyślnie = Nie)
  • Zaplecze    Witryna    Konfiguracja globalna    Serwer    Ustawienia serwera    Raportowanie błędów    Maksimum (domyślnie = Domyślne systemu)

Jeśli ustawimy diagnostykę języka na Tak, w raporcie na dole strony pojawią informacje o załadowaniu bądź niezaładowaniu plików językowych i ewentualnych błędach w plikach językowych. Aby wyświetlić szczegółowy raport, otwórz karty Pliki językowe z błędami i Wczytane pliki języka.

© Ten materiał jest dokładnym albo swobodnym tłumaczeniem artykułu http://docs.joomla.org/J2.5:Modifying_a_Joomla!_Template udostępnionego na licencji JEDL na witrynie: Oficjalnej dokumentacji Joomla!.Pierwszy autor oryginału: Tom_Hutchison.