Instrukcja edycji szablonów

Owned by Mateusz Kamiński
Last updated: Dec 06, 2019
2 min read

System Omega wspiera modyfikację szablonów w formacie XHTML technologii JSF w trakcie działania systemu. Domyślne szablony można zmodyfikować lub nawet zastąpić własnymi plikami.

Wprowadzanie modyfikacji w szablonach należy przeprowadzać stopniowo oraz rozważnie, aby nie spowodować problemów w działaniu systemu. Dlatego zalecana jest modyfikacja zawartości tekstowej strony wraz z dostosowaniem styli CSS.

Wyszukanie szablonu

Aby zmodyfikować wybrany szablon należy w Funkcjach administracyjnych wybrać moduł Szablony. Następnie wystarczy kliknąć przycisk wyszukaj aby pokazała nam się lista dostępnych szablonów.

Jedynie użytkownik z uprawnieniami administracyjnymi może wprowadzać modyfikacje w szablonach.

Na początku listy zawsze pokazują się zmodyfikowane, niedomyślne szablony (oznaczone na niebiesko). Mogą one dotyczyć wyglądu poszczególnych stron, menu, stopki lub nawet dostępnych raportów.

Szablony oznaczone na czerwono są domyślny szablonami. Jedynie w szczególnych przypadkach powinno się je zmieniać.

Aby rozpocząć edycję wybranego raportu wystarczy kliknąć w wiersz zawierający opis szablonu.

Interesujące szablony:

  • /about.xhtml - zawartość strony informacyjnej “O repozytorium”

  • /layout/menuNew.xhtml - zawartość górnej belki

  • /start.xhtml - zawartość strony głównej

  • /layout/messager.xhtml - zawartość strony głównej w panelu redaktora (informacje o kontakcie, zmianach w wersjach Omegi)

Modyfikacja szablonu

Formularz edycji szablonu udostępnia możliwość aktywowania szablonu - jeżeli jesteśmy pewni, że zakończyliśmy nad nim pracę należy zaznaczyć pole “Aktywny”.

W polu wartość możemy przeprowadzić faktyczną modyfikację zawartości szablonu. Obowiązują tu podstawowe tagi HTML lecz obowiązują restrykcje dla XHTML (silnik Java Server Faces). Tagi rozpoczynające się od prefiksuu np. ui: należą do zarejestrowanych tagów JSF. Więcej na temat dostępnych tagów można znaleźć na stronie: https://primefaces.github.io/primefaces/7_0/#/?id=main

Format XHTML wymaga poprawności domykania wszystkich tagów, co oznacza, że należy zadbać o domknięcia poprzez dodanie tagu zamykającego lub znaku “/” jeśli tag nie ma zawartości wewnętrznej np. <img /> lub <div></div>

W sekcji Diff można porównać ostatnią zapisaną wersję z poprzednią. Może to być przydatne gdy chcemy rozróżnić nasze zmiany w stosunku do zawartości domyślnej szablonu.

Na dole formularza są dostępne przyciski “save here” lub standardowe “Sprawdź poprawność”. Jeśli na bieżąco chcemy obserwować wprowadzane zmiany bez zamykania formularza edycji można zapisywać zmiany opcją “save here” a w drugiej zakładce przeglądarki odświeżać stronę której te zmiany będą dotyczyć.