Koha/Post-Installation

Step 1 - Setup email delivery

• Install mail delivery agent

sudo apt-get install postfix

When asked for type of configuration, select Internet with smarthost. The smarthost is your campus email server, for example at Stellenbosch University that server is: mail.sun.ac.za

• Deliver koha user email to designated recipients

sudo nano /etc/aliases

See example below. Replace the example email addresses with your email addresses.

# Added by installer for initial user
root:	me@my.edu
koha:   me@my.edu, you@my.edu

After saving the file, run the following command.

sudo newaliases

Enable command line email utils

sudo apt-get install mailx

Send a test email to yourself, by typing and pressing enter.

mail -s "Test from KOHA server" root, me@my.edu

Type in some content for the email, then press CTL+d to deliver the email.

You can check the log at /var/log/mail.log for more info of delivery.

Help

• https://help.ubuntu.com/community/Postfix

Tips

• https://github.com/colinsc/koha/blob/master/misc/maintenance/borrowers-force-messaging-defaults

Step 2 - Setup custom website style

• Select the "ccsr" theme using the opacthemes parameter in the admin interface.
• Setup the opacsmallimage in the admin interface.
• See the highlighted red boxes in the screenshot below for customisable areas of the OPAC web interface.

• The following folder contains the CCS files to style the OPAC client depending on which theme you selected.

/usr/share/koha/opac/htdocs/opac-tmpl

• The following folder contains the CCS files to style the admin interface.

/usr/share/koha/intranet/htdocs/intranet-tmpl

Help

• http://wiki.lib.sun.ac.za/images/5/56/OPAC-Customization.pdf
• http://libill.hartford.edu/koha/development/index.asp
• http://manual.koha-community.org/3.4/en/impopac.html
• http://wiki.koha-community.org/wiki/Customising_Notices_and_Slips
• http://wiki.koha-community.org/wiki/Receipt_Printing_Fonts

---

• http://learnlayout.com
• http://www.csstutorial.net
• http://www.echoecho.com/css.htm
• http://htmldog.com
• http://htmlhelp.com/reference/css
• http://www.fontsquirrel.com
• http://validator.w3.org
• http://jigsaw.w3.org/css-validator

Step 3 - Enable LDAP user ID and authentication

To do.

Help

• http://perldoc.koha-community.org/C4/Auth_with_ldap.html
• http://kohablog.wordpress.com/category/koha/ldap
• http://bywatersolutions.com/2012/07/09/koha-ldap
• http://www.slideshare.net/ohiocore/koha-integration-ldap

Step 4 - Enable Plugins

See: http://kohageek.blogspot.com/2013/09/how-to-setup-plugin-system-in-koha.html

Below is a brief procedure on how to add a "plugins" preference to Koha. Remember, with the packages installation method, these paths must be modified to point to your instance of Koha.

• To enable Koha plugins, the system preference UseKohaPlugins must be enabled.
• Create the directory /var/lib/koha/plugins
• Add the following lines to your koha-conf.xml file

      <pluginsdir>/var/lib/koha/plugins</pluginsdir>
      <enable_plugins>1</enable_plugins>"

• Add the following line to your koha-httpd.conf file

Alias /plugin/ "/var/lib/koha/plugins/"

• Restart your webserver
• Access the plugins system from the "More" pulldown
• Upload the example plugin file provided here.

Return to Koha wiki page