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.

Default

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.

Alternate

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" 
  title='&opac.style.yourtheme;' 
  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 opac.style.yourtheme "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

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

The file at /etc/apache2/sites_available/eg_vhost.conf includes example code to draw cover images from Amazon.com 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.