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.