LP#1915219: opt-in setting for overdue and predue emails
[Evergreen.git] / docs / RELEASE_NOTES_NEXT / Circulation / overdue-email-opt-in-setting.adoc
1 Opt-In Setting for Overdue and Predue Emails
2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
3 The "Receive Overdue and Courtesy Emails" user setting permits users to
4 control whether they receive email notifications about overdue items.
5
6 To use the setting, modify any action trigger event definitions which
7 send emails about overdue items, setting the "Opt In Setting" to
8 "circ.default_overdue_notices_enabled" and the "User Field" to "usr".
9 You can accomplish this by running the following query in your database:
10
11 ----
12 UPDATE action_trigger.event_definition
13 SET opt_in_setting = 'circ.default_overdue_notices_enabled',
14     usr_field = 'usr'
15 WHERE opt_in_setting IS NULL
16     AND hook = 'checkout.due'
17     AND reactor = 'SendEmail';
18 ----
19
20 Once this is done, the patron registration screen in the staff client
21 will show a "Receive Overdue and Courtesy Emails" checkbox, which will
22 be checked by default.  To ensure that existing patrons continue to
23 recieve email notifications, you will need to add the user setting to
24 their accounts, which you can do by running the following query in your
25 database:
26
27 ----
28 INSERT INTO actor.usr_setting (usr, name, value)
29 SELECT
30     id,
31     'circ.default_overdue_notices_enabled',
32     'true'
33 FROM actor.usr;
34 ----
35
36