Skip to content

Liliputech/koha-plugin-recommendations

Repository files navigation

Koha Plugin Recommendations 📚

How it works

What This Plugin Does (No AI Required!)

This Koha Plugin is a crowd-sourced recommendation engine that helps patrons discover related items based on what other patrons have borrowed together.

Important Disclaimer: This plugin uses zero artificial intelligence - just good old-fashioned library science and SQL queries!

How it works?

The plugin analyzes circulation patterns to find items that are frequently borrowed together:

  • Only issues less than one year old are considered (configurable)
  • Similar references are linked by patron borrowing patterns
  • Results are displayed in both staff interface and OPAC (optional)

Want to learn more about Recommender Systems?

Here is a list of links about the theory beyond the code:

Here are some links more specifically about Recommender System in Libraries:

Why This Isn't an AI Plugin 🤖❌

We promise this plugin contains:

  • 0% Artificial Intelligence
  • 0% Machine Learning
  • 0% Neural Networks
  • 100% Traditional Database Queries
  • 100% Library Science

Your patrons' reading habits stay private, your budget stays intact, and your server doesn't need a GPU!

To install the plugin

First you have to modify koha-conf.xml and set enableplugins to 1 (it is set to 0 by default). Then check in Koha Administration panel, search for the UseKohaPlugins variable, and set this to Enable. Finally go to the Reports panel and click on "Report Plugins". On the top left corner you'll see an "Upload a plugin" link, which will enable you to install the KPZ file.

Configuration - Integration to OPAC

Configuration needs to be run at least once for the plugin to work. On first configuration you will have to choose how many recommendations to compute and how many years of historical data to analyse. You can also choose whether or not you want the results to be available on OPAC (checked = yes). After clicking on the "Save" button, the plugin should be working correctly and results will be displayed in the intranet interface + Opac interface if enabled.

Opac Details Recommendation

To Do

  • Fasten/Optimize query
  • Develop some configuration options
  • Enable handling of "Content-Based Filtering" techniques
  • Improve UI.
  • Any other idea is welcome

Greetings

  • Kyle Hall who developped Koha Plugin functionnality and provided the community with running examples.
  • Lyon 3 Koha Team for their "knowledge sharing" values and for giving me the necessary pre-requisite for having fun while coding in Perl and JS.

FR - Koha Plugin Recommendations 📚

Ce plugin est une tentative d'implémentation d'un système de recommendation. Actuellement c'est un système assez basique de "Filtre Collaboratif". Les références bibliographiques sont liées les unes aux autres par les emprunts des usagers. Attention, seuls les emprunts datant de moins d'un an sont pris en comptes. Le code peut facilement être étendu pour prendre également en charge des filtres basés sur le contenu.

Comment ça marche?

J'ai fait cette petite bande-dessinée pour tenter d'expliquer le fonctionnement (pas encore traduite). How it works

En savoir plus sur les systèmes de recommendation

Quelques liens à propos de la théorie de fonctionnement des systèmes de recommendation:

Quelques liens plus spécifiques à propos de leurs usages en bibliothèques:

Pourquoi ce n'est pas un plugin d'IA 🤖❌

Nous promettons que ce plugin contient :

  • 0% d'Intelligence Artificielle
  • 0% d'Apprentissage Machine
  • 0% de Réseaux de Neurones
  • 100% de Requêtes SQL Traditionnelles
  • 100% de Sciences Bibliothéconomiques

Les habitudes de lecture de vos usagers restent privées, votre budget reste intact, et votre serveur n'a pas besoin de GPU !

Pour installer le plugin

En premier lieu vous devrez modifier le fichier "koha-conf.xml" et positionner la variable "enableplugins" à 1 (elle est à 0 par défaut). Ensuite rendez vous dans le module d'Administration de Koha, cherchez la variable "UseKohaPlugin" et positionnez là à "Enable". Pour finir, aller dans la partie "Rapports" et cliquez sur le lien "Plugins de rapports". Dans le coin supérieur gauche vous devriez alors voir un lien "Téléverser un plugin" ou "Upload a plugin", qui vous permettra d'installer le fichier ".KPZ".

Configuration - Integration à l'OPAC

Pour que le plugin fonctionne correctement il doit être configuré au moins une fois. À la première configuration vous devrez renseigner le nombre de résultats à générer ainsi que le nombre d'années d'historique de prêt à prendre en compte. Vous pouvez également choisir si vous souhaitez que les résultats soient affichés sur l'OPAC (case coché = oui). Après avoir cliqué sur le bouton "Save" le plugin devrait fonctionner normalement et les résultats s'afficher sur l'interface Pro, et également sur l'OPAC si l'option a été coché.

Si tout s'est passé correctement vous devriez obtenir un nouvel onglet à la suite de l'onglet "Commentaires" sur la page opac-detail: Opac Details Recommendation

À faire

  • Optimiser la requète SQL
  • Ajouter des options de configurations
  • Permettre la prise en charge de filtres de contenus
  • Améliorer l'interface utilisateur.
  • Toutes les idées sont les bienvenues!

Remerciements

  • Kyle Hall pour le développement des Plugins et les exemples fournis à la communauté.
  • l'équipe Koha de l'Université Lyon 3 pour sa valorisation du partage des connaissances et pour m'avoir donné les prérequis nécessaires en Perl, JS et SQL.

About

Crowd-sourced recommendations based on old issues in your library :)

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors