Aller au contenu
Tamil

OPAC personnalisé

L'OPAC Koha est la vitrine de votre bibliothèque, vitrine que vous pouvez entièrement personnaliser et aligner sur la charte graphique de votre établissement. Au-delà de l'aspect visuel, c'est le fonctionnement même de votre OPAC que vous pouvez adapter à vos besoins et à vos pratiques métiers.

Les pages de l'OPAC

L'OPAC Koha affiche plusieurs catégories de pages :

  • Page d'accueil — C'est la page de démarrage de votre OPAC. On y place généralement les informations permettant aux usagers d'avoir une vue globale des informations et des services proposés par votre bibliothèque.

  • Résultat d'une recherche — Après avoir lancé une recherche dans le Catalogue, le résultat est présenté dans une page regroupant les notices trouvées. Une vue synthétique des notices est proposée. Les notices sont groupées et une barre de navigation dans le résultat permet de passer d'un groupe de notices au suivant. Pour chaque notice, un lien permet d'accéder à la vue détaillée de la notice.

  • Notice détaillée — La vue détaillée d'une notice bibliographique. Les informations des notices qui sont affichées sont sélectionnées au moyen d'une feuille de style XSL.

  • Nouvelles — Les nouvelles sont affichées sur la page d'accueil. Chaque nouvelle dispose d'une page individuelle à laquelle on peut accéder depuis la page d'accueil. Les nouvelles ont une date de publication et une date d'expiration qui déterminent si elles sont affichées à l'OPAC. Elles sont aussi diffusées par un flux RSS : /cgi-bin/koha/opac-news-rss.pl.

  • Pages fixes — Les pages fixes sont similaires aux nouvelles, mais elles ne sont pas affichées sur la page d'accueil. On y accède au moyen d'URL qui ont la forme suivante :

    /cgi-bin/koha/opac-page.pl?page_id=<PAGE_ID>

  • Page restreinte — Une page dont le contenu HTML est saisi dans la préférence RestrictedPageContent et le titre dans RestrictedPageTitle. Elle n'est accessible sans connexion que depuis les adresses IP de la préférence RestrictedPageLocalIPs, par exemple les postes de la bibliothèque. Son adresse : /cgi-bin/koha/opac-restrictedpage.pl.

Code HTML

Ce que vous ajoutez à l'OPAC c'est du code HTML que vous saisissez en PRO. Ce code est saisi de façon similaire pour les quatre catégories d'information suivantes :

  • Bloc HTML — Une portion d'information affichée à différents emplacements de l'OPAC. Outils > Personnalisations HTML.
  • Nouvelle — Une information longue, affichée en partie dès la page d'accueil. Outils > Annonces.
  • Page — Une page d'information. Il faut créer des liens vers ce type de page. Outils > Pages.
  • Affichage des notices — Un contenu ajouté à l'affichage des notices. Outils > Personnalisations de l'affichage de la notice. Voir ci-dessous.

Propriétés — Les blocs HTML, les nouvelles et les pages ont les propriétés suivantes :

  • Spécifique à une bibliothèque — Un bloc peut être global ou propre à une bibliothèque spécifique.

  • Emplacement — Pour les nouvelles : PRO, OPAC, les deux, ou le ticket de transaction remis au lecteur. Pour les pages : PRO, OPAC ou les deux. Pour les blocs HTML : le bloc de l'OPAC où le contenu est affiché.

  • Dates — Un contenu a une date de publication et une date d'expiration.

  • Positionnement — Un numéro qui ordonne les contenus affichés au même endroit, par exemple les nouvelles de la page d'accueil.

  • Titre — Titre de la nouvelle ou de la page.

  • Contenu — Le code HTML proprement dit. Ce code peut être saisi en mode WYSIWYG ou en mode texte.

  • Multilingues — On définit pour chaque bloc un contenu par défaut. On peut traduire ce contenu pour chaque langue disponible dans son installation de Koha.

Blocs HTML

