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
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
Documentation
Other bugs fixed
- 33790 Fix and add various links to the manual
ERM
Other bugs fixed
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
- 33727 Merge Calendar tests
- 33852 jobs.t is not testing only_current
Critical bugs fixed
- 34288 Cannot use cataloguing tools without cataloguing permissions
Other bugs fixed
Enhancements
Architecture, internals, and plumbing
Enhancements
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
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:
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-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 28 Jul 2023 11:16:16.