OPAC personnalisé

L'OPAC Koha est la vitrine de votre bibliothèque, vitrine que vous pouvez entièrement personnalisée et alignée 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 affichent 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ée 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é 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étermine si elles sont affichées à l'OPAC.
Pages fixes — Les pages fixes sont similaires aux nouvelles, mais elles ne sont pas affichées sur la page d'accueil. On y accès au moyen d'URL qui ont la forme suivante :

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

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 trois catégories d'information suivantes :

Bloc HTML — Une portion d'information affichée à différents emplacement de l'OPAC. Outils > Paramétrages HTML.
Nouvelle — Une information longue, affichée en partie dès la page d'accueil. Outils > Nouvelles.
Page — Une page d'information. Il faut créer des liens vers ce type de page. Outils > Pages.

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 propose à une bibliothèque spécifique.
Dates — Un contenu a une date de publication et une date d'expiration.
Positionnement — Pour les nouvelles, leur positionnement sur la page d'accueil les unes par rapport aux autres.
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 > Paramétrages HTML. On choisit un des blocs suivants :

ArticleRequestsDisclaimerText
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
OpacLoginInstructions
OpacMainUserBlock — Le bloc central de la page d'accueil.
OpacMoreSearches
OpacMySummaryNotes
OpacNav — La 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.
OpacNavRight — Bloc à droite de la page d'accueil.
OpacSuggestionInstructions

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 à l'OPAC. La fonction est activée avec la préférence QuoteOfTheDay. Puis, dans Outils > Citations du jour, 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 transforme 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

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>

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.

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.