Zmiana aktualnej szaty graficznej

Spójrz na lewy lub prawy bok strony głównej. Być może moduł jest już uaktywniony. Poniżej miniatury aktualnie użytego szablonu znajdziesz listę rozwijalną. Wybierz tam inny szablon i kliknij przycisk Ustaw [Select]. Po chwili strona odświeży się w nowej szacie graficznej.

Moduł Zmień szatę na stronie frontowej

Lista tworzona jest na podstawie zainstalowanych w witrynie szablonów (umieszczonych w katalogu templates/.

Aby udostępnić moduł użytkownikom, konieczne jest przygotowanie zestawu szablonów, przynajmniej - dwóch - trzech. Szablony mogą różnić się kolorystyką, krojem czcionki, rozmiarem czcionki.

Wybór szablonu przez użytkownika anuluje przypisanie do strony zarówno szablonu domyślnego, jak i szablonów konkretnych stron. Wszystkie strony będą w przeglądarce użytkownika wyświetlane w wybranej szatce-templatce.

Zmiana szaty przy pomocy modułu Zmień szatę nie jest trwała. Po pierwszym wywołaniu adresu Twojej witryny internauta zobaczy ją w ubranku domyślnym, określonym w globalnych ustawieniach witryny w panelu administracyjnym.

Publikacja modułu

Jeśli modułu Zmień szatę nie ma, trzeba go uaktywnić, czyli opublikować.

Aby uaktywnić moduł Zmień szatę:
1. Zaloguj się do panelu administracyjnego.
2. W menu administratora przejdź do opcji Moduły ⇒ Moduły witryny [Modules ⇒ Site Modules].
3. Otworzy się okno menedżera modułów. W obszarze roboczym zostanie wyświetlony wykaz zainstalowanych modułów. Odszukaj moduł Zmień szatę [Template Chooser] i kliknij jego nazwę, by przejść do okna edycji właściwości.
4. W oknie ustawień, na samym dole znajduje się opcja Opublikowany [Published] z dwiema możliwościami. Ustaw Tak [Yes], aby uaktywnić moduł.

Aby uaktywnić moduł Zmień szatę (i każdy inny), możesz skorzystać z dróg na skróty. A takie są dwie:

• Kliknij ikonę w kolumnie Publikacja [Published] przy nazwie modułu Zmień szatę,
• Zaznacz pole wyboru przy nazwie modułu Zmień szatę, a następnie kliknij ikonę lub odnośnik Publikuj [Publish] w pasku narzędziowym pod menu administratora.

Konfiguracja modułu

Każdy moduł charakteryzują cztery grupy właściwości:

• typ [Type],
• szczegóły [Details],
• miejsce publikacji - strony [Pages/Items].
• parametry [Parameters],

Typ modułu

Każdy moduł przypisany jest do określonej grupy - typu. Nazwa typu pochodzi od nazwy skryptu, zawierającego kod modułu. Korzysta z tego skryptu zarówno oryginalny moduł, jak i każda kopia modułu (instancja). Moduł Zmień szatę i wszystkie jego kopie są przypisane do typu mod_templatechooser.

Szczegóły

Szczegóły modułu określa kilka opcji po lewej stronie okna właściwości:

• Tytuł [Title] : Tytuł modułu wyświetlany w wykazie i na stronie frontowej. Możesz wpisać dowolną nazwę, sygnalizującą rolę modułu.
• Pokaż tytuł [Show Title] : Jeśli Tak, na stronie frontowej tytuł będzie umieszczony nad treścią modułu.
• Położenie [Position] : Określa pozycję - obszar, w którym moduł będzie wyświetlany na stronie frontowej. O obszarach strony przeczytasz w dalszej części, a tymczasem zaznacz tutaj pozycję Prawa [right].
• Kolejność modułów [Module order] : Określ kolejność wyświetlania modułu w obszarze, do którego został przypisany. Jeśli modułów jest więcej, kliknij na nazwę tego, przed którym chcesz umieścić aktualnie edytowany moduł.
• Uprawnienia [Acces Level] : Określa, dla której z grup użytkowników i grup potomnych moduł będzie dostępny. Dysponujesz wprawdzie trzema opcjami, ale w przypadku modułów korzystamy jedynie z dwu pierwszych:
  • Public - dostęp publiczny: przeglądać może każdy odwiedzający witrynę,
  • Registered - dostęp dla zarejestrowanych: przeglądać mogą tylko zalogowani użytkownicy witryny,
  • Special - dostęp specjalny: przeglądać mogą tylko użytkownicy ze specjalnymi uprawnieniami (autorzy, redaktorzy, edytorzy). Uprawnienia te nadajesz w menu Witryna => Konta użytkowników => [Site => User Manager => ], przypisując użytkownika do wybranej grupy.
• Opublikowany [Published]: Decyduje, czy moduł będzie opublikowany. Moduł będzie wyświetlany tylko na ustalonych stronach witryny pod warunkiem, że szablon zawiera obszar, w którym moduł ma być opublikowany.
• ID [ID]: Numer identyfikacyjny modułu w tabeli #__modules bazy danych. ID jest nadawany automatycznie po zapisaniu nowego modułu.

Umieszczenie na stronach serwisu

To bardzo ważny element konfiguracji modułów.

Każdy opublikowany moduł może być prezentowany na jednej, kilku lub wszystkich stronach serwisu. Ustawienia dokonuje się w tej części okna edycji właściwości.

Na liście możliwości wyszczególnione są wszystkie aktualne pozycje menu oraz kilka dodatkowych opcji (Wszystkie, Brak, Nieprzypisane).

Aby wyświetlać moduł na wszystkich stronach, wystarczy zaznaczyć pierwszą z opcji - Wszystkie.

Aby zaznaczyć więcej niż jedną stronę - pozycję menu, trzeba użyć myszki oraz klawisza [CTRL] w komputerach PC, a w komputerach Mac [Command].

Moduł wyświetlany jest na stronach wywoływanych po kliknięciu zaznaczonego tutaj łącza w menu oraz wszystkich stronach, do których ta pozycja menu prowadzi pośrednio. A więc gdy na przykład zaznaczysz pozycję wywołującą wykaz zawartości sekcji, to moduł zostanie wyświetlony zarówno na stronie z wykazem zawartości sekcji, jak i stronach z wykazami zawartości kategorii oraz na każdej stronie z artykułem pochodzącym z tej sekcji.

O umieszczeniu modułów na stronach serwisu najlepiej zdecydować po ustaleniu struktury i zawartości wszystkich menu. Trzeba również pamiętać, aby po dodaniu nowych pozycji zdecydować również, czy na wywoływanych z tego połączenia stronach mają być prezentowane jakieś moduły.

Parametry

W sekcji parametrów możesz zdecydować o różnych ustawieniach modułów. W przypadku modułu Zmień szatę możesz ustalić następujące kwestie:

• Przyrostek klasy CSS modułu [Module Class Suffix] : Jeśli stworzysz w arkuszu stylów specjalną odmianę klasy table.moduletable lub klasy .module dla wyświetlania tego modułu, wpisz tutaj przyrostek tej klasy, np. -szata.
• Schowek [Enable Cache] : Tak, aby generowane przez moduł treści były przechowywane w schowku (katalogu pamięci podręcznej na serwerze: /cache). Zaznaczenie tej opcji zmniejsza ilość zapytań do bazy danych i przyspiesza zarówno operacje na serwerze, jak i wczytywanie stron w przeglądarkach użytkowników. Katalog /cache musi mieć ustawione prawa do zapisu.
• Długość nazwy [Type] : Określ maksymalną ilość znaków wyświetlanych w nazwie szablonu (domyślnie 20). Jeśli nazwa będzie zawierać więcej znaków, zostanie skrócona.
• Podgląd miniaturek [Show preview] : Zaznacz Pokaż lub Ukryj miniaturki szat graficznych. Miniaturki to pliki template_thumbnail.png w katalogach szablonów.
• Szerokość [Width] : Określ szerokość miniaturki szablonu (w pikselach - domyślnie 140). Może powodować nieoczekiwane efekty, jeśli obrazek miniaturki ma inną szerokość).
• Wysokość [Height] : Określ wysokość miniaturki szablonu (w pikselach - domyślnie 90). Może powodować nieoczekiwane efekty, jeśli obrazek miniaturki ma inną wysokość. Najlepiej więc przygotować miniaturki standardowych rozmiarów.

Na wszystkich stronach panelu administracyjnego dysponujesz rozbudowanym systemem pomocy. Jeśli niewiele mówi Ci nazwa parametru, wystarczy ustawić nad nią wskaźnik myszki, by pojawiło się dodatkowe objaśnienie. Pomoc kontekstowa sygnalizowana jest podkreśleniem nazwy parametru. Możesz również skorzystać z szerszego omówienia wszystkich dostępnych podczas edycvji opcji, klikając przycisk Pomoc w pasku narzędzi pod górnym paskiem menu.

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