From 3bfb2206640585c1557f1b511e92b28d018fed4f Mon Sep 17 00:00:00 2001 From: Josh Stompro Date: Thu, 23 Oct 2014 13:21:16 -0500 Subject: [PATCH] LP#1116387 - adding kpac setup notes. Revised instructions based on my testing. Swapped around the Monster and Default skin discriptions since the listed Alternate Skin is the default skin. Signed-off-by: Josh Stompro Signed-off-by: Galen Charlton --- docs/TechRef/KidsOPAC.txt | 24 +++++++++++++++--------- docs/opac/kids_opac.txt | 23 ++++++++++------------- 2 files changed, 25 insertions(+), 22 deletions(-) diff --git a/docs/TechRef/KidsOPAC.txt b/docs/TechRef/KidsOPAC.txt index 856adb77c7..169c4ff1cd 100644 --- a/docs/TechRef/KidsOPAC.txt +++ b/docs/TechRef/KidsOPAC.txt @@ -7,7 +7,10 @@ Configuration Apache ~~~~~~ -[source, bash] +The KPAC is already included and ready to be used with new Evergreen installs. So you only need to change the apache config +if you need to change template locations or if you want to use a different *kpac.xml* config file. The defaults for the KPAC are set +in */etc/apache2/eg_vhosts.conf*. + ------------------------------------------------------------------------------ PerlSetVar OILSWebContextLoader "OpenILS::WWW::EGKPacLoader" @@ -77,14 +80,19 @@ XML Configuration File Skin Configuration ~~~~~~~~~~~~~~~~~~ -The following example enables you to configure the alternate skin for the Kids +The following example enables you to configure the alternate skin (Monster Skin, kpac2) for the Kids Catalog. -[source, xml] +You should be familiar with how the <<_how_to_override_templates|Evergreen TPAC handles template folders>> +before you make these changes. + +If you already have a custom template directory setup you can copy the *Open-ILS/examples/web/templates/kpac* +files to that directory instead, and then skip any Apache config changes. + +[source, bash] ------------------------------------------------------------------------------ % cp -r Open-ILS/examples/web/css/skin/kpac2 /openils/var/web/css/skin/ -% cp -r Open-ILS/examples/web/images/kpac/* /openils/var/web/images/kpac/ # -does not clobber +% cp -r Open-ILS/examples/web/images/kpac/* /openils/var/web/images/kpac/ #does not clobber % mkdir /openils/var/templates_kpac2 % cp -r Open-ILS/examples/web/templates/kpac /openils/var/templates_kpac2/ ------------------------------------------------------------------------------- @@ -92,7 +100,6 @@ does not clobber Then set up 443/80 vhosts for serving the alternate skin in eg.conf, something along the lines of: -[source, xml] ------------------------------------------------------------------------------ ServerName xyz.dev198.esilibrary.com:80 @@ -100,9 +107,8 @@ along the lines of: DirectoryIndex index.xml index.html index.xhtml Include eg_vhost.conf - PerlSetVar OILSWebContextLoader "OpenILS::WWW::EGKPacLoader" - PerlSetVar KPacConfigFile "/openils/conf/kpac.xml.example" - PerlAddVar OILSWebTemplatePath "/openils/var/templates" + #Point to a different kpac.xml config file if needed + #PerlSetVar KPacConfigFile "/openils/conf/kpac.xml.example" PerlAddVar OILSWebTemplatePath "/openils/var/templates_kpac2" diff --git a/docs/opac/kids_opac.txt b/docs/opac/kids_opac.txt index cc6d08902a..126a28c7bd 100644 --- a/docs/opac/kids_opac.txt +++ b/docs/opac/kids_opac.txt @@ -17,19 +17,7 @@ Two skins, or design interfaces, have been created for the KPAC. The KPAC was designed to run multiple skins on a single web server. A consortium, then, could allow each library system to choose a skin for their patrons. - -*Monster Skin:* - - -In this skin, the search bar shares the top panel with a playful monster. The -search grid appears beneath the search bar. Help and Login links appear in bold -colors at the top right of the interface although you can customize these with CSS. -After you login, the Login button disappears. - -image::media/Kids_OPAC2.jpg[Kids_OPAC2] - - -*Alternate Skin:* +*Default Skin:* In this skin, the search bar is the focal point of the top panel and is centered on the screen. The search grid appears beneath the search bar. Help and Login @@ -39,6 +27,15 @@ in the top right corner, and the Login link becomes an option to Logout. image::media/Kids_OPAC1.jpg[Kids_OPAC1] +*Alternate Monster Skin:* + +In this skin, the search bar shares the top panel with a playful monster. The +search grid appears beneath the search bar. Help and Login links appear in bold +colors at the top right of the interface although you can customize these with CSS. +After you login, the Login button disappears. + +image::media/Kids_OPAC2.jpg[Kids_OPAC2] + Search the Catalog ~~~~~~~~~~~~~~~~~~ -- 2.11.0