misc/release_notes/release_notes_21_05_01.md

   1 # RELEASE NOTES FOR KOHA 21.05.01
   2 24 Jun 2021
   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 21.05.01 can be downloaded from:
  12
  13 - [Download](http://download.koha-community.org/koha-21.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 21.05.01 is a bugfix/maintenance release.
  21
  22 It includes 2 enhancements, 23 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 - [[28519]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28519) Add a 2nd directory for Perl modules
  36
  37 ### REST API
  38
  39 - [[27931]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=27931) Add GET /items/:item_id/pickup_locations
  40
  41   >This development adds routes for fetching an item's valid pickup location list.
  42
  43
  44 ## Critical bugs fixed
  45
  46 ### Architecture, internals, and plumbing
  47
  48 - [[24434]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=24434) C4::Circulation::updateWrongTransfer is never called but should be
  49
  50 ### Authentication
  51
  52 - [[28489]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28489) CGI::Session is incorrectly serialized to DB in production env / when strict_sql_modes = 0
  53
  54 ### Circulation
  55
  56 - [[28538]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28538) Regression - Date of birth entered without correct format causes internal server error
  57
  58 ### Fines and fees
  59
  60 - [[28482]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28482) Floating point math prevents items from being returned
  61
  62 ### Hold requests
  63
  64 - [[28338]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28338) Validate item holdability and pickup location separately
  65 - [[28496]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28496) Club holds form broken
  66
  67   >This fixes the libraries shown in the 'Pickup at' dropdown list when placing a club hold so that it shows all libraries, instead of just the currently logged in library.
  68 - [[28503]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28503) When ReservesControlBranch = "patron's home library" and Hold policy = "From home library" all holds are allowed
  69 - [[28520]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28520) Cancelling a hold that is in transit hides item's transit status
  70
  71 ### Notices
  72
  73 - [[28487]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28487) Overdue_notices does not fall back to default language
  74
  75   >Previously overdue notices exclusively used the default language, but bug 26420 changed this to the opposite - to exclusively use the language chosen by the patron.
  76   >
  77   >However, if there is no translation for the overdue notice for the language chosen by the patron then no message is sent.
  78   >
  79   >This fixes this so that if there is no translation of the overdue notice for the language chosen by the patron, then the default language notice is used.
  80
  81 ### OPAC
  82
  83 - [[28600]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28600) Variable "$patron" is not available
  84
  85 ### Packaging
  86
  87 - [[28616]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28616) Remove Data::Printer dependency
  88
  89 ### Patrons
  90
  91 - [[28490]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28490) Cannot modify patrons in some categories (e.g. Child category)
  92
  93 ### REST API
  94
  95 - [[28586]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28586) Cannot resolve a claim
  96
  97   >This fixes an issue with the 'Returned claims' feature (enabled by setting a value for ClaimReturnedLostValue)- resolving returned claims now works as expected.
  98   >
  99   >Before this fix, an attempt to resolve a claim resulted in the page hanging and the claim not being able to be resolved.
 100
 101
 102 ## Other bugs fixed
 103
 104 ### Cataloging
 105
 106 - [[28171]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28171) Serial enumeration / chronology sorting is broken in biblio page
 107 - [[28204]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28204) Table highlighting is broken at the cataloguing/additem.pl
 108 - [[28383]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28383) Log in via the itemsearch URL leads to Internal Server Error
 109
 110   >When trying to access the item search form in the staff interface (/cgi-bin/koha/catalogue/itemsearch.pl) when not logged in, an internal server error (error code 500) is received after entering your login details. This fixes the problem so that the item search form is displayed as expected.
 111
 112 ### Circulation
 113
 114 - [[27064]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=27064) Transferring an item with a hold allows the user to set a hold waiting without transferring to the correct branch
 115 - [[28382]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28382) 'Reserve' should be passed through as transfer reason appropriately in branchtransfers
 116
 117 ### OPAC
 118
 119 - [[28518]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28518) "Return to the last advanced search" exclude keywords if more than 3
 120
 121 ### Patrons
 122
 123 - [[28350]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28350) Sort by "circ note" is broken on the patron search result view
 124
 125   >This fixes the patron search result page so that the results can be sorted using the 'Circ note' column. Before this fix you could not sort the results by this column.
 126
 127 ### Self checkout
 128
 129 - [[28488]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28488) Javascript error in self-checkout (__ is not defined)
 130
 131 ### Staff Client
 132
 133 - [[28467]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28467) Add wording to TrackLastPatronActivity description to tell users that it records SIP authentication
 134
 135   >This improves the wording for the TrackLastPatronActivity system preference to reflect that the 'last seen' date updates when a patron logs into the OPAC or connects using SIP.
 136
 137 ### Tools
 138
 139 - [[28353]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28353) Regression: Batch item deletion no longer shows which items were not removed
 140
 141   >This restores and improves the messages displayed when batch deleting items (Tools > Catalog > Batch item deletion).
 142   >
 143   >The messages displayed are:
 144   >- "Warning, the following barcodes were not found:", followed by a list of barcodes
 145   >- "Warning, the following items cannot be deleted:", followed by a list of barcodes
 146
 147
 148
 149 ## Documentation
 150
 151 The Koha manual is maintained in Sphinx. The home page for Koha
 152 documentation is
 153
 154 - [Koha Documentation](http://koha-community.org/documentation/)
 155
 156 As of the date of these release notes, the Koha manual is available in the following languages:
 157
 158
 159 - [Arabic](https://koha-community.org/manual/21.05/ar/html/) (34.3%)
 160 - [Chinese (Taiwan)](https://koha-community.org/manual/21.05/zh_TW/html/) (58.5%)
 161 - [Czech](https://koha-community.org/manual/21.05/cs/html/) (27.6%)
 162 - [English (USA)](https://koha-community.org/manual/21.05/en/html/)
 163 - [French](https://koha-community.org/manual/21.05/fr/html/) (47.2%)
 164 - [French (Canada)](https://koha-community.org/manual/21.05/fr_CA/html/) (25.2%)
 165 - [German](https://koha-community.org/manual/21.05/de/html/) (67.2%)
 166 - [Hindi](https://koha-community.org/manual/21.05/hi/html/) (98.2%)
 167 - [Italian](https://koha-community.org/manual/21.05/it/html/) (47.8%)
 168 - [Spanish](https://koha-community.org/manual/21.05/es/html/) (34.8%)
 169 - [Turkish](https://koha-community.org/manual/21.05/tr/html/) (40.3%)
 170
 171 The Git repository for the Koha manual can be found at
 172
 173 - [Koha Git Repository](https://gitlab.com/koha-community/koha-manual)
 174
 175
 176 ## Translations
 177
 178 Complete or near-complete translations of the OPAC and staff
 179 interface are available in this release for the following languages:
 180
 181 - Arabic (91.2%)
 182 - Armenian (100%)
 183 - Armenian (Classical) (89%)
 184 - Chinese (Taiwan) (81.6%)
 185 - Czech (70.1%)
 186 - English (New Zealand) (62.2%)
 187 - English (USA)
 188 - Finnish (80.9%)
 189 - French (84.6%)
 190 - French (Canada) (83.5%)
 191 - German (100%)
 192 - German (Switzerland) (61.4%)
 193 - Greek (54.9%)
 194 - Hindi (100%)
 195 - Italian (92.8%)
 196 - Nederlands-Nederland (Dutch-The Netherlands) (62.5%)
 197 - Norwegian Bokmål (58.2%)
 198 - Polish (86%)
 199 - Portuguese (79.9%)
 200 - Portuguese (Brazil) (87.8%)
 201 - Russian (87%)
 202 - Slovak (73.6%)
 203 - Spanish (91.7%)
 204 - Swedish (77.4%)
 205 - Telugu (99.9%)
 206 - Turkish (93.8%)
 207 - Ukrainian (61.9%)
 208
 209 Partial translations are available for various other languages.
 210
 211 The Koha team welcomes additional translations; please see
 212
 213 - [Koha Translation Info](http://wiki.koha-community.org/wiki/Translating_Koha)
 214
 215 For information about translating Koha, and join the koha-translate
 216 list to volunteer:
 217
 218 - [Koha Translate List](http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-translate)
 219
 220 The most up-to-date translations can be found at:
 221
 222 - [Koha Translation](http://translate.koha-community.org/)
 223
 224 ## Release Team
 225
 226 The release team for Koha 21.05.01 is
 227
 228
 229 - Release Manager: Jonathan Druart
 230
 231 - Release Manager assistants:
 232   - Martin Renvoize
 233   - Tomás Cohen Arazi
 234
 235 - QA Manager: Katrin Fischer
 236
 237 - QA Team:
 238   - David Cook
 239   - Agustín Moyano
 240   - Martin Renvoize
 241   - Marcel de Rooy
 242   - Joonas Kylmälä
 243   - Julian Maurice
 244   - Tomás Cohen Arazi
 245   - Josef Moravec
 246   - Nick Clemens
 247   - Kyle M Hall
 248   - Victor Grousset
 249   - Andrew Nugged
 250   - Petro Vashchuk
 251
 252 - Topic Experts:
 253   - UI Design -- Owen Leonard
 254   - REST API -- Tomás Cohen Arazi
 255   - Elasticsearch -- Fridolin Somers
 256   - Zebra -- Fridolin Somers
 257   - Accounts -- Martin Renvoize
 258
 259 - Bug Wranglers:
 260   - Sally Healey
 261
 262 - Packaging Manager:
 263   - Mason James
 264
 265 - Documentation Manager: David Nind
 266
 267
 268 - Documentation Team:
 269   - Lucy Vaux-Harvey
 270   - David Nind
 271
 272 - Translation Managers:
 273   - Bernardo González Kriegel
 274
 275 - Release Maintainers:
 276   - 21.05 -- Kyle Hall
 277   - 20.11 -- Fridolin Somers
 278   - 20.05 -- Victor Grousset
 279   - 19.11 -- Wainui Witika-Park
 280
 281 ## Credits
 282
 283 We thank the following individuals who contributed patches to Koha 21.05.01
 284
 285 - Tomás Cohen Arazi (9)
 286 - Nick Clemens (9)
 287 - David Cook (2)
 288 - Jonathan Druart (16)
 289 - Katrin Fischer (1)
 290 - Andrew Fuerste-Henry (1)
 291 - Kyle M Hall (1)
 292 - Joonas Kylmälä (17)
 293 - Owen Leonard (1)
 294 - Julian Maurice (2)
 295 - Andrew Nugged (1)
 296 - Martin Renvoize (9)
 297 - Alexis Ripetti (1)
 298 - Koha translators (1)
 299 - Petro Vashchuk (1)
 300
 301 We thank the following libraries, companies, and other institutions who contributed
 302 patches to Koha 21.05.01
 303
 304 - Athens County Public Libraries (1)
 305 - BibLibre (2)
 306 - Bibliotheksservice-Zentrum Baden-Württemberg (BSZ) (1)
 307 - ByWater-Solutions (11)
 308 - Independant Individuals (2)
 309 - Koha Community Developers (16)
 310 - Prosentient Systems (2)
 311 - PTFS-Europe (9)
 312 - Solutions inLibro inc (1)
 313 - Theke Solutions (9)
 314 - University of Helsinki (17)
 315
 316 We also especially thank the following individuals who tested patches
 317 for Koha
 318
 319 - Tomás Cohen Arazi (5)
 320 - Nick Clemens (28)
 321 - David Cook (5)
 322 - Jonathan Druart (46)
 323 - Katrin Fischer (7)
 324 - Andrew Fuerste-Henry (5)
 325 - Victor Grousset (7)
 326 - Kyle M Hall (71)
 327 - Joonas Kylmälä (5)
 328 - Owen Leonard (3)
 329 - Christian Nelson (2)
 330 - David Nind (13)
 331 - Andrew Nugged (2)
 332 - Martin Renvoize (14)
 333 - Marcel de Rooy (1)
 334 - Emmi Takkinen (8)
 335 - Petro Vashchuk (10)
 336
 337
 338
 339 We regret any omissions.  If a contributor has been inadvertently missed,
 340 please send a patch against these release notes to koha-devel@lists.koha-community.org.
 341
 342 ## Revision control notes
 343
 344 The Koha project uses Git for version control.  The current development
 345 version of Koha can be retrieved by checking out the master branch of:
 346
 347 - [Koha Git Repository](https://git.koha-community.org/koha-community/koha)
 348
 349 The branch for this version of Koha and future bugfixes in this release
 350 line is 21.05.X.
 351
 352 ## Bugs and feature requests
 353
 354 Bug reports and feature requests can be filed at the Koha bug
 355 tracker at:
 356
 357 - [Koha Bugzilla](http://bugs.koha-community.org)
 358
 359 He rau ringa e oti ai.
 360 (Many hands finish the work)
 361
 362 Autogenerated release notes updated last on 24 Jun 2021 16:41:01.