docs/RELEASE_NOTES_3_5.adoc

   1 Evergreen 3.5 Release Notes
   2 ===========================
   3 :toc:
   4 :numbered:
   5
   6 Evergreen 3.5.3
   7 ---------------
   8
   9 This release contains bug fixes improving on Evergreen 3.5.2,
  10 including a security bug fix.
  11
  12 Bug Fixes
  13 ~~~~~~~~~
  14
  15 Security
  16 ^^^^^^^^
  17
  18 * Fix an issue where `open-ils.pcrud` backends could crash with
  19 a segmentation fault under certain conditions that could be invoked
  20 by an external attacker, thus leading to a potential denial
  21 of service attack.
  22
  23 Staff Interface
  24 ^^^^^^^^^^^^^^^
  25 * Expert Search in the staff interface now respects the search library.
  26 (https://bugs.launchpad.net/evergreen/+bug/1468132[Bug 1468132])
  27 * The Items Out page is now less prone to cause `open-ils.actor` backend
  28 exhaustion. It now also displays a progress bar while loading.
  29 (https://bugs.launchpad.net/evergreen/+bug/1913811[Bug 1913811])
  30 * Grids in the staff interface no longer require that a row
  31 be selected in order to activate a grid action that doesn't
  32 logically require that at least one row be selected.
  33 (https://bugs.launchpad.net/evergreen/+bug/1670457[Bug 1670457])
  34 * The display of total amounted billed, owed, and paid on the patron
  35 Bills page now reflects just open bills with a non-zero balance, fixing
  36 an issue where the totals could include paid billings for transactions
  37 that are still open.
  38 (https://bugs.launchpad.net/evergreen/+bug/1772955[Bug 1772955])
  39 * The pending patron interface now respects the library setting whether
  40 to set the patron's initial password to the last four digits of their
  41 phone number.
  42 (https://bugs.launchpad.net/evergreen/+bug/1887852[Bug 1887852])
  43 * Several interfaces, including Mark Missing, adding patrons to a bucket
  44 from a search, and applying a default item status now use batch
  45 API calls for better efficiency.
  46 (https://bugs.launchpad.net/evergreen/+bug/1896285[Bug 1896285])
  47 * Fix an issue where the holdings editor would not close its window
  48 when the Save & Exit button was clicked.
  49 (https://bugs.launchpad.net/evergreen/+bug/1913219[Bug 1913219])
  50 * Fix an issue where a double barcode scan could create a precat
  51 item without giving the staff member the chance to review the
  52 form before submitting it.
  53 (https://bugs.launchpad.net/evergreen/+bug/1778522[Bug 1778522])
  54 * Fix an issue preventing the staff interface from being used
  55 on various Android and iOS devices.
  56 (https://bugs.launchpad.net/evergreen/+bug/1901760[Bug 1901760])
  57 * Fix an issue where the report editor could supply the wrong
  58 kind of input for an aggregate filter.
  59 (https://bugs.launchpad.net/evergreen/+bug/1858114[Bug 1858114])
  60
  61 Public Catalog
  62 ^^^^^^^^^^^^^^
  63
  64 * Fix an issue where titles could run together when viewing a
  65 carousel with a mobile browser.
  66 (https://bugs.launchpad.net/evergreen/+bug/1868147[Bug 1868147])
  67 * The order that items in a carousel display in is now more
  68 predictable. For example, for 'Top Circulated Items' carousels,
  69 the order is from most circulated to least circulated.
  70 (https://bugs.launchpad.net/evergreen/+bug/1866406[Bug 1866406])
  71 * Carousels no longer display deleted items.
  72 (https://bugs.launchpad.net/evergreen/+bug/1836254[Bug 1836254])
  73 * CGI parameters in the public catalog are now consistently forced
  74 to be separated by ampersands rather than semicolons.
  75 (https://bugs.launchpad.net/evergreen/+bug/1687545[Bug 1687545]) and
  76 (https://bugs.launchpad.net/evergreen/+bug/1914116[Bug 1914116])
  77
  78 Administration
  79 ^^^^^^^^^^^^^^
  80
  81 * The EDI Webrick installer now works on Ubuntu 18.04
  82 (https://bugs.launchpad.net/evergreen/+bug/1901900[Bug 1901900])
  83
  84 Acknowledgements
  85 ~~~~~~~~~~~~~~~~
  86 We would like to thank the following individuals who contributed code,
  87 testing and documentation patches to the 3.5.3 point release of Evergreen:
  88
  89 * John Amundson
  90 * Zavier Banks
  91 * Jason Boyer
  92 * Dan Briem
  93 * Galen Charlton
  94 * Garry Collum
  95 * Jeff Davis
  96 * Bill Erickson
  97 * Ruth Frasur
  98 * Blake Graham-Henderson
  99 * Angela Kilsdonk
 100 * Terran McCanna
 101 * Michele Morgan
 102 * Jane Sandberg
 103 * Mike Rylander
 104 * Chris Sharp
 105 * Jason Stephenson
 106
 107 Evergreen 3.5.2
 108 ---------------
 109
 110 This release contains bug fixes improving on Evergreen 3.5.1.
 111
 112 Bug Fixes
 113 ~~~~~~~~~
 114
 115 Accessibility
 116 ^^^^^^^^^^^^^
 117
 118 * Help popovers in the AngularJS staff client can now be opened using keyboard navigation
 119 (https://bugs.launchpad.net/evergreen/+bug/1801947[Bug 1801947])
 120 * Keyboard navigation improvement to the Register/Edit Patron screen
 121 (https://bugs.launchpad.net/evergreen/+bug/1840329[Bug 1840329])
 122 * Decorative icons in the navbar are now aria-hidden
 123 (https://bugs.launchpad.net/evergreen/+bug/1795720[Bug 1795720])
 124 * The staff login page now contains an apporopriate heading
 125 (https://bugs.launchpad.net/evergreen/+bug/1839365[Bug 1839365])
 126
 127 Acquisitions
 128 ^^^^^^^^^^^^
 129
 130 * Improve wording in acquisitions line item actions menu
 131 (https://bugs.launchpad.net/evergreen/+bug/1418694[Bug 1418694])
 132
 133 Administration
 134 ^^^^^^^^^^^^^^
 135
 136 * Permission Group Interface refreshes after making permission changes
 137 (https://bugs.launchpad.net/evergreen/+bug/1891355[Bug 1891355])
 138 * Permissions for creating/modifying booking reservations can now be
 139 scoped by org unit
 140 (https://bugs.launchpad.net/evergreen/+bug/1835127[Bug 1835127])
 141 * Fixes issues with sharing settings in the reporter
 142 (https://bugs.launchpad.net/evergreen/+bug/1851413[Bug 1851413])
 143 * It is now possible to report on non-cataloged circulations
 144 separately from non-cataloged in-house uses
 145 (https://bugs.launchpad.net/evergreen/+bug/1788260[Bug 1788260])
 146 * Prevents duplicated report outputs
 147 (https://bugs.launchpad.net/evergreen/+bug/1893463[Bug 1893463])
 148 * Fixes a UI issue in the reporter
 149 (https://bugs.launchpad.net/evergreen/+bug/1207744[Bug 1207744])
 150 * Improves description of an org unit setting
 151 (https://bugs.launchpad.net/evergreen/+bug/1325704[Bug 1325704])
 152
 153 Cataloging
 154 ^^^^^^^^^^
 155
 156 * Catalogers can now batch edit call numbers from item buckets
 157 (https://bugs.launchpad.net/evergreen/+bug/1747664[Bug 1747664])
 158 * The item editor now displays all circulation modifiers when batch updating
 159 (https://bugs.launchpad.net/evergreen/+bug/1844732[Bug 1844732])
 160 * When merging bibliographic records, the deleted record is now also marked as
 161 inactive (https://bugs.launchpad.net/evergreen/+bug/1771386[Bug 1771386])
 162 * The staff catalog now includes a UPC search option
 163 (https://bugs.launchpad.net/evergreen/+bug/1885764[Bug 1885764])
 164 * Catalogers can now choose "AND" or "OR" as the root node of a record match set
 165 (https://bugs.launchpad.net/evergreen/+bug/1839562[Bug 1839562])
 166 * The Replace Item Barcode screen now displays an error message when trying to
 167 replace a barcode with a barcode already in use (Bugs
 168 https://bugs.launchpad.net/evergreen/+bug/1362743[1362743]
 169 and https://bugs.launchpad.net/evergreen/+bug/1890498[1890498])
 170 * The Angular Catalog's Holding View grid now includes more columns
 171 (https://bugs.launchpad.net/evergreen/+bug/1892077[Bug 1892077])
 172 * The Angular Catalog's Holding View grid context menu no longer includes horizontal scroll bars
 173 (https://bugs.launchpad.net/evergreen/+bug/1890849[Bug 1890849])
 174 * Fixes an issue that caused the Holdings View grid to not display all necessary holdings
 175 (https://bugs.launchpad.net/evergreen/+bug/1845047[Bug 1845047])
 176 * Fixes an issue with the Staff Catalog call number browse
 177 (https://bugs.launchpad.net/evergreen/+bug/1889685[Bug 1889685])
 178 * Fixes an issue with exporting MARC records via a CSV file
 179 (https://bugs.launchpad.net/evergreen/+bug/1850825[Bug 1850825])
 180 * Fixes an issue with the queue type selector in the Inspect Queue screen
 181 (https://bugs.launchpad.net/evergreen/+bug/1890351[Bug 1890351])
 182 * Display a helpful message when a staff catalog barcode search doesn't match
 183 any barcodes (https://bugs.launchpad.net/evergreen/+bug/1896083[Bug 1896083])
 184 * Filters in the angular staff catalog now differentiate between OPAC visible
 185 and OPAC invisible values
 186 (https://bugs.launchpad.net/evergreen/+bug/1872867[Bug 1872867])
 187
 188
 189
 190 Circulation
 191 ^^^^^^^^^^
 192
 193 * The Patron Edit form now reflects the opac.hold_notify user setting, if set
 194 (https://bugs.launchpad.net/evergreen/+bug/1879993[Bug 1879993])
 195 * The Register Patron form can now set default password according to a patron's
 196 phone number when the org setting "Patron: password from phone #" is TRUE
 197 (https://bugs.launchpad.net/evergreen/+bug/1900184[Bug 1900184])
 198 * The Patron self-registration form now persists a patron's selected home library,
 199 even if they refresh the form in their browser
 200 (https://bugs.launchpad.net/evergreen/+bug/1361270[Bug 1361270])
 201 * Offline circulation interface now lists organizational units in the correct order
 202 (https://bugs.launchpad.net/evergreen/+bug/1724019[Bug 1724019])
 203 * Several improvements to placing holds in the Angular staff catalog
 204 (https://bugs.launchpad.net/evergreen/+bug/1851882[Bug 1851882])
 205 * The org unit selector in the staff catalog holds tab is now sticky
 206 (https://bugs.launchpad.net/evergreen/+bug/1889113[Bug 1889113])
 207 * Fixes an issue that resulted in displaying duplicate holds in the catalog's View
 208 Holds tab (https://bugs.launchpad.net/evergreen/+bug/1865564[Bug 1865564])
 209 * Fixes an issue in which cataloged resources sometimes do not appear in the
 210 Booking Pull List (https://bugs.launchpad.net/evergreen/+bug/1882828[Bug 1882828])
 211 * The Booking Pull List grid now allows users to save their grid settings
 212 (https://bugs.launchpad.net/evergreen/+bug/1882825[Bug 1882825])
 213 * Fixes an issue with the hold targeter
 214 (https://bugs.launchpad.net/evergreen/+bug/1508208[Bug 1508208])
 215 * Fixes an issue that prevents items from circulating when OpenSRF is installed
 216 with non-default router names
 217 (https://bugs.launchpad.net/evergreen/+bug/1904220[Bug 1904220])
 218
 219 Client
 220 ^^^^^^
 221
 222 * Fixes an issue with keyboard shortcuts in the Angular Staff Client
 223 (https://bugs.launchpad.net/evergreen/+bug/1883126[Bug 1883126])
 224 * Fixes an issue that caused a blank screen to appear
 225 (https://bugs.launchpad.net/evergreen/+bug/1855737[Bug 1855737])
 226
 227
 228 Public Catalog
 229 ^^^^^^^^^^^^^^
 230
 231 * Fixes an issue which prevented Zotero from gathering metadata from the
 232 public catalog (https://bugs.launchpad.net/evergreen/+bug/1776954[Bug 1776954])
 233
 234 Acknowledgements
 235 ~~~~~~~~~~~~~~~~
 236 We would like to thank the following individuals who contributed code,
 237 testing and documentation patches to the 3.5.2 point release of Evergreen:
 238
 239 * Jason Boyer
 240 * Dan Briem
 241 * Galen Charlton
 242 * Garry Collum
 243 * Jeff Davis
 244 * Bill Erickson
 245 * Jason Etheridge
 246 * Ruth Frasur
 247 * Rogan Hamby
 248 * Elaine Hardy
 249 * Shula Link
 250 * Tiffany Little
 251 * Mary Llewellyn
 252 * Terran McCanna
 253 * Christine Morgan
 254 * Michele Morgan
 255 * Jennifer Pringle
 256 * Mike Risher
 257 * Mike Rylander
 258 * Jane Sandberg
 259 * Dan Scott
 260 * Chris Sharp
 261 * Remington Steed
 262 * Jason Stephenson
 263 * Jennifer Weston
 264 * Beth Willis
 265
 266
 267 Evergreen 3.5.1
 268 ---------------
 269
 270 This release contains bug fixes improving on Evergreen 3.5.0.
 271
 272 Bug Fixes
 273 ~~~~~~~~~
 274
 275
 276 Administration
 277 ^^^^^^^^^^^^^^
 278
 279 * Fixes a bug that caused the Emergency Closing handler to skip circulations with fines (https://bugs.launchpad.net/evergreen/+bug/1870605[Bug 1870605])
 280 * The column headers in the Copy Status configuration screen have improved labels (https://bugs.launchpad.net/evergreen/+bug/1848573[Bug 1848573])
 281 * Fixes an incorrect link to the Match Set configuration screen (https://bugs.launchpad.net/evergreen/+bug/1840294[Bug 1840294])
 282 * Updates the descriptions of the _circ.staff_client.receipt_ library settings (https://bugs.launchpad.net/evergreen/+bug/1705302[Bug 1705302])
 283 * The labels of the All Circulations reporter sources have been clarified (https://bugs.launchpad.net/evergreen/+bug/1852443[Bug 1852443])
 284 * The emergency closing form provides additional guidance about end dates (https://bugs.launchpad.net/evergreen/+bug/1867524[Bug 1867524])
 285 * The badge_score_generator.pl script is now installed as part of an Evergreen install (https://bugs.launchpad.net/evergreen/+bug/1847784[Bug 1847784])
 286 * User preferred names and name keywords are now purged from the database when the user is purged
 287 (https://bugs.launchpad.net/evergreen/+bug/1802166[Bug 1802166])
 288 * Fixes a bug with the "months ago" functionality in the reporter (https://bugs.launchpad.net/evergreen/+bug/1885759[Bug 1885759])
 289 * Angular call number prefix/suffix admin pages no longer let you edit sort key (https://bugs.launchpad.net/evergreen/+bug/1889251[Bug 1889251])
 290
 291 Cataloging
 292 ^^^^^^^^^^
 293
 294 * Various improvements to the MARC Editor (Bugs https://bugs.launchpad.net/evergreen/+bug/1735568[Bug 1735568] and
 295 https://bugs.launchpad.net/evergreen/+bug/1830443[Bug 1830443])
 296 * Fixes an issue with undeleting bibliographic records (https://bugs.launchpad.net/evergreen/+bug/1845241[Bug 1845241])
 297 * Item status now alerts the user about invalid barcodes uploaded from a file (https://bugs.launchpad.net/evergreen/+bug/1847784[Bug 1847784])
 298 * You can now open multiple items in Item Status from an item bucket (https://bugs.launchpad.net/evergreen/+bug/1735828[Bug 1735828])
 299 * The experimental catalog now allows searching by format (https://bugs.launchpad.net/evergreen/+bug/1886118[Bug 1886118])
 300 * The experimental catalog now displays the bib call number according to the search library's org unit setting
 301 (https://bugs.launchpad.net/evergreen/+bug/1874897[Bug 1874897])
 302 * Fixes an issue with adding and editing call numbers in the experimental catalog (https://bugs.launchpad.net/evergreen/+bug/1878079[Bug 1878079])
 303 * Newly added items and call numbers have distinct styling (https://bugs.launchpad.net/evergreen/+bug/1731370[Bug 1731370])
 304 * Fixes an issue with hold activation dates (https://bugs.launchpad.net/evergreen/+bug/1783793[Bug 1783793])
 305 * Adds item creator and editor to holdings editor grids (https://bugs.launchpad.net/evergreen/+bug/1811466[Bug 1811466])
 306 * The experimental catalog authority MARC editor can now delete and undelete authority records
 307 (https://bugs.launchpad.net/evergreen/+bug/1866546[Bug 1866546])
 308
 309 Circulation
 310 ^^^^^^^^^^^
 311
 312 * Overdue items are now highlighted in red in the Items Out screen (https://bugs.launchpad.net/evergreen/+bug/1775286[Bug 1775286])
 313 * Fixes an issue that caused patron stat cat information to persist between patrons in the Patron Edit screen
 314 (https://bugs.launchpad.net/evergreen/+bug/1844365[Bug 1844365])
 315 * The Pending User Buckets now allow more than 100 users (https://bugs.launchpad.net/evergreen/+bug/1754387[Bug 1754387])
 316 * Fixes an issue that caused long patron names to obscure important parts of circulation screens
 317 (https://bugs.launchpad.net/evergreen/+bug/1805860[Bug 1805860])
 318 * Prevents an incorrect "Input is out of range" validation error in the date pickers of the check out and renewal
 319 screens (https://bugs.launchpad.net/evergreen/+bug/1864056[Bug 1864056])
 320 * Long overdue and lost and paid items now count toward patron limits (https://bugs.launchpad.net/evergreen/+bug/1747542[Bug 1747542])
 321 * The holds shelf list now includes columns for "User Alias" and "User Alias or Display Name" (https://bugs.launchpad.net/evergreen/+bug/1712854[Bug 1712854])
 322 * In the messages tab of a patron's account, you can now change the date range of displayed archived penalties
 323 (https://bugs.launchpad.net/evergreen/+bug/1775940[Bug 1775940])
 324 * Fixes an issue with hanging transits (https://bugs.launchpad.net/evergreen/+bug/1819542[Bug 1819542])
 325 * Fixes some hold targeting logic (https://bugs.launchpad.net/evergreen/+bug/1886852[Bug 1886852])
 326 * Fixes an issue with default billing type prices (https://bugs.launchpad.net/evergreen/+bug/1776757[Bug 1776757])
 327 * The experimental catalog's hold grid now includes both date and time for hold request time (https://bugs.launchpad.net/evergreen/+bug/1889296[Bug 1889296])
 328 * Sounds now play when an item alert pops up in the web client (https://bugs.launchpad.net/evergreen/+bug/1851541[Bug 1851541])
 329 * Autorenewal notifications now display a more intelligible message (https://bugs.launchpad.net/evergreen/+bug/1842431[Bug 1842431])
 330
 331 Client
 332 ^^^^^^
 333
 334 * New installations of Evergreen will prevent problematic caching of the Angular client (https://bugs.launchpad.net/evergreen/+bug/1775276[Bug 1775276])
 335 * All screens in the angular client now have a banner to indicate which screen it is (https://bugs.launchpad.net/evergreen/+bug/1474874[Bug 1474874])
 336 * Fixes a bug that caused inconsistent hotkey behavior (https://bugs.launchpad.net/evergreen/+bug/1886713[Bug 1886713])
 337 * The Angular client has been upgraded to be compatible with moment-timezone 0.5.29 (https://bugs.launchpad.net/evergreen/+bug/1884787[Bug 1884787])
 338 * Fixes an issue with comboboxes (typeaheads) in the Angular client (https://bugs.launchpad.net/evergreen/+bug/1882591[Bug 1882591])
 339 * Publicly visible buckets are now known as Shareable buckets (https://bugs.launchpad.net/evergreen/+bug/1717996[Bug 1717996])
 340
 341 Feeds
 342 ^^^^^
 343
 344 * Fixes an issue with HTML item feed cover images (https://bugs.launchpad.net/evergreen/+bug/1674364[Bug 1674364])
 345
 346 Public catalog
 347 ^^^^^^^^^^^^^^
 348
 349 * The list of holdings in the OPAC now considers call number suffix in its sorting (https://bugs.launchpad.net/evergreen/+bug/1795469[Bug 1795469])
 350 * The Exclude Electronic Resources checkbox now works properly when locale picker is enabled (https://bugs.launchpad.net/evergreen/+bug/1847343[Bug 1847343])
 351
 352 QA
 353 ^^
 354
 355 * Adds automated tests for the barcode completion feature (https://bugs.launchpad.net/evergreen/+bug/1847680[Bug 1847680])
 356
 357 Search
 358 ^^^^^^
 359
 360 * Fixes an issue with SRU search (https://bugs.launchpad.net/evergreen/+bug/1833300[Bug 1833300])
 361 * Fixes an issue with searching the catalog from the staff client (https://bugs.launchpad.net/evergreen/+bug/1858701[Bug 1858701])
 362 * The experimental catalog basket clears when a staff member logs out (https://bugs.launchpad.net/evergreen/+bug/1867834[Bug 1867834])
 363 * Fixes an accessibility issue with the catalog search on the splash page (https://bugs.launchpad.net/evergreen/+bug/1839369[Bug 1839369])
 364
 365 Upgrade notes
 366 ~~~~~~~~~~~~~
 367
 368 Evergreen administrators should update existing apache configuration files
 369 so that the Angular index.html file is never cached by the client.  This
 370 can be done by changing the Angular setup section of the apache configuration
 371 that starts with:
 372
 373 [source,xml]
 374 ----
 375 <Directory "/openils/var/web/eg2/en-US">
 376 ----
 377
 378 or similar in the apache configuration. Add the following after the
 379 FallbackResource directive:
 380
 381 [source,xml]
 382 ----
 383     <Files "index.html">
 384       <IfModule mod_headers.c>
 385         Header set Cache-Control "no-cache, no-store, must-revalidate"
 386         Header set Pragma "no-cache"
 387         Header set Expires 0
 388       </IfModule>
 389     </Files>
 390 ----
 391
 392 Finally, ensure that the mod_headers apache module is enabled by running the
 393 following commands on all apache servers as the root user:
 394
 395 [source,bash]
 396 ----
 397 a2enmod headers
 398 sudo /etc/init.d/apache2 restart
 399 ----
 400
 401 Purge User Preferred Names
 402 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 403 The new, user preferred name fields are now set to NULL in the
 404 database when a user account is purged via the staff client or using
 405 the actor.usr_delete function in the database.
 406
 407 To clear the preferred name fields from records that have already been
 408 purged, run the following SQL update:
 409
 410 [source,sql]
 411 ----
 412 UPDATE actor.usr
 413 SET pref_prefix = NULL,
 414     pref_first_given_name = NULL,
 415     pref_second_given_name = NULL,
 416     pref_family_name = NULL,
 417     pref_suffix = NULL,
 418     name_keywords = NULL
 419 WHERE usrname ~ ('^' || id || '-PURGED')
 420 AND NOT active
 421 AND deleted
 422 AND (
 423   pref_prefix IS NOT NULL OR
 424   pref_first_given_name IS NOT NULL OR
 425   pref_second_given_name IS NOT NULL OR
 426   pref_family_name IS NOT NULL OR
 427   pref_suffix IS NOT NULL OR
 428   name_keywords IS NOT NULL
 429 );
 430 ----
 431
 432 Acknowledgements
 433 ~~~~~~~~~~~~~~~~
 434 We would like to thank the following individuals who contributed code,
 435 testing and documentation patches to the 3.5.1 point release of Evergreen:
 436
 437 * John Amundson
 438 * A. Bellenir
 439 * Jason Boyer
 440 * Steven Callender
 441 * Galen Charlton
 442 * Jeff Davis
 443 * Bill Erickson
 444 * Jason Etheridge
 445 * Ruth Frasur
 446 * Blake Graham Henderson
 447 * Rogan Hamby
 448 * Elaine Hardy
 449 * Kyle Huckins
 450 * Shula Link
 451 * Tiffany Little
 452 * Christine Morgan
 453 * Michele Morgan
 454 * Terran McCanna
 455 * Gina Monti
 456 * Mike Risher
 457 * Mike Rylander
 458 * Jane Sandberg
 459 * Dan Scott
 460 * Jason Stephenson
 461 * Josh Stompro
 462 * John Yorio
 463
 464 Evergreen 3.5.0
 465 ---------------
 466
 467 Upgrade notes
 468 -------------
 469
 470 New Action Trigger hook for patron registration
 471 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 472 Use of the new Action Trigger stgu.created hook requires changes to
 473 your action_trigger_filters.json file.  See below for more details.
 474
 475 New prerequisite - Email::MIME Perl module
 476 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 477 The Email::MIME Perl module is now required, so be sure to run the
 478 prerequisite installation procedure for your Linux distribution before
 479 upgrading Evergreen.
 480
 481
 482
 483 New Features for 3.5.0
 484 ----------------------
 485
 486 Administration
 487 ~~~~~~~~~~~~~~
 488
 489 Do not cache the Angular application root
 490 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 491
 492 Evergreen administrators should update existing apache configuration files
 493 so that the Angular index.html file is never cached by the client.  This
 494 can be done by changing the Angular setup section of the apache configuration
 495 that starts with:
 496
 497 [source, conf]
 498 ----
 499 <Directory "/openils/var/web/eg2/en-US">
 500 ----
 501
 502 or similar in the apache configuration. Add the following after the
 503 FallbackResource directive:
 504
 505 [source, conf]
 506 ----
 507     <Files "index.html">
 508       <IfModule mod_headers.c>
 509         Header set Cache-Control "no-cache, no-store, must-revalidate"
 510         Header set Pragma "no-cache"
 511         Header set Expires 0
 512       </IfModule>
 513     </Files>
 514 ----
 515
 516 Finally, ensure that the mod_headers apache module is enabled by running the
 517 following commands on all apache servers as the root user:
 518
 519 [source, sh]
 520 ----
 521 a2enmod headers
 522 /etc/init.d/apache2 restart
 523 ----
 524
 525
 526 Repair of Self-closing HTML Tags
 527 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 528 The most recent release of JQuery requires valid closing tags for X/HTML elements.
 529 These were repaired within affected OPAC/Staff Client TT2 templates, but care should
 530 be taken in Action/Trigger templates to make sure closing tags are present where
 531 appropriate.  The stock template for PO HTML was affected.
 532 See https://bugs.launchpad.net/evergreen/+bug/1873286[LP#1873286] for details.
 533
 534 Aged Money Changes
 535 ^^^^^^^^^^^^^^^^^^
 536
 537 Two new global flag settings have been added to control if/when billings and
 538 payments are aged.  Both settings are disabled by default.
 539
 540 * 'history.money.age_with_circs'
 541  ** Age billings and payments linked to circulations when the cirulcation
 542     is aged.
 543 * 'history.money.retention_age'
 544   ** Age billings and payments based on the age of the finish date for
 545      the linked transaction.
 546   ** To age money based on this setting, there is a new srfsh script
 547      at (by default) /openils/bin/age_money.srfsh.
 548
 549 Aged Payment Additional Fields
 550 ++++++++++++++++++++++++++++++
 551
 552 The aged payment table now has accepting_usr, cash_drawer, and billing
 553 columns to improve reporting of aged money.
 554
 555 Manual Data Migration of Aged Money
 556 +++++++++++++++++++++++++++++++++++
 557
 558 For users that wish to age money along with circulations (global flag
 559 'history.money.age_with_circs' is set to true), it's necessary to manaully
 560 age money for circulations which have already been aged.  This can be
 561 done directly in the database with SQL:
 562
 563 NOTE: This SQL can take a very long time to run on large databases, so
 564 it may be necessary to process aged circulations in batches instead
 565 of all at once.
 566
 567 [source,sql]
 568 -------------------------------------------------------------------------
 569 SELECT money.age_billings_and_payments_for_xact(circ.id)
 570 FROM action.aged_circulation circ
 571 -- limit to aged circs with billings
 572 JOIN money.billing mb ON mb.xact = circ.id;
 573 -------------------------------------------------------------------------
 574
 575
 576 PostgreSQL 10 Support
 577 ^^^^^^^^^^^^^^^^^^^^^
 578 PostgreSQL 10 is now available for installation with Evergreen.  Please
 579 see the installation documentation for details.
 580
 581 New Action Trigger hook for patron registration
 582 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 583 Evergreen now includes a new type of Action Trigger hook: stgu.created.
 584 This hook will trigger upon the patron registration submission form. In
 585 addition to the new hook, an example Action Trigger definition is
 586 provided (disabled by default) entitled "Patron Registered for a card
 587 stgu.created". With clever timing and delay settings, a library can
 588 receive a single notification containing all of the pending patron
 589 registrations for a given time interval. No special server-side
 590 considerations required unless you introduce a new granularity. There
 591 is, however, a new clause introduced to the
 592 "action_trigger_filters.json.example" file.
 593
 594 If you wish to use this new hook, be sure to include this clause in your
 595 local "action_trigger_filters.json" file:
 596
 597 ----
 598 "stgu.created" : {
 599         "context_org": "home_ou",
 600         "filter": {
 601             "complete": "f"
 602         }
 603     }
 604 ----
 605
 606 SendEmail Reactor Updated to use Email::MIME
 607 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 608 The SendEmail reactor for Action/Trigger has been updated to use the
 609 Email::MIME Perl module for proper encoding of the email message
 610 header fields.  You should notice no functional difference in the
 611 sending of emails.
 612
 613
 614
 615 Cataloging
 616 ~~~~~~~~~~
 617
 618 Enriched/Full MARC Editor Ported to Angular
 619 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 620 The full MARC editor is now implemented in Angular.  This change impacts
 621 both the experimental Angular catalog and the MARC edit option within
 622 MARC Batch Import/Export (Vandelay) Queue manager.
 623
 624 Patron View tab in Experimental Catalog
 625 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 626 The record view screen in the Experimental Catalog now has a
 627 _Patron View_ tab.  This tab displays a view of the record in
 628 the OPAC, as a patron would see it.
 629
 630 The _Patron View_ tab replaces the previous _View in Catalog_
 631 button.
 632
 633
 634
 635 Circulation
 636 ~~~~~~~~~~~
 637
 638 New Hold Sort Order: Traditional with Holds-chase-home-lib-patrons
 639 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 640
 641 This is a new entry under Administration -> Server Administration ->
 642 Best-Hold Selection Sort Order in the staff client.  It prioritizes holds
 643 such that a given item, based on its owning library, will prefer patrons with
 644 a matching home library, no matter the pickup library.
 645
 646
 647 Angular Staff Catalog Holds Patron Search Support
 648 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 649 The Angular staff catalog now supports patron searching directly from
 650 the holds placement interace.
 651
 652 Hide Print List Button On Self Check Home Page
 653 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 654 The _Print List_ button is no longer displayed on the main page
 655 of the self check interface. This addresses an issue where
 656 users were observed to either hit the _Print List_ button and
 657 walk away or hit it *and* the _Logout_ button, causing duplicate
 658 receipts to be printed.  The _Print List_ button continues to
 659 be displayed on the _Items Out_, _Holds_, and _Fines Details_ pages
 660 of the self check interface.
 661
 662 Update Hold Notification Information
 663 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 664 The public catalog and staff client now have the ability to update
 665 existing holds if a patron or a staff member changes certain
 666 notification preferences or contact information.  Evergreen will detect
 667 these changes and prompt the staff user or patron user and ask if they
 668 want to update existing holds with the new contact information and/or
 669 notification preferences.
 670
 671
 672
 673 Client
 674 ~~~~~~
 675
 676 Angular Staff Catalog Preferences Page
 677 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 678 Adds a new "Catalog Preferences" interface, accessible directly from the
 679 catalog.  The UI houses the search preferences (default search lib,
 680 preferred library, default search tab) and a new staff-specific
 681 hits-per-page setting.  Other preferences may be added later.
 682
 683 Adds support for selecting a default search tab using the existing
 684 'eg.search.adv_pane' setting.
 685
 686 Hatch File Writer Print Option
 687 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 688 Adds a new stock print option in the Hatch printer configuration interface
 689 called Hatch File Writer (translatable).  When selected, any print content
 690 that is delivered to this printer is translated into text where necessary
 691 and written to a file in the Hatch profile directory.
 692
 693 The name of the file written is based on the print context:
 694 "receipt.<context>.txt".  For example, 'receipt.label.txt'.
 695
 696 Angular Staff Catalog gets Search Highlighting
 697 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 698 Search text highlighting is now supported on the search results and
 699 record details pages in the Angular staff catalog for searches that
 700 support highlighting.
 701
 702
 703
 704 OPAC
 705 ~~~~
 706
 707 Custom CSS in OPAC
 708 ^^^^^^^^^^^^^^^^^^
 709 There is now a library setting called opac.patron.custom_css. This can be
 710 populated with CSS that will load in the OPAC after the stylesheets and
 711 allow for custom CSS without editing server side templates. The permission
 712 UPDATE_ORG_UNIT_SETTING.opac.patron.custom_css manages access to it.
 713
 714
 715
 716 SIP
 717 ~~~
 718
 719 Add patron_status_always_permit_loans Option to SIP Server
 720 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 721 Evergreen now has a new `oils_sip.xml` login attribute called
 722 `patron_status_always_permit_loans` that specifies whether
 723 the charge privileges denied, renewal privilges denied, and
 724 card reported lost flags in the patron status block should be
 725 coerced to permissive values regardless of the actual state
 726 of the patron record. Turning this on works around an issue
 727 where a 2019-12 change by the Hoopla SIP2 client takes those flag
 728 fields into account, but some libraries may not wish those
 729 to block a patron's access to online resources that use
 730 SIP2 to authenticate. This setting can also be set as
 731 an `implementation_config` option; note that if it is set to
 732 'true' or 'false' as a login attribute, the login attribute will
 733 override whatever is set in the `implementation_config`.
 734
 735
 736
 737
 738 Acknowledgments
 739 ---------------
 740 The Evergreen project would like to acknowledge the following
 741 organizations that commissioned developments in this release of
 742 Evergreen:
 743
 744 * King County Library System
 745 * MassLNC
 746 * PaILS
 747
 748 We would also like to thank the following individuals who contributed
 749 code, translations, documentations patches and tests to this release of
 750 Evergreen:
 751
 752 * Jason Boyer
 753 * Galen Charlton
 754 * Garry Collum
 755 * Dawn Dale
 756 * Jeff Davis
 757 * Bill Erickson
 758 * Jason Etheridge
 759 * Lynn Floyd
 760 * Ruth Frasur
 761 * Blake Graham-Henderson
 762 * Rogan Hamby
 763 * Terran McCanna
 764 * Mike Risher
 765 * Mike Rylander
 766 * Jane Sandberg
 767 * Chris Sharp
 768 * Josh Stompro
 769 * Cesar Velez
 770
 771
 772 We also thank the following organizations whose employees contributed
 773 patches:
 774
 775 * BC Libraries Cooperative
 776 * Catalyte
 777 * Equinox Open Library Initiative
 778 * Georgia Public Library Service
 779 * Indiana State Library
 780 * King County Library System
 781 * Lake Agassiz Regional Library
 782 * Linn-Benton Community College
 783 * MOBIUS
 784
 785 We regret any omissions.  If a contributor has been inadvertently
 786 missed, please open a bug at http://bugs.launchpad.net/evergreen/
 787 with a correction.
 788