====== Instalace ======

===== Požadavky =====
Systém pro svůj běh vyžaduje:
  * PHP 8.1
  * MySQL 8.0 nebo vyšší

Systém je primárně optimalizován pro instalaci na server pro jednotky Junáka ([[https://lebeda.skauting.cz/|Lebeda]]).


----


===== Instalace systému =====

<WRAP center round important 100%>
Od ledna 2024 poskytujeme Skautský rezervační systém skautským akcím jako **službu**, kterou kompletně nainstalujeme, udržujeme aktuální a poskytujeme podporu na základě **e-mailové žádosti** na [[mailto:srs@skaut.cz|srs@skaut.cz]].\\   
V e-mailu prosím uveďte **název akce a pořádající jednotku, termín akce a odhadovaný počet účastníků** pro rychlé odbavení žádosti a přípravy serveru. Přidejte **informaci o adrese budoucí instalace** - nabízíme variantu v podobě subdomény //cokoliv//.skauting.cz či na //vlastní doméně// pomocí směrování DNS záznamů.
</WRAP>

**Instalační návod (neaktuální):**

  - stáhněte si archív <wrap download>srs.zip</wrap> z [[https://github.com/skaut/SRS/releases|GitHub]] a rozbalte jej
  - v souboru <color #ed1c24>app/config/config.local.neon</color> nastavte připojení k ''databázi'' a ''skautISu''
    * budete potřebovat ''skautIS Application ID''. Pokud jím ještě nedisponujete, tak zažádejte o přidělení na [[https://ws.skautis.cz/zadost|on-line podpoře]] 
      *  URL po přihlášení: ''<URL aplikace>/login''
      *  URL po odhlášení: ''<URL aplikace>/logout''
      * systém potřebuje [[srs:instalace:funkce|tato oprávnění]]
    * pro testování s testovacím skautIS změňte ''test:false'' na ''test:true''
    * v sekci ''mail'' je možné nakonfigurovat vlastní SMTP server pro rozesílání e-mailů. Podrobné informace k nastavení jsou v [[https://doc.nette.org/cs/3.0/configuring#toc-maily|dokumentaci Nette]].
    * pokud budete v konfiguračním souboru provádět změny po nahrání na server bude pravděpodobně nutné poté vymazat obsah adresáře <color #ed1c24>temp/cache</color>
    * pro server [[https://lebeda.skauting.cz/|Lebeda]] by měla správná konfigurace vypadat přibližně takto: <code bash app/config/local.neon>
parameters:

nettrine.dbal:
    connection:
        host: localhost
        driver: mysqli
        dbname: "<nazev-databaze>"
        user: "<uzivatel-databaze>"
        password: "<heslo-k-databazi>"

skautis:
    applicationId: "<skautIS-appId>"
    testMode: false

mail:
    smtp: false
    host: ""
    port: 0
    username: ""
    password: ""
    secure: ""
    
mailing:
    mails: [
    	senderEmail: "<e-mail-odesilatele-e-mailu>"
    ]   
    
recaptcha:
    siteKey: "<recaptcha-site-key>"
    secretKey: "<recaptcha-secret-key>"    
</code>
  - nahrajte obsah na server pomocí FTP klienta
    * na serveru Lebeda nahrajte obsah přímo do kořenového adresáře účtu
    * pokud na Vašem hostingu není adresář ''www'', tak bude nutné v kořenovém adresáři vytvořit soubor ''.htaccess'' s tímto obsahem: <code bash .htaccess>
    RewriteEngine On
    RewriteCond %{REQUEST_URI} |^/www/
    RewwriteRule ^(.")$ /www/$1 [QSA]
</code>
  - nastavte práva pro zápis (777) pro následující adresáře: <color #ed1c24>backup</color>, <color #ed1c24>temp</color>, <color #ed1c24>log</color>, <color #ed1c24>www/files</color> a <color #ed1c24>www/webtemp</color>  <code bash>
    chmod -R 777 backup
    chmod -R 777 temp
    chmod -R 777 log
    chmod -R 777 www/files
    chmod -R 777 www/webtemp
</code>
  - pro automatické párování plateb, odhlašování nezaplacených účastníků a rozesílání upomínek je třeba nastavit cron - kontaktujte prosím podporu SRS
  - otevřete stránku ve webovém prohlížeči, spustí se instalační průvodce. Podle pokynů průvodce vytvoříte tabulky v databázi a nastavíte administrátora systému
<WRAP round info>Po dokončení instalačního průvodce a přihlášení do administrace věnujte zvýšenou pozornost sekci [[srs:admin|Nastavení]]</WRAP>

----

===== Úprava grafiky =====
Předpokládá se, že pro každý seminář bude nasazena unikátní grafika webové prezentace. Webová prezentace po instalaci disponuje pouze jednoduchou 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ů - <color #ed1c24>layout.css</color> a <color #ed1c24>style.css</color> (nacházejí se ve složce <color #ed1c24>www/css/web</color>).

==== layout.css ====
V souboru <color #ed1c24>layout.css</color> je definováno rozmístění funkčních prvků na stránce. <color #ed1c24>Layout.css</color> využívá kaskádové styly knihovny [[https://getbootstrap.com/|Bootstrap]] v4.

<WRAP round important>\\ Obsah tohoto souboru neupravujte, případné změny se neprojeví.</WRAP>

==== style.css ====
Soubor <color #ed1c24>style.css</color> je **určený pro vlastní kaskádové styly**.

Pro umístění obrázků souvisejících s grafikou webové prezentace je určen adresář <color #ed1c24>www/img</color>.

----

===== Pokročilé úpravy =====
V případě potřeby lze upravit HTML webové prezentace. SRS využívá šablonovací systém [[https://latte.nette.org/|Latte]].

Šablony související s webovou prezentací se nacházejí v adresářích <color #ed1c24>app/WebModule/presenters/templates</color> a <color #ed1c24>app/WebModule/components/templates</color>. V šablonách je dostupná funkcionalita knihoven [[https://jquery.com/|jQuery]] a [[https://jqueryui.com/|jQuery UI]].