Koha 22.11.08 released
RELEASE NOTES FOR KOHA 22.11.08
28 Jul 2023
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.11.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.11.08 is a bugfix/maintenance release.
It includes 8 enhancements, 121 bugfixes.
System requirements
You can learn about the system components (like OS and database) needed for running Koha on the community wiki.
Security bugs
- 22990 Add CSRF protection to boraccount, pay, suggestions and virtualshelves on staff
- 30524 Add base framework for dealing with CSRF in Koha
- 34023 HTML injection in “back to results” link from search page
- 34368 Add CSRF protection to Content Management pages
Bugfixes
About
Other bugs fixed
- 33899 Release team 23.11
Acquisitions
Critical bugs fixed
- 33993 The GET orders endpoint needs to allow users with order_receive permission
- 34080 Updating suggestion status can result in 500 error
Other bugs fixed
- 33939 JavaScript needs to distinguish between order budgets and default budgets when adding to staged file form a basket
- 34002 Check for stage_marc_import permission when adding to basket from a new file
- 34261 Deleting an EDIFACT ordering account throws an error
Architecture, internals, and plumbing
Critical bugs fixed
- 32894 Objects cache methods’ result without invalidation
- 33270 OAI-PMH should not die on record errors
Other bugs fixed
- 18855 Fines cronjob can cause duplicate fines if run during active circulation
- 24517 Zebra: date-entered-on-file misses 6th position
This patch fixes the date-entered-on-file index so that it correctly uses all 6 characters instead of the 5 character it has used the last 11 years.
Note: For this patch to have effect, Zebra must be re-indexed.
- 30002 Add project-level perltidyrc
- 30649 Vendor EDI account passwords should be encrypted in the database
- 33047 Local cover image fetchers return 500 internal error when image not available
- 33167 Cleanup staff interface catalog details page
- 33496 Add ‘host_items’ param to Koha::Biblio->items
- 33500 Failing test for t/db_dependent/Circulation.t when RecordLocalUseOnReturn is set to record
- 33844 item->is_denied_renewal should check column from associated pref
- 33937 Incorrect export in C4::Members
- 33950 Unnecessary processing in opac-readingrec if BakerTaylor and Syndetics off
- 33951 normalized_oclc not defined in opac-readingrecord.tt
- 33967 REMOTE_ADDR incorrect in plack.log when run behind a proxy
- 34033 DB update problems from bug 30649
- 34051 Koha::AuthorisedValues->get_description_by_koha_field not caching results for non-existent values
- 34243 Too many cities are created (at least in comments)
- 34303 t/00-testcritic.t should only test files part of git repo
Authentication
Critical bugs fixed
- 33880 “Enable two-factor authentication” fails if patron’s library branchname is too long
- 33904 2FA registration fails if library name has non-latin characters
Other bugs fixed
- 31651 Log message incorrect in Auth_with_shibboleth.pm
- 33879 check_cookie_auth overwrites interface set by get_template_and_user
This fixes an issue with recording the interface for the log viewer where installations run the OPAC and staff interface on the same domain name. Before this patch, if a user logged into the OPAC and then went to the staff interface and performed a logable action (such as a checkout), the interface in the log was incorrectly recorded as the OPAC.
Cataloging
Critical bugs fixed
- 34146 How to limit number of copies (on additem and serials-edit)?
- 34218 XSLT parse on record directly breaks OPAC display
Other bugs fixed
- 34029 Import breaks when data exceeds size of mapped database columns
- 34097 Using the three ellipses to set the date accessioned for an item repositions the screen to the top
- 34182 AddBiblio shouldn’t set biblio.serial based on biblio.seriestitle
- 34251 MARC editor with JS error when using fast add framework
Circulation
Critical bugs fixed
- 33888 Overdues with fines report displays error 500
This fixes the ‘Circulation > Overdues > Overdues with fines’ listing so that it lists overdue items where there are fines, instead of generating an error.
Other bugs fixed
- 31082 Add tooltip to buttons when item bundles cannot be changed while checked out
-
31147 Recalls due date to the minute rather than 23:59
Sponsored by Catalyst
The current recalls behaviour adjusts the due date of the most appropriate checkout based on the ‘recall due date interval’ circulation rule. It also adjusts the due time, which is buggy behaviour. The due date should be adjusted based on the circulation rule, but the due time should remain the same.
- 33806 Overridden checkin date not retained when CircConfirmItemParts enabled
- 33817 Composition of an item bundle can be changed if checked out
- 33858 Date for pending offline circulation is unformatted
- 33944 When listing checkouts, don’t fetch item object if not using recalls
- 33976 Claims returned option is not disabled in moredetail.pl if the item has a different lost status
- 34071 Change the phrasing of ‘automatic checkin’ to fit consistent terminology
- 34072 Holds queue search interface hidden on small screens
- 34086 On detail.tt if item.permanent_location is NULL no shelving location will show
- 34232 Item groups dropdown on add item form does not respect display order
Documentation
Other bugs fixed
- 33790 Fix and add various links to the manual
ERM
Other bugs fixed
- 33941 EBSCO Packages filter failing
- 33973 Sorting broken on ERM tables
- 34107 Sorting agreements by Name actually sorts by ID
- 34201 Missing sorting indicator on the ERM tables
-
34214 Toolbar component should make the icon configurable
Sponsored by Bibliothèque Universitaire des Langues et Civilisations (BULAC)
Hold requests
Critical bugs fixed
- 34233 Pickup location pulldowns when placing holds in staff are blank
Other bugs fixed
- 33573 Add public endpoint for cancelling holds
- 34137 Requested cancellation date column missing from holds awaiting pickup table config
ILL
Critical bugs fixed
- 34130 ILL requests table won’t load if request_placed date is null
Installation and upgrade (web-based installer)
Critical bugs fixed
- 33671 Database update 22.06.00.048 breaks update process
Other bugs fixed
- 33581 Error in web installer concerning sample holidays and patrons requiring sample libraries
Label/patron card printing
Other bugs fixed
- 34209 Follow up on Bug 28726 – move whole search header div into checkbox column condition
MARC Authority data support
Critical bugs fixed
- 33404 Authorities imported from Z39.50 in encodings other than UTF-8 are corrupted
Other bugs fixed
- 34180 Template variable in JavaScript triggers error when showing authority MARC preview
MARC Bibliographic data support
Other bugs fixed
- 26862 MARC21 530 is missing from staff interface and has no label
This fixes the display of the MARC21 530 tag and subfields so that it:
– now displays in the staff interface (was missing)
– improves the display of the values by adding
. a description/label
. separators between repeated 530 tags
. missing spaces before $u and between repeated $u subfields - 31618 Typo in POD for C4::ImportBatch::RecordsFromMARCXMLFile
Notices
Other bugs fixed
- 33900 advance_notices.pl cronjob hangs
OPAC
Critical bugs fixed
- 34174 Saving RIS results to Error 505
Other bugs fixed
- 32341 Some OPAC tables are not displayed well in mobile mode
- 33933 Use restrictions appear twice for items on OPAC
- 33957 normalized_oclc not defined in opac-user.tt
- 34005 Toggling the search term highlighting is not always working in the bibliographic record details page
- 34015 Terminology: Relative issues should be Relative’s checkouts
Packaging
Other bugs fixed
- 33720 updatedatabase.pl should purge memcached
Patrons
Critical bugs fixed
- 34106 Patron search in member-search-box.inc always defaults to ‘Starts with’ search
Other bugs fixed
- 33117 Patron checkout search not working if searching with second surname
- 33176 Improve enforcing of RequirePaymentType
- 33968 Two colons missing on guarantor labels in memberentry.pl form
- 34083 Patron auto-complete fails if organization patron full name is in a single field separated by a space
- 34092 patron-autocomplete.js and patron-search.inc search logic should match
- 34256 Patron search: search for borrowernumber starts with fails
REST API
Critical bugs fixed
- 32801 /checkouts?checked_in=1 errors when itemnumber is null
Reports
Other bugs fixed
- 27824 Report batch operations break with space in placeholder
- 29664 Do not show voided payments in cash register statistics wizard
Searching
Other bugs fixed
- 28196 In page anchors on additem.pl don’t always go to the right place
- 31253 Item search in staff interface should call barcodedecode if the search index is a barcode
- 33896 Catalog search from the masthead searchbar produces a warning in the logs
Serials
Other bugs fixed
- 23775 Claiming a serial issue doesn’t create the next one
- 33901 Only one issue shown when testing prediction pattern
- 34052 Fix link to subscription from serial collection page
Staff interface
Other bugs fixed
- 32245 Deleting news entries from Koha’s staff start page is broken
- 33497 Reduce DB calls on staff detail page
- 33946 biblio-title.inc should not add a link if biblio does not exist
- 34094 Apply DefaultPatronSearchMethod to all patron search forms
- 34116 Add page-sectioning to item search in label creator
- 34131 Plugins page breadcrumbs and side menu not consistent
System Administration
Other bugs fixed
- 33578 Cannot edit patron restriction types
Templates
Other bugs fixed
- 33781 Terminology: Item already issued to other borrower.
- 33855 Clean up forms and page sections on ‘manage MARC imports’ page
This enhancement makes minor changes to the structure of the “Manage staged MARC records” page for a batch so that sections are more clearly delineated and forms have the correct structure. It also shortens the new framework field labels and adds hints for clarification.
- 33893 Use template wrapper for tabs: OPAC checkout history
- 33894 Use template wrapper for tabs: OPAC search history
- 33897 Use template wrapper for tabs: OPAC bibliographic detail page
- 33999 Subscription details link on bibliographic detail page should have permission check
- 34010 Template corrections to recall pages
- 34012 Use template wrapper for tabs: Recalls awaiting pickup
- 34013 Recalls awaiting pickup doesn’t show count on each tab
- 34074 Improve translations of strings on the about page
- 34103 Capitalization: Currencies & Exchange rates
- 34184 “Document type” in suggestions form should have an empty entry
- 34244 Improve contrast in staff interface main page layered icons
Test Suite
Other bugs fixed
Tools
Critical bugs fixed
- 34288 Cannot use cataloguing tools without cataloguing permissions
Other bugs fixed
- 29762 Patron batch modification tool – mobile phone number column naming
-
33667 ‘Copy to all libraries’ doesn’t work on editing holidays
Sponsored by Koha-Suomi Oy
- 33972 Remove unnecessary batch status change in C4::ImportBatch
- 33987 Combine multiple db updates in C4::ImportBatch::BatchCommitRecords for efficiency/avoiding possible deadlocks
- 33989 Inventory tool performs unnecessary authorized value lookups
- 34220 Running log viewer for only Catalog module loads wrong side navbar
Enhancements
Architecture, internals, and plumbing
Enhancements
-
32478 Remove Koha::Config::SysPref->find since bypasses cache
Sponsored by Gothenburg University Library
ERM
Enhancements
- 33417 Create one standard Toolbar component
- 34206 [22.11] Vendor options do not show on agreements and licenses form
Label/patron card printing
Enhancements
- 28726 Add sort1 and sort2 to patron card creator patron search
MARC Bibliographic data support
Enhancements
- 29471 MARC21: 520 – Summary etc. doesn’t display in staff interface
OPAC
Enhancements
- 33808 Accessibility: Non-descriptive links
REST API
Enhancements
- 33974 Add ability to search biblios endpoint any biblioitem attribute
- 34211 Add +strings for GET /api/v1/biblios/:biblio_id/items
New system preferences
- DefaultPatronSearchMethod
Documentation
The Koha manual is maintained in Sphinx. The home page for Koha
documentation is
-
Koha Documentation
As of the date of these release notes, the Koha manual is available in the following languages: -
Chinese (Taiwan) (71.5%)
- English (USA)
- French (53.4%)
- German (53%)
- Hindi (76.8%)
- Italian (32.2%)
- Turkish (26.2%)
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 (71.8%)
– Armenian (100%)
– Armenian (Classical) (64.6%)
– Bulgarian (90.7%)
– Chinese (Taiwan) (81.4%)
– Czech (62.2%)
– English (New Zealand) (68.2%)
– English (USA)
– English (United Kingdom) (99.6%)
– Finnish (96.1%)
– French (99.8%)
– French (Canada) (95.5%)
– German (100%)
– German (Switzerland) (50.2%)
– Greek (50.7%)
– Hindi (100%)
– Italian (91.7%)
– Nederlands-Nederland (Dutch-The Netherlands) (89%)
– Norwegian Bokmål (64.8%)
– Persian (70.2%)
– Polish (98.3%)
– Portuguese (89.2%)
– Portuguese (Brazil) (99.7%)
– Russian (93.4%)
– Slovak (61.8%)
– Spanish (99.7%)
– Swedish (77.9%)
– Telugu (77%)
– Turkish (87.1%)
– Ukrainian (77.9%)
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.11.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
- Andrii Nugged
- Martin Renvoize
- Marcel de Rooy
- Petro Vashchuk
-
Topic Experts:
- UI Design — Owen Leonard
- Zebra — Fridolin Somers
- REST API — Martin Renvoize
- ERM — Pedro Amorim
- ILL — Pedro Amorim
-
Bug Wranglers:
- Aleisha Amohia
-
Packaging Manager: Mason James
-
Documentation Manager: Aude Charillon
-
Documentation Team:
- Caroline Cyr La Rose
- Lucy Vaux-Harvey
-
Translation Manager: Bernardo González Kriegel
-
Wiki curators:
- Thomas Dukleth
- Katrin Fischer
-
Release Maintainers:
- 23.05 — Fridolin Somers
- 22.11 — PTFS Europe (Matt Blenkinsop, Pedro Amorim)
- 22.05 — Lucas Gass
- 21.11 — Danyon Sewell
-
Release Maintainer assistants:
- 21.11 — Wainui Witika-Park
Credits
We thank the following libraries, companies, and other institutions who are known to have sponsored
new features in Koha 22.11.08
– [Bibliothèque Universitaire des Langues et Civilisations (BULAC)](http://www.bulac.fr)
– [Catalyst](https://www.catalyst.net.nz/products/library-management-koha)
– Gothenburg University Library
– [Koha-Suomi Oy](https://koha-suomi.fi)
We thank the following individuals who contributed patches to Koha 22.11.08
– Aleisha Amohia (1)
– Pedro Amorim (14)
– Tomás Cohen Arazi (21)
– Matt Blenkinsop (25)
– Jérémy Breuillard (1)
– Nick Clemens (19)
– David Cook (9)
– Jake Deery (2)
– Jonathan Druart (37)
– Laura Escamilla (1)
– Katrin Fischer (10)
– Lucas Gass (12)
– Victor Grousset (1)
– Thibaud Guillot (1)
– Amit Gupta (1)
– David Gustafsson (3)
– Michał Górny (1)
– Michael Hafen (3)
– Kyle M Hall (5)
– Jan Kissig (1)
– Emily Lamancusa (1)
– Sam Lau (2)
– Owen Leonard (18)
– Julian Maurice (2)
– Jacob O’Mara (1)
– Philip Orr (1)
– Martin Renvoize (16)
– Phil Ringnalda (3)
– Marcel de Rooy (25)
– Caroline Cyr La Rose (2)
– Andreas Roussos (1)
– Emmi Takkinen (1)
– Koha translators (1)
– Hammat Wele (5)
We thank the following libraries, companies, and other institutions who contributed
patches to Koha 22.11.08
– Athens County Public Libraries (18)
– BibLibre (4)
– Bibliotheksservice-Zentrum Baden-Württemberg (BSZ) (10)
– ByWater-Solutions (37)
– Catalyst Open Source Academy (1)
– Chetco Community Public Library (3)
– Dataly Tech (1)
– gentoo.org (1)
– Göteborgs Universitet (3)
– Independant Individuals (6)
– Informatics Publishing Ltd (1)
– Koha Community Developers (38)
– Koha-Suomi (1)
– lmscloud.de (1)
– montgomerycountymd.gov (1)
– Prosentient Systems (9)
– PTFS-Europe (57)
– Rijksmuseum (25)
– Solutions inLibro inc (7)
– th-wildau.de (1)
– Theke Solutions (21)
We also especially thank the following individuals who tested patches
for Koha
– AlexanderBlanchardAC (1)
– Pedro Amorim (62)
– Tomás Cohen Arazi (202)
– Alexander Blanchard (2)
– Matt Blenkinsop (163)
– Univ Brest (1)
– Nick Clemens (24)
– David Cook (10)
– Paul Derscheid (4)
– Jonathan Druart (26)
– Sharon Dugdale (1)
– ebal (1)
– Katrin Fischer (70)
– Andrew Fuerste-Henry (4)
– Lucas Gass (9)
– Victor Grousset (2)
– Kyle M Hall (10)
– Sally Healey (1)
– Heather Hernandez (1)
– Emily Lamancusa (3)
– Sam Lau (41)
– Owen Leonard (15)
– Solene Ngamga (1)
– David Nind (17)
– Björn Nylén (2)
– Quinn (1)
– Martin Renvoize (245)
– Phil Ringnalda (2)
– Marcel de Rooy (38)
– Caroline Cyr La Rose (1)
– Michaela Sieber (3)
– Fridolin Somers (13)
– Ed Veal (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 22.11.x.
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 28 Jul 2023 11:16:16.