misc/release_notes/release_notes_20_05_06.md

   1 # RELEASE NOTES FOR KOHA 20.05.06
   2 23 Nov 2020
   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 20.05.06 can be downloaded from:
  12
  13 - [Download](http://download.koha-community.org/koha-20.05.06.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 20.05.06 is a bugfix/maintenance release.
  21
  22 It includes 3 enhancements, 73 bugfixes.
  23
  24 ### System requirements
  25
  26 Koha is continuously tested against the following configurations and as such these are the recommendations for
  27 deployment:
  28
  29 - Debian Jessie with MySQL 5.5 (End of life)
  30 - Debian Stretch with MariaDB 10.1
  31 - Debian Buster with MariaDB 10.3
  32 - Ubuntu Bionic with MariaDB 10.1
  33 - Debian Stretch with MySQL 8.0 (Experimental MySQL 8.0 support)
  34
  35 Additional notes:
  36
  37 - Perl 5.10 is required (5.24 is recommended)
  38 - Zebra or Elasticsearch is required
  39
  40
  41
  42
  43 ## Enhancements
  44
  45 ### Architecture, internals, and plumbing
  46
  47 - [[26600]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26600) Missing module in Indexer.pm
  48
  49 ### Fines and fees
  50
  51 - [[26506]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26506) Koha::Account::pay will fail if $userenv is not set
  52
  53 ### Plugin architecture
  54
  55 - [[24633]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=24633) Add support for gitlab searching of plugins
  56
  57   **Sponsored by** *Theke Solutions*
  58
  59   >The enhancement allows setting Gitlab targets for retrieving plugins.
  60
  61
  62 ## Critical bugs fixed
  63
  64 ### Acquisitions
  65
  66 - [[26496]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26496) Budget plan save button doesn't save plans
  67 - [[26738]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26738) Unable to change manager of purchase suggestion
  68 - [[26908]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26908) EDI vendor accounts edit no longer allows plugins to be selected for an account
  69
  70 ### Architecture, internals, and plumbing
  71
  72 - [[26639]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26639) Turn auto_savepoint ON
  73 - [[26911]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26911) Update for 18936 can cause data loss if constraints are violated
  74 - [[26963]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26963) Improve Koha::Item::pickup_locations performance
  75
  76   >Koha::Item::pickup_locations is very inefficient, causing timeouts on records with large numbers of holds/items.
  77   >
  78   >This development refactors the underlying implementation, and also makes the method return a resultset, to delay as much as possible the DB access, and thus allowing for further filtering  on the callers, through chaining.
  79
  80 ### Cataloging
  81
  82 - [[18051]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18051) Advanced Editor - Rancor - encoding issues with some sources
  83 - [[26750]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26750) Deleted items are not removed from index
  84
  85 ### Circulation
  86
  87 - [[25758]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25758) Items scheduled for automatic renewal do not show that they will not renew due to a hold
  88
  89   >Bug 19014 prioritized the 'too soon' message for renewals to prevent sending too many notifications. When displaying information about the hold elsewhere it is desired to see the 'on hold' status even when the renewal is too soon.
  90   >
  91   >This patch add a switch to the CanBookBeRenewed routine to decide which status has priority (i.e. whether we are checking from the renewal cron or elsewhere)
  92 - [[26232]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26232) undefined fine grace period kills koha
  93
  94 ### Database
  95
  96 - [[18050]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18050) Missing constraint on aqbudgets.budget_period_id in aqbudgets
  97
  98 ### Fines and fees
  99
 100 - [[26915]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26915) Koha explodes when writing off a fee with FinePaymentAutoPopup
 101
 102 ### Hold requests
 103
 104 - [[26429]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26429) If a waiting hold has expired the expiration date on the holds page shows for tomorrow
 105 - [[26900]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26900) Fixes Koka::Libraries typo in C4/Reserves.pm
 106 - [[26990]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26990) No feedback if holds override is disabled and hold fails
 107
 108 ### MARC Bibliographic record staging/import
 109
 110 - [[26853]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26853) Data lost due to "Data too long for column" errors during MARC import
 111
 112 ### OPAC
 113
 114 - [[26973]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26973) extendedPatronAttributes not showing during selfregistration
 115
 116 ### Plugin architecture
 117
 118 - [[25549]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25549) Broken plugins should not break Koha (Install plugin script/method should highlight broken plugins)
 119 - [[26751]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26751) Fatal exception if only one repo defined
 120
 121 ### Searching - Elasticsearch
 122
 123 - [[23828]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=23828) Elasticsearch - ES - Authority record results not ordered correctly
 124
 125 ### Searching - Zebra
 126
 127 - [[26581]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26581) Elasticsearch - Records can be indexed multiple times during returns
 128
 129 ### Serials
 130
 131 - [[26604]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26604) "Generate next" button gives error on serials-collection.pl
 132 - [[26987]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26987) No property notforloan for Koha::Serial::Item
 133
 134 ### Staff Client
 135
 136 - [[23432]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=23432) Stock rotation: cancelled transfer result in stockrotation failures
 137
 138 ### Tools
 139
 140 - [[26557]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26557) Batch import fails when incoming records contain itemnumber
 141
 142
 143 ## Other bugs fixed
 144
 145 ### Acquisitions
 146
 147 - [[26190]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26190) Cannot close baskets when all lines have been cancelled
 148
 149 ### Architecture, internals, and plumbing
 150
 151 - [[26569]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26569) Use gender-neutral pronouns in systempreference explanation field in DB
 152 - [[26673]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26673) Remove Perl shebangs from Perl modules
 153
 154 ### Authentication
 155
 156 - [[26191]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26191) Relocate track_login call in Auth.pm (see 22543)
 157
 158 ### Cataloging
 159
 160 - [[11460]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=11460) Correction to default itemcallnumber system preference in UNIMARC
 161 - [[17515]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17515) Advanced Editor - Rancor - Z39 sources not sorted properly
 162 - [[25353]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25353) Correct eslint errors in additems.js
 163 - [[26605]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26605) Correctly URI-encode query string in call number browse plugin
 164 - [[26613]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26613) In the unimarc_framework.sql file in the it-IT translation there are wrong value fields for 995 r record
 165
 166 ### Circulation
 167
 168 - [[26583]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26583) Unnecessary code in AddIssue
 169 - [[26627]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26627) Print and confirming a hold can cause an infinite loop
 170 - [[26675]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26675) Typo in line 341 of process_koc.pl
 171
 172 ### Command-line Utilities
 173
 174 - [[26601]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26601) Add utf8 output to text output of overdue_notices.pl
 175
 176   **Sponsored by** *Styrian State Library*
 177
 178 ### Hold requests
 179
 180 - [[26762]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26762) OPAC hold template markup error
 181
 182 ### Installation and upgrade (web-based installer)
 183
 184 - [[26612]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26612) Error during web install for it-IT translation
 185
 186 ### MARC Authority data support
 187
 188 - [[26606]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26606) Correctly URI-encode query string in URL loaded after deleting an authority record
 189
 190 ### MARC Bibliographic data support
 191
 192 - [[26018]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26018) Not all subfields for the following tags are in the same tab (or marked 'ignored')
 193
 194 ### OPAC
 195
 196 - [[26184]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26184) Wrap 'items available for pick-up' note when placing a hold in the OPAC in a div element
 197 - [[26389]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26389) OPAC renewal failure due to automatic renewal does not have a failure message
 198 - [[26526]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26526) Use of checkout notes not clear in OPAC
 199 - [[26619]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26619) Cart - The "Print" button is only translated when you are in "More details" mode
 200 - [[26647]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26647) Add translation context to cancel hold button in OPAC
 201 - [[26766]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26766) Don't show star rating in dialog when saving a checkout note
 202
 203 ### Patrons
 204
 205 - [[26594]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26594) Patrons merge problem with restriction
 206 - [[26686]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26686) Sorting for "Updated on" broken on patron's "Notices" tab
 207
 208 ### Searching - Elasticsearch
 209
 210 - [[26487]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26487) Add all MARC flavours for not-onloan-count search field
 211 - [[26832]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26832) Elasticsearch mappings export should use UTF-8
 212
 213 ### Searching - Zebra
 214
 215 - [[26599]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26599) Unused parameter name in POD of ModZebra
 216
 217 ### Staff Client
 218
 219 - [[26137]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26137) Warn on malformed param on log viewer (viewlog.pl)
 220 - [[26445]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26445) Search results browser in staff has broken link back to results
 221
 222 ### System Administration
 223
 224 - [[20804]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=20804) Sanitize input of timeout syspref
 225
 226 ### Templates
 227
 228 - [[26449]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26449) Small typo in web installer template
 229 - [[26450]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26450) Typo in UNIMARC field 105 plugin template
 230 - [[26538]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26538) Display cities list before input text
 231 - [[26551]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26551) When importing a framework, the modal heading is too long and runs outside of the dialog
 232 - [[26696]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26696) Make payment table has a display issue when credits exist
 233 - [[26723]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26723) Improve link text on OverDriveAuthName system preference
 234 - [[26725]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26725) Improve link text on Patron attributes administration page
 235 - [[26726]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26726) Improve link text on Transport cost matrix page
 236 - [[26727]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26727) Fix <p/> appearing in the templates
 237 - [[26756]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26756) Fix quotes showing behind some system preference descriptions
 238 - [[26816]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26816) Remove extra space before comma in staff results item list
 239
 240 ### Test Suite
 241
 242 - [[26589]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26589) t/db_dependent/OAI/Sets.t unit test fails due to OAI-PMH:AutoUpdateSets syspref
 243
 244 ### Tools
 245
 246 - [[8437]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=8437) Large database backups and large exports from export.pl fail under plack
 247 - [[9118]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=9118) Show only sensible options when editing a unique holiday
 248 - [[25167]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=25167) Fix not for loan filter in inventory tool
 249 - [[26781]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26781) Marc Modification Templates treat subfield 0 and no subfield set
 250 - [[26784]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=26784) Editing a MARC modification template is noisy
 251
 252
 253 ## Documentation
 254
 255 The Koha manual is maintained in Sphinx. The home page for Koha
 256 documentation is
 257
 258 - [Koha Documentation](http://koha-community.org/documentation/)
 259
 260 As of the date of these release notes, only the English version of the
 261 Koha manual is available:
 262
 263 - [Koha Manual](http://koha-community.org/manual/20.05/en/html/)
 264
 265
 266 The Git repository for the Koha manual can be found at
 267
 268 - [Koha Git Repository](https://gitlab.com/koha-community/koha-manual)
 269
 270 ## Translations
 271
 272 Complete or near-complete translations of the OPAC and staff
 273 interface are available in this release for the following languages:
 274
 275 - Arabic (99.1%)
 276 - Armenian (100%)
 277 - Armenian (Classical) (99.7%)
 278 - Chinese (Taiwan) (94.2%)
 279 - Czech (80.9%)
 280 - English (New Zealand) (67%)
 281 - English (USA)
 282 - Finnish (70.8%)
 283 - French (81.9%)
 284 - French (Canada) (95.5%)
 285 - German (100%)
 286 - German (Switzerland) (74.8%)
 287 - Greek (62.3%)
 288 - Hindi (99.7%)
 289 - Italian (100%)
 290 - Norwegian Bokmål (71.4%)
 291 - Polish (73.8%)
 292 - Portuguese (87.3%)
 293 - Portuguese (Brazil) (98.4%)
 294 - Russian (57.7%)
 295 - Slovak (90.1%)
 296 - Spanish (99.9%)
 297 - Swedish (77.8%)
 298 - Telugu (89.9%)
 299 - Turkish (96.7%)
 300 - Ukrainian (66.4%)
 301
 302 Partial translations are available for various other languages.
 303
 304 The Koha team welcomes additional translations; please see
 305
 306 - [Koha Translation Info](http://wiki.koha-community.org/wiki/Translating_Koha)
 307
 308 For information about translating Koha, and join the koha-translate
 309 list to volunteer:
 310
 311 - [Koha Translate List](http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-translate)
 312
 313 The most up-to-date translations can be found at:
 314
 315 - [Koha Translation](http://translate.koha-community.org/)
 316
 317 ## Release Team
 318
 319 The release team for Koha 20.05.06 is
 320
 321
 322 - Release Manager: Martin Renvoize
 323
 324 - Release Manager assistants:
 325   - Tomás Cohen Arazi
 326   - Jonathan Druart
 327
 328 - QA Manager: Katrin Fischer
 329
 330 - QA Team:
 331   - Jonathan Druart
 332   - Marcel de Rooy
 333   - Joonas Kylmälä
 334   - Josef Moravec
 335   - Tomás Cohen Arazi
 336   - Nick Clemens
 337   - Kyle Hall
 338
 339 - Topic Experts:
 340   - SIP2 -- Colin Campbell
 341   - EDI -- Colin Campbell
 342   - Elasticsearch -- Fridolin Somers
 343   - REST API -- Tomás Cohen Arazi
 344   - ILS-DI -- Arthur Suzuki
 345   - UI Design -- Owen Leonard
 346   - ILL -- Andrew Isherwood
 347
 348 - Bug Wranglers:
 349   - Michal Denár
 350   - Cori Lynn Arnold
 351   - Lisette Scheer
 352   - Amit Gupta
 353
 354 - Packaging Manager: Mason James
 355
 356
 357 - Documentation Managers:
 358   - Caroline Cyr La Rose
 359   - David Nind
 360
 361 - Documentation Team:
 362   - Donna Bachowski
 363   - Lucy Vaux-Harvey
 364   - Sugandha Bajaj
 365
 366 - Translation Manager: Bernardo González Kriegel
 367
 368
 369 - Release Maintainers:
 370   - 19.11 -- Joy Nelson
 371   - 19.05 -- Lucas Gass
 372   - 18.11 -- Hayley Mapley
 373
 374 - Release Maintainer mentors:
 375   - 19.11 -- Martin Renvoize
 376   - 19.05 -- Nick Clemens
 377   - 18.11 -- Chris Cormack
 378
 379 ## Credits
 380 We thank the following libraries who are known to have sponsored
 381 new features in Koha 20.05.06:
 382
 383 - Styrian State Library
 384 - [Theke Solutions](https://theke.io/)
 385
 386 We thank the following individuals who contributed patches to Koha 20.05.06.
 387
 388 - Tomás Cohen Arazi (3)
 389 - Blou (1)
 390 - Alex Buckley (1)
 391 - Nick Clemens (19)
 392 - David Cook (4)
 393 - Jonathan Druart (15)
 394 - John Fawcett (2)
 395 - Katrin Fischer (11)
 396 - Andrew Fuerste-Henry (1)
 397 - Lucas Gass (9)
 398 - Didier Gautheron (3)
 399 - Kyle Hall (5)
 400 - Mark Hofstetter (1)
 401 - Mason James (1)
 402 - Owen Leonard (8)
 403 - Matthias Meusburger (1)
 404 - Agustín Moyano (1)
 405 - Björn Nylen (1)
 406 - Martin Renvoize (5)
 407 - Phil Ringnalda (2)
 408 - Tal Rogoff (3)
 409 - Marcel de Rooy (3)
 410 - Andreas Roussos (2)
 411 - Lisette Scheer (1)
 412 - Fridolin Somers (6)
 413 - Emmi Takkinen (2)
 414 - Koha Translators (1)
 415 - Timothy Alexis Vass (1)
 416
 417 We thank the following libraries, companies, and other institutions who contributed
 418 patches to Koha 20.05.06
 419
 420 - Athens County Public Libraries (8)
 421 - BibLibre (10)
 422 - Bibliotheksservice-Zentrum Baden-Württemberg (BSZ) (11)
 423 - ByWater-Solutions (34)
 424 - cass.govt.nz (3)
 425 - Catalyst (1)
 426 - Chetco Community Public Library (2)
 427 - Dataly Tech (2)
 428 - hofstetter.at (1)
 429 - Independant Individuals (2)
 430 - Koha Community Developers (15)
 431 - KohaAloha (1)
 432 - Latah County Library District (1)
 433 - Prosentient Systems (4)
 434 - PTFS-Europe (5)
 435 - Rijks Museum (3)
 436 - Solutions inLibro inc (1)
 437 - Theke Solutions (4)
 438 - ub.lu.se (2)
 439 - voipsupport.it (2)
 440
 441 We also especially thank the following individuals who tested patches
 442 for Koha.
 443
 444 - Tomás Cohen Arazi (12)
 445 - Bob Bennhoff (1)
 446 - Christoper Brannon (2)
 447 - Nick Clemens (16)
 448 - David Cook (2)
 449 - Chris Cormack (9)
 450 - Jonathan Druart (85)
 451 - Magnus Enger (2)
 452 - Katrin Fischer (43)
 453 - Andrew Fuerste-Henry (3)
 454 - Lucas Gass (101)
 455 - Didier Gautheron (1)
 456 - Victor Grousset (1)
 457 - Kyle Hall (6)
 458 - Sally Healey (1)
 459 - Heather Hernandez (2)
 460 - B Johnson (1)
 461 - Barbara Johnson (4)
 462 - Joonas Kylmälä (4)
 463 - Owen Leonard (5)
 464 - Julian Maurice (5)
 465 - kelly mcelligott (1)
 466 - David Nind (25)
 467 - Séverine Queune (6)
 468 - Martin Renvoize (41)
 469 - Marcel de Rooy (1)
 470 - Fridolin Somers (1)
 471
 472
 473
 474 We regret any omissions.  If a contributor has been inadvertently missed,
 475 please send a patch against these release notes to
 476 koha-patches@lists.koha-community.org.
 477
 478 ## Revision control notes
 479
 480 The Koha project uses Git for version control.  The current development
 481 version of Koha can be retrieved by checking out the master branch of:
 482
 483 - [Koha Git Repository](git://git.koha-community.org/koha.git)
 484
 485 The branch for this version of Koha and future bugfixes in this release
 486 line is rmain2005.
 487
 488 ## Bugs and feature requests
 489
 490 Bug reports and feature requests can be filed at the Koha bug
 491 tracker at:
 492
 493 - [Koha Bugzilla](http://bugs.koha-community.org)
 494
 495 He rau ringa e oti ai.
 496 (Many hands finish the work)
 497
 498 Autogenerated release notes updated last on 23 Nov 2020 23:29:55.