1 <h1 id=
"releasenotesforkoha20.05.02">RELEASE NOTES FOR KOHA
20.05.02</h1>
5 <p>Koha is the first free and open source software library automation
6 package (ILS). Development is sponsored by libraries of varying types
7 and sizes, volunteers, and support companies from around the world. The
8 website for the Koha project is:
</p>
11 <li><a href=
"http://koha-community.org">Koha Community
</a></li>
14 <p>Koha
20.05.02 can be downloaded from:
</p>
17 <li><a href=
"http://download.koha-community.org/koha-20.05.02.tar.gz">Download
</a></li>
20 <p>Installation instructions can be found at:
</p>
23 <li><a href=
"http://wiki.koha-community.org/wiki/Installation_Documentation">Koha Wiki
</a></li>
24 <li>OR in the INSTALL files that come in the tarball
</li>
27 <p>Koha
20.05.02 is a bugfix/maintenance release.
</p>
29 <p>It includes
17 enhancements,
25 bugfixes.
</p>
31 <h3 id=
"systemrequirements">System requirements
</h3>
33 <p>Koha is continuously tested against the following configurations and as such these are the recommendations for
37 <li>Debian Jessie with MySQL
5.5 (End of life)
</li>
38 <li>Debian Stretch with MariaDB
10.1</li>
39 <li>Debian Buster with MariaDB
10.3</li>
40 <li>Ubuntu Bionic with MariaDB
10.1 </li>
41 <li>Debian Stretch with MySQL
8.0 (Experimental MySQL
8.0 support)
</li>
44 <p>Additional notes:
</p>
47 <li>Perl
5.10 is required (
5.24 is recommended)
</li>
48 <li>Zebra or Elasticsearch is required
</li>
51 <h2 id=
"enhancements">Enhancements
</h2>
53 <h3 id=
"architectureinternalsandplumbing">Architecture, internals, and plumbing
</h3>
56 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=21395">[
21395]
</a> Make perlcritic happy
</li>
59 <h3 id=
"circulation">Circulation
</h3>
62 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25232">[
25232]
</a> Add ability to skip trapping items with a given notforloan value
</li>
63 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25699">[
25699]
</a> Add edition information to Holds to pull report
</li>
66 <h3 id=
"holdrequests">Hold requests
</h3>
69 <li><p><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25789">[
25789]
</a> New expiration date on placing a hold in staff interface can be set to a date in the past
</p>
71 <p><strong>Sponsored by
</strong> <em>Koha-Suomi Oy
</em></p></li>
74 <h3 id=
"notices">Notices
</h3>
77 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25097">[
25097]
</a> Add option to message_queue to allow for only specific sending notices
</li>
80 <h3 id=
"opac">OPAC
</h3>
83 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18911">[
18911]
</a> Option to set preferred language in OPAC
</li>
84 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=22807">[
22807]
</a> Accessibility: Add 'Skip to main content' link
</li>
85 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25151">[
25151]
</a> Accessibility: The 'Your cart' page does not contain a level-one header
</li>
86 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25154">[
25154]
</a> Accessibility: The 'Search results' page does not use heading markup where content is introduced
</li>
87 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25236">[
25236]
</a> Accessibility: The 'Refine your search' box contains semantically incorrect headings
</li>
88 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25238">[
25238]
</a> Accessibility: Multiple 'H1' headings exist in the full record display
</li>
89 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25239">[
25239]
</a> Accessibility: The 'Confirm hold page' contains semantically incorrect headings
</li>
90 <li><p><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25402">[
25402]
</a> Put OPAC cart download options into dropdown menu
</p>
93 <p>This enhancement adds the OPAC cart download format options into the dropdown menu, rather than opening in a separate pop up window. (This also matches the behaviour in the staff interface.)
</p>
97 <h3 id=
"staffclient">Staff Client
</h3>
100 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=12093">[
12093]
</a> Add CSS classes to item statuses in detail view
</li>
103 <h3 id=
"templates">Templates
</h3>
106 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25471">[
25471]
</a> Add DataTables to MARC subfield structure admin page for bibliographic frameworks
</li>
107 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25747">[
25747]
</a> Don't display a comma when patron has no firstname
</li>
110 <h3 id=
"tools">Tools
</h3>
113 <li><p><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4985">[
4985]
</a> Copy a change on the calendar to all libraries
</p>
115 <p><strong>Sponsored by
</strong> <em>Koha-Suomi Oy
</em></p></li>
118 <h2 id=
"criticalbugsfixed">Critical bugs fixed
</h2>
120 <h3 id=
"architectureinternalsandplumbing">Architecture, internals, and plumbing
</h3>
123 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=24986">[
24986]
</a> Maximum row size reached soon for borrowers and deletedborrowers
</li>
126 <h3 id=
"circulation">Circulation
</h3>
129 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25851">[
25851]
</a> 19.11 upgrade creates holdallowed rule with empty value
</li>
132 <h3 id=
"command-lineutilities">Command-line Utilities
</h3>
135 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25752">[
25752]
</a> Current directory not kept when using koha-shell
</li>
138 <h3 id=
"opac">OPAC
</h3>
141 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=22672">[
22672]
</a> Replace
<i> tags with
<em> AND
<b> tags with
<strong> in the OPAC
</li>
142 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25769">[
25769]
</a> Patron self modification triggers change request for date of birth to null
</li>
145 <h3 id=
"patrons">Patrons
</h3>
148 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25322">[
25322]
</a> Adding a guarantor with no relationship defaults to first available relationship name
</li>
149 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25858">[
25858]
</a> Borrower permissions are broken by update from bug
22868</li>
152 <h3 id=
"searching-elasticsearch">Searching - Elasticsearch
</h3>
155 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25864">[
25864]
</a> Case sensitivity breaks searching of some fields in ES5
</li>
158 <h2 id=
"otherbugsfixed">Other bugs fixed
</h2>
160 <h3 id=
"acquisitions">Acquisitions
</h3>
163 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25611">[
25611]
</a> Changing the vendor when creating the basket does not keep that new vendor
</li>
166 <h3 id=
"architectureinternalsandplumbing">Architecture, internals, and plumbing
</h3>
169 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25875">[
25875]
</a> Patron displayed multiple times in add user search if they have multiple sub permissions
</li>
172 <h3 id=
"cataloging">Cataloging
</h3>
175 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25189">[
25189]
</a> AutoCreateAuthorities can repeatedly generate authority records when using Default linker
</li>
176 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25553">[
25553]
</a> Edit item date sort does not sort correctly
</li>
179 <h3 id=
"circulation">Circulation
</h3>
182 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25440">[
25440]
</a> Remove undef and CGI warnings and fix template variables list in circulation rules
</li>
183 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25807">[
25807]
</a> Version
3.008 of Template breaks smart-rules display
</li>
186 <h3 id=
"installationandupgradeweb-basedinstaller">Installation and upgrade (web-based installer)
</h3>
189 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25491">[
25491]
</a> Perl warning at the login page of installer
</li>
192 <h3 id=
"opac">OPAC
</h3>
195 <li><p><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=11994">[
11994]
</a> Fix OpenSearch discovery in the OPAC
</p>
198 <p>OpenSearch (https://en.wikipedia.org/wiki/OpenSearch) allows you to search your library's catalog directly from the browser address bar or search box. This fixes the OpenSearch feature so that it now works correctly in Firefox. Note: make sure OPACBaseURL is correctly set.
</p>
200 <li><p><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=24352">[
24352]
</a> Wrong labels displaying in result list with OpacItemLocation
</p>
203 <p>This fixes the OPAC's MARC21 search results XSLT so that OPAC search result information is correctly labelled based on the OpacItemLocation preference.
</p>
205 <p>Previously, search results showed the label
"Location(s)" whether the
206 setting was
"collection code" or
"location."</p>
208 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25914">[
25914]
</a> Relative's checkouts have empty title in OPAC
</li>
211 <h3 id=
"packaging">Packaging
</h3>
214 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25509">[
25509]
</a> Remove useless libjs-jquery dependency
</li>
217 <h3 id=
"restapi">REST API
</h3>
220 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25570">[
25570]
</a> Listing requests should be paginated by default
</li>
223 <h3 id=
"sip2">SIP2
</h3>
226 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25805">[
25805]
</a> SIP will show hold patron name (DA) as something like C4::SIP::SIPServer=HASH(
0x88175c8) if there is no patron
</li>
229 <h3 id=
"staffclient">Staff Client
</h3>
232 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25756">[
25756]
</a> Empty HTML table row after OPAC
"Appearance" preferences
</li>
233 <li><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25804">[
25804]
</a> Remove HTML from title tag of bibliographic detail page
</li>
236 <h3 id=
"templates">Templates
</h3>
239 <li><p><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25447">[
25447]
</a> Terminology: Fix button text
"Edit biblio"</p>
242 <p>This updates the text on the cataloging main page so that in the menu for each search result the
"Edit biblio" link is now
"Edit record."</p>
246 <h3 id=
"webservices">Web services
</h3>
249 <li><p><a href=
"http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25793">[
25793]
</a> OAI 'Set' and 'Metadata' dropdowns broken by OPAC jQuery upgrade
</p>
251 <h2 id=
"newsysprefs">New sysprefs
</h2></li>
252 <li><p>SkipHoldTrapOnNotForLoanValue
</p></li>
255 <h2 id=
"documentation">Documentation
</h2>
257 <p>The Koha manual is maintained in Sphinx. The home page for Koha
258 documentation is
</p>
261 <li><a href=
"http://koha-community.org/documentation/">Koha Documentation
</a></li>
264 <p>As of the date of these release notes, only the English version of the
265 Koha manual is available:
</p>
268 <li><a href=
"http://koha-community.org/manual/20.05/en/html/">Koha Manual
</a></li>
271 <p>The Git repository for the Koha manual can be found at
</p>
274 <li><a href=
"https://gitlab.com/koha-community/koha-manual">Koha Git Repository
</a></li>
277 <h2 id=
"translations">Translations
</h2>
279 <p>Complete or near-complete translations of the OPAC and staff
280 interface are available in this release for the following languages:
</p>
283 <li>Arabic (
84.6%)
</li>
284 <li>Armenian (
99.9%)
</li>
285 <li>Armenian (Classical) (
99.7%)
</li>
286 <li>Chinese (Taiwan) (
91.3%)
</li>
287 <li>Czech (
81.2%)
</li>
288 <li>English (New Zealand) (
68%)
</li>
289 <li>English (USA)
</li>
290 <li>Finnish (
70%)
</li>
291 <li>French (
82%)
</li>
292 <li>French (Canada) (
95.8%)
</li>
293 <li>German (
97.7%)
</li>
294 <li>German (Switzerland) (
75.9%)
</li>
295 <li>Greek (
60.8%)
</li>
296 <li>Hindi (
100%)
</li>
297 <li>Italian (
81.7%)
</li>
298 <li>Norwegian Bokmål (
72.5%)
</li>
299 <li>Polish (
73.3%)
</li>
300 <li>Portuguese (
86.3%)
</li>
301 <li>Portuguese (Brazil) (
100%)
</li>
302 <li>Slovak (
72.6%)
</li>
303 <li>Spanish (
100%)
</li>
304 <li>Swedish (
79%)
</li>
305 <li>Telugu (
91.4%)
</li>
306 <li>Turkish (
91.8%)
</li>
307 <li>Ukrainian (
65.4%)
</li>
310 <p>Partial translations are available for various other languages.
</p>
312 <p>The Koha team welcomes additional translations; please see
</p>
315 <li><a href=
"http://wiki.koha-community.org/wiki/Translating_Koha">Koha Translation Info
</a></li>
318 <p>For information about translating Koha, and join the koha-translate
319 list to volunteer:
</p>
322 <li><a href=
"http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-translate">Koha Translate List
</a></li>
325 <p>The most up-to-date translations can be found at:
</p>
328 <li><a href=
"http://translate.koha-community.org/">Koha Translation
</a></li>
331 <h2 id=
"releaseteam">Release Team
</h2>
333 <p>The release team for Koha
20.05.02 is
</p>
336 <li><p>Release Manager: Martin Renvoize
</p></li>
337 <li><p>Release Manager assistants:
</p>
340 <li>Tomás Cohen Arazi
</li>
341 <li>Jonathan Druart
</li>
343 <li><p>QA Manager: Katrin Fischer
</p></li>
347 <li>Jonathan Druart
</li>
348 <li>Marcel de Rooy
</li>
349 <li>Joonas Kylmälä
</li>
350 <li>Josef Moravec
</li>
351 <li>Tomás Cohen Arazi
</li>
352 <li>Nick Clemens
</li>
355 <li><p>Topic Experts:
</p>
358 <li>SIP2 -- Colin Campbell
</li>
359 <li>EDI -- Colin Campbell
</li>
360 <li>Elasticsearch -- Fridolin Somers
</li>
361 <li>REST API -- Tomás Cohen Arazi
</li>
362 <li>ILS-DI -- Arthur Suzuki
</li>
363 <li>UI Design -- Owen Leonard
</li>
364 <li>ILL -- Andrew Isherwood
</li>
366 <li><p>Bug Wranglers:
</p>
369 <li>Michal Denár
</li>
370 <li>Cori Lynn Arnold
</li>
371 <li>Lisette Scheer
</li>
374 <li><p>Packaging Manager: Mason James
</p></li>
375 <li><p>Documentation Managers:
</p>
378 <li>Caroline Cyr La Rose
</li>
381 <li><p>Documentation Team:
</p>
384 <li>Donna Bachowski
</li>
385 <li>Lucy Vaux-Harvey
</li>
386 <li>Sugandha Bajaj
</li>
388 <li><p>Translation Manager: Bernardo González Kriegel
</p></li>
389 <li><p>Release Maintainers:
</p>
392 <li>19.11 -- Joy Nelson
</li>
393 <li>19.05 -- Lucas Gass
</li>
394 <li>18.11 -- Hayley Mapley
</li>
396 <li><p>Release Maintainer mentors:
</p>
399 <li>19.11 -- Martin Renvoize
</li>
400 <li>19.05 -- Nick Clemens
</li>
401 <li>18.11 -- Chris Cormack
</li>
405 <h2 id=
"credits">Credits
</h2>
407 <p>We thank the following libraries who are known to have sponsored
408 new features in Koha
20.05.02:
</p>
411 <li>Koha-Suomi Oy
</li>
414 <p>We thank the following individuals who contributed patches to Koha
20.05.02.
</p>
417 <li>Tomás Cohen Arazi (
4)
</li>
418 <li>Nick Clemens (
7)
</li>
419 <li>David Cook (
1)
</li>
420 <li>Jonathan Druart (
8)
</li>
421 <li>Katrin Fischer (
3)
</li>
422 <li>Lucas Gass (
8)
</li>
423 <li>Kyle Hall (
6)
</li>
424 <li>Owen Leonard (
11)
</li>
425 <li>Hayley Mapley (
1)
</li>
426 <li>Julian Maurice (
7)
</li>
427 <li>Andrew Nugged (
6)
</li>
428 <li>Martin Renvoize (
12)
</li>
429 <li>David Roberts (
1)
</li>
430 <li>Marcel de Rooy (
1)
</li>
431 <li>Andreas Roussos (
1)
</li>
432 <li>Slava Shishkin (
1)
</li>
433 <li>Emmi Takkinen (
3)
</li>
434 <li>Koha Translators (
1)
</li>
435 <li>Petro Vashchuk (
2)
</li>
438 <p>We thank the following libraries, companies, and other institutions who contributed
439 patches to Koha
20.05.02</p>
442 <li>Athens County Public Libraries (
11)
</li>
443 <li>BibLibre (
7)
</li>
444 <li>Bibliotheksservice-Zentrum Baden-Württemberg (BSZ) (
3)
</li>
445 <li>ByWater-Solutions (
21)
</li>
446 <li>Catalyst (
1)
</li>
447 <li>Dataly Tech (
1)
</li>
448 <li>Independant Individuals (
12)
</li>
449 <li>Koha Community Developers (
8)
</li>
450 <li>Prosentient Systems (
1)
</li>
451 <li>PTFS-Europe (
13)
</li>
452 <li>Rijks Museum (
1)
</li>
453 <li>Theke Solutions (
4)
</li>
456 <p>We also especially thank the following individuals who tested patches
460 <li>Tomás Cohen Arazi (
4)
</li>
461 <li>Alex Arnaud (
5)
</li>
462 <li>Alex Buckley (
1)
</li>
463 <li>Jonathan Druart (
73)
</li>
464 <li>Katrin Fischer (
29)
</li>
465 <li>Andrew Fuerste-Henry (
3)
</li>
466 <li>Lucas Gass (
76)
</li>
467 <li>Didier Gautheron (
1)
</li>
468 <li>Kyle Hall (
1)
</li>
469 <li>Sally Healey (
11)
</li>
470 <li>Heather Hernandez (
1)
</li>
471 <li>Bernardo González Kriegel (
2)
</li>
472 <li>Rhonda Kuiper (
1)
</li>
473 <li>Owen Leonard (
9)
</li>
474 <li>Hayley Mapley (
5)
</li>
475 <li>Julian Maurice (
5)
</li>
476 <li>David Nind (
5)
</li>
477 <li>Martin Renvoize (
29)
</li>
478 <li>Marcel de Rooy (
1)
</li>
479 <li>Emmi Takkinen (
1)
</li>
480 <li>Timothy Alexis Vass (
1)
</li>
481 <li>Christofer Zorn (
1)
</li>
484 <p>We thank the following individuals who mentored new contributors to the Koha project.
</p>
487 <li>Andrew Nugged
</li>
490 <p>We regret any omissions. If a contributor has been inadvertently missed,
491 please send a patch against these release notes to
492 koha-patches@lists.koha-community.org.
</p>
494 <h2 id=
"revisioncontrolnotes">Revision control notes
</h2>
496 <p>The Koha project uses Git for version control. The current development
497 version of Koha can be retrieved by checking out the master branch of:
</p>
500 <li><a href=
"git://git.koha-community.org/koha.git">Koha Git Repository
</a></li>
503 <p>The branch for this version of Koha and future bugfixes in this release
504 line is rmain2005.
</p>
506 <h2 id=
"bugsandfeaturerequests">Bugs and feature requests
</h2>
508 <p>Bug reports and feature requests can be filed at the Koha bug
512 <li><a href=
"http://bugs.koha-community.org">Koha Bugzilla
</a></li>
515 <p>He rau ringa e oti ai.
516 (Many hands finish the work)
</p>
518 <p>Autogenerated release notes updated last on
22 Jul
2020 21:
03:
08.
</p>