Pro členy katedry a sekr

Prohlížení info o osobách je na http://www.kiv.zcu.cz/katedra/clenove/, úpravy jsou cetralizované na https://www.kiv.zcu.cz/local/admin/clenove/.

Přidávání, změny pozic a odstraňování osob může dělat admin a sekretariát. Každý si může upravovat svoje vlastní údaje (po přihlášení přes Orion jméno a heslo).

Pro admina

Po přidání nové osoby je potřeba, aby ještě admin zavedl odpovídajícího uživatele do OpenCms (aby se dotyčný mohl přihlásit na web). Při zavedení je potřeba v datech uživatele

zadat login stejný jako má v Orionu; vyplnit jméno a příjmení
zadat náhodné dlouhé heslo, které nejde cracknout, protože přihlašování se děje přes Orion hesla
napsat do popisu osoby něco jako "doktorand od 2010" pokud jde o doktoranda, aby se vědělo, jak dlouho už tam uživatel visí a jestli je třeba ho případně zrušit, když doktorand skončí
přidělit správně skupiny, aspoň "KIV", "KIV Staff" xor "KIV Doktorandi"

Instalace a konfigurace modulu

Tento návod popisuje instalaci modulu cz.zcu.kiv.osoby na beta.kiv.zcu.cz. Jelikož je modul závislý na konkrétní DB na KIV, nebude fungovat v systému bez přístupu k této DB.
Nutná podmínka pro instalaci tohoto modulu: V OpenCms musí být nainstalován aplikační framework Spring.

aktuální verze modulu je cz.zcu.kiv.osoby_0.16.zip

Importování modulů

Pro instalaci modulu je třeba provést následující kroky:

Importujte do OpenCms modul cz.zcu.kiv.common

Modul Osoby má nastavenou dependency na tento modul, takže bez něj nebudete moci provést krok 2.

Aktuální verze modulu Common je cz.zcu.kiv.common_0.12.zip

Importujte do Opencms modul cz.zcu.kiv.osoby

Vytvoření JSP resources na frontendu

Po importování modulů je nutné vytvořit JSP stránky na OpenCms frontendu. Na beta.kiv.zcu.cz jsem následující stránky do adresáře www.kiv.zcu.cz/osoby/.

aktivity-edit.jsp
ciselniky-edit.jsp
clenstvi-edit-jsp
detail.jsp
edit.jsp
kategorie-edit.jsp
pozice-edit.jsp
predmety-edit.jsp
seznam.jsp

Každá z těchto JSP stránek obsahuje pouze include stejnojmenného JSP z modulu cz.zcu.kiv.osoby tedy např. JSP detail.jsp obsahuje následující kód:

    
    <?xml version="1.0" encoding="UTF-8"?>
    <%@ taglib prefix="cms" uri="http://www.opencms.org/taglib/cms" %>

    <cms:include page="/system/modules/cz.zcu.kiv.osoby/pages/osoby/detail.jsp" />

Fotografie osob

Jelikož některé JSP z adresáře osoby zobrazuje fotografii osob (např. detail.jsp), je třeba nastavit property fotky_osob_folder_path u adresáře ve kterém se JSP zobrzující fotografii nachází, nebo přímo na property samotného JSP. Na beta.kiv.zcu.cz jsem tuto property nastavil na adresář www.kiv.zcu.cz/osoby/
Property udává, kde jsou uloženy soubory s fotografiemi.

Tato property defaultně není definovaná, takže je nutné ji nejprve definovat. Hodnota property se pak vyplní podle toho, kam se budou fotky osob do VFS ukládat (hodnota bude cesta k existujícímu adresáři).

Příklad z beta.kiv.zcu.cz: Property jsem nastavil přímo na detail.jsp, protože ji na jiné stránce nebudu potřebovat.

fotky_osob_folder_path=/osoby/fotografie/

Nastavení lokalizace modulu Osoby

Modul Osoby je vytvořen ve 2 jazykových verzích - české a anglické. Vytvoření obou lokalizací popíšu podle toho, jak jsem je vytvořil na beta.kiv.zcu.cz

Česká verze

Na adresáři www.kiv.zcu.cz/osoby/ jsem vyplnil následující property:

locale=cs

Anglická verze

Vytvořil jsem sibling celého adresáře www.kiv.zcu.cz/osoby/ (i se všemi resources uvnitř) do adresáře www.kiv.zcu.cz/en/ Tento adresář má totiž nastavené property:

locale=en

Na tomto uri - www.kiv.zcu.cz/en/osoby/ je nyní tedy umístěna anglická lokalizace modulu osob. Později bude ještě třeba přejmenovat adresáře a jednotlivá JSP na anglické názvy.