d69a645708d5014b631f360fb60b900441da1b26
[Evergreen.git] / docs / RELEASE_NOTES_2_12.adoc
1 Evergreen 2.12 Release Notes
2 ============================
3 :toc:
4 :numbered:
5
6 Evergreen 2.12.9
7 ----------------
8 This release contains bug fixes improving on Evergreen 2.12.8:
9
10 * NodeJs is now installed from source, rather than using a pre-compiled binary.
11 * NodeJs is now at version 6.11.3, which is the most recent LTS release.
12
13 Acknowledgements
14 ~~~~~~~~~~~~~~~~
15 We would like to thank the following individuals who contributed code,
16 tests and documentation patches to the 2.12.8 point release of
17 Evergreen:
18
19 * Jeanette Lundgren
20 * Ben Shum
21 * Remington Steed
22
23 Evergreen 2.12.8
24 ----------------
25 This release contains several bug fixes improving on Evergreen 2.12.7:
26
27 * Many patron fields have been redacted from the web staff client's patron
28 and record holds grids, leaving patron name, username, and ID.
29 * Fixes two bugs where patron records could fail to be saved upon editing.
30 * The patron summary in the web staff client now correctly displays
31 primary and secondary ID values.
32 * Patron barcode search completion in the web staff client now allows
33 the user to select from all of the matching patron records.
34 * The web staff print templates for current and historical bills can
35 now include copy barcode and title.
36 * Fixes a bug that resulted in some catalog searches unexpectedly
37 timing out.
38 * Fixes a bug where placing a hold request in the public catalog could result
39 in "forgetting" the type and library of the user's previous search.
40 * Fixes a bug that made using the volume/copy editor to change a copy's
41 price problematic.
42 * The administration interface for hard due dates now ensures that
43 new (or edited) ceiling dates have their time component set to end
44 of day, resolving an issue where ceiling dates would not be applied
45 during the ceiling date itself.
46 * Asset merging during bibliographic record merging now correctly
47 recognizes call number prefixes and suffixes and deletes disused
48 call number records.
49 * The Concerto sample data set now includes data allowing for testing
50 placing holds on monographic parts.
51 * Fixes a bug where displaying user surveys could result in PCRUD
52 drone starvation.
53 * Fixes a bug where pg_restore of an Evergreen database could fail
54 to create certain indexes on the `actor.usr` table.
55
56 Acknowledgements
57 ~~~~~~~~~~~~~~~~
58 We would like to thank the following individuals who contributed code,
59 tests and documentation patches to the 2.12.8 point release of
60 Evergreen:
61
62 * Alex Cautley 
63 * Ben Shum 
64 * Bill Erickson 
65 * Cesar Velez 
66 * Chris Sharp 
67 * Galen Charlton 
68 * Jason Boyer 
69 * Jason Stephenson 
70 * Jeff Davis 
71 * Jeff Godin 
72 * Kathy Lussier 
73 * Kyle Huckins 
74 * Michele Morgan 
75 * Mike Rylander 
76 * Remington Steed 
77 * Rogan Hamby 
78
79 Evergreen 2.12.7
80 ----------------
81 This release contains several bug fixes improving on Evergreen 2.12.6
82
83 * Fixes a bug in the web staff client that prevented initials from being
84 stored with copy notes.
85 * Adds billing types that may have been missed by systems that were 
86 running Evergreen prior to the 1.4 release.
87 * Fixes a web staff client bug with the CSV export option available from
88 the Import Queue in the MARC Batch Import/Export interface.
89 * Adds the missing copy alert field in the web client's volume/copy
90 editor.
91 * Fixes a bug where the setting to require date of birth in patron
92 registration was not being honored in the web staff client.
93 * Fixes a bug in the web staff client patron registration form where the 
94 password wasn't generating from the last four digits of the patron's
95 phone number.
96 * Fixes an issue in the web staff client where the complete barcode did
97 not display in some interfaces when partial barcodes were scanned.
98
99 Acknowledgements
100 ~~~~~~~~~~~~~~~~
101 We would like to thank the following individuals who contributed code,
102 tests and documentation patches to the 2.12.7 point release of
103 Evergreen:
104
105 * Galen Charlton
106 * Bill Erickson
107 * Jeanette Lundgren
108 * Kathy Lussier
109 * Mike Rylander
110 * Jane Sandberg
111 * Chris Sharp
112 * Ben Shum
113 * Remington Steed
114 * Cesar Velez
115
116
117 Evergreen 2.12.6
118 ----------------
119 This release contains several bug fixes improving on Evergreen 2.12.5.
120
121 * Removes the option to add a title to My List from Group Formats and
122 Editions searches where the option never worked correctly due to a bad id.
123 * Removes deleted shelving locations from the web client's volume/copy editor. Since there is no database constraint that prevents a copy from a deleted shelving location, if there are already copies attached to those shelving locations, the copy location selector will be blank. Evergreen admins can identify those items by running the following query:
124
125 ----
126 select acp.id, acp.barcode, acpl.name
127 from asset.copy acp
128 join asset.copy_location acpl on (acpl.id = acp.location)
129 where not acp.deleted
130 and acpl.deleted
131 order by acp.id;
132 ----
133 * Adds the patron opt-in check in the web client whenever a patron is retrieved
134 by barcode scan, patron search, or item circ history.
135 * Fixes a bug where the price and acquisitions cost fields did not display
136 their values. 
137 * Fixes a bug where a patron's circulation history no longer moved to the lead
138 account when merging patron accounts.
139 * Now hides the ebook tabs in My Account for sites that have not yet enabled the
140 Ebook API service.
141 * Trims spaces from patron barcodes in the web client check out interface.
142 * Makes a string in the holds validation alert translatable. 
143 * Fixes a bug that prevented the web client patron registration screen from
144 loading when there is an opt-in action triggers, such as the email checkout
145 receipt, t set to be a registration default. 
146 * Fixes a bug where barcode validation in the web client patron editor was 
147 using the incorrect regular expression.
148 * Replaces an empty string in the mobile carrier dropdown menu with a 'Please
149 select your mobile carrier' label to improve usability and resolve a problem
150 with translations.
151 * Restores the ability to display a photo in the web client patron editor for
152 accounts that have an actor.usr.photo_url.
153 * Fixes a Firefox display issue in the web client that occurred when retrieving
154 a bib record by TCN when the MARC Edit tab was set as the default view.
155 * Fixes an bug where setting a patron's default pickup location in the web 
156 client patron editor inadvertently changed the home library. It also disables
157 any locations that are not viable pickup locations.
158 * Fixes a bug where a misscan in a copy bucket failed silently.
159
160 Acknowledgements
161 ~~~~~~~~~~~~~~~~
162 We would like to thank the following individuals who contributed code,
163 tests and documentation patches to the 2.12.6 point release of
164 Evergreen:
165
166 * Jason Boyer
167 * Galen Charlton
168 * Jeff Davis
169 * Bill Erickson
170 * Jason Etheridge
171 * Blake Henderson
172 * Skye Howard
173 * Kathy Lussier
174 * Terran McCanna
175 * Jane Sandberg
176 * Ben Shum
177 * Cesar Velez
178
179 Evergreen 2.12.5
180 ----------------
181 This release contains several bug fixes improving on Evergreen 2.12.4.
182
183 * Hides the _Hold is Behind Circ Desk_ checkbox in the XUL client's patron
184 registration screen for those libraries that have not enabled Behind Desk Pickup 
185 support via the Library Settings Editor
186 * Adds a missing error string that appears when marking an item damaged from
187 an aged circulation.
188 * Changes the hold request form so that it no longer defaults to the first SMS
189 carrier for text notifications.
190 * Adds a requirement for users to enter a phone/SMS number when they have
191 enabled that notification method on the hold request form.
192 * Changes the URL pointing to catalog images, CSS and javascript files to a full
193 absolute URL instead of the relative URL previously used. This change fixes an
194 issue with the Open Graph image property, which requires a full URL.
195 * Fixes an issue where payment amounts sent to Stripe can be one cent less than
196 the actual Evergreen payment.
197 * Fixes an issue where the open-ils.storage OpenSRF module fails to start when
198 using perl 5.24 or higher.
199 * Fixes a problem in the web client where marking a transaction as claims
200 returned or claims never checked out at the same time the patron's record is
201 edited would not increase the count once the patron's record is saved.
202 * Changes the cursor to a pointer for the record menus in the web client.
203 * Fixes hardcoded patchs in srfsh support scripts.
204 * Prevents a "Use of freed value in iteration" error that appeared in logs when
205 adjusting a transaction to zero.
206 * Prevents the temporary list page from crashing when a user adds the same title
207 to the list more than once.
208 * Removes duplicate rows from localized 950.data.seed-values.sql files.
209 * Fixes the following two issues with conjoined items:
210    - Foreign items previously did not display there was no extra copy attached
211 to the bib record.
212    - Conjoined items did not display unless there were two or more items in a
213 set.
214 * Fixes an issue in the web client where the Hold Verify prompt did not display
215 for items in a Copy Location where the hold verify flag is enabled.
216 * Fixes support for automatic item barcode completion in the web client check in,
217 check out, renew, and item status interfaces.
218 * Makes the courier code variable available for transit slips in the web client.
219 * Fixes the ability to apply funds from the acquisitions selection list, 
220 View/Place Order, and MARC Federated Search interfaces.
221
222 Acknowledgements
223 ~~~~~~~~~~~~~~~~
224 We would like to thank the following individuals who contributed code,
225 tests and documentation patches to the 2.12.5 point release of
226 Evergreen:
227
228 * Galen Charlton
229 * Jeff Davis
230 * Bill Erickson
231 * Jason Etheridge
232 * Kathy Lussier
233 * Michele Morgan
234 * Mike Rylander
235 * Dan Scott
236 * Chris Sharp
237 * Ben Shum
238 * Josh Stompro
239 * Cesar Velez
240 * Liam Whalen
241 * Dan Wells
242
243
244
245 Evergreen 2.12.4
246 ----------------
247 Upgrade Notes
248 ~~~~~~~~~~~~~
249 * This release of Evergreen contains a fix to the _Hold/Copy Ratio per Bib
250 and Pickup Library (and Descendants)_ data source. Report templates using
251 this data source will need to be re-created to improve accuracy of the
252 data reported from this source.
253 * This release also contains a fix to downloading large checkout histories from
254 My Account. This feature no longer uses the action/trigger mechanism and the 
255 OPAC now generates the CSV directly.  The old action/trigger code is still
256 present in the database and should be removed at some point in the
257 near future.
258
259 Bug Fixes
260 ~~~~~~~~~
261 This release contains several bug fixes improving on Evergreen 2.12.3
262
263
264 * A fix to a web client bug where adding copies through the _Add Volumes 
265 and Copies_ menu item could fail silently.
266 * A fix to a bug that allowed users to access some web client admin interfaces 
267 without a login.
268 * A fix to the display of the loan duration and fine level fields in the web
269 client Item Status Detail view.
270 * A fix to the display of duplicate data on the bib record View Holds page when 
271 toggling between the holds and OPAC view. 
272 * A fix to a bug that prevented the web client patron registration page from
273 loading.
274 * Support for Org Unit Includes alert text, notice text, event text, header
275 text, and footer text in the web client print templates.
276 * A fix to make the web client MARC Editor's flat text editor selection sticky.
277 * A fix to make the Patron Search library selector sticky.
278 * A fix to a bug in the web client that prevented the user from saving a new
279 copy after using the MARC Edit _Add Item_ option.
280 * A fix to a patron registration bug that did not require the entry of a required
281 user statistical category for stat cats that do not allow free-text entries.
282 * The addition of the bad bacode image file in the web client.
283 * An improvement to the MARC Batch Edit progress indicator to reduce the 
284 likelihood of system backlogs.
285 * Downloading checkout history as a CSV from My Account has been fixed
286 for users with a large circulation history.  Previously, this would
287 time out for patrons with more than 100 or so circulations.
288 * A fix to syntax in the Spanish lang.dtd file that was creating an error
289 when using the Closed Date Editor.
290 * Improvements to CSS to silence some Mozilla extension warnings.
291 * A fix to a failure to update targeted circulations when utilzing the recall
292 functionality.
293 * The addition of text wrapping in the copy details table on the bib
294 record to prevent contents from falling off the page.
295 * A fix to the adjust to zero option so that it can be applied correctly
296 to multiple billings.
297 * A fix to the "Hold/Copy Ratio per Bib and Pickup Library
298 (and Descendants)" data source so that it will now include counts of eligible
299 copies at locations that are not a pickup library for bib's holds.
300 * A fix to the XUL client Item Status -> Alternate View -> Holds / Transit
301 tab so that it properly refreshes all data when switching between copies.
302
303 Acknowledgements
304 ~~~~~~~~~~~~~~~~
305 We would like to thank the following individuals who contributed code,
306 tests and documentation patches to the 2.12.4 point release of
307 Evergreen:
308
309 * Jason Boyer
310 * Galen Charlton
311 * Jeff Davis
312 * Bill Erickson
313 * Jason Etherige
314 * Pasi Kallinen
315 * Angela Kilsdonk
316 * Kathy Lussier
317 * Michele Morgan
318 * Mike Rylander
319 * Jane Sandberg
320 * Dan Scott
321 * Ben Shum
322 * Jason Stephenson
323 * Josh Stompro
324 * Cesar Velez
325 * Dan Wells
326
327 Evergreen 2.12.3
328 ----------------
329
330 This release contains several bug fixes improving on Evergreen 2.12.2.
331
332 Web Client Bug Fixes
333 ~~~~~~~~~~~~~~~~~~~~
334 The web client, which is available for trial production use in libraries,
335 received several fixes in this release:
336
337 * The receipt on payment checkbox now prints a receipt at time of payment.
338 * The Items Out count in the patron screen now includes long overdue
339 items.
340 * A fix was added to prevent values from a previously-edited patron from
341 appearing in the edit form of a subsequent patron.
342 * User notification preferences now save correctly in the patron
343 registration and edit forms.
344 * The UPDATE_MARC permission is no longer requested when performing a
345 search from the staff catalog.
346 * Non-cataloged circulations now display in the Items Out screen without
347 requiring a refresh.
348 * Required statistical categories are now required to be entered in the 
349 copy editor. (A similar bug for the patron editor was fixed in the 2.12.1
350 release).
351 * Voiding bills now requires confirmation.
352 * Staff can no longer use the copy editor to put items into or out of the
353 following statuses: checked out, lost, in transit, on holds shelf, long
354 overdue, and canceled transit.
355 * The contrast is improved for alert text showing the amount a patron owes
356 in bills.
357 * Circ modifiers now sort alphabetically in the copy editor.
358
359 Other Bug Fixes
360 ~~~~~~~~~~~~~~~
361 * Code to prevent a hold already on the Holds Shelf from being
362 transferred to another title.
363 * A fix to a bug that prevented users from scheduling reports with a
364 relative month if the report template used a date that applied the Year +
365 Month transform with the On or After (>=) operator.
366 * A fix to a bug where the max fines threshold was reached prematurely
367 due to the presence of account adjustments.
368 * A check that prevents a SMS message from attempting to sending when the SMS
369 carrier is null.
370 * For systems that provide search format as a filter on the advanced
371 search page, a fix so that the format selected in the search bar when
372 launching a new search from the results page overrides any previously-set 
373 formats.
374 * The addition of an optional new Apache/mod_perl configuration variable for
375 defining the port Apache listens on for HTTP traffic. This resolves an issue
376 where added content lookups attempting HTTP requests on the local Apache
377 instance on port 80 failed because Apache was using non-standard ports.
378 * A fix to the public catalog's My List page responsive design so that it now
379 displays properly on mobile devices and allows users to place holds from My List. 
380 * A fix to a bug where the second (and subsequent)
381 pages of search results in the public catalog (when group
382 formats and editions is in effect) does not correctly generate
383 links to hits that are not part of of a multi-bib metarecords.
384
385 Acknowledgements
386 ~~~~~~~~~~~~~~~~
387 We would like to thank the following individuals who contributed code,
388 testing and documentation patches to the 2.12.3 point release of
389 Evergreen:
390
391 * Jason Boyer
392 * Galen Charlton
393 * Jeff Davis
394 * Bill Erickson
395 * Jason Etheridge
396 * Kathy Lussier
397 * Terran McCanna
398 * Dan Scott
399 * Chris Sharp
400 * Ben Shum
401 * Remington Steed
402 * Cesar Velez
403 * Dan Wells
404
405 Evergreen 2.12.2
406 ----------------
407
408 This release is a security release that also contains several other bug
409 fixes improving on Evergreen 2.12.1.
410
411 Security Issue: XSS Vulnerability in Public Catalog
412 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
413 This release fixes several cross-site scripting (XSS) vulnerabilities
414 in the public catalog. When upgrading, Evergreen administrators should
415 review whether any of the following templates have been customized
416 or overridden. If so, either the template should be replaced with the
417 stock version or the XSS fix (which entails adding the `| html` filter
418 in several places) applied to the customized version.
419
420 * `Open-ILS/src/templates/opac/parts/locale_picker.tt2`
421 * `Open-ILS/src/templates/opac/parts/login/form.tt2`
422 * `Open-ILS/src/templates/opac/parts/searchbar.tt2`
423
424 Upgrade Notes
425 ~~~~~~~~~~~~~
426 * Administrators of Evergreen who use RTL locales and who have customized
427 `style-rtl.css.tt2` should now incorporate their customizations into
428 `style.css.tt2`.
429 * The `reporter.classic_current_circ` view, which is part of some
430 extra views defined in `Open-ILS/src/sql/Pg/example.reporter-extension.sql`,
431 has been fixed to not exclude loans for patrons who do not have a
432 billing address set. Users of this view should rerun
433 `Open-ILS/src/sql/Pg/example.reporter-extension.sql` during upgrade.
434
435 Hold Targeter Repairs and Improvements
436 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
437 A series of changes were made to the new hold targeter available in 2.12.
438
439 * Make the batch targeter more resilient to a single-hold failure.
440 * Additional batch targeter info logging.
441 * Set OSRF_LOG_CLIENT in hold_targeter_v2.pl for log tracing
442 * Removes the confusingly named --target-all option
443  ** The same behavior can be achieved by using --retarget-interval "0s"
444 * Removes --skip-viable (see --soft-retarget-interval below)
445
446 New --next-check-interval Option
447 ++++++++++++++++++++++++++++++++
448 Specify how long after the current run time the targeter will retarget
449 the currently affected holds. Applying a specific interval is useful
450 when the retarget-interval is shorter than the time between targeter
451 runs.
452
453 For example, if the targeter is run nightly at midnight with a
454 --retarget-interval 36h, you would set --next-check-interval to 48hr,
455 since the holds won't be processed again until 48 hours later. This
456 ensures that the org unit closed date checks are looking at the correct
457 date. 
458
459 This setting overrides the default behavior of calculating the next 
460 retarget time from the retarget-interval.
461
462 New --soft-retarget-interval Option
463 +++++++++++++++++++++++++++++++++++
464 This is a replacement for (and rebranding of) the --skip-viable option. 
465 The new option allows for time-based soft-targeting instead simple binary 
466 on/off soft-targeting.
467
468 How soft-targeting works:
469 * Update hold copy maps for all affected holds
470 * Holds with viable targets (on the pull list) are otherwise left alone.
471 * Holds without viable targets are retargeted in the usual manner. 
472
473 Other Bug Fixes
474 ~~~~~~~~~~~~~~
475 * A fix to remove the Chilifresh patron reviews header for Evergreen sites
476 that do not use Chilifresh.
477 * A fix that marks acquisitions POs as received when all line items on the 
478 PO are received or canceled.
479 * A typo fix to the long overdue override permission that prevented staff
480 from being able to override long overdue check ins.
481 * A fix to use a library's configured currency in SIP patron responses
482 instead of always using US dollars.
483 * A fix to SIP timeouts caused by invalid sessions
484 * A fix that allows boolean fields to be recognized in queries to the
485 Z39.50 server.
486 * A fix to use the correct method during adjust to zero on negative
487 balances.
488 * A correction to the datatype for the Vandelay Default Record Match Set
489 setting.
490 * The removal of the _Keep_ field from MARC Batch Import Item Attributes.
491 The field was not previously implemented.
492 * A fix to set the complete time value for grouped Action/Trigger events
493 when an event's state reach complete, consistent with non-grouped events.
494 * A fix to a bug in the rollover_phone_to_print.pl script that kept failed
495 call files from being moved.
496 * A new index for acq.edi_message that speeds up the check for duplicate
497 EDI messages.
498 * A fix that ensures JSON strings are converted to UTF8, ensuring that
499 non-ASCII data display correctly.
500 * A fix to avoid an erroneous unsaved data popup to appear during MARC
501 record creation.
502 * A typo fix in the web client's bill payment receipt template.
503 * A correction to ebook account links on the My Account Summary page.
504 * Improved responsive design for the ebook My Account screens so that
505 they display better on mobile devices.
506 * A fix to a bug that prevented a patron opt-in dialog from loading.
507 * The RTL stylesheet for the public catalog,
508 `templates/opac/css/style-rtl.css.tt2`, has been merged into the LTR
509 one (`templates/opac/css/style.css.tt2`). The combined stylesheet
510 template will emit RTL or LTR styles based on the value of
511 the `rtl` flag of the active locale. An `rtl` variable is also available
512 in the template to allow the correct style to be chosen.
513 * A fix to leaking of the internal port number to the client when
514 Apache is configured to use nonstandard ports in combination with a proxy
515 server.
516 * The addition of the vandelay.auto_overlay_bib_record upgrade script,
517 which was missed in a 2.1-2.2 era upgrade script. It isn't necessary for
518 sites that began using Evergreen since then to run the script, but
519 it is harmless to run.
520 * A web staff client fix that will hid the behind-desk option for
521 for libraries that do not support "Behind Desk Pickup".
522 * A web staff client fix that caused hold transit check ins to fail
523 silently when the transit destination does not have a holds address.
524 * A web staff client fix that now requires the entry of user statistical
525 categories in the patron editor if those stat cats are configured to
526 be required.
527 * A fix to a problem with the "Exclude Electronic Resources" checkbox
528 that prevented users from removing a selection from the box.
529 * The removal of the search format limiters from the new advanced search
530 limiter block on the search results page. The search format limiters
531 should not display there because they can be selected from the search bar.
532
533
534
535
536 Acknowledgements
537 ~~~~~~~~~~~~~~~~
538 We would like to thank the following individuals who contributed code,
539 testing and documentation patches to the 2.12.2 point release of
540 Evergreen:
541
542 * Galen Charlton
543 * Jeff Davis
544 * Bill Erickson
545 * Jason Etheridge
546 * Jeff Godin
547 * Blake Henderson
548 * Linda Jansova
549 * Kathy Lussier
550 * Jillianne Presley
551 * Jane Sandberg
552 * Dan Scott
553 * Chris Sharp
554 * Remington Steed
555 * Jason Stephenson
556 * Josh Stompro
557 * Remington Steed
558
559 Evergreen 2.12.1 
560 ----------------
561
562 This release contains several bug fixes improving on Evergreen 2.12.0
563
564 * A fix to the 2.12 upgrade of the subject|temporal and subject|geographic 
565 indexes, where the above-mentioned browse indexes were not turned off in favor
566 of new browse versions of the indexes. Sites that are upgrading from 2.12.0
567 can cancel the browse reingest that comes with the new upgrade script.
568
569 * A change to the default pickup library when staff place a hold. The place hold
570 screen will now default to the preferred pickup location for the patron. If the
571 patron does not have a preferred pickup location, it will default to the
572 patron's home library.
573 * A fix to a problem where users could not change the selected Org Unit on the
574 MARC Tag Tables server admin page.
575 * A fix to the seed data for translations for some Coded Value Map entries.
576 * The ability to skip the XUL staff client build when in make_release.
577 * Revised layout and styling for the advanced search limiter block that displays
578 on the search results page.
579 * A fix that silences a log warning that appears for every checkout where a hard
580 due date is not used.
581 * Tweaks for sounds that are used in the web staff client.
582 * The addition of f4 and ctrl-f2 as hotkeys in the web staff client.
583 * Additional help text for receipt templates in the web staff client.
584 * The reinstatement of the Reprint Last Receipt functionality in the web staff client.
585 * The ability in the web staff client copy editor to add new volumes to
586 libraries that were not selected in holdings view.
587 * A fix to a billing issue where transactions were not re-opened after they
588 acquired a non-zero balance at check in.
589 * A change to the web staff client work log to prevent it from storing 
590 unnecessary data.
591 * A fix to a translation issue for the record attributes displayed in the 
592 advanced search limiter block on the search results page.
593 * A fix to hold targeting for metarecord holds when the new hold targeter is
594 run in parallel mode.
595
596 Acknowledgements
597 ~~~~~~~~~~~~~~~~
598 We would like to thank the following individuals who contributed code,
599 testing and documentation patches to the 2.12.1 point release of
600 Evergreen:
601
602 * Eva Cerniňáková
603 * Galen Charlton
604 * Bill Erickson
605 * Jason Etherige
606 * Jeanette Lundgren
607 * Kathy Lussier
608 * Mike Rylander
609 * Jane Sandberg
610 * Dan Scott
611 * Ben Shum
612 * Robert Soulliere
613 * Jason Stephenson
614 * Josh Stompro
615 * Dan Wells
616
617
618 2.12.0 Upgrade notes
619 --------------------
620 Evergreen 2.12 now requires OpenSRF 2.5 or later; certain functionality
621 will not work if you attempt to run Evergreen 2.12 on OpenSRF 2.4. Evergreen
622 2.12 recommends PostgreSQL 9.4. The minimum supported version of PostgreSQL is
623 9.3.
624
625 The stock schema upgrade script performs a browse and facet reingest,
626 recalculates bib fingerprints, and remaps metarecords.
627
628 This version also adds two new services, `open-ils.ebook_api` and
629 `open-ils.hold-targeter`.
630
631 2.12.0 New Features
632 -------------------
633
634 Acquisitions
635 ~~~~~~~~~~~~
636 Default status for received line items
637 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
638 A new Library Setting has been added to allow libraries to set the default
639 status for received line items. The previous behavior was to use the
640 "In process" status for all acquisitions items that are received.
641
642
643 Administration
644 ~~~~~~~~~~~~~~
645
646
647
648 Additional SMS Carriers
649 ^^^^^^^^^^^^^^^^^^^^^^^
650 SMS carrier definitions are now included for Google Fi and
651 Republic Wireless. These will be automatically loaded when
652 installing a new Evergreen system; admins who wish to
653 add these definitions during an upgrade can use the following
654 email gateway values:
655
656  * Google Fi: `$number@msg.fi.google.com`
657  * Republic Wireless: `$number@text.republicwireless.com`
658
659
660
661
662 Bibliographic Fingerprint Improvements
663 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
664 The bibliographic fingerprint will now incorporate subfields $n and $p from MARC
665 title fields to better distinguish among records of the same series that
666 may share the same title but have a different part. With this change, these
667 MARC records will no longer be grouped together in a 'Group Formats & Editions'
668 search.
669
670 The bibliographic fingerprint was also changed to better distinguish among
671 the fields contributing to the fingerprint. This change will help the system
672 distinguish between a record for the movie _Blue Steel_ and another record for
673 the book _Blue_ written by Danielle Steel.
674
675
676
677
678
679
680 Batch Hold Targeter Speed-up and New Features
681 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
682
683 Adds a new `open-ils.hold-targeter` service, supporting new targeting options
684 and runtime optimizations to speed up targeting.  The service is launched
685 from a new targeting script, `hold_targeter_v2.pl` (default location:
686 `/openils/bin/hold_targeter_v2.pl`).
687
688 This code has no effect on the existing hold targeter, which is still
689 available as of this release and functions as before.
690
691 New Features/Options
692 ++++++++++++++++++++
693
694 * Adds a global configuration flag 'circ.holds.retarget_interval' for 
695   setting the hold retarget interval.
696
697 * `--target-all` option forces the targeter to process all active
698   holds, regardless of when they were last targeted.
699
700 * `--retarget-interval` option make is possible to override the new
701   'circ.holds.retarget_interval' setting via the command line 
702   when calling the hold targeter.
703
704 * `--skip-viable` option causes the hold targeter to avoid modifying 
705   the currently targeted copy (i.e. the copy on the pull list) for holds 
706   that target a viable (capturable) copy.  
707   {empty} +
708   {empty} +
709   For skipped holds, no entry is added to the unfulfilled_hold_list.
710   The set of potential copies (hold copy maps) are refreshed for all
711   processed holds, regardless of target viability.
712   {empty} +
713   {empty} +
714   This option is useful for 1.) finding targets for holds that require 
715   new targets and 2.) adding new/modified copies to the potential copy 
716   lists (for opportunistic capture) more frequently than you may want to do full
717   retargeting of all holds.
718
719 * `--newest-first` option processes holds in reverse order of request_time,
720   so that newer holds are (re)targeted first.  This is primarily useful
721   when a large backlog of old, un-targetable holds exist.  With 
722   `--newest-first`, the older holds will be processed last.
723
724 * `--parallel` option overrides the parallel settings found in `opensrf.xml`
725   for simpler modification and testing.
726
727 * `--lockfile` option allows the caller to specify a lock file instead
728   of using the default /tmp/hold_targeter-LOCK
729
730 * `--verbose` option prints progress info to STDOUT, showing the number of
731   holds processed per parallel targeter instance.
732
733 * When configured, hold target loops cycle through all org units (with 
734   targetable copies) instead of repeatedly targeting copies at the pickup
735   library when multiple targetable copies exist at the pickup library.
736
737 * When configured, hold target loops prioritize (targetable) org units
738   first by the number of previous target attempts, then by their 
739   weight/proximity.  This effectively back-fills org units that had no
740   targetable copies during earlier target loops so that they are 
741   targeted as many times as other org units (to the extent possible, 
742   anyway).
743
744 Examples
745 ++++++++
746
747 * Traditional daily hold targeter with a value set for 
748   'circ.holds.retarget_interval'.
749
750 [source,sh]
751 --------------------------------------------------------------------------
752 /openils/bin/hold_targeter_v2.pl
753 --------------------------------------------------------------------------
754
755 * (Re)target non-viable holds twice a day, only processing holds that 
756   have never been targeter or those that have not been re-targeted in
757   the last 12 hours.
758
759 [source,sh]
760 --------------------------------------------------------------------------
761 /openils/bin/hold_targeter_v2.pl --skip-viable --retarget-interval "12h"
762 --------------------------------------------------------------------------
763
764 * (Re)target non-viable holds twice a day, processing all holds regardless
765   of when or if they were targeted before, running 3 targeters in
766   parallel.
767
768 [source,sh]
769 --------------------------------------------------------------------------
770 /openils/bin/hold_targeter_v2.pl --skip-viable --target-all --parallel 3
771 --------------------------------------------------------------------------
772
773
774
775
776
777 Add separate make target for translators
778 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
779 For those only interested in building Evergreen translations, a separate
780 "translator" make target has been added to allow for easier installation
781 of i18n prerequisites.
782
783
784 Allow admin to specify where Perl modules will be installed
785 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
786 Add `--with-perlbase` option to `configure` to specify an alternative
787 location for installing the Perl modules. This can be useful for setups
788 that want to run the Perl modules from a shared filesystem or
789 environments that need to run multiple versions of Evergreen
790 simultaneously.
791
792 Users of `--with-perlbase` are responsible for ensuring that `PERL5LIB`
793 is set appropriately.
794
795
796
797 Addition of missing permissions
798 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
799 Required permissions that were previously missing from the stock data have now
800 been added. If Evergreen sites have already manually added these permissions,
801 the upgrade script will remove the old permission and create the new one,
802 maintaining any maps to permission groups, with the stock permission ID.
803
804
805
806
807
808 get_org_unit_ancestor_at_depth Helper Added to Action Trigger Reactor Helpers
809 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
810 In action trigger templates it's now possible to call
811 `helpers.get_org_unit_ancestor_at_depth($id_or_aou, $depth)` in order to retrieve
812 a fleshed aou for the target aou's ancestor at the chosen depth. This could be
813 used to retrieve the name of the library system rather than a specific branch
814 name, for instance.
815
816
817
818
819 Removed unused selfcheck password setting
820 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
821 There was an unused duplicate selfcheck password setting that was removed
822 to avoid confusion over which library setting was supposed to be set to
823 enable passwords for selfcheck. After upgrading, verify that your library
824 policy remains consistent for this setting.
825
826
827
828
829
830 Credit Processor Stripe Settings Permissions
831 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
832 Unprivileged users can retrieve organizational unit setting values for
833 setting types lacking a "view" permission.  When the feature adding
834 Stripe credit card processing was added, the upgrade script neglected
835 to add the VIEW_CREDIT_CARD_PROCESSING permission to the
836 organizational unit setting type.  This means that anyone can retrieve
837 and view the settings for Stripe credit card processing.
838
839 Any system that upgraded from Evergreen version 2.5 to 2.6 is
840 affected.  If you use Stripe for credit card processing, it is
841 strongly recommended that you apply this upgrade.  Even if you do not
842 use Stripe, applying this upgrade is still recommended.  If you did
843 not upgrade from version 2.5 to 2.6 of Evergreen, but started with a
844 later version, applying this upgrade is harmless.
845
846
847
848
849 Cataloging
850 ~~~~~~~~~~
851
852
853
854 New Access Points for MARC Merge/Overlay Profiles
855 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
856 Catalogers can now select a MARC merge/overlay profile to apply when
857 merging records in the (browser client) record bucket merge and Z39.50
858 record overlay interfaces. In both interfaces, if the user selects
859 a merge profile, the results of the merge are displayed, giving the
860 user the opportunity to choose a different merge profile or edit
861 the records involved prior to committing to the merge.
862
863 A new library setting, "Default Merge Profile (Z39.50 and Record Buckets)",
864 specifies the merge profile to preselect in the new merge profile
865 selectors in the record bucket merge and Z39.50 overlay logs. The
866 selectors will also remember the last selection that the user made.
867
868
869
870
871 Circulation
872 ~~~~~~~~~~~
873
874
875
876 Display Copy Alerts With In-House-Use
877 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
878
879 Two library settings are used to control the display of copy alert
880 messages or copy location check in alerts when recording in-house-use
881 in Evergreen.
882
883 Setting 'Display copy alert for in-house-use' to true for an
884 organization will cause an alert to appear with the copy's alert
885 message, if it has one, when recording in-house-use for the copy.
886
887 Setting 'Display copy location check in alert for in-house-use' to true
888 for an organization will cause an alert to display a message
889 indicating that the item needs to be routed to its location if the
890 location has check in alert set to true.
891
892 The settings are independent of one another because you may want to
893 display one and not the other when recording in-house-use.
894
895
896
897
898 Client
899 ~~~~~~
900
901
902
903 Active Date Column Picker Option
904 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
905 The active date will now be available as a column picker option in the Item
906 Status screen.
907
908
909
910
911 Punctuation Insensitive Patron Search
912 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
913 When performing a patron search, punctuation characters will be
914 ignored.  So if the patron is named O'Brien, then you can enter Obrien,
915 O'Brien, O Brien, etc. in the search box.
916
917 This behavior affects the Last Name (internally: family_name), First Name
918 (first_given_name), and Middle Name (second_given_name) fields of the search.
919
920
921
922
923
924
925 Touch screen improvements for Evergreen self-check interface
926 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
927 Improvements were made to the Evergreen self-check interface to make it easier
928 to use in a touch-screen environment.
929
930  * The pay fines link is now a pay fines button, matching other buttons on the
931 page.
932  * The checkboxes have been enlarged, making them easier to activate when using
933 a touch screen.
934
935
936
937
938
939 Trial Production Use of the Web Staff Client
940 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
941 The new web staff client is ready for trial production use in all functional
942 areas with the exception of serials and offline transactions. In addition to
943 many bug fixes in the areas of circulation, cataloging, administration and
944 reporting, Release 2.12 sees the following additions to web client
945 functionality.
946
947  * Acquisitions interfaces and functionality have been integrated into the web
948  staff client.
949  * Booking interfaces and functionality have been integrated into the web staff
950  client.
951  * Hatch, the program that will allow for unmediated printing to multiple
952  printers, sharing of workstation settings, and, eventually, offline 
953  transactions is now available. A windows installer for Hatch will be available
954  on the Evergreen-ILS Downloads page.
955
956 The Evergreen developers will keep pilot libraries updated about known web
957 client issues by posting known bugs to https://wiki.evergreen-ils.org/doku.php?id=dev:browser_staff:known_issues .
958
959 About Hatch
960 +++++++++++
961 Hatch is not required to use the web client, but should be used for workstations
962 that need to perform the following tasks.
963
964  * Unmediated printing to multiple printers. Workstations can print to multiple
965  printers without Hatch, but will need to click through a dialog to select a
966  printer. Hatch allows workstations to automatically print, without dialog, to
967  different printers. 
968  * Storage of workstation settings in a place outside the browser. Storing local
969  preferences in hatch will prevent tampering with preferences via the browser
970  developer tools and protect the settings from possible deletion if the browser
971  deletes settings in local storage.
972  * When offline functionality is available, hatch will be required to perform
973  offline transactions.
974  
975 Hatch is currently run as a Chrome extension and is not available in Firefox. To
976 use hatch on Windows, Evergreen sites should:
977
978  . install a java runtime environment version 8 (or higher) if not already
979  installed,
980  . download and execute the installer from the Evergreen downloads page, 
981  . open Chrome and navigate to chrome://extensions,
982  . enable _Developer Mode_ along the top right of the page,
983  . click the _Load Unpacked Extension_ button,
984  . load the directory at Hatch -> extension -> app,
985  .. In Windows, the default location for the app directory will be
986  C:\Program Files (x86)\Hatch\extension\app
987  . enable hatch features in the web client by going to Administration ->
988  Workstation Administration -> Print/Storage Service ("Hatch") and choosing
989  which services to use with Hatch.
990  .. this page will also inform you that hatch is connected. 
991
992
993
994
995 Infrastructure
996 ~~~~~~~~~~~~~~
997
998
999
1000 Client Timezone Awareness
1001 ^^^^^^^^^^^^^^^^^^^^^^^^^
1002
1003 Previously, adjusting the time zone in which a database session operates
1004 could not be done in any way except globally, directly within the database.
1005 However, allowing modification of the timezone parameter now supports
1006 localization efforts for those consortia that span multiple time zones.
1007
1008 Implementation
1009 ++++++++++++++
1010
1011 CStore and other services that interact with the primary Evergreen database
1012 make use of the functionality provided by LP#1485371 in OpenSRF in order to
1013 set the time zone configuration parameter available in PostgreSQL.  This has
1014 the effect of interpreting all timestamps written to or read from the database
1015 in the client's time zone.
1016
1017 Within CStore (and related, C-based services), all stateful sessions make use
1018 of this capability, setting the database time zone upon a successful CONNECT
1019 message from the client.  The time zone is reset to the database default when
1020 a session is terminated either due to client DISCONNECT or server keepalive
1021 timeout.
1022
1023 All stateless requests record the current database time zone, set the database
1024 time zone to that of the client's, run the query, and then reset the database
1025 time zone on each request that carries a client time zone value.  It is expected
1026 that this will not cause any noticeable increase in latency or query execution
1027 time, as this setting is local to the specific PostgreSQL server backend process.
1028
1029 Within the Storage service, the timezone will be set automatically by a simple
1030 wrapper method used by the existing method registration mechanism for method
1031 publishing.  Disconnect and error callbacks are registered to revert the time
1032 zone setting within the database.  This provides completely transparent time
1033 zone manipulation for backend services that make use of open-ils.storage.
1034
1035
1036
1037
1038 Public Catalog
1039 ~~~~~~~~~~~~~~
1040
1041
1042
1043 New Subject Browse Index Definitions
1044 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1045 New subject browse index definitions have been added that display the entire
1046 heading as a unit with hyphens between terms instead of displaying individual
1047 terms separately. 
1048
1049 For example, the browse heading for:
1050
1051 =650 \0$aCats$zUnited States$vCorrespondence.
1052
1053 will display in a single entry as:
1054
1055 Cats -- United States -- Correspondence
1056
1057 Rather than separate entries for Cats and United States. 
1058
1059 Name subjects will continue to display as separate entries because additional
1060 work would be required for the heading to be punctuated correctly.
1061
1062
1063
1064
1065 Advanced Search Limiters Enhancement
1066 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1067 Advanced search limiters will no longer propagate to the basic search box in
1068 the catalog. Instead, the limiters applied to the search will appear underneath
1069 the search box where they can be easily cleared by clicking an 'x.' On a small,
1070 mobile device, the advanced search limiters can be seen by clicking an 'x filter
1071 applied' link. 
1072
1073 The selected limiters will be applied to any search from the search bar until:
1074  * The user actively removes the filters from the search or
1075  * The user starts a new basic or advanced search from scratch.
1076
1077
1078
1079
1080 Arabic and Right-to-Left Language Support for the catalog
1081 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1082 New stylesheets and other changes to the catalog to allow for 
1083 better support of right-to-left (RTL) languages, such as Arabic.
1084
1085 Also adds Arabic (Jordan) as a new supported language.
1086
1087
1088
1089
1090 Ebook API integration
1091 ^^^^^^^^^^^^^^^^^^^^^
1092 Evergreen 2.12 supports partial integration with third-party APIs
1093 provided by OverDrive and OneClickdigital.  When ebook API integration
1094 is enabled, bibliographic records from these vendors that appear in your
1095 public catalog will include vendor holdings and availability information.  Also,
1096 when a user is logged in, the public catalog dashboard and My Account interface
1097 will include information about that user's checkouts and holds for
1098 supported vendors.
1099
1100 For API integration to work, you need to request API access from the
1101 vendor and configure your Evergreen system according to the instructions
1102 below.  You also need to configure the new `open-ils.ebook_api` service.
1103
1104 This feature assumes that you are importing MARC records supplied by the
1105 vendor into your Evergreen system, using Vandelay or some other MARC
1106 import method.  This feature does not search the vendor's online
1107 collections or automatically import vendor records into your system; it
1108 merely augments records that are already in Evergreen.
1109
1110 A future Evergreen release will add the ability for users to check out
1111 titles, place holds, etc., directly via the public catalog.
1112
1113 Ebook API service configuration
1114 +++++++++++++++++++++++++++++++
1115 This feature uses the new `open-ils.ebook_api` OpenSRF service.  This
1116 service must be configured in your `opensrf.xml` and `opensrf_core.xml`
1117 config files for ebook API integration to work.  See
1118 `opensrf.xml.example` and `opensrf_core.xml.example` for guidance.
1119
1120 OverDrive API integration
1121 +++++++++++++++++++++++++
1122 Before enabling OverDrive API integration, you will need to request API
1123 access from OverDrive.  OverDrive will provide the values to be used for
1124 the following new org unit settings:
1125
1126   * *OverDrive Basic Token*: The basic token used for API client
1127     authentication.  To generate your basic token, combine your client
1128     key and client secret provided by OverDrive into a single string
1129     ("key:secret"), and then base64-encode that string.  On Linux, you
1130     can use the following command: `echo -n "key:secret" | base64 -`
1131   * *OverDrive Account ID*: The account ID (a.k.a. library ID) for your
1132     OverDrive API account.
1133   * *OverDrive Website ID*: The website ID for your OverDrive API
1134     account.
1135   * *OverDrive Authorization Name*: The authorization name (a.k.a.
1136     library name) designated by OverDrive for your library.  If your
1137     OverDrive subscription includes multiple Evergreen libraries, you
1138     will need to add a separate value for this setting for each
1139     participating library.
1140   * *OverDrive Password Required*: If your library's OverDrive
1141     subscription requires the patron's PIN (password) to be provided
1142     during patron authentication, set this setting to "true."  If you do
1143     not require the patron's PIN for OverDrive authentication, set this
1144     setting to "false."  (If set to "true," the password entered by a
1145     patron when logging into the public catalog will be cached in plain text in
1146     memcached.)
1147   * *OverDrive Discovery API Base URI* and *OverDrive Circulation API
1148     Base URI*: By default, Evergreen uses OverDrive's production API, so
1149     you should not need to set a value for these settings.  If you want
1150     to use OverDrive's integration environment, you will need to add the
1151     appropriate base URIs for the discovery and circulation APIs.  See
1152     OverDrive's developer documentation for details.
1153   * *OverDrive Granted Authorization Redirect URI*: Evergreen does not
1154     currently support granted authorization with OverDrive, so this
1155     setting is not currently in use.
1156
1157 For more information, consult the
1158 https://developer.overdrive.com/docs/getting-started[OverDrive API
1159 documentation].
1160
1161 To enable OverDrive API integration, adjust the following public catalog settings
1162 in `config.tt2`:
1163
1164   * `ebook_api.enabled`: set to "true".
1165   * `ebook_api.overdrive.enabled`: set to "true".
1166   * `ebook_api.overdrive.base_uris`: list of regular expressions
1167     matching OverDrive URLs found in the 856$9 field of older OverDrive
1168     MARC records.  As of fall 2016, OverDrive's URL format has changed,
1169     and the record identifier is now found in the 037$a field of their
1170     MARC records, with "OverDrive" in 037$b.  Evergreen will check the
1171     037 field for OverDrive record identifiers; if your system includes
1172     older-style OverDrive records with the record identifier embedded in
1173     the 856 URL, you need to specify URL patterns with this setting.
1174
1175 OneClickdigital API integration
1176 +++++++++++++++++++++++++++++++
1177 Before enabling OneClickdigital API integration, you will need to
1178 request API access from OneClickdigital.  OneClickdigital will provide
1179 the values to be used for the following new org unit settings:
1180
1181   * *OneClickdigital Library ID*: The identifier assigned to your
1182     library by OneClickdigital.
1183   * *OneClickdigital Basic Token*: Your client authentication token,
1184     supplied by OneClickdigital when you request access to their API.
1185
1186 For more information, consult the
1187 http://developer.oneclickdigital.us/[OneClickdigital API documentation].
1188
1189 To enable OneClickdigital API integration, adjust the following public catalog
1190 settings in `config.tt2`:
1191
1192   * `ebook_api.enabled`: set to "true".
1193   * `ebook_api.oneclickdigital.enabled`: set to "true".
1194   * `ebook_api.oneclickdigital.base_uris`: list of regular expressions
1195     matching OneClickdigital URLs found in the 859$9 field of your MARC
1196     records.  Evergreen uses the patterns specified here to extract
1197     record identifiers for OneClickdigital titles.
1198
1199 Additional configuration
1200 ++++++++++++++++++++++++
1201 Evergreen communicates with third-party vendor APIs using the new
1202 `OpenILS::Utils::HTTPClient` module.  This module is configured using
1203 settings in `opensrf.xml`.  The default settings should work for most
1204 environments by default, but you may need to specify a custom location
1205 for the CA certificates installed on your server.  You can also disable
1206 SSL certificate verification on HTTPClient requests altogether, but
1207 doing so is emphatically discouraged.
1208
1209
1210
1211 Links to Other Formats and Editions
1212 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1213 The record summary pages in the catalog will now link to other formats and
1214 editions of a title. The links will allow users to quickly jump to another
1215 format of the title or an edition written in another language. 
1216
1217
1218
1219
1220
1221 Metarecord Search Improvements
1222 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1223 This release brings several improvement to the Group Formats and Editions
1224 search. 
1225
1226  * Limiters on the advanced search page can now be successfully applied to 
1227 Group Formats and Editions searches,
1228  * Electronic resources are now retrievable through these searches,
1229  * Paged navigation has improved.
1230
1231
1232
1233
1234 Allow Metarecord Search by default
1235 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1236 Before the TPAC, a site could configure the public catalog to use metarecord searching
1237 by default, via a configuration file.  Here we bring that back.
1238
1239 A new setting called search.metarecord_default is present in
1240 `templates/opac/parts/config.tt2` to enable this feature.  By setting this to
1241 a true value (normally 1) the TPAC will silently include the #metabib search
1242 modifier in the search form on any interfaces that do not have a UI component
1243 that allows the user to control the setting.
1244
1245
1246
1247 RDA Improvements
1248 ^^^^^^^^^^^^^^^^
1249  * Author fields are now normalized to strip ending periods so that authors from
1250 RDA and non-RDA records are collapsed in browse and facet headings.
1251  * All author/contributor roles will now display in the record detail page.
1252 Previously, some of the roles were omitted or were duplicated.
1253
1254
1255 Obalkyknih.cz Integration
1256 ^^^^^^^^^^^^^^^^^^^^^^^^^
1257 Evergreen now integrates with Czech added content provider obalkyknih.cz. A new
1258 setting called obalkyknih_cz.enabled is available in
1259 `templates/opac/parts/config.tt2` to enable this new feature.
1260
1261
1262 2.12.0 Acknowledgments
1263 ----------------------
1264 The Evergreen project would like to acknowledge the following
1265 organizations that commissioned developments in this release of
1266 Evergreen:
1267
1268 * Bibliomation
1269 * British Columbia Libraries Cooperative
1270 * C/W MARS
1271 * Georgia PINES
1272 * King County Library System
1273 * Linn Libraries Consortium
1274 * MassLNC
1275 * Pennsylvania Integrated Library System
1276 * Pioneer Library System
1277
1278 We would also like to thank the following individuals who contributed
1279 code, translations, documentations patches and tests to this release of
1280 Evergreen:
1281
1282 * Adam Bowling
1283 * Anahi Valdez
1284 * Ben Shum
1285 * Bill Erickson
1286 * Billy Horn
1287 * Blake Henderson
1288 * Bob Wicksall
1289 * Chris Sharp
1290 * Christine Burns
1291 * Christine Morgan
1292 * Clare Sobotka
1293 * Dan Pearl
1294 * Dan Scott
1295 * Dan Wells
1296 * Darrell Rodgers
1297 * Debbie Luchenbill
1298 * Eva Cerninakova
1299 * Fares Othman
1300 * Galen Charlton
1301 * Jakub Kotrla
1302 * Jane Sandberg
1303 * Jason Boyer
1304 * Jason Etheridge
1305 * Jason Stephenson
1306 * Jeanette Lundgren
1307 * Jeff Davis
1308 * Jeff Godin
1309 * Jennifer Pringle
1310 * Jillianne Presley
1311 * Jim Keenan
1312 * Job Diógenes Ribeiro Borges
1313 * Jonathan Schatz
1314 * Josh Stompro
1315 * Kate Butler
1316 * Kathy Lussier
1317 * Kyle Huckins
1318 * Linda Jansová 
1319 * Michele Morgan
1320 * Michelle Purcell
1321 * Mike Rylander
1322 * Nawras Othman
1323 * Remington Steed
1324 * Rogan Hamby
1325 * Terran McCanna
1326 * Thomas Berezansky
1327 * Victoria Lewis
1328
1329 We also thank the following organizations whose employees contributed
1330 patches:
1331
1332 * British Columbia Libraries Cooperative
1333 * Calvin College
1334 * Catalyst DevWorks
1335 * C/W MARS
1336 * Emerald Data Networks, Inc.
1337 * Equinox Open Library Initiative
1338 * Georgia PINES
1339 * Indiana State Library
1340 * The Institute for the Study of Totalitarian Regimes, Prague
1341 * Jabok Library
1342 * Jordanian Library and Information Association
1343 * King County Library System
1344 * Lake Agassiz Regional Library
1345 * Laurentian University
1346 * Linn-Benton Community College
1347 * MassLNC
1348 * Merrimack Valley Library Consortium
1349 * MOBIUS Consortium
1350 * North of Boston Library Exchange
1351 * Pioneer Library System
1352 * Rodgers Memorial Library
1353 * Sigio
1354 * Traverse Area District Library
1355
1356
1357 We regret any omissions.  If a contributor has been inadvertently
1358 missed, please open a bug at https://bugs.launchpad.net/evergreen/
1359 with a correction.
1360