1. Michal Májský Avatar Michal Májský
  2. Untitled project
  3. SRS

Wiki

Clone wiki

SRS / Instalační-příručka

View History

##Požadavky Aplikace pro svůj běh vyžaduje:

  • webový server Apache 2.2 a vyšší s moduly mod_rewrite a mod_php. Správný běh aplikace je otestován na Apache 2.2.16 a Apache 2.4.3.

  • PHP 5.3.3 a vyšší. Správný běh aplikace je otestován na PHP 5.3.9 a PHP 5.4.13.

  • MySQL 5.0[1] a vyšší. Správný běh aplikace je otestován na MySQL 5.0.51 a MySQL 5.6.10.

Aplikace je primárně optimalizována pro instalaci na server pro jednotky Junáka - Lebeda http://lebeda.skauting.cz.

[1] Aplikace má předpoklady být kompatibilní i s dalšími databázovými stroji, které podporuje knihovna Doctrine. Jejich kompatibilita však nebyla testována.

##Instalace aplikace Pokud disponujete pouze FTP přístupem k Vašemu serveru nebo instalujete aplikaci na servery Junáka, je doporučen následující postup:

  1. Stáhněte aplikaci a rozbalte archiv.
  2. Vytvořte na Vašem serveru MySQL databázi a uživatele, který má k databázi práva.
  3. Přejmenujte soubor app/config/config.example.neon na app/config/config.neon
  4. Nahrajte prostřednictvím FTP klienta soubory aplikace na Váš server.
    • Pokud máte na svém počítači nainstalované PHP, je doporučeno použít pro přenos souborů program FTP deployment (ke stáhnutí z https://github.com/dg/ftp-deployment). Konfigurační soubor deployment.ini je v kořenové složce aplikace připraven, je třeba pouze změnit přihlašovací údaje k FTP účtu.
  5. Nastavte práva pro zápis (777) pro následující složky temp, www/files, www/webtemp, log a pro soubor app/config/config.neon.
    chmod -R 777 temp
chmod -R 777 www/files
chmod -R 777 www/webtemp/
chmod -R 777 log
chmod 777 app/config/config.neon
    1. Spusťte instalačního průvodce nacházejícího se na http://vasedomema.cz/install a pokračujte dle pokynů. - S pomocí instalačního průvodce postupně nastavíte připojení k databázi a naimportujete schéma databáze spolu s inicializačními daty, nastavíte propojení se systémem skautIS a vytvoříte administrátorský účet. - Během instalace budete požádáni o skautIS Application ID. Pokud jím ještě nedisponujete, zažádat o přidělení můžete na https://is.skaut.cz/podpora/ (seznam volaných funkcí ve skautIS)
    2. Po dokončení instalačního průvodce a přihlášení do administrace věnujte zvýšenou pozornost modulu Konfigurace, zejména sekci Seminář, kde je možné nastavit základní informace o semináři (název, datum konání, ...).

Alternativou k Výše popsaném postupu je pro přenos aplikace využít verzovací nástroj GIT a příkaz clone. V takovém případě je třeba doinstalovat knihovny prostřednictvím nástroje Composer (http://getcomposer.org/). Konfigurační soubor composer.json se nachází v kořenové složce aplikace.

Nasazení grafiky

Je předpokládáno, že pro každý seminář bude nasazena unikátní grafika pro webovou prezentaci. Webová prezentace po instalaci disponuje pouze jednoduchou černobílou grafikou pro účely prezentace systému. Následuje stručný návod, jak nasadit vlastní grafiku na webovou prezentaci.

CSS styly webové prezentace jsou rozděleny do dvou souborů - layout.css a design.css (nacházejí se ve složce www/css/front).

###layout.css V souboru layout.css je definováno rozmístění funkčních prvků na stránce. Layout.css využívá kaskádové styly knihovny [1] twitter bootstrap (využívané části této knihovny jsou grid a pro výběr programů také alerts a modal).

Obsah tohoto souboru by měl zůstat zachován.

[1] http://twitter.github.com/bootstrap/

###design.css Soubor design.css je určený pro vlastní kaskádové styly a jeho původní obsah může být kompletně odstraněn. Po smazání obsahu tohoto souboru zůstane funkční rozmístění prvků na stránce zachováno.

Pro umístění obrázků souvisejících s grafikou webové prezentace je určena složka www/img.

###Pokročilé úpravy V případě potřeby lze upravit HTML webové prezentace. SRS využívá šablonovací systém Latte[1].

Šablony související s webovou prezentací se nacházejí ve složce app/FrontModule/templates.

V šablonách je dostupná funkcionalita knihoven jQuery[2] a jQuery UI[3].

[1] http://doc.nette.org/cs/templating

[2] http://jquery.com

[3] http://jqueryui.com

Updated