aaieduhr/aosi-module-address-book

AOSI AddressBook Module

v5.0.0 2026-04-14 12:12 UTC

Requires

• php: >=8.2

Requires (Dev)

• aaieduhr/aosi: ^5
• phpstan/phpstan: ^2.1
• phpstan/phpstan-deprecation-rules: ^2.0
• phpunit/phpunit: ^10 || ^11
• rector/rector: ^2.0
• slevomat/coding-standard: ^8
• squizlabs/php_codesniffer: ^3

MIT

• Klara Minga

README

Opis

Modul Adresar komponenta je web aplikacije AOSI koja omogućuje jednostavno pretraživanje i pregled osnovnih kontaktnih podataka zaposlenika ustanove. Podržava prikaz u obliku tablice i kartica te omogućuje preuzimanje kontakata u vCard (.vcf) formatu.

Adresar je moguće ograničiti na određene realmove (institucije ili korisničke domene).
Ako konfiguracijska opcija enable_module_for_specific_realms_only nije definirana, modul je dostupan svim realmovima.
Ukoliko je opcija definirana, modul će biti dostupan samo korisnicima čiji realm odgovara jednom od navedenih u konfiguraciji.

Funkcionalnosti

Pretraživanje korisnika

Pretraživanje po sljedećim atributima:*

• Ime
• Prezime
• E-pošta
• Mobilni telefon
• Telefon
• Lokalni broj
• Broj sobe
• Povezanost s ustanovom
• Položaj u ustanovi
• Mjesto (lokalitet)

*(ovisno o odabranim atributima tijekom instalacije)

Mogućnost brisanja pretrage (X gumb)

Prikaz korisnika

• Tablica — standardni prikaz u redovima
• Kartice — vizualni prikaz korisnika

Prebacivanje između prikaza
Pamćenje prikaza (sessionStorage)

Preuzimanje kontakata (vCard)

• Generiranje u JavaScriptu
• Format datoteke: Prezime_Ime.vcf

Sadrži:

• FN (puno ime)
• N (prezime; ime)
• EMAIL
• TEL
• NOTE (lokalni broj, soba)
• REV (vrijeme generiranja)

Sortiranje i paginacija

• Sortiranje po svim atributima
• Paginacija

Tehnička arhitektura

Frontend

• HTML / Bootstrap
• JavaScript:
  • upravljanje prikazom
  • generiranje vCard datoteka
  • sessionStorage

Backend

• LDAP (dohvat korisnika)

Kontroleri:

• AddressController
• AbstractUserController

Instalacija

1. Instalirati aplikaciju iz paketa
2. U direktoriju config/ nalazi se primjer konfiguracijske datoteke module_address_book.php.dist
3. U glavnom projektu/repozitoriju potrebno je odabrati koje atribute korisnika želite prikazivati u modulu