Kierując się tym ogólnymi zasadami oraz swoją wiedzą i wyobraźnią, twórcy szablonów dla mogą tworzyć dowolne układy. Nie są w żaden sposób ograniczeni wymaganiami Joomla! i Mambo.

Wprawdzie kod składników Joomla! i Mambo generujących treść pozostawia wciąż jeszcze sporo do życzenia ze względu na nadużywanie HTML do formatowania treści, ale mechanizm wspomagający rozmieszczanie elementów zawartości nie budzi pod tym względem żadnych zastrzeżeń

Rozmieszczaniu elementów zawartości na stronach Joomla! i Mambo służą pozycje modułów - obszary przeznaczone na moduły.

Można zdefiniować aż 50 pozycji. 27 domyślnych zaplanowali projektanci Joomla! i Mambo, w tym dla 18 przewidziano bądź funkcję, bądź położenie, co sugerują zastosowane nazwy: header, newsflash, pathway, cpanel, banner, footer, legals, toolbar, icon, debug, advert1. advert2, advert3, top, left, right, bottom, inset. Pozostałych 9 oznaczono słowem user z kolejnym numerem user1, user2 itd.

Ten zestaw - w razie potrzeby - można jeszcze wzbogacić o 23 własne dowolnie nazwane pozycje. Nie ma więc potrzeby, jak w początkach rozwoju systemu, ingerować w kod Joomla! czy Mambo, by dodać własne pozycje bądź dokonać zmiany domyślnych nazw. Jedyny warunek - muszą to być nazwy unikalne, żadna nie może się powtórzyć.

Odpowiednich modyfikacji można dokonać z poziomu panelu administracyjnego w menu Pozycje modułów.

Nazwy pozycji zapisywane są w bazie danych i stosowane w kodzie Joomla! i Mambo tylko w głównym skrypcie szablonu w funkcji mosLoadModule (pozycja, [styl]).

Rola pozycji modułów i zasady stosowania

Pozycje służą do oznaczania w szablonie miejsc przeznaczonych na moduły. Funkcja mosLoadModule (pozycja, [styl]) umieszcza w szablonie pozycję modułów wraz z przypisanymi do niej i opublikowanymi modułami.

Przypisania modułu dokonuje się poprzez wybór z listy dostępnych pozycji w formularzach edycji właściwości modułu, (zob. rozdział Zmień szatę).

Zasady zastosowania pozycji są następujące:

• Użyta w funkcji mosLoadModule pozycja musi znajdować się w wykazie Pozycje modułów. Jeśli stosujemy nazwę, której tam nie ma, trzeba ją dopisać.
• Pozycje umieszczone w powyższym wykazie stają się natychmiast dostępne na liście wyboru w oknie edycji właściwości modułu. Jeśli w wykazie wypełnimy pole Opis [Description], to ten właśnie opis zostanie umieszczony w liście wyboru (stąd powinien być raczej krótki). Łatwiej jednak posługiwać się nazwami.
• Do każdej pozycji można przypisać dowolną ilość modułów.

Generując źródłowy dokument HTML Joomla! i Mambo dowiadują się z funkcji mosLoadModule, że w tym miejscu należy umieścić wszystkie opublikowane moduły. System sprawdza w bazie danych, jakie moduły zostały przypisane do pozycji wyszczególnionej w funkcji, uruchamia skrypty tych modułów i wpisuje wynik ich działania do generowanego dokumentu HTML.

Uwaga w sprawie nazw pozycji modułów

Tworząc projekt szablonu i rozważając zmiany nazw pozycji predefiniowanych, warto uwzględnić cztery okoliczności:

1. nazwy domyślne są wprowadzane do bazy danych przez instalatory Joomla! i Mambo i stosowane w szablonach włączonych do pakietu instalacyjnego,
2. wszystkim modułom należącym do standardowej dystrybucji Joomla! i Mambo! przypisywane są pozycje domyślne, m.in.
   • pozycja left modułom Menu główne, Menu użytkownika, Logowanie,
   • pozycja user3 modułowi Menu górne,
   • pozycja user4 modułowi wyszukiwarki,
3. Autorzy szablonów publikowanych w Sieci na warunkach GNU GPL dość powszechnie przyjęli rozwiązanie, o którym mowa w poprzednim punkcie, jako standard,
4. Domyślne nazwy pozycji modułów wykorzystywane są w systemie pomocy, w instrukcjach dołączonych do każdej dystrybucji i udostępnianych przez serwery pomocy, a także w podręcznikach dla administratorów Joomla! i Mambo.

Projektanta szablonu te rozwiązania do niczego nie zobowiązują, ani w żaden sposób nie ograniczają. Może usuwać pozycje domyślne, zmieniać ich nazwy. Zalecanym jednak jest przyjęcie rozstrzygnięć zastosowanych w pakietach instalacyjnych jako standardu ułatwiającego komunikację z użytkownikami, poradnictwo czy chociażby testowanie innych szablonów pobranych z Sieci.

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