WARNING: Prior to version 1.1.15 there is no safeguard in place to prevent data from being deleted during an upgrade. Be sure to backup/save data prior to upgrading. Beginning with version 1.1.15 as a new install, existing table data (reservations, rooms, room equipment, etc.) will persist after upgrades. Even so, always remember to perform a database backup prior to upgrading any component!
Koha's Plugin System (available in Koha 3.12+) allows for you to add additional tools and reports to Koha that are specific to your library. Plugins are installed by uploading KPZ ( Koha Plugin Zip ) packages. A KPZ file is just a zip file containing the perl files, template files, and any other files necessary to make the plugin work. Learn more about the Koha Plugin System in the Koha 3.22 Manual or watch Kyle's tutorial video.
From the release page you can download the relevant *.kpz file
Koha's Plugin System allows for you to add additional tools and reports to Koha that are specific to your library. Plugins are installed by uploading KPZ ( Koha Plugin Zip ) packages. A KPZ file is just a zip file containing the perl files, template files, and any other files necessary to make the plugin work.
The plugin system needs to be turned on by a system administrator.
To set up the Koha plugin system you must first make some changes to your install.
<enable_plugins>1</enable_plugins>in your koha-conf.xml file
- Confirm that the path to
<pluginsdir>exists, is correct, and is writable by the web server
- Restart your webserver
Once set up is complete you will need to alter your UseKohaPlugins system preference. On the Tools page you will see the Tools Plugins and on the Reports page you will see the Reports Plugins.
Package from source
From the root of the room reservation git folder, make sure
zip is installed and package the plugin with the command
zip -r package-file-name.kpz Koha/
-r flag compresses everything contained within the Koha folder into a file with the specified name. The important part about the file name is for it to end with
- These instructions assume the plugin is being installed in kohadevbox. If installing for production change the file paths accordingly.
In order for the Room Reservations plugin to work from the OPAC, Apache needs to be tweaked.
First, add the following ScriptAlias Directive to your Apache configuration file under the OPAC section (on Debian, depending on your installation, the configuration file is typically located in
ScriptAlias /booking "/var/lib/koha/kohadev/plugins/Koha/Plugin/Com/MarywoodUniversity/RoomReservations/opac/calendar.pl"
Next, also under the OPAC section of the koha.conf Apache configuration file, we need to add an Alias entry so the plugins folder can be reached from the OPAC
Alias /plugin "/var/lib/koha/kohadev/plugins"
Last, we need to add a directive to
/etc/apache2/apache2.conf to prevent 403 errors on the OPAC
The following directory stanza is only required in Apache 2.4+.
Require all granted will result in breaks on Apache 2.2 and below.
<Directory /var/lib/koha/kohadev/plugins/> Options Indexes FollowSymLinks AllowOverride None Require all granted </Directory>
This plugin requires the following modules to be installed:
Cwd File::Basename Calendar::Simple
Add link to OPAC
To add a link to this plugin for acess from the OPAC add the following lines to the
OPACUserJs System Preference
/* Add Booking link for redirection plugin script */ $("#moresearches li:contains('Advanced search')").after("<li><a href='/booking' target='_blank'>Booking</a></li>");