Description du script

Ce script JavaScript a pour objectif d'améliorer la lisibilité de la page issuehistory.pl dans Koha, en mettant en évidence les prêts présentant des anomalies. Il permet d’identifier visuellement les retours en retard ou incohérents (par exemple, un retour avant la date d’emprunt).

Explication détaillée de l’algorithme

1. Le script s'exécute uniquement si l'URL de la page contient issuehistory.pl.
2. Il sélectionne le tableau contenant l’historique des prêts, identifié par l’ID table_issues.
3. Pour chaque ligne du tableau :
   • Il récupère les dates d’emprunt, d’échéance et de retour à partir des attributs data-order.
   • Il supprime tout message antérieur dans la cellule de retour pour éviter les doublons.
   • Il applique un fond rouge clair si le document a été rendu en retard, en affichant le nombre de jours de retard.
   • Il applique un fond orange si la date de retour est antérieure à la date d’emprunt.
   • Il affiche un message d’erreur dans la cellule si une anomalie est détectée.
   • Sinon, il colore le texte de la cellule en vert.
4. Un MutationObserver est mis en place pour relancer l’analyse en cas de changement dans le tableau (ex. : chargement AJAX).
5. Des écouteurs sont également ajoutés aux boutons de pagination pour que l’analyse se relance après un changement de page.

Inclusion du code

//mise en page de la page Historique de prêts
if (window.location.pathname.includes("issuehistory.pl")) {
    let observer;

    function highlightIssues() {
        const table = document.getElementById("table_issues");
        if (!table) return;

        const rows = table.querySelectorAll("tbody tr");
        rows.forEach((row) => {
            const cells = row.querySelectorAll("td");
            if (cells.length < 8) return;

            // Supprime les anciens messages pour éviter les doublons
            const existingSpans = cells[7].querySelectorAll("span");
            existingSpans.forEach(span => span.remove());

            // Réinitialise le style de la cellule
            cells[7].style.backgroundColor = "";
            cells[7].style.color = "";

            const borrowedDate = new Date(cells[5].getAttribute("data-order"));
            const dueDate = new Date(cells[6].getAttribute("data-order"));
            const returnDate = new Date(cells[7].getAttribute("data-order"));

            let hasIssue = false;
            let issueMessage = "";

            // Vérifie les retards
            if (returnDate > dueDate) {
                const delayDays = Math.ceil((returnDate - dueDate) / (1000 * 60 * 60 * 24));
                cells[7].style.backgroundColor = "rgba(255, 0, 0, 0.3)";
                issueMessage = `Retour en retard (${delayDays} jours)`;
                hasIssue = true;
            }

            // Vérifie les incohérences (retour avant emprunt)
            if (returnDate < borrowedDate) {
                cells[7].style.backgroundColor = "rgba(255, 165, 0, 0.5)";
                issueMessage = "Retour avant emprunt";
                hasIssue = true;
            }

            // Ajoute un message dans la cellule en cas de problème
            if (hasIssue) {
                const issueSpan = document.createElement("span");
                issueSpan.style.display = "block";
                issueSpan.style.color = "red";
                issueSpan.textContent = issueMessage;
                cells[7].appendChild(issueSpan);
            } else {
                // Si aucun problème, réinitialise la cellule
                cells[7].style.color = "green";
            }
        });
    }

    function observeTableChanges() {
        const tableBody = document.querySelector("#table_issues tbody");
        if (!tableBody) return;

        observer = new MutationObserver(() => {
            console.log("Changement détecté dans le tableau, relance du script.");
            highlightIssues();
        });

        observer.observe(tableBody, {
            childList: true,
        });
    }

    function addPaginationListener() {
        const paginationButtons = document.querySelectorAll('.paginate_button');
        paginationButtons.forEach(button => {
            button.addEventListener('click', () => {
                console.log("Bouton de pagination cliqué : " + button.id);
                setTimeout(() => {
                    console.log("Relance du script après le changement de page.");
                    highlightIssues();
                }, 1000);
            });
        });
    }

    highlightIssues();
    observeTableChanges();
    addPaginationListener();
}

Éléments à modifier

• Les indices des colonnes peuvent être ajustés si la structure du tableau change (actuellement emprunt = colonne 5, échéance = 6, retour = 7).
• Les couleurs utilisées (rgba) peuvent être modifiées selon les préférences visuelles.
• Les messages affichés peuvent être personnalisés.

Points clés pour les mises à jour de Koha

• Ce script repose sur la structure HTML actuelle de la page issuehistory.pl : toute modification de l'ID table_issues ou de la disposition des colonnes pourrait nécessiter des ajustements.
• Si Koha modifie son système de pagination ou passe à un nouveau système AJAX, il faudra adapter l’observation des mutations et les écouteurs d’événements.

Dépendances

• Ce script ne dépend d’aucune bibliothèque externe.
• Il suppose que les données de date sont disponibles dans les attributs data-order des cellules concernées.