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