Prije instalacije potrebno je preuzeti zip arhivu Joomla_25_SSO_setup_i_upute.zip. Arhiva sadrži detaljne upute kako instalirati uslugu.
Prije instalacije
Kroz Joomla administracijko sučelje dodajte korisnika i za username mu postavite kompletan AAI@EduHr identitet korisnika koji će biti superadmin Joomle, te mu dodajte superadministrator privilegije. Napomena: polje za lozinku (password) nije bitno, morate upisati neki password radi konvencije, no neće se provjeravati u pluginu.
Pažnja!!! Ukoliko prije instalacije plugina ne dodate AAI superadministratora možete si stvoriti probleme s pristupom.
Postupak instalacije
U gore spomenutoj arhivi se nalazi autentikacijski plugin plg_aailogin.zip te dvije template datoteke u direktoriju dodatno koje sadrže login template za vaš site i to:
- za frontend dio u poddirektoriju site;
- za backend dio u poddirektoriju admin;
1) Instalirajte plg_aailogin.zip iz Joomle:
- prijavite se u administratorsko sučelje [url joomla sitea]/administrator/
- selektirajte Extensions -> Extension manager;
- uploadajte plugin u dijelu Upload package file;
2) Nakon toga trebate aktivirati Plugin:
- selektirajte Extensions -> Plugin manager;
- aktivirajte plugin AAI@EduHr authentication klikom na crvenu točku kraj njega;
3) Zatim trebate promjeniti ranije spomenute template za Login:
- datoteku iz direktorija /dodatno/site/aai.php potrebno je kopirati u slijedeći direktorij na serveru: [path do joomle]/modules/mod_login/tmpl/
- datoteku dodatno/admin/aai.php potrebno je kopirati u slijedeći direktorij na serveru: [path do joomle]/administrator/modules/mod_login/tmpl/
4) Nakon što ste kopirali datoteke potrebno je "reći" Joomli da koristi njih umjesto defaultnog logina:
- za site dio (frontend) potrebno je modificirati datoteku [path do joomle]/modules/mod_login/mod_login.php na način da promijenite liniju:
require JModuleHelper::getLayoutPath('mod_login', $params->get('layout', 'default'));
u
require JModuleHelper::getLayoutPath('mod_login', $params->get('layout', 'aai'));
Vraćanjem te linije u default vraća se i defaultni login. Na taj način mozete birati izmedju Joomla i AAI@EduHr logina.
- Za admin dio (backend) isto je potrebno napraviti u datoteci [path do joomle]/administrator/modules/mod_login/mod_login.php. Promijenite liniju:
require JModuleHelper::getLayoutPath('mod_login', $params->get('layout', 'default'));
u
require JModuleHelper::getLayoutPath('mod_login', $params->get('layout', 'aai'));
Vraćanjem te linije u default vraća se i defaultni backend login. Na taj način možete birati izmedju Joomla i AAI login. Na taj način se možete i "spasiti" ukoliko niste napravili korak 0) !!
Važno - nakon instalacije
Svakog korisnika potrebno je dodati kroz Joomla sučelje Users -> User manager -> Add new user te mu dodijeliti razinu prava koja mu pripadaju. Nakon toga će se moći spojiti koristeći svoj AAI@EduHr identitet u roli koja mu je dodijeljena. Još jednom napominjemo da password koji upišete korisniku nije relevantan za funkcioniranje plugina. Ukoliko ne planirate onemogućiti standardni Joomla auth plugin Authentication - Joomla potrebno je unijeti neki kompliciraniji password da netko zlonamjeran ne bi provalio kroz standardni auth mehanizam.
Važno - nakon nadogradnje
Nakon update-a Joomle vrlo je vjerojatno da će se vratiti "standardni" login ekran. Zbog toga trebate ponoviti korak 4) iz postupka instalacije, odnosno promjeniti unutar mod_login.php datoteke vrijednost iz default u aai.