


Skrypt instalacyjny: templateDetails.xml |
![]() |
![]() |
Plik templateDetails.xml jest jednym z trzech niezbędnych elementów szablonu. Joomla! i Mambo potrafią zainstalować szablon i korzystać z niego tylko wówczas, gdy plik templateDetails.xml zostanie stworzony zgodnie z regułami języka XML.
Rola pliku templateDetails.xmlSkrypt
Struktura plikuSkrypt składa się z dwóch elementów - nagłówka oraz elementu głównego:
KodOto przykładowy kod: <?xml version="1.0" encoding="iso-8859-2"?> <mosinstall type="template" version="1.0.0"> <name>nazwa_identyfikująca</name> <creationDate>2006-08-01</creationDate> <author>Nazwa projektanta - Autora, pracowni</author> <copyright>GNU/GPL</copyright> <authore-mail>adres e-mail autora</authore-mail> <authorUrl>www.domena.pl</authorUrl> <version>1.0</version> <description>Szablon dla Joomla!</description> <files> <filename>index.php</filename> <filename>template_thumbnail.png</filename> </files> <images> <filename>images/header.jpg</filename> </images> <css> <filename>css/template_css.css</filename> </css> </mosinstall> ObjaśnieniaSkrypt instalacyjny napisany jest w języku XML. Każdy znacznik musi więc być zamknięty. Poniżej znajdziesz szczegółowe objaśnienie poszczególnych elementów. NagłówekW nagłówku skryptu umieszczona jest instrukcja dla programu przetwarzającego: <?xml version="1.0" encoding="iso-8859-2"?> Informuje ona procesor, że plik został napisany zgodnie ze specyfikacją XML w wersji 1.0 (aktualnie jedyna możliwa) oraz że kodowany jest zgodnie ze standardem iso-8859-2. Można by również podać uniwersalną stronę kodową UTF-8 lub opuścić tę część instrukcji. Jeśli jej nie ma, program przetwarzający przyjmuje, że zostało zastosowane uniwersalne domyślne kodowanie - właśnie UTF-8. Element głównyElement główny rozpoczyna linia druga, a kończy ostatnia: <mosinstall type="template" version="1.0.0"> </mosinstall> Znacznik Kończąca instrukcję ostatnia linia kodu zawiera jedynie słowo kluczowe Część informacyjna<name>00_podstawa</name> Trzecia linia określa nazwę szablonu, a równocześnie nazwę katalogu, w którym instalator ma umieścić pliki. Na podstawie tej instrukcji zakładany jest katalog główny szablonu. W gruncie rzeczy jest to więc nie tylko informacja, ale i instrukcja konfiguracyjna. Instalator zakłada poprawnie nazwany katalog także wówczas, gdy nazwa szablonu składa się z więcej niż jednego wyrazu. Łączy wtedy słowa tworzące nazwę w jedno za pomocą dolnych łączników. Jeśli instalujesz szablony <creationDate>2006-08-01</creationDate> <author>Stefan Wajda</author> <copyright>GNU/GPL</copyright> <authore-mail> Ten adres email jest ukrywany przed spamerami, włącz obsługę JavaScript w przeglądarce, by go zobaczyć </authore-mail> <authorUrl>www.joomla.pl</authorUrl> <version>1.0</version> Kolejnych sześć linii zawiera dane szablonu. Nie są one konieczne, by z szablonu korzystać. Prezentowane są w panelu administracyjnym. Mogą być również wykorzystane przez składniki Joomla! i Mambo lub programy zewnętrzne.
<description>Podstawa szablonu dla Joomla.</description>
Część konfiguracyjna<files> <filename>index.php</filename> <filename>template_thumbnail.png</filename> </files> <images> <filename>images/header.jpg</filename> </images> <css> <filename>css/template_css.css</filename> </css> Linie te wskazują na pliki składowe i ich lokalizację w katalogu szablonu. Mamy tutaj trzy sekcje - obejmowane przez znaczniki
Nazwy plików ujęte są w znacznik rozpoczynający
Przygotowanie pliku konfiguracyjnego szablonu nie jest, jak widać, skomplikowane. Jeśli skrypt ma posłużyć także do instalacji szablonu, trzeba tylko dokładnie sprawdzić, czy wyszczególnione zostały w nim wszystkie pliki składowe. Aby plik został odczytany poprawnie przez intsalatora, musi zostać zakodowany zgodnie z instrukcją umieszczoną w pierwszej linii. Niektóre edytory HTML, np. polski Pajączek na podstawie tej instrukcji zapiszą plik w zadeklarowanym kodowaniu. W przypadku innych trzeba określić sposób kodowania podczas zapisu albo dokonać odpowiedniej konwersji, korzystając z programu narzędziowego lub odpowiedniego edytora. Ot, dlaczego warto korzystać z odpowiedniego oprogramowania. Uwagi, źródłaJeż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 |
|
Zmieniony ( 20.06.2007. ) |
« poprzedni artykuł | następny artykuł » |
---|