docs/RELEASE_NOTES_3_5.adoc

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