1 Example /etc/koha.conf file entries
7 includes=/usr/local/www/koha/htdocs/includes
8 Please note the final line (includes=path) - The path entry can be used as an alternative to manually editing the path in Output.pm file (see INSTALL manual).
11 --------------------------------------------------------------------------------
12 Example apache httpd.conf entries:
13 Koha makes extensive use of Server Side Includes (SSI):
16 http://httpd.apache.org/docs/mod/mod_include.html
17 If your page headers and footers do not show, then you may need to re-configure your web server.
19 Here is an example of entries suitable for Apache httpd.conf:
22 <VirtualHost 111.222.333.1>
23 ServerName koha.example.com
24 ServerPath /var/www/library
25 DocumentRoot /var/www/library/koha/html
26 Alias /images/ "/var/www/library/koha/html/images/"
27 ScriptAlias /cgi-bin/koha/ "/var/www/library/koha/cgi-bin/"
28 SetEnv PERL5LIB "/var/www/library/modules"
29 ErrorLog /var/log/httpd/koha-error_log
31 # ======== koha uses Server Side Includes =========
32 # Normally here, use the same path as "DocRoot" above
33 <Directory "/var/www/library/koha/html">
37 # First, you MUST enable +Includes or +IncludesNoExec
39 Options +Includes -FollowSymlinks -Indexes
41 # Second, you must also configure one of following:
43 # 1. server-parsed content (SSI) for files ending in ".html"
45 AddHandler server-parsed .html
47 # ...OR... (not "AND" !!!!)...
49 # 2. Allow SSI if executable bit set using "XBitHack"
50 # XBitHack on|off|full
52 # XBitHack on - any file that has the user-execute bit
53 # - set will be treated as a server-parsed html doc.
54 # - The "full" = "on" but, in addition, will test the
55 # - group-execute bit. If the group execute bit is set
56 # - then the Last-modified date of the returned file
57 # - is sent. If group-execute bit is not set, then no
58 # - last-modified date is sent.
59 # - Setting this bit allows clients and proxies to
60 # - cache the result of the request!
62 # For example, enable XBitHack (on) if you want to
63 # - include non-executable content in documents like:
64 # <!--#include virtual="/includes/footer.inc" -->
65 # <!--#include virtual="/cgi-bin/counter.pl" -->
69 # Remember - do not use XBitHack if using AddHandler!
73 <VirtualHost 111.222.333.1>
74 ServerName opac.example.com
75 ServerPath /var/www/library
76 DocumentRoot /var/www/library/opac/html
77 Alias /images/ "/var/www/library/opac/html/images/"
78 ScriptAlias /cgi-bin/opac/ "/var/www/library/opac/cgi-bin/"
79 SetEnv PERL5LIB "/var/www/library/modules"
80 ErrorLog /var/log/httpd/opac-error_log
82 <Directory "/var/www/library/opac/html">
84 Options +Includes -FollowSymLinks -Indexes
85 AddHandler server-parsed .html
90 Read your web server docs for more information about how Server Side Includes work.