Les blocs HTML sont injectés automatiquement aux pages générées par Koha. Cela permet d'enrichir l'OPAC standard. On crée un bloc HTML dans Outils > Personnalisations HTML. On choisit un des blocs suivants :

  • ArticleRequestsDisclaimerText — Avertissement affiché dans le formulaire de demande d'article.
  • CatalogConcernHelp — Aide affichée dans le formulaire de signalement d'un problème sur une notice.
  • CatalogConcernTemplate — Texte qui préremplit ce formulaire.
  • CookieConsentBar — Le bandeau de consentement aux cookies.
  • CookieConsentPopup — La fenêtre qui détaille les cookies utilisés.
  • ILLModuleCopyrightClearance — Mention de droit d'auteur que le lecteur doit accepter avant une demande de PEB.
  • opaccredits — Le bloc qui est affiché en bas de toutes les pages de l'OPAC. On y place les mentions légales, la politique de confidentialité, etc.
  • OpacCustomSearch — Une barre de recherche personnalisée qui remplace la barre de recherche standard.
  • opacheader — Le bloc qui se trouve au-dessus de la barre de recherche rapide.
  • OpacLibraryInfo — Informations affichées sur la page de chaque site.
  • OpacLoginInstructions — Instructions affichées sous le formulaire de connexion.
  • OpacMainUserBlock — Le bloc central de la page d'accueil.
  • OpacMaintenanceNotice — Le message de la page affichée quand l'OPAC est en maintenance.
  • OpacMoreSearches — Liens affichés sous la barre de recherche.
  • OpacMySummaryNote — Note affichée en haut du compte du lecteur.
  • OpacNav — Le bloc à gauche de la page d'accueil et des pages de gestion (fiche lecteur par exemple).
  • OpacNavBottom — Bloc placé en dessous du bloc précédent, avec entre les deux des onglets de gestion s'il y en a.
  • OPACNavbarExtraContent — Contenu ajouté à la barre de navigation, en haut des pages.
  • OpacNavRight — Bloc à droite de la page d'accueil.
  • OPACResultsSidebar — Bloc placé sous les facettes, dans le résultat d'une recherche.
  • OpacSuggestionInstructions — Instructions affichées en haut du formulaire de suggestion d'achat.
  • OpacSuppressionMessage — Message affiché quand on tente d'afficher une notice masquée à l'OPAC.
  • PatronSelfRegistrationAdditionalInstructions — Instructions affichées après une inscription en ligne.
  • SCOMainUserBlock — Bloc de la page du prêt en libre-service.
  • SelfCheckHelpMessage — Aide du prêt en libre-service.
  • SelfCheckInMainUserBlock — Bloc de la page du retour en libre-service.

Emplacement des blocs dans les pages

Les schémas suivants montrent où s'affichent les principaux blocs. En orange, les blocs HTML (Outils > Personnalisations HTML) et les annonces ; en bleu, les personnalisations de l'affichage de la notice (voir plus bas) ; en gris, le contenu produit par Koha.

Cadre commun — L'en-tête et le pied de page sont les mêmes sur toutes les pages de l'OPAC. OpacCustomSearch remplace la barre de recherche standard.

Barre de navigation : OPACNavbarExtraContentopacheaderBarre de recherche, ou OpacCustomSearchLiens sous la recherche + OpacMoreSearchesContenu propre à chaque pageopaccreditsCookieConsentBar / CookieConsentPopup

Page d'accueil

OpacNavOpacNavBottomAnnoncesCitation du jourOpacMainUserBlockConnexionOpacLoginInstructionsOpacNavRight

Résultat d'une recherche — Le contenu OPACResultsPage est ajouté à chaque notice du résultat.

FacettesOPACResultsSidebarNotice 1 (XSL)OPACResultsPageNotice 2 (XSL)OPACResultsPage

Notice détaillée

Notice (XSL)OPACDetailPageOnglets : exemplaires, commentaires...Couverture, actions

Compte du lecteur — Les blocs OpacNav et OpacNavBottom encadrent le menu du compte, sur toutes les pages du compte.

OpacNavMenu du compteOpacNavBottomOpacMySummaryNotePrêts, réservations, frais...

La page de recherche avancée n'a pas de bloc qui lui soit propre : seuls ceux du cadre commun y sont affichés.

Exemples de blocs HTML

Les blocs se saisissent en mode texte (HTML) ou en mode WYSIWYG. Koha place chaque bloc dans un <div> dont l'id est le nom du bloc (<div id="opaccredits">...) : on peut s'en servir dans OPACUserCSS pour le mettre en forme.

opaccredits — Le pied de page, avec des liens vers des pages fixes (Outils > Pages) :

<p>
  <a href="/cgi-bin/koha/opac-page.pl?page_id=1">Mentions légales</a> ·
  <a href="/cgi-bin/koha/opac-page.pl?page_id=2">Politique de confidentialité</a> ·
  <a href="/cgi-bin/koha/opac-library.pl">Nous contacter</a>
</p>

OpacNavRight — Les horaires d'ouverture, à droite de la page d'accueil :

<h4>Horaires</h4>
<ul>
  <li>Mardi à vendredi : 10 h – 18 h</li>
  <li>Samedi : 10 h – 17 h</li>
  <li>Fermé le dimanche et le lundi</li>
</ul>

OpacMoreSearches — Un lien ajouté à ceux qui suivent la barre de recherche (Recherche avancée, etc.), ici vers le catalogue collectif Sudoc. Le contenu doit être un élément de liste, comme les liens standard :

<li class="nav-item">
  <a href="https://www.sudoc.abes.fr/" target="_blank">Rechercher dans le Sudoc</a>
</li>

OpacMySummaryNote — Un message en haut du compte du lecteur :

<p class="alert alert-info">
  Vous pouvez prolonger vos prêts depuis l'onglet Prêts, sauf si le document
  est réservé par un autre lecteur.
</p>

Les classes alert et alert-info viennent de Bootstrap, utilisé par l'OPAC : le message prend l'aspect des autres messages de Koha.

Affichage des notices

Depuis Koha 25.11, on peut ajouter un contenu à l'affichage des notices sans modifier les feuilles de style XSL (voir plus bas). Dans Outils > Personnalisations de l'affichage de la notice, on choisit la page où le contenu est ajouté : à l'OPAC, OPACResultsPage (résultat d'une recherche), OPACDetailPage (notice détaillée) ou OPACListPage (listes) ; en PRO, les pages équivalentes. Le contenu est placé à la suite de ce que produit la feuille XSL.

Ce contenu est un modèle Template Toolkit, qui reçoit la notice MARC dans la variable record. Par exemple, pour afficher le résumé (330$a) d'une notice UNIMARC :

[% IF record.subfield('330','a') %]
<p class="resume">
  <strong>Résumé :</strong> [% record.subfield('330','a') | html %]
</p>
[% END %]

Le filtre html protège les caractères spéciaux de la notice (<, &...). Pour la sécurité, le HTML produit est ensuite filtré : seules les balises de mise en forme courantes sont conservées (paragraphes, titres, listes, liens, images, tableaux...). Les scripts sont supprimés. L'éditeur WYSIWYG n'est pas disponible pour ce type de contenu.

Exemple plus élaboré — Sur la notice détaillée (OPACDetailPage), on ajoute une rubrique Voir aussi qui regroupe :

  • les ressources en ligne de la notice (856), avec leur libellé ($z), ou à défaut Accès en ligne ;
  • un lien vers la notice dans le Sudoc, construit à partir du PPN que le Sudoc place en 009.
[% SET ppn = record.field('009') ? record.field('009').data : '' %]
[% SET liens = record.field('856') %]
[% IF ppn || liens %]
<div class="voir-aussi">
  <strong>Voir aussi :</strong>
  <ul>
    [% FOREACH f IN liens %]
      [% NEXT UNLESS f.subfield('u') %]
      <li><a href="[% f.subfield('u') | html %]" target="_blank">
        [% f.subfield('z') || 'Accès en ligne' | html %]
      </a></li>
    [% END %]
    [% IF ppn %]
      <li><a href="https://www.sudoc.fr/[% ppn | uri %]" target="_blank">Notice dans le Sudoc</a></li>
    [% END %]
  </ul>
</div>
[% END %]

Quelques explications :

  • record.field('009') renvoie le champ 009, ou rien si la notice n'en a pas. .data donne la valeur d'un champ de contrôle (00X).
  • record.field('856') renvoie tous les champs 856. FOREACH les parcourt un à un, qu'il y en ait un ou plusieurs ; f.subfield('u') lit un sous-champ du champ courant.
  • NEXT UNLESS saute un 856 sans URL.
  • Une notice sans 009 ni 856 n'affiche rien : la rubrique entière est dans le IF.
  • Le filtre uri encode le PPN pour qu'il puisse figurer dans une URL.

Avec une notice qui a un PPN et deux 856, dont un seul avec un $z, on obtient :

<div class="voir-aussi">
  <strong>Voir aussi :</strong>
  <ul>
    <li><a href="https://gallica.bnf.fr/ark:/12148/..." target="_blank">Version numérique (Gallica)</a></li>
    <li><a href="https://www.persee.fr/doc/..." target="_blank">Accès en ligne</a></li>
    <li><a href="https://www.sudoc.fr/035474041" target="_blank">Notice dans le Sudoc</a></li>
  </ul>
</div>

La classe voir-aussi permet de mettre la rubrique en forme dans OPACUserCSS. Les liens vers d'autres sites sont des liens ordinaires : la CSP (voir plus bas) ne les bloque pas.

Citations du jour

Une fonction amusante de Koha permet de gérer une petite base de données de citations qui sont affichées automatiquement et de façon aléatoire sur la page d'accueil. La fonction est activée avec la préférence QuoteOfTheDay, à l'OPAC et/ou en PRO. Puis, dans Outils > Éditeur de citations, vous gérez vos citations, soit une à une soit par lot, par import d'un fichier.

XSL

Les notices bibliographiques sont affichées à l'OPAC dans trois pages : résultat, détail et liste (les notices d'une liste). Les données des notices MARC qui sont extraites et affichées le sont au moyen de trois feuilles de style XSL. Ces feuilles de style vont chercher des éléments de la notice MARC et les transforment en HTML pour l'affichage. Il y a trois feuilles de style dont l'emplacement est spécifié au moyen des préférences suivantes :

  • OPACXSLTResultsDisplay
  • OPACXSLTDetailsDisplay
  • OPACXSLTListsDisplay

Chaque préférence contient default (la feuille de style livrée avec Koha), le chemin d'un fichier XSL sur le serveur ou l'URL d'une feuille de style externe. Dans le chemin ou l'URL, {langcode} est remplacé par la langue de l'interface : on peut ainsi avoir une feuille de style par langue. Pour qu'une feuille de style du résultat d'une recherche utilise les données des exemplaires, il faut activer la préférence PassItemMarcToXSLT.

Exemple — On veut afficher le champ résumé qui se trouve en 330$a. Le document XML de la notice contient ceci pour la zone 330 :

<datafield tag="330" ind1=" " ind2=" ">
  <subfield code="a">
    This reference work documents every aspect of the American public library
    experience through topical entries, statistics, biographies, and profile
  </subfield>
</datafield>

Pour l'afficher, il faut avoir dans la feuille XSL :

<xsl:if test="marc:datafield[@tag=330]">
  <p>
    <b>Résumé : </b>
    <xsl:value-of select="marc:datafield[@tag=330]/marc:subfield[@code='a']"/>
  </p>
</xsl:if>

Ce qui transforme le XML précédent en HTML :

<p>
  <b>Résumé : </b>
  This reference work documents every aspect of the American public library
  experience through topical entries, statistics, biographies, and profile
</p>

Pour un ajout aussi simple, la personnalisation de l'affichage des notices (voir plus haut) évite de maintenir sa propre feuille de style XSL.

Style CSS / OPACUserCSS

On modifie globalement l'aspect visuel de son OPAC au moyen de styles CSS. En inspectant le code HTML de l'OPAC Koha, on voit que tous les éléments des pages sont identifiés au moyen de class ou de id. La préférence OPACUserCSS contient les instructions CSS modifiant l'affichage de l'OPAC Koha. On peut globalement, ou spécifiquement, changer de police de caractères, changer la taille ou la couleur de certaines zones de texte, cacher des éléments, etc.

D'autres moyens complètent cette préférence :

  • CSS d'un site — Dans Administration > Bibliothèques, chaque site peut avoir ses propres instructions CSS, appliquées en plus de OPACUserCSS.
  • Feuille de style externe — La préférence OpacAdditionalStylesheet ajoute une feuille de style, désignée par son chemin ou son URL.

Javascript / OPACUserJS

Parfois toutes les méthodes précédentes ont été utilisées pour modifier son OPAC et il apparaît que ce n'est pas suffisant. On veut par exemple masquer un élément, mais sous certaines conditions, ou bien on veut afficher le résultat d'une requête SQL Koha ou l'information retournée par une autre application que Koha. Dans ces cas de figure, on peut utiliser la préférence OPACUserJS pour exécuter du code JavaScript. On peut ainsi programmer toutes sortes de choses complexes et manipuler le DOM, la structure, des pages HTML générées par Koha. Comme pour le CSS, chaque site peut avoir son propre JavaScript, dans Administration > Bibliothèques.

Politique de sécurité du contenu (CSP)

Koha peut envoyer une politique de sécurité du contenu (Content Security Policy, CSP) qui limite ce que le navigateur accepte d'exécuter et de charger. Elle est activée par l'administrateur système, dans le fichier koha-conf.xml. Quand elle l'est à l'OPAC :

  • OPACUserCSS et OPACUserJS fonctionnent normalement ;
  • une balise <script> placée dans un bloc HTML, une nouvelle ou une page n'est pas exécutée : le JavaScript doit être mis dans OPACUserJS ;
  • les images, scripts et polices chargés depuis un autre site (couvertures, widgets, etc.) sont bloqués, sauf si l'administrateur système autorise ce site dans la politique ;
  • de même, une feuille de style externe (OpacAdditionalStylesheet) donnée par l'URL d'un autre site est bloquée, ainsi que les polices et images qu'elle charge depuis un autre site. Une feuille de style placée sur le serveur Koha, désignée par un chemin, n'est pas concernée.

Les feuilles de style XSL données par une URL ne sont pas concernées : c'est le serveur Koha qui les télécharge, pas le navigateur. Le HTML qu'elles produisent l'est en revanche, comme tout autre contenu.