misc/release_notes/release_notes_22_05_01.md

   1 # RELEASE NOTES FOR KOHA 22.05.01
   2 27 Jun 2022
   3
   4 Koha is the first free and open source software library automation
   5 package (ILS). Development is sponsored by libraries of varying types
   6 and sizes, volunteers, and support companies from around the world. The
   7 website for the Koha project is:
   8
   9 - [Koha Community](http://koha-community.org)
  10
  11 Koha 22.05.01 can be downloaded from:
  12
  13 - [Download](http://download.koha-community.org/koha-22.05.01.tar.gz)
  14
  15 Installation instructions can be found at:
  16
  17 - [Koha Wiki](http://wiki.koha-community.org/wiki/Installation_Documentation)
  18 - OR in the INSTALL files that come in the tarball
  19
  20 Koha 22.05.01 is a bugfix/maintenance release.
  21
  22 It includes 5 enhancements, 48 bugfixes.
  23
  24 ### System requirements
  25
  26 You can learn about the system components (like OS and database) needed for running Koha here: https://wiki.koha-community.org/wiki/System_requirements_and_recommendations
  27
  28
  29
  30
  31 ## Enhancements
  32
  33 ### Architecture, internals, and plumbing
  34
  35 - [[29883]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=29883) Uninitialized value warning when GetAuthorisedValues gets called with no parameters
  36 - [[30830]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30830) Add Koha Objects  for Koha Import Items
  37
  38 ### I18N/L10N
  39
  40 - [[30733]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30733) Simplify translatable strings
  41
  42   >Cleanup of translatable text done by guiding the string extractor to make it do simpler strings for translators instead of large concatenation of long strings in the code with a lot of unnecessary %s placeholders.
  43
  44 ### Templates
  45
  46 - [[30523]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30523) Quiet console warning about missing shortcut-buttons map file
  47 - [[30786]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30786) Capitalization in (Opac)AdvancedSearchTypes
  48
  49   >This fixes the descriptions for the AdvancedSearchTypes and OpacAdvancedSearchTypes system preferences - sentence case is now used for "..Shelving location..".
  50
  51
  52 ## Critical bugs fixed
  53
  54 ### Architecture, internals, and plumbing
  55
  56 - [[30876]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30876) recalls/recalls_to_pull.pl introduces an incorrect use of ->search in list context
  57
  58 ### Cataloging
  59
  60 - [[30234]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30234) Serial local covers don't appear in the staff interface for other libraries with SeparateHoldings
  61
  62   >This fixes the display of item-specific local cover images in the staff interface. Before this, item images were not shown for holdings on the record's details view page.
  63
  64 ### Circulation
  65
  66 - [[30885]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30885) Recall - detail page explosion
  67
  68   **Sponsored by** *Catalyst*
  69 - [[30886]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30886) Recall status cannot be correct on OPAC detail page
  70
  71   **Sponsored by** *Catalyst*
  72 - [[30907]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30907) Remaining incorrect uses of Koha::Recall->item_level_recall
  73 - [[30971]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30971) Recalls - log viewer error
  74
  75   >This fixes an error that occurred when viewing recalls log entries. The error was caused by the renaming of itemnumber, biblionumber, and branchcode attributes.
  76
  77 ### Command-line Utilities
  78
  79 - [[29325]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=29325) commit_file.pl error 'Already in a transaction'
  80
  81   >This fixes the command line script misc/commit_file.pl and manage staged MARC records tool in the staff interface so that imported records are processed.
  82   >
  83   >The error message from The command line script was failing with this error message "DBIx::Class::Storage::DBI::_exec_txn_begin(): DBI Exception: DBD::mysql::db begin_work failed: Already in a transaction at /kohadevbox/koha/C4/Biblio.pm line 303". In the staff interface, the processing of staged records would fail without any error messages.
  84
  85 ### Database
  86
  87 - [[30899]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30899) Upgrade sometimes fails at "Upgrade to 21.11.05.004"
  88
  89   >This database revision fixes the one from bug 30449 for table borrower_attribute_types.
  90 - [[30912]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30912) Database update fails for 21.12.00.016 Bug 30060
  91
  92 ### Hold requests
  93
  94 - [[30742]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30742) Confusion when placing hold on record with no items available because of not for loan
  95 - [[30892]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30892) Holds not getting placed
  96 - [[30960]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30960) Koha lets you place item-level holds without a pick-up place
  97
  98 ### Patrons
  99
 100 - [[30868]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30868) Modifying a patron - page not found error after fixing validation errors where the message is displayed at the top of the page
 101
 102   >This fixes a page not found error message generated after fixing validation errors when editing a patron (where the validation/error message is shown at the top of the page - below the patron name, but before the Save and Cancel buttons). (This was introduced by bug 29684: Fix warn about js/locale_data.js in 22.05.)
 103 - [[31005]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=31005) Cannot edit patrons in other categories if an extended attribute is mandatory and limited to a category
 104
 105   >This fixes an error when a mandatory patron attribute limited to a specific patron category was causing a '500 error' when editing a patron not in that category.
 106
 107 ### Searching - Elasticsearch
 108
 109 - [[30883]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30883) Authorities merge is limited to 100 biblio with Elasticsearch
 110
 111   >This fixes the hard-coded limit of 100 when merging authorities (when Elasticsearch is the search engine). When merging authorities where the term is used over 100 times, only the first 100 authorities would be merged and the old term deleted, irrespective of the value set in the AuthorityMergeLimit system preference.
 112
 113 ### Tools
 114
 115 - [[29828]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=29828) If no content is added to default, but a translation, news/additional content entries don't show in list
 116 - [[30831]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30831) Add unit test for BatchCommitItems
 117 - [[30884]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30884) Incomplete replace of jQuery UI tabs in batch patron modification breaks the form sending
 118 - [[30972]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30972) "Replace existing covers" checkbox replaces ALL local covers for a biblio, not only the specific item's covers
 119
 120
 121 ## Other bugs fixed
 122
 123 ### Acquisitions
 124
 125 - [[29961]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=29961) Horizontal scroll bar in acquisition z39.50 search should always show
 126
 127 ### Architecture, internals, and plumbing
 128
 129 - [[30731]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30731) Noise from about script coming from Test::MockTime (or other CPAN modules)
 130
 131 ### Authentication
 132
 133 - [[30842]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30842) Two-factor  authentication code should be valid longer
 134
 135   >This extends the time a two-factor authentication code is valid for, in case it is not entered quickly enough. (Example: wait for the code to change, then enter the previous code - this should still work, but will not work when the code changes again.)
 136
 137 ### Circulation
 138
 139 - [[30337]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30337) Holds to Pull ( pendingreserves.pl ) ignores holds if priority 1 hold is suspended
 140
 141 ### Command-line Utilities
 142
 143 - [[30781]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30781) Use of uninitialized value $val in substitution iterator at /usr/share/koha/lib/C4/Letters.pm line 665.
 144 - [[30788]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30788) Argument "" isn't numeric in multiplication (*) at /usr/share/koha/lib/C4/Overdues.pm
 145 - [[30893]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30893) Typo: update_patrons_category.pl fine(s)
 146
 147   >This updates the help text for the update patrons category cronjob script (misc/cronjobs/update_patrons_category.pl). It changes the full option names and associated information for -fo (--fineover to --finesover) and -fu (--fineunder to --finesunder), as well as some minor formatting and text tidy ups.
 148
 149 ### Course reserves
 150
 151 - [[30840]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30840) Add support for barcode filters to course reserves
 152
 153 ### Hold requests
 154
 155 - [[23659]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=23659) Allow hold pickup location to default to item home branch for item-level holds
 156
 157   >This patch adds a new system preference 'DefaultHoldPickupLocation'
 158   >
 159   >This preference will allow the library to determine which library is the default for pickup location dropdowns while placing holds in the staff client. The options are logged in library, homebranch, or holdingbranch
 160   >
 161   >Previously the behavior was inconsistent, and varied between versions. Libraries may need to adjust this preference after upgrade to mirror their expected workflow
 162 - [[28529]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28529) Item type-constrained biblio-level holds should honour max_holds as item-level do
 163 - [[30828]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30828) Remove unused variable in placerequest.pl
 164
 165 ### OPAC
 166
 167 - [[30746]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30746) JS error on 'your personal details' in OPAC
 168 - [[30844]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30844) The OPAC detail page's browser is limited to the current page of results when using Elasticsearch
 169
 170   **Sponsored by** *Lund University Library*
 171
 172 ### REST API
 173
 174 - [[30853]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30853) Missing description for 'baskets' in swagger.yaml
 175 - [[30854]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30854) Missing description for 'import_record_matches' in swagger.yaml
 176 - [[30855]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30855) Rename /import => /import_batches
 177
 178 ### Searching
 179
 180 - [[27697]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=27697) Opening bibliographic record page prepopulates search bar text
 181
 182 ### Searching - Zebra
 183
 184 - [[30528]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30528) Limits are not correctly parsed when query contains CCL
 185
 186 ### Staff Client
 187
 188 - [[28723]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28723) Holds table not displayed when it contains a biblio without title
 189
 190 ### System Administration
 191
 192 - [[30862]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30862) Typo: langues
 193
 194 ### Templates
 195
 196 - [[30629]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30629) <span> in title of patron card creator template needs to be removed
 197
 198   >This removes <span> tags incorrectly displaying in browser page titles for some pages in the staff interface (Tools > Patron card creator > Layouts; Tools > Label creator > Manage > Label batches; Administration > Budgets administration > select a budget > Plan by ...).
 199 - [[30726]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30726) Flatpickr's "yesterday" shortcut doesn't work if entry is limited to past dates
 200 - [[30761]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30761) Typo: PLease
 201 - [[30772]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30772) Terminology: Replace instances of "reserve" with "hold"
 202 - [[30774]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30774) Typo: i %sEdit %sReserve %s
 203
 204 ### Test Suite
 205
 206 - [[29860]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=29860) Useless warnings in regressions.t
 207 - [[30756]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30756) Get skip block out of Koha_Authority.t and add TestBuilder
 208 - [[30870]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30870) Don't skip tests if Test::Deep is not installed
 209
 210 ### Tools
 211
 212 - [[28152]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28152) Hidden error when importing an item with an existing itemnumber
 213
 214 ## New system preferences
 215 - DefaultHoldPickupLocation
 216
 217
 218
 219 ## Documentation
 220
 221 The Koha manual is maintained in Sphinx. The home page for Koha
 222 documentation is
 223
 224 - [Koha Documentation](http://koha-community.org/documentation/)
 225
 226
 227
 228 The Git repository for the Koha manual can be found at
 229
 230 - [Koha Git Repository](https://gitlab.com/koha-community/koha-manual)
 231
 232
 233 ## Translations
 234
 235 Complete or near-complete translations of the OPAC and staff
 236 interface are available in this release for the following languages:
 237
 238 - Arabic (78.7%)
 239 - Armenian (100%)
 240 - Armenian (Classical) (71.6%)
 241 - Bulgarian (82.7%)
 242 - Chinese (Taiwan) (79.9%)
 243 - Czech (62.6%)
 244 - English (New Zealand) (56.7%)
 245 - English (USA)
 246 - Finnish (95.7%)
 247 - French (96.4%)
 248 - French (Canada) (86.2%)
 249 - German (100%)
 250 - German (Switzerland) (54.7%)
 251 - Greek (53.5%)
 252 - Hindi (90.9%)
 253 - Italian (91.7%)
 254 - Nederlands-Nederland (Dutch-The Netherlands) (79.5%)
 255 - Norwegian Bokmål (56%)
 256 - Polish (87.9%)
 257 - Portuguese (80.1%)
 258 - Portuguese (Brazil) (76.9%)
 259 - Russian (78.2%)
 260 - Slovak (64.3%)
 261 - Spanish (98.3%)
 262 - Swedish (77%)
 263 - Telugu (85.6%)
 264 - Turkish (90.3%)
 265 - Ukrainian (68.5%)
 266
 267 Partial translations are available for various other languages.
 268
 269 The Koha team welcomes additional translations; please see
 270
 271 - [Koha Translation Info](http://wiki.koha-community.org/wiki/Translating_Koha)
 272
 273 For information about translating Koha, and join the koha-translate
 274 list to volunteer:
 275
 276 - [Koha Translate List](http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-translate)
 277
 278 The most up-to-date translations can be found at:
 279
 280 - [Koha Translation](http://translate.koha-community.org/)
 281
 282 ## Release Team
 283
 284 The release team for Koha 22.05.01 is
 285
 286
 287 - Release Manager:
 288
 289 ## Credits
 290 We thank the following libraries, companies, and other institutions who are known to have sponsored
 291 new features in Koha 22.05.01
 292
 293 - [Catalyst](https://www.catalyst.net.nz/products/library-management-koha)
 294 - Lund University Library
 295
 296 We thank the following individuals who contributed patches to Koha 22.05.01
 297
 298 - Aleisha Amohia (2)
 299 - Tomás Cohen Arazi (17)
 300 - Kevin Carnes (2)
 301 - Nick Clemens (14)
 302 - Jonathan Druart (12)
 303 - Katrin Fischer (2)
 304 - Lucas Gass (3)
 305 - Victor Grousset (2)
 306 - Kyle M Hall (1)
 307 - Joonas Kylmälä (1)
 308 - Owen Leonard (4)
 309 - Julian Maurice (2)
 310 - David Nind (2)
 311 - Marcel de Rooy (7)
 312 - Caroline Cyr La Rose (1)
 313 - Slava Shishkin (1)
 314 - Fridolin Somers (3)
 315 - Koha translators (1)
 316 - Petro Vashchuk (2)
 317
 318 We thank the following libraries, companies, and other institutions who contributed
 319 patches to Koha 22.05.01
 320
 321 - Athens County Public Libraries (4)
 322 - BibLibre (5)
 323 - Bibliotheksservice-Zentrum Baden-Württemberg (BSZ) (2)
 324 - ByWater-Solutions (18)
 325 - Catalyst Open Source Academy (2)
 326 - David Nind (2)
 327 - Independant Individuals (4)
 328 - Koha Community Developers (14)
 329 - Rijksmuseum (7)
 330 - Solutions inLibro inc (1)
 331 - Theke Solutions (17)
 332 - ub.lu.se (2)
 333
 334 We also especially thank the following individuals who tested patches
 335 for Koha
 336
 337 - Tomás Cohen Arazi (58)
 338 - Nick Clemens (10)
 339 - Paul Derscheid (1)
 340 - Jonathan Druart (13)
 341 - Katrin Fischer (16)
 342 - Andrew Fuerste-Henry (1)
 343 - Lucas Gass (78)
 344 - Victor Grousset (5)
 345 - Sally Healey (1)
 346 - Joonas Kylmälä (8)
 347 - David Nind (45)
 348 - Martin Renvoize (29)
 349 - Jason Robb (1)
 350 - Marcel de Rooy (6)
 351 - Caroline Cyr La Rose (1)
 352 - Fridolin Somers (2)
 353
 354
 355
 356 We regret any omissions.  If a contributor has been inadvertently missed,
 357 please send a patch against these release notes to koha-devel@lists.koha-community.org.
 358
 359 ## Revision control notes
 360
 361 The Koha project uses Git for version control.  The current development
 362 version of Koha can be retrieved by checking out the master branch of:
 363
 364 - [Koha Git Repository](https://git.koha-community.org/koha-community/koha)
 365
 366 The branch for this version of Koha and future bugfixes in this release
 367 line is rmain2205.
 368
 369 ## Bugs and feature requests
 370
 371 Bug reports and feature requests can be filed at the Koha bug
 372 tracker at:
 373
 374 - [Koha Bugzilla](http://bugs.koha-community.org)
 375
 376 He rau ringa e oti ai.
 377 (Many hands finish the work)
 378
 379 Autogenerated release notes updated last on 27 Jun 2022 15:28:28.