Koha 22.05.08 released
RELEASE NOTES FOR KOHA 22.05.08
22 Dec 2022
Koha is the first free and open source software library automation
package (ILS). Development is sponsored by libraries of varying types
and sizes, volunteers, and support companies from around the world. The
website for the Koha project is:
Koha 22.05.08 can be downloaded from:
Installation instructions can be found at:
- Koha Wiki
- OR in the INSTALL files that come in the tarball
Koha 22.05.08 is a bugfix/maintenance release.
It includes 5 enhancements, 2 security bugs, and 50 bugfixes.
System requirements
You can learn about the system components (like OS and database) needed for running Koha here.
Enhancements
Acquisitions
- [31459] Make order receive page faster on systems with many budgets
Architecture, internals, and plumbing
- [31776] Typo in cleanup_database.pl cron’s help/usage
Notices
- [27265] process_message_queue.pl cron should be able to take multiple types as a parameter
This patch adds the ability to specify several types or letter codes when running the process_message_queue script. This allows libraries to consolidate calls when some message types or letter codes are scheduled differently than others
Templates
- [31677] Convert basic MARC editor tabs to Bootstrap
- [31678] Convert authority editor tabs to Bootstrap
Critical bugs fixed
Architecture, internals, and plumbing
- [31785] Adding or editing library does not respect public flag
- [32242] The job has not been sent to the message broker: (Wide character in syswrite … )
Circulation
- [30944] Fix single cancel recall button in recalls tab in staff interface and correctly handle cancellations with branch transfers
Sponsored by Catalyst
This fixes the ‘cancel’ recall button in several places so that it now works as expected (including the recalls tab in a patron’s details section, the recalls section for a record, and the circulation recalls queue and recalls to pull pages). It also ensures a correct cancellation reason is logged when cancelling a recall in transit.
Command-line Utilities
- [32012] runreport.pl should use binmode UTF-8
MARC Bibliographic data support
- [31869] Unable to save thesaurus value to frameworks subfields
OPAC
- [32114] Template error in OPAC search results RSS
Packaging
- [31588] Update cpanfile for new OpenAPI versions
Other bugs fixed
Acquisitions
- [29554] neworderempty.pl may create records with biblioitems.itemtype NULL
- [31587] Basket not accessible from ACQORDER notice
This makes sure that the basket object is passed to the ACQORDER notice in order to allow adding information about the basket and the order lines within it.
- [31649] Acquisition basket CSV export fails if biblio does not exist
Architecture, internals, and plumbing
- [20457] Overdue and pre-overdue cronjobs not skipping phone notices
- [26648] Prevent internal server error if item attached to old checkout has been removed
- [31196] Key “default_value_for_mod_marc-” cleared from cache but not set anymore
- [31441] Koha::Item::as_marc_field ignores subfields where kohafield is an empty string
- [31469] log4perl.conf: Plack logfiles need %n in conversionpattern
- [31920] Unit test t/db_dependent/Holds.t leaves behind database cruft
Cataloging
- [31643] Link authorities automatically requires ALL cataloging and authorities permissions
- [31682] Silence warn when using automatic linker in biblio editor
Sponsored by Catalyst
Circulation
- [31903] Article requests: Edit URLs link missing in the New tab
Documentation
- [27315] The man pages for the command line utilities do not display properly
Fines and fees
- [29987] Manual credits are not recorded for a register
This fixes the recording of manual credits for patrons so that these transactions are now included in the cash summary report for a library. When adding a manual credit, there are now fields for choosing the transaction type and cash register.
Hold requests
- [31540] Holds reminder cronjob should consider expiration date of holds, and not send notices if hold expired
- [31575] Missing warning for holds where AllowHoldPolicyOverride can be used to force a hold to be placed
I18N/L10N
- [30517] Translation breaks editing parent type circulation rule
- [31738] Unstranslatable string in checkouts.js for recalls
MARC Authority data support
- [19693] Update of an authority record creates inconsistency when the heading tag is changed
- [31660] MARC preview for authority search results comes up empty
OPAC
- [31685] Article request count in table caption of opac-user missing
Patrons
- [31739] Password reset from staff fails if previous expired reset-entry exists
Sponsored by Lund University Library, Sweden
Plugin architecture
- [31684] Plugin versions starting with a “v” cause unnecessary warnings
Reports
- [28967] Patrons with no checkouts report shows patrons from other libraries with IndependentBranches
- [31594] Report results count of shown can be incorrect on last page
SIP2
- [31552] SIP2 option format_due_date not honored for AH field in item information response
Searching
- [15048] Genre/Form (655) searches fail on searches with $x ‘General subdivision’ subfield values
Searching – Elasticsearch
- [29048] Incorrect search for linked authority records from authority search result list in OPAC
- [29561] Remove blank facet for languages
This removes blank facets from search results when using Elasticsearch. Currently, this only seems to affect language fields, but could affect any facetable field that contains blank values.
Searching – Zebra
- [31532] Zebra search results including 880 with original script incorrect because of Bug 15187
Staff interface
- [18556] Message “Patron’s address in doubt” is confusing
System Administration
- [31619] Cannot select title when setting non-default value for OPACSuggestionMandatoryFields
This fixes the OPACSuggestionMandatoryFields system preference so that the title field is visible and marked as mandatory (in red).
- [31976] Incorrect default category selected by authorized values page
Templates
- [29671] Dropbox mode is unchecked after check in confirm on item with Materials specified
- [31412] Set focus for cursor to Name when adding a new SMTP server
- [31420] Managing funds: Labels of statistic fields overlap with pull downs
- [31559] Staff results page doesn’t always use up full available screen width
- [31653] jQuery upgrade broke search button hover effect
Test Suite
Tools
- [31595] Import patrons tool should not process extended attributes if no attributes are being imported
- [31609] JavaScript error on Additional contents main page
- [31644] MARCModification template fails to copy to/from subfield 0
Documentation
The Koha manual is maintained in Sphinx. The home page for Koha
documentation is
As of the date of these release notes, the Koha manual is available in the following languages:
- Arabic (28.2%)
- Chinese (Taiwan) (49.2%)
- English (USA)
- French (58.4%)
- German (61.3%)
- Hindi (100%)
- Italian (41.2%)
- Spanish (29.7%)
- Turkish (33.5%)
The Git repository for the Koha manual can be found at
Translations
Complete or near-complete translations of the OPAC and staff
interface are available in this release for the following languages:
- Arabic (77.9%)
- Armenian (100%)
- Armenian (Classical) (71.6%)
- Bulgarian (85.6%)
- Chinese (Taiwan) (90.4%)
- Czech (62.3%)
- English (New Zealand) (56.5%)
- English (USA)
- Finnish (94.8%)
- French (97.1%)
- French (Canada) (99.9%)
- German (100%)
- German (Switzerland) (54.1%)
- Greek (54.3%)
- Hindi (100%)
- Italian (100%)
- Nederlands-Nederland (Dutch-The Netherlands) (84.2%)
- Norwegian Bokmål (56%)
- Persian (58.7%)
- Polish (100%)
- Portuguese (79.3%)
- Portuguese (Brazil) (76.8%)
- Russian (78.4%)
- Slovak (63.9%)
- Spanish (100%)
- Swedish (78.6%)
- Telugu (84.6%)
- Turkish (92%)
- Ukrainian (74.2%)
Partial translations are available for various other languages.
The Koha team welcomes additional translations; please see
For information about translating Koha, and join the koha-translate
list to volunteer:
The most up-to-date translations can be found at:
Release Team
The release team for Koha 22.05.08 is
- Release Manager: Tomás Cohen Arazi
- Release Manager assistants:
- Jonathan Druart
- Martin Renvoize
- QA Manager: Katrin Fischer
- QA Team:
- Aleisha Amohia
- Nick Clemens
- David Cook
- Jonathan Druart
- Lucas Gass
- Victor Grousset
- Kyle M Hall
- Martin Renvoize
- Marcel de Rooy
- Fridolin Somers
- Topic Experts:
- UI Design — Owen Leonard
- Zebra — Fridolin Somers
- REST API — Martin Renvoize
- Bug Wranglers:
- Aleisha Amohia
- Indranil Das Gupta
- Packaging Manager:
- Documentation Manager: Caroline Cyr La Rose
- Documentation Team:
- Aude Charillon
- David Nind
- Lucy Vaux-Harvey
- Translation Managers:
- Bernardo González Kriegel
- Wiki curators:
- Thomas Dukleth
- Katrin Fischer
- Release Maintainers:
- 22.11 — PTFS Europe
- 22.05 — Lucas Gass
- 21.11 — Arthur Suzuki
- 21.05 — Wainui Witika-Park
Credits
We thank the following libraries, companies, and other institutions who are known to have sponsored
new features in Koha 22.05.08
- Catalyst
- Lund University Library, Sweden
We thank the following individuals who contributed patches to Koha 22.05.08
- Aleisha Amohia (2)
- Tomás Cohen Arazi (1)
- Kevin Carnes (1)
- Galen Charlton (1)
- Nick Clemens (17)
- David Cook (1)
- Jonathan Druart (3)
- Katrin Fischer (4)
- Lucas Gass (7)
- Isobel Graham (1)
- Kyle M Hall (9)
- Mason James (2)
- Janusz Kaczmarek (2)
- Owen Leonard (8)
- The Minh Luong (1)
- Julian Maurice (1)
- Björn Nylén (1)
- Martin Renvoize (5)
- Marcel de Rooy (15)
- Andreas Roussos (1)
- Fridolin Somers (4)
- Christophe Torin (1)
- Koha translators (1)
- Petro Vashchuk (1)
- Shi Yao Wang (1)
We thank the following libraries, companies, and other institutions who contributed
patches to Koha 22.05.08
- Athens County Public Libraries (8)
- BibLibre (5)
- Bibliotheksservice-Zentrum Baden-Württemberg (BSZ) (4)
- ByWater-Solutions (33)
- Catalyst Open Source Academy (2)
- Dataly Tech (1)
- Equinox Open Library Initiative (1)
- Independant Individuals (4)
- Koha Community Developers (3)
- KohaAloha (2)
- Prosentient Systems (1)
- PTFS-Europe (5)
- Rijksmuseum (15)
- Solutions inLibro inc (2)
- Theke Solutions (1)
- ub.lu.se (2)
- Université Rennes 2 (1)
We also especially thank the following individuals who tested patches
for Koha
- Tomás Cohen Arazi (77)
- Emmanuel Bétemps (1)
- Catrina (1)
- Nick Clemens (3)
- David Cook (4)
- Chris Cormack (3)
- Katrin Fischer (37)
- Andrew Fuerste-Henry (1)
- Lucas Gass (86)
- Géraud (1)
- Kyle M Hall (5)
- Barbara Johnson (3)
- Joonas Kylmälä (3)
- Owen Leonard (3)
- David Nind (35)
- Martin Renvoize (12)
- Marcel de Rooy (19)
- Caroline Cyr La Rose (2)
- Cab Vinton (1)
We regret any omissions. If a contributor has been inadvertently missed,
please send a patch against these release notes to koha-devel@lists.koha-community.org.
Revision control notes
The Koha project uses Git for version control. The current development
version of Koha can be retrieved by checking out the master branch of:
The branch for this version of Koha and future bugfixes in this release
line is security-22.05.x-security.
Bugs and feature requests
Bug reports and feature requests can be filed at the Koha bug
tracker at:
He rau ringa e oti ai.
(Many hands finish the work)
Autogenerated release notes updated last on 22 Dec 2022 18:15:12.