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.