Add KPAC configuration information to the community docs

[Kathy Lussier]

Some useful KPAC configuration information was sitting in the TechRef directory of the Evergreen repository and, after some discussion in IRC today, we thought it would be useful to include in the community docs. This commit:

* Includes KidsOPAC.txt in the root.txt file so that it will be included in the community docs.
* Adds some information to KidsOPAC.txt on configuring kpac to use the alternate skin. This information is based on code that berick shared in IRC and could probably use some review.
* Removes a reference in the end-user kpac docs on where to find configuration information.

http://git.evergreen-ils.org/?p=working/Evergreen.git;a=shortlog;h=refs/heads/user/kmlussier/kpac-doc-addition

Documentation will need to be added to master and to 2.3.

[Ben Shum (bshum)]

Hmm, some minor changes necessary to the alternate skin configuration steps so that they'll work better I think. Great start though!

[Josh Stompro (u-launchpad-stompro-org)]

I noticed that the default skin for the kpac on my 2.6 test system is the alternate skin according to what is listed at
http://docs.evergreen-ils.org/dev/_kids_opac.html#_choose_a_skin

So should the docs say "How to enable the monster skin"? kpac2 seems to be the monster skin.
http://git.evergreen-ils.org/?p=Evergreen.git;a=commit;h=cf4875ecf60b8d907310f9881c39c6a96f6d8652

Should the Alternate Skin be called "The default Skin" or something other than alternate?

Josh

[Josh Stompro (u-launchpad-stompro-org)]

The instructions for copying the files worked without any problems... although I already had an alternate template location setup for the opac, so I just copied the monster skin template files into that template folder, and I didn't need to touch apache for it to work correctly.

So maybe there should be a note saying something along those lines. The template redirection is so flexible it is hard to document every eventuality.

I will test out the listed apache setup next to see if there are problems with it.

Josh

[Josh Stompro (u-launchpad-stompro-org)]

I found that the minimum required apache config change if you want a separate template dir for the kpac is

 <Location /eg/kpac>
         PerlAddVar OILSWebTemplatePath "/openils/var/templates_kpac2"
 </Location>

The other options are already loaded globally in the default install for 2.6. I would guess that is the case for 2.5 and 2.7 also. Maybe in 2.3 those were required, but I don't think they are any more.

[Josh Stompro (u-launchpad-stompro-org)]

I made the changes that I mentioned, and got setup to use the EG git instead of github, Yeah. Ben if you could be more specific about what changes are needed that would help. I went though the docs and tried them out on my 2.6 test system and everything worked as described.

http://git.evergreen-ils.org/?p=working/Evergreen.git;a=shortlog;h=refs/heads/user/stompro/lp1116387_kpac_docs

[Galen Charlton (gmc)]

As part of pulling in the fix for 1083639, I've pushed these changes as well to master, rel_2_7, and rel_2_6. Thanks, Josh!

[Ben Shum (bshum)]

Removing 2.next top level milestone, since this was a bug fix that was repaired in an actual series maintenance release.