= Portal = Moduł portal jest rozszerzeniem do systemu eDokumenty, które daje możliwość utworzenia utworzenia portalu dostępnego dla użytkowników nieposiadających konta w systemie. Do struktury eDokumentów został dodany katalog portal w '''public_html/apps/''', wewnątrz którego znajduje się cała struktura modułu - wraz z silnikiem. [[Image(schemat_portal.png)]] 1. Gdzie jest szablon strony głównej Szablony .tpl portalu znajdują się w katalogu '''public_html/apps/edokumenty/var/tpl/portal''', a plik strony głównej to '''main.tpl'''. 2. Gdzie jest CSS - custom.css Portal pozwala na dodawanie własnego kodu CSS. Szablon, który to umożliwia umiejscowiony został tam, gdzie pozostałe pliki typu assets, czyli w '''public_html/apps/portal/var/''', a w tym wypadku dokładnie w podfolderze css. Jego pełna ścieżka to: '''public_html/apps/portal/var/css/custom.css''' 3. Ogólny mechanizm: Struktura portalu zapisana jest w bazie danych, na potrzebę serwisu został utworzony osobny schemat '''portal'''. W tabeli '''pages''' przetrzymywane są definicje stron: == pages == {{{ pageid INTEGER - id strony (klucz główny) prntid INTEGER - pageid strony nadrzędnej - domyślnie NULL name__ VARCHAR - tytuł strony url___ VARCHAR - url - na potrzeby tworzenia linków na stronie i w menu short_ VARCHAR - skrócony adres j/w params JSON - dodatkowe parametry przekazywane do strony }}} Każda strona powinna zawierać treść, która jest definiowana w tabeli content == content == {{{ contid INTEGER - id treści (klucz główny) pageid INTEGER - id strony, na której treść ma zostać wyświetlona, w przypadku wartości NULL wyświetla wszędzie tam, gdzie jest użyty znacznik {uuid__:h} (uuid__ zamieniamy na wartość z uuid__, np.: header, slider itd.) htmtpl VARCHAR - jeśli ustawione, to używa szablonu, który znajduj się w folderze public_html/apps/edokumenty/var/tpl/portal/ title_ VARCHAR - tytuł treści static TEXT - statyczna treść strony - używana w przypadku braku definicji szablonu tags__ VARCHAR - tagi, oddzielane przecinkami author VARCHAR - autor treści s_from TIMESTAMP - w przypadku ustawienia treść zostanie wyświetlona dopiero po tym terminie s_to__ TIMESTAMP - w przypadku ustawienia treść przestanie być wyświetlana po tym terminie order_ INTEGER - wartość po której sortowana jest treść na stronie (od najmniejszego do największego params JSON - parametry przekazywane do contentu uuid__ TEXT - identyfikator treści - jeśli jest to zwykła treść, to musi być ustawiony na content, inaczej dajemy unikalny znacznik type__ VARCHAR - domyślnie NULL, możliwe REPORT dla raportu oraz FORM dla formularza }}} Zawartość menu wyświetlana jest na podstawie tabeli menus, która posiada strukturę: == menus == {{{ menuid INTEGER - id elementu (klucz główny) prntid INTEGER - id elementu nadrzędnego (menuid) - pozwala tworzy dwupoziomowe menu pageid INTEGER - id strony, do której ma prowadzić link label_ VARCHAR - tekst, który zostanie wyświetlony w menu oraz jako title (po najechaniu myszką na link) order_ INTEGER - służy do sortowania kolejności elementów w menu - od najmniejszego do najwększego icon__ VARCHAR - klasa ikony w formacie nazwa - lista dostępna na https://material.io/icons/ - w przypadku null ikona nie jest wyświetlana onlyic BOOLEAN - w przypadku ustawienia na true label nie jest wyświetlany, a jedynie ikona }}} Ustawienia systemowe zapisane są w kolumnie options w formie klucz-wartość: == options == {{{ opt_id - INTEGER - klucz główny, id wpisu key___ - VARCHAR - nazwa klucza value_ - VARCHAR - wartośc }}} Lista kluczy obsługiwanych przez system: {{{ default_page - id strony głównej name - nazwa serwisu - widoczna wewnątrz tagu description - opis dla meta tagów w sekcji <head> theme - folder szablonu, domyślnie jest to portal 404 - id strony błędu 404 }}} 4. Element content: * wpis w bazie * szablon * przykładowe elementy Flexy 5. Ikony Lista dostępnych ikon znajduje się na stronie: https://material.io/icons/ - w celu ich użycia należy użyć składni: {{{ <i class="material-icons">nazwa_ikony</i> np.: <i class="material-icons">home</i> }}} == Szablony == Szablon contentu w formie pliku HTML umieszczony w apps/edokumenty/var/tpl może być podłączony pod dany content w tabeli i polu "content.htmtpl". Wówczas do wizualizacji tego contentu system użyje wskazanego szablonu. W szablonie można oprócz HTML-a stosować znaczniki Flexy, w tym również takie które odwołują się do wcześniej przygotowanych komponentów. W ten sposób można wyświetlić inny element "content". {{{ {formularz_ankiety} }}}