Hlavní menu
Nástroje |
Zde je stručné shrnutí postupu pro normální uživatele. Pozn: autorizovanému softwaru se v evidenční aplikaci říká "Produkt". Přihlášení:
Jak se najde autorizovaný software
Zadání/úprava produktu:Všechny stránky s autoriz.sw. mají lokální menu dole (na konci stránky) vpravo; přes něj se dělá většina akcí.
Tytéž softwary jsou také na anglických stránkách (English > Research > Software) kde ale nejsou editační formuláře. K dispozici je také podrobná příručka. Technická dokumentace: Instalace modulu ProduktyTento návod popisuje instalaci modulu cz.zcu.kiv.produkty 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.
Importování modulůPro instalaci modulu je třeba provést následující kroky:
Modul Produkty má nastavenou dependency na tento modul, takže bez něj nebudete moci provést krok 3.
Aktuální verze modulu Common je cz.zcu.kiv.common_0.12.zip
Vytvoření JSP resources na frontenduPo 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/produkty/.
Každá z těchto JSP stránek obsahuje pouze include stejnojmenného JSP z modulu cz.zcu.kiv.produkty tedy např. JSP detail.jsp obsahuje následující kód: <%@ taglib prefix="cms" uri="http://www.opencms.org/taglib/cms" %> <cms:include page="/system/modules/cz.zcu.kiv.produkty/pages/produkty/detail.jsp" /> Nastavení adresáře pro ukládání souborů produktuProduktům je možné přiřadit soubor, který se uploaduje do OpenCms VFS. Je tedy třeba nastavit property upload_folder_path u adresáře ve kterém se nachází JSP pracující s produkty. Na beta.kiv.zcu.cz jsem tuto property nastavil na adresář www.kiv.zcu.cz/produkty/. Property udává, kam se ukládají uploadované soubory. Tato property defaultně není definovaná, takže je nutné ji nejprve definovat. Hodnota property se pak vyplní podle toho, kam se budou soubory do VFS ukládat (hodnota bude cesta k existujícímu adresáři). Příklad z beta.kiv.zcu.cz: Vytvořil jsem adresář www.kiv.zcu.cz/produkty/data/. Property jsem nastavil na adresář www.kiv.zcu.cz/produkty/.
Nastavení přístupových práv na modul ProduktyNa Modulu Produkty následující role uživatelů:
Aby jsme využili všechny funkce modulu, je třeba přiřadit OpenCms skupinám tyto role. Na beta.kiv.zcu.cz jsem nejprve definoval nové property:
Na adresáři www.kiv.zcu.cz/produkty pak těmto properties přiřadím hodnotu. Každá role přitom může být přidělena více skupinám - pro tento případ v property odděluji jednotlivé skupiny znakem Př. V OpenCms mám následující skupiny:
Chci, aby uživatelé ze skupin TestVedeni a TestNeutral mohli schvalovat produkty a uživatelé ze skupiny TestNeutral byli vlastníky. Property tedy nastavím následujícím způsobem:
Poznámka: při registraci uživatelů do OpenCms je potřeba, aby se jim nastavily
Práva pro adresář se souboryJelikož se produkty stahují přes licenci, neměl by být umožněn přímý přístup do adresáře www.kiv.zcu.cz/produkty/data/, kde jsou uloženy soubory produktů. K tomu je třeba upravit permissions k tomuto adresáři.
Pokud chce uživatel jakkoli editovat produkty, musí se přihlásit do systému OpenCms jako schvalovatel, vlastník, nebo administrátor. K produktům se však vkládají i údaje o uživateli, který je editoval a tyto údaje se berou z DAO osoby. Proto je třeba, aby pro uživatele, který edituje produkty, existovala v Nastavení pomocného uživatele pro download souborůZ předchozí kapitoly vyplývá, že nepřihlášený uživatel nebude mít přístupová práva ke složce, v níž jsou uloženy soubory produktů. Tzn., že si nebude moci stáhnout soubory ani již publikovaného produktu. Z tohoto důvodu bylo třeba vytvořit pomocného uživatele pro download produktů - ten musí být typu WebUser nikoli normální uživatel. Oproti schvalovatelům a vlastníkům však údaje o download uživateli jsou umístěny do souboru classes/cz/zcu/kiv/produkty/access.properties ve složce modulu. V tomto souboru je třeba definovat properties:
Př. V Opencms mám skupinu TestDownload a do ní patří uživatel download, jehož přístupové heslo je: password
Do access.properties tedy uložím následující properties:
Download uživatel však stále nemá přístup do složky se soubory produktů: www.kiv.zcu.cz/produkty/data/. Upravíme tedy permissions k tomuto adresáři:
Nastavení SMTP serveru pro odesílání e-mailů o navržení produktů na schváleníPři navržení produktu na schválení se provede akce odeslání emailu o navržení na schválení schvalovatelům. smtp=smtp.zcu.cz odesilatel=email@kiv.zcu.cz username= password= port=25 tls.enable=false auth=false subject=Navr\u017Een\u00ED produktu
U odesílání mailů jsem také narazil na problém, že na beta.kiv.zcu.cz byla mezi knihovnami OpenCms verze 6.2.3 zastaralá knihovna javamail-API. Verzi, s kterou již odesílání funguje přikládám zde: Soubor mail.jar je poté potřeba nakopírovat do Nastavení počtu produktů. které se zobrazí na stránce seznam-nejstahovanejsi.htmlPočet zobrazovaných nejstahovanějších produktů lze na této stránce redukovat nastavením property pocet_produktu. Tuto property je třeba nejprve definovat.
Pokud property není nastavena, zobrazuje se seznam všech schválených produktů v systému. Nastavení maximální velikosti uploadovaného souboru produktuMaximální velikost souboru pro upload je možné nastavit vytvořením a vyplněním property max_file_upload_size. Tuto property je třeba nejprve definovat. Příklad z beta.kiv.zcu.cz: Property jsem nastavil na adresář www.kiv.zcu.cz/produkty/
Pokud property není nastavena, je maximální velikost souboru pro upload omezená pouze velikostí paměti webového kontejneru. Nastavení větší velikosti paměti webového kontejneruV případě, kdy bude chtít webmaster umožnit uploadování souborů větších než cca 10 MB, aplikace bude vyžadovat na webovém kontejneru více paměti a tudíž bude třeba zvýšit na něm velikost haldy, jinak bude OpenCms vyhazovat následující hlášku: java.lang.OutOfMemoryError: Java heap space
Následující postup popisuje, jak zvýšit velikost instance webového kontejneru Apache Tomcat:
Pozn. Předchozí postup byl otestován na Apache Tomcat Version 6.0.14 na systému Windows Vista. Nastavení proměnných vystačí pro upload souboru velkého cca 100 MB. Více infromací k nastavení heap size na javahowto.blogspot.com Nastavení lokalizace modulu ProduktyModul Produkty 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
Na adresáři www.kiv.zcu.cz/produkty/ jsem vyplnil následující property:
Vytvořil jsem sibling celého adresáře www.kiv.zcu.cz/produkty/ (i se všemi resources uvnitř kromě podadresáře /data/ a jeho obsahu) na adresář www.kiv.zcu.cz/en/products/ Tento adresář má totiž nastavené property(dědí od nadřazeného adresáře):
Na tomto uri - www.kiv.zcu.cz/en/products/ je nyní tedy umístěna anglická lokalizace modulu Produkty. Později bude ještě třeba přejmenovat jednotlivá JSP na anglické názvy.
Patří do KategorieModulyWebuKiv |