Redir - odkazy do modulu + garantované odkazy
Jádro www aplikací » Redir - odkazy do modulu + garantované odkazy
Přímé odkazy do modulů se používají k přechodům mezi jednotlivými moduly (např. Kdo je Kdo -> Detail práce), nebo k externím odkazům z prostředí mimo IS STUDIUM (např. z homepage vyučujícího -> Seznam předmětů, které učí atp).
Aby funkčnost takových odkazů zůstala zachována i po interní změně parametrů v modulu, je u některých modulů podporován tzv. redir. Je to soubor, který garantuje správné přesměrování požadavku do modulu.
Příklad: učitel si na své stránce umístí odkaz Seznam mých předmětů -> http://is.skola.cz/predmety/kod.php&kod=xxxx. Po interní změně modulu by ale parametr ./kod.php&kod=xxxx už nemusel fungovat, takže by bylo nutné pozměnit všechny externí odkazy. Proto by daný odkaz měl směřovat na soubor "redir.php" s příslušnými parametry http://is.skola.cz/predmety/redir.php?redir=yyyy&kod=xxxx.
Zda daný modul podporuje takové odkazy, je možné zjistit v dokumentaci k danému modulu, v seznamu kapitol se bude nacházet kapitola Redir - odkazy do modulu. V této kapitole bude seznam možných přesměrování.
Příklad použití dokumentace a reálný tvar odkazu (příklad je k modulu "Předměty Online"):
- dokumentace => &redir=sezn_kat&kod=XXXX
- použití => http://is.skola.cz/predmety/redir.php?redir=sezn_kat&kod=MUJKOD
Vzhledem k tomu, že ne všechny moduly mají vlastní redir a vyvstala otázka jednak obecného odkazu na modul, jednak i garantovaného odkazu v případě přejmenování modulu, bylo stávající řešení rozšířeno takto:
- od verze stev 859 je možno pro libovolný modul použít odkaz v následujícím tvaru:
http://is.skola.cz/garantlink.php?gmodul=modul&glogin=true&gscript=redir.php&fak=11320&redir=rozvrh_ucit&kod=13027
kde hodnoty parametrů mohou nabývat těchto hodnot - gmodul - garantovaný název modulu - jedná se o krátký název, např. predm_st2, term_uc, predmety...
- glogin - zde jsou možné hodnoty
true - uživatel se musí před zobrazením modulu přihlásit a případně vybrat roli, se kterou bude pracovat
false modul umí pracovat v anonymním režimu a v tom bude i spuštěn - gsident - pro volbu sidentu, pokud jakým bude student přihlášen
- grole - při přihlášení je vynucen výběr role. Standardně by uživatel byl přihlášen rovnou do své výchozí role (a nemusel by mít tak danou akci dostupnou)
- gscript - pokud chcete odkaz pouze na modul, nikoliv na konkrétní stránku pomocí redir - viz výše, tento parametr neuvádějte
pokud chcete použít redir, musí příkaz pokračovat =redir.php& a následuje seznam parametrů a jejich hodnot dle definice příslušného rediru popsaného v dokumentaci k danému modulu.
Pokud bude hodnota tohoto parametru uvedena chybně, nebo redir nebude existovat, bude celý tento parametr ignorován.