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 <stomproj@larl.org>
Signed-off-by: Galen Charlton <gmc@esilibrary.com>

diff --git a/docs/TechRef/KidsOPAC.txt b/docs/TechRef/KidsOPAC.txt
index 856adb7..169c4ff 100644 (file)
--- 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*.
+
 ------------------------------------------------------------------------------
 <Location /eg/kpac>
     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]
 ------------------------------------------------------------------------------
 <VirtualHost *:80>
     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
     <Location /eg/kpac>
-        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"
     </Location>
 </VirtualHost>

diff --git a/docs/opac/kids_opac.txt b/docs/opac/kids_opac.txt
index cc6d089..126a28c 100644 (file)
--- 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
 ~~~~~~~~~~~~~~~~~~