User Tools

Site Tools


This is an old revision of the document!

Customizing the OPAC

Note: Be sure to save a backup copy of all files you edit in a location other than /openils/var/web/opac/ as files here could be overwritten when you upgrade your copy of Evergreen. These notes were tested using an installation of Evergreen Version 1.2.0 rc 1 running on Ubuntu 7.04.

NOTE: This documentation is also available in the Evergreen documentation at In github:

Color Scheme


To change the four shades of green used throughout the OPAC as the default color scheme, edit /openils/var/web/opac/theme/default/css/colors.css and the new colors you select will appear as your default colors.


Or, you can create an alternate theme, which can be viewed in Firefox using View > Page Style > YourTheme.

  • Copy the css folder and its contents from the example alternate theme /openils/var/web/opac/theme/reddish/ to a new folder /openils/var/web/opac/theme/yourtheme/.
  • Edit /openils/var/web/opac/theme/yourtheme/css/colors.css to use the colors you want.
  • Link to your new style sheet by adding the following to /openils/var/web/opac/skin/default/xml/common/css_common.xml
<link type='text/css' 
  rel="alternate stylesheet" 
  href="<!--#echo var='OILS_THEME_BASE'-->/yourtheme/css/colors.css" 
  name='Default' csstype='color'/>
  • Give your new theme a name users can select by adding the following to /openils/var/web/opac/locale/en-US/opac.dtd
<!ENTITY "YourTheme">


To change text and links used throughout the OPAC, edit the following files:

  • /openils/var/web/opac/locale/en-US/lang.dtd
  • /openils/var/web/opac/locale/en-US/opac.dtd

Logo Images

To change the logos used by default to your own logos, replace the following files with images of your own, appropriately sized. The images Georgia PINES uses are 561px wide by 181px high and 187px wide by 48px high, but you could go larger or smaller within reason.

  • /openils/var/web/opac/images/main_logo.jpg
  • /openils/var/web/opac/images/small_logo.jpg

Cover Images

The file at /etc/apache2/sites_available/eg_vhost.conf includes example code to draw cover images from using Apache rewrites. This should be changed to use the URL of a content provider of your choice, where $1 is the part of the URL where the item's ISBN belongs.

Before this works, you may need to:

  • Enable proxy_http_module if not already enabled, by:
    sudo a2enmod proxy_http
    sudo /etc/init.d/apache2 force-reload
  • Update your proxy settings at /etc/apache2/mods-available/proxy.conf to allow access.
evergreen-admin/customizations/opac.1287592832.txt.gz · Last modified: 2022/02/10 13:33 (external edit)

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki

© 2008-2022 GPLS and others. Evergreen is open source software, freely licensed under GNU GPLv2 or later.
The Evergreen Project is a U.S. 501(c)3 non-profit organization.