From: Robert Soulliere Date: Thu, 30 Sep 2010 18:45:48 +0000 (-0400) Subject: Add sections on integragred search forms and customizing Slimpac. X-Git-Url: https://old-git.evergreen-ils.org/?a=commitdiff_plain;h=f4aeda7840994a33060b99390bfb9451438cb26b;p=Evergreen-DocBook.git Add sections on integragred search forms and customizing Slimpac. --- diff --git a/1.6/development/customize_opac.xml b/1.6/development/customize_opac.xml index 3daf236..1a6669b 100644 --- a/1.6/development/customize_opac.xml +++ b/1.6/development/customize_opac.xml @@ -6,7 +6,7 @@ While Evergreen is ready to go out of the box, libraries will want to customize Evergreen with their own color scheme, logos and layout. This chapter will explain how to customize Evergreen to meet the needs of your users. For these task some knowledge of html and css is required. Many of these - instructions assume aninstallation of Evergreen using the default file locations. + instructions assume an installation of Evergreen using the default file locations. 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. @@ -68,7 +68,7 @@ name='Default' csstype='color'/> <div id='copyright_text'> <span>&footer.copyright;</span> - The included opac.dtd file in the en-US locale direcotry has this setting for &footer.copyright text: + The included opac.dtd file in the en-US locale directory has this setting for &footer.copyright text: <!ENTITY footer.copyright "Copyright © 2006-2010 Georgia Public Library Service, and others">
@@ -82,11 +82,11 @@ name='Default' csstype='color'/>
Added Content By default Evergreen includes customizable Added Content features to enhance the OPAC experience for your user. These features include Amazon book covers - and Google books searching. These features can be turned off or custimized. + and Google books searching. These features can be turned off or customized. Book Covers The default install of Evergreen includes Amazon book covers. The settings for this are controlled by the <added_content> section of - /opneils/conf/opensrf.xml. Here are the key elements of this configuration: + /openils/conf/opensrf.xml. Here are the key elements of this configuration: <module>OpenILS::WWW::AddedContent::Amazon</module> This calls the Amazon perl module. If you wish to link to a different book cover service other than Amazon, you must create a new perl module and refer to it here. You will also need to change other settings accordingly. There are some available book cover perl modules available in @@ -118,8 +118,8 @@ name='Default' csstype='color'/> experienced web developers. There are several critical files to edit if you wish to customize the results page: - /openils/var/web/opac/skin/default/js/result_common.js - This file controls the javascript for the top level elements on the results - page and should only be edited by experienced web developers except for the google books link setting mentioned perviously. + /openils/var/web/opac/skin/default/js/result_common.js - This file controls the JavaScript for the top level elements on the results + page and should only be edited by experienced web developers except for the Google books link setting mentioned previously. /openils/var/web/opac/skin/default/js/rresult.js - Has some good controls of results page settings at the top of this file but requires web development skills for editing this file. /openils/var/web/opac/skin/default/xml/result/rresult_table.xml - This controls the layout of the items table on results page. @@ -130,13 +130,13 @@ name='Default' csstype='color'/> There are many options when customizing the details page in Evergreen. The default settings are effective for most libraries, but it is important to understand the full potential of Evergreen when displaying the details of items. Some quick features can be turned on and off by changing variable values in the file /openils/var/web/opac/skin/default/js/rdedail.js. - You will notice the section at the top of this file called Per-skin configuration settings. Changing setting in this section can control several features includuing + You will notice the section at the top of this file called Per-skin configuration settings. Changing setting in this section can control several features including limiting results to local only or showing copy location or displaying serial holdings. Form this section you can also enable refworks and set the Refworks host URL. Some copy level details settings can be turned on and off from /openils/var/web/opac/skin/default/js/copy_details.js including displaying certain fields such as due date in the OPAC. An important file is the /openils/var/web/opac/skin/default/xml/rdetail/rdetail_summary.xml file. This file allows you to control which field to display in - the details summary of the record. The new BibTemnplate feature makes this file even more powerful by allowing you to display any marc fields - with a variey of formatting options. + the details summary of the record. The new BibTemplate feature makes this file even more powerful by allowing you to display any marc fields + with a variety of formatting options. The /openils/var/web/opac/skin/default/xml/rdetail/rdetail_copyinfo.xml file allows you to format the display of the copy information.
@@ -146,7 +146,7 @@ name='Default' csstype='color'/> unAPI MARCXMLMODS Managing the display of information from raw XML can be difficult, and the purpose of BibTemplate is to make this simpler, as well as move the display closer to the client and away from the source data. This is good from a separation-of-responsibilities perspective, and also makes it easier to contain and control local customization. - BibTemplate supports the foloowing Evergreen metadata formats: + BibTemplate supports the following Evergreen meta data formats: MARCXML - datatype='marcxml-full' (default) MODS 3.3: datatype='mods33' @@ -276,5 +276,36 @@ name='Default' csstype='color'/>
+
+ Customizing the Slimpac + The Slimpac is the an alternative OPAC display for browsers or devices without JavaScript or which may have screen size limitations. There is both a simple and advanced search + option for the Slimpac. + The html files for customizing the Slimpac search display are located in the folder /openils/var/web/opac/extras/slimpac. + start.html is the basic search display and advanced.html is the display for the advanced search option in the Slimpac. + By default, the Slimpac files include the same locale dtd as the regular OPAC (opac.dtd). However the slimpac files do not use the same CSS files as the + regular OPAC which means that if you change the OPAC color scheme for the OPAC, you must also change the Slimpac colors. +
+
+ Integrating a Evergreen Search Form on a Web Page + It is possible to embed a simple search form into an html page which will allow users to search for materials in your Evergreen catalog. Here is code which can be embedded + anywhere in the body of your web page: + +
+ Quick Catalog Search:
+ + + + + + + +
+ +]]> + + Replace [domain name] with the domain name of your Evergreen server and replace [locale] with the desired locale of + your Evergreen instance (e.g. en-US). This does a basic keyword search. Different types of searches and more advanced search forms can be developed. For further information on the url parameters used by Evergreen, see for more details. +