Realizarea legăturii între VuFind și Koha este pasul care transformă un simplu portal de căutare într-un instrument interactiv. Această conexiune se face prin intermediul unui ILS Driver (Integrated Library System Driver), care permite VuFind să interogheze baza de date Koha în timp real.

Iată ghidul tehnic pentru a configura această „punte”:

1. Pregătirea în Koha (Partea de Server)

Înainte ca VuFind să poată „vorbi” cu Koha, trebuie să te asiguri că API-ul Koha este accesibil.

• Activează REST API: Verifică în Koha Administration > Global System Preferences ca API-ul să fie activat.

• Creează un utilizator API: Recomandăm crearea unui utilizator special în Koha (cu permisiuni de super-bibliotecar sau acces la catalog) pentru ca VuFind să se poată autentifica.

• Permite accesul IP: Dacă VuFind și Koha sunt pe servere diferite, asigură-te că firewall-ul permite conexiunile pe portul 80/443 sau 8080.

2. Configurarea Driver-ului în VuFind

VuFind vine cu un driver nativ pentru Koha. Trebuie doar să îl activezi și să îl configurezi.

Pasul A: Activarea driver-ului

Accesează folderul de configurare al VuFind (de obicei /usr/local/vufind/config/vufind) și editează fișierul config.ini:

[Catalog]
driver = KohaRest

Notă: În versiunile 2026, KohaRest este driver-ul recomandat (folosește noul REST API), înlocuind vechiul driver bazat pe baze de date directe sau ILS-DI.

Pasul B: Configurarea detaliilor de conexiune

Editează fișierul KohaRest.ini (sau creează-l în folderul local/config/vufind dacă nu există):

[Catalog]
host = "https://catalog.scoala-ta.ro"
port = 443

[API]
user = "utilizator_vufind"
password = "parola_secreta"
locationID = "Nume_Biblioteca"

3. Maparea locațiilor și a tipurilor de itemi

Pentru ca VuFind să afișeze corect textul „Disponibil la raft” sau „Împrumutat până la…”, trebuie să mapăm codurile interne din Koha cu cele din VuFind.

În KohaRest.ini, secțiunea [Items] permite definirea modului în care statusurile sunt citite:

• Disponibilitate: VuFind verifică dacă notforloan este 0 și itemlost este 0 în Koha.

• Locații: Poți mapa codurile de bibliotecă (ex: CENTRAL) către nume prietenoase.

4. Testarea conexiunii (Live Check)

După ce ai salvat fișierele, restartează serviciul Apache:

sudo systemctl restart apache2

Cum verifici?

1. Caută o carte în interfața VuFind.

2. Dacă vezi un mesaj de tipul „Checking availability…” urmat de un cerculeț care se învârte, înseamnă că VuFind încearcă să comunice cu Koha.

3. Dacă apare statusul (ex: Disponibil), „puntea” funcționează!

5. Erori comune și soluții (Troubleshooting)

• Eroare: „Driver error”: Verifică dacă extensia php-curl este instalată pe serverul VuFind.

• Timp de răspuns mare: Dacă ai o bază de date imensă, activează Caching-ul în VuFind pentru a nu interoga Koha la fiecare secundă pentru aceeași carte.

• Probleme SSL: Dacă Koha folosește un certificat self-signed, va trebui să configurezi VuFind să ignore verificarea SSL (nerecomandat în producție).