Bug 12532: Send email to guarantee and guarantor
[koha.git] / koha-tmpl / intranet-tmpl / prog / en / modules / admin / preferences / patrons.pref
1 Patrons:
2     General:
3      -
4          - pref: CheckPrevCheckout
5            default: no
6            choices:
7                hardyes: "Do"
8                softyes: "Unless overridden by patron category, do"
9                softno: "Unless overridden by patron category, do not"
10                hardno: "Do not"
11          - " check borrower checkout history to see if the current item has been checked out before."
12      -
13          - "Trigger a warning if the current item has been checked out no longer than"
14          - pref: CheckPrevCheckoutDelay
15            default: 0
16          - "days ago."
17          - "Requires <a href='/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=CheckPrevCheckout'>CheckPrevCheckout</a> to be enabled. There is no time limit if 0 or empty."
18      -
19          - pref: ExtendedPatronAttributes
20            choices:
21                1: Enable
22                0: "Don't enable"
23          - searching, editing and display of custom attributes on patrons.
24      -
25          - pref: intranetreadinghistory
26            choices:
27                1: "Allow"
28                0: "Don't allow"
29          - "staff to access a patron's checkout and hold history (checkout history is still stored, regardless of staff being allowed access or not)."
30      -
31          - "When deleting a patron who owns public or shared lists,"
32          - pref: ListOwnershipUponPatronDeletion
33            choices:
34             delete: "delete these lists."
35             transfer: "change owner of these lists."
36          - All public or shared lists of this patron are either deleted or transferred to a new owner according to your choice; other private lists (not shared) are deleted.
37          - "<br/>When changing owner at patron deletion, use borrowernumber "
38          - pref: ListOwnerDesignated
39            class: integer
40          - as new list owner, or leave this field empty in order to change owner to the active staff member who deletes the patron.
41      -
42          - The late fine for all checkouts will only go up to
43          - pref: MaxFine
44            class: currency
45          - '[% local_currency %].'
46          - Empty value means no limit. Single item caps are specified in the circulation rules matrix.
47      -
48          - pref: patronimages
49            choices:
50                1: Allow
51                0: "Don't allow"
52          - images to be uploaded and shown for patrons on the staff interface.
53      -
54          - By default, show
55          - pref: PatronsPerPage
56            class: integer
57          - results per page in the staff interface.
58      -
59          - "Pipe separated list defining the default fields to be used during a patron search using the \"standard\" option in the patrons or circulation module:"
60          - pref: DefaultPatronSearchFields
61            type: modalselect
62            source: borrowers
63            exclusions: anonymized|auth_method|autorenew_checkouts|date_renewed|dateenrolled|dateexpiry|lang|lastseen|login_attempts|overdrive_auth_token|password|password_expiration_date|primary_contact_method|gonenoaddress|lost|debarred|debarredcomment|branchcode|categorycode|flags|guarantorid|relationship|privacy|privacy_guarantor_checkouts|privacy_guarantor_fines|pronouns|secret|sms_provider_id|updated_on|checkprevcheckout
64          - "If empty Koha will default to \"firstname|middle_name|surname|othernames|cardnumber|userid\". Additional fields added to this preference will be added as search options in the dropdown menu on the patron search page."
65      -
66          - pref: DefaultPatronSearchMethod
67            choices:
68                starts_with: "Starts with"
69                contains: "Contains"
70          - Enable this search method to determine whether to use Starts with or Contains for autocomplete patron searches.
71      -
72          - "Show the following fields from the items database table as columns on the statistics tab on the patron record: "
73          - pref: StatisticsFields
74            type: modalselect
75            source: items
76          - "If empty, defaults to: location|itype|ccode"
77      -
78          - pref: EnableBorrowerFiles
79            choices:
80                1: Do
81                0: "Don't"
82          - enable the ability to upload and attach arbitrary files to a borrower record.
83      -
84          - pref: useDischarge
85            choices:
86                1: Allow
87                0: "Don't allow"
88          - librarians to discharge borrowers and borrowers to request a discharge.
89      -
90          - pref: FeeOnChangePatronCategory
91            choices:
92                1: Do
93                0: "Don't"
94          - charge a fee when a patron changes to a category with an enrollment fee.
95      -
96          - pref: TrackLastPatronActivity
97            choices:
98                1: Do
99                0: "Don't"
100          - track last patron activity.
101          - The first time each day that a patron logs into the OPAC, connects to Koha via SIP or ILS-DI, or checks an item out the borrowers.lastseen will update with the current date and time.
102      -
103          - pref: AutoApprovePatronProfileSettings
104            choices:
105                1: Enable
106                0: Disable
107          - "automatic approval of patron detail changes from the OPAC."
108          - Requires <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACPatronDetails">OPACPatronDetails</a> to be activated.
109      -
110          - pref: ProtectSuperlibrarianPrivileges
111            choices:
112                1: Allow only superlibrarians
113                0: Allow all permitted users
114          - "to access/change superlibrarian privileges."
115          - "<br><strong>NOTE:</strong> A permitted user needs to have the 'permissions' flag (if no superlibrarian)."
116      -
117          - pref: AllowPatronToControlAutorenewal
118            choices:
119                1: Allow patrons
120                0: Allow only staff
121          - "to allow/disallow auto-renewal for account. If allowed a patron will be able to update their own account to allow/disallow auto-renewal."
122      -
123          - Lock expired patrons after
124          - pref: LockExpiredDelay
125            class: integer
126          - days. Leave empty to disable this behavior.
127          - "<br><strong>NOTE:</strong> This system preference requires the misc/cronjobs/cleanup_database.pl cronjob. Ask your system administrator to schedule it."
128
129     Membership expiry:
130      -
131          - When renewing borrowers, base the new expiry date on
132          - pref: BorrowerRenewalPeriodBase
133            choices:
134                now: current date.
135                dateexpiry: current membership expiry date.
136                combination: the latter of the current and expiry date.
137      -
138          - Show a notice if the patron is about to expire or has expired
139          - pref: NotifyBorrowerDeparture
140            class: integer
141          - days beforehand.
142      -
143          - Send an account expiration notice when a patron's card will expire in
144          - pref: MembershipExpiryDaysNotice
145            class: integer
146          - days.
147          - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/membership_expiry.pl</code> cronjob. Ask your system administrator to schedule it."
148     Notices and notifications:
149      -
150          - pref: EnhancedMessagingPreferences
151            choices:
152                1: Allow
153                0: "Don't allow"
154          - "staff to manage which notices patrons will receive and when they will receive them."
155          - '<br><strong>NOTE:</strong> This only applies to courtesy notices. To manage if patrons have also access to these settings, use <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=EnhancedMessagingPreferencesOPAC">EnhancedMessagingPreferencesOPAC</a>.'
156          - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/process_message_queue.pl</code> and the <code>misc/cronjobs/advance_notices.pl</code> cronjob. Ask your system administrator to schedule them."
157      -
158          - pref: EnhancedMessagingPreferencesOPAC
159            choices:
160                1: Show
161                0: "Don't show"
162          - "patron messaging setting on the OPAC."
163          - '<br><strong>NOTE:</strong> <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=EnhancedMessagingPreferences">EnhancedMessagingPreferences</a> must be enabled.'
164      -
165          - pref: AutoEmailNewUser
166            choices:
167                1: Send
168                0: "Don't send"
169          - an email to newly created patrons.
170          - '<br><strong>NOTE:</strong> This uses the WELCOME notice.'
171      -
172          - pref: NotifyPasswordChange
173            choices:
174                1: Notify
175                0: "Don't notify"
176          - patrons whenever their password is changed.
177      -
178          - pref: UseEmailReceipts
179            choices:
180                1: Send
181                0: "Don't send"
182          - email receipts to patrons for payments and writeoffs.
183      -
184          - "Use the patron's"
185          - pref: EmailFieldPrimary
186            default: "OFF"
187            choices:
188                email: primary email
189                emailpro: secondary email
190                B_email: alternate email
191                cardnumber: cardnumber
192                "OFF": first valid email address
193          - 'for sending out email notices.'
194          - '<br><strong>NOTE:</strong> If set to "first valid", the order in which the email addresses are checked is set in <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=EmailFieldPrecedence">EmailFieldPrecedence</a>.'
195      -
196          - "When <a href='/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=EmailFieldPrimary'>EmailFieldPrimary</a> is set to '<strong>first valid</strong>', check the patron email address fields in the following order and use the first valid email address found:"
197          - pref: EmailFieldPrecedence
198            class: multi
199          - '<br><strong>NOTE:</strong> All patron fields can be used, but to work correctly they must contain a valid email address or an empty string.'
200          - "Valid options are the <a href='http://schema.koha-community.org/__VERSION__/tables/borrowers.html' target='blank'>database columns</a> of the borrowers table, separated by | (pipe)."
201          - "Example: email|emailpro|B_email"
202      -
203          - pref: TalkingTechItivaPhoneNotification
204            choices:
205                1: Enable
206                0: Disable
207          - patron phone notifications using Talking Tech i-tiva (overdues, predues and holds notices currently supported).
208          - <br/><i class="fa fa-exclamation-triangle"></i> If <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=TalkingTechItivaPhoneNotification">TalkingTechItivaPhoneNotification</a> is enabled, <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=PhoneNotification">PhoneNotification</a> should be disabled.
209      -
210          - pref: PhoneNotification
211            choices:
212                1: Enable
213                0: Disable
214          - patron phone notifications generation. A plugin will be required to process the phone notifications.
215          - <br/><i class="fa fa-exclamation-triangle"></i> If <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=PhoneNotification">PhoneNotification</a> is enabled, <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=TalkingTechItivaPhoneNotification">TalkingTechItivaPhoneNotification</a> should be disabled.
216      -
217          - "Use the SMS::Send::"
218          - pref: SMSSendDriver
219          - driver to send SMS messages.
220          - "<br>If you would prefer to send SMS via E-mail, set SMSSendDriver to: Email"
221          - "<br><strong>NOTE:</strong> Many mobile providers have deprecated support for this feature and it is not recommended for use unless you have a dedicated SMS to Email gateway."
222      -
223          - "Define a username/login"
224          - pref: SMSSendUsername
225          - "and a password"
226          - pref: SMSSendPassword
227          - ". Override from address with"
228          - pref: EmailSMSSendDriverFromAddress
229            class: email
230          - "for emails sent using \"Email\" send driver."
231      -
232          - pref: FallbackToSMSIfNoEmail
233            choices:
234                1: Enable
235                0: Disable
236          - sending purchase suggestion messages by SMS if no patron email is defined.
237      -
238          - "Send automatic renewal notices: "
239          - pref: AutoRenewalNotices
240            choices:
241                never: never
242                preferences: according to patron messaging preferences
243                cron: (Deprecated) according to --send-notices cron switch
244     Patron forms:
245      -
246          - "The following <a href='http://schema.koha-community.org/__VERSION__/tables/borrowers.html' target='blank'>database columns</a> must be filled in on the patron entry screen:"
247          - pref: BorrowerMandatoryField
248            type: modalselect
249            source: borrowers
250            exclusions: flags
251          - '<strong>NOTE:</strong> If <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=autoMemberNum">autoMemberNum</a> is enabled, the system preference <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=BorrowerMandatoryField">BorrowerMandatoryField</a> must not contain the field <code>cardnumber</code>.'
252      -
253          - "The following <a href='http://schema.koha-community.org/__VERSION__/tables/borrowers.html' target='blank'>database columns</a> will not appear on the patron entry screen:"
254          - pref: BorrowerUnwantedField
255            type: modalselect
256            source: borrowers
257            exclusions: branchcode|categorycode|flags
258      -
259          - "Borrowers can have the following titles:"
260          - pref: BorrowersTitles
261            class: multi
262          - (separate multiple choices with |)
263      -
264          - pref: autoMemberNum
265            choices:
266                1: Do
267                0: "Don't"
268          - default the card number field on the patron addition screen to the next available card number (for example, if the largest currently used card number is 26345000012941, then this field will default to 26345000012942).
269          - '<strong>NOTE:</strong> If <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=autoMemberNum">autoMemberNum</a> is enabled, the system preference <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=BorrowerMandatoryField">BorrowerMandatoryField</a> must not contain the field <code>cardnumber</code>.'
270      -
271          - Card numbers for patrons must be
272          - pref: CardnumberLength
273          - "characters long. The length can be a single number to specify an exact length, a range separated by a comma (i.e., 'Min,Max'), or a maximum with no minimum (i.e., ',Max')."
274          - 'If <code>cardnumber</code> is included in the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=BorrowerMandatoryField">BorrowerMandatoryField</a> list, the minimum length, if not specified here, defaults to one. Maximum cannot be bigger than the database field size of 32.'
275      -
276          - pref: uppercasesurnames
277            choices:
278                1: Do
279                0: "Don't"
280          - store and display surnames in upper case.
281      -
282          - "The following <a href='http://schema.koha-community.org/__VERSION__/tables/borrowers.html' target='blank'>database columns</a>:"
283          - pref: PatronQuickAddFields
284            type: modalselect
285            source: borrowers
286          - "will be added to the patron quick add form when entering a new patron. Displays only mandatory fields and fields specified here. If applicable the guarantor form will be shown as well, individual fields in that form will be ignored."
287      -
288          - "When adding new patrons or editing existing patrons, collapse the following fields from the full form (can still be expanded later):"
289          - pref: CollapseFieldsPatronAddForm
290            multiple:
291                identity: "Patron identity"
292                guarantor: "Guarantor information"
293                primary_address: "Main address"
294                primary_contact: "Contact information"
295                alt_address: "Alternate address"
296                alt_contact: "Alternate contact"
297                lib_mgmt: "Library management"
298                lib_setup: "Library setup"
299                login: "OPAC/Staff interface login"
300                flags: "Patron account flags (existing patrons)"
301                debarments: "Patron restrictions (existing patrons)"
302                housebound: "Housebound roles"
303                additional: "Additional attributes and identifiers"
304                messaging: "Patron messaging preferences"
305      -
306          - "The following <a href='http://schema.koha-community.org/__VERSION__/tables/borrowers.html' target='blank'>database columns</a>:"
307          - pref: PatronDuplicateMatchingAddFields
308            type: modalselect
309            source: borrowers
310          - "will be used to detect possible duplicates when adding a new patron."
311     Patron relationships:
312      -
313          - "Guarantors can be the following of those they guarantee:"
314          - pref: borrowerRelationship
315            class: multi
316          - (input multiple choices separated by |). Leave empty to deactivate.
317      -
318          - "When adding a guarantee to a guarantor patron fill the following fields in the guarantee's member entry form from the guarantors record:"
319          - pref: PrefillGuaranteeField
320            multiple:
321                surname: "Surname"
322                B_streettype: "Alternate address - Street type"
323                B_address: "Alternate address - Address"
324                B_address2: "Alternate address - Address 2"
325                B_city: "Alternate address - City"
326                contactnote: "Alternate address - Contact note"
327                B_country: "Alternate address - Country"
328                B_email: "Alternate address - Email"
329                B_phone: "Alternate address - Phone"
330                B_state: "Alternate address - State"
331                B_streetnumber: "Alternate address - Street number"
332                B_zipcode: "Alternate address - ZIP/Postal code"
333                altcontactaddress1: "Alternate contact - Address"
334                altcontactaddress2: "Alternate contact - Address 2"
335                altcontactaddress3: "Alternate contact - City"
336                altcontactcountry: "Alternate contact - Country"
337                altcontactfirstname: "Alternate contact - First name"
338                altcontactphone: "Alternate contact - Phone"
339                altcontactstate: "Alternate contact - State"
340                altcontactsurname: "Alternate contact - Surname"
341                altcontactzipcode: "Alternate contact - ZIP/Postal code"
342                fax: "Contact - Fax"
343                mobile: "Contact - Other phone"
344                email: "Contact - Primary email"
345                phone: "Contact - Primary phone"
346                emailpro: "Contact - Secondary email"
347                phonepro: "Contact - Secondary phone"
348                streettype: "Main address - Street type"
349                address: "Main address - Address"
350                address2: "Main address - Address 2"
351                city: "Main address - City"
352                country: "Main address - Country"
353                state: "Main address - State"
354                zipcode: "Main address - ZIP/Postal code"
355                streetnumber: "Main address - Street number"
356      -
357          - pref: AllowStaffToSetCheckoutsVisibilityForGuarantor
358            choices:
359                1: Allow
360                0: "Don't allow"
361          - staff to set the ability for a patron's checkouts to be viewed by linked patrons in the OPAC.
362      -
363          - pref: RedirectGuaranteeEmail
364            choices:
365                yes: Enable
366                no: Disable
367          - sending emails to both guarantees and their guarantor. This does not affect patrons without guarantors.
368      -
369          - pref: AllowStaffToSetFinesVisibilityForGuarantor
370            choices:
371                1: Allow
372                0: "Don't allow"
373          - staff to set the ability for a patron's charges to be viewed by linked patrons in the OPAC.
374
375     Privacy:
376      -
377          - Use the following URL
378          - pref: PrivacyPolicyURL
379            class: url
380          - to refer to your local privacy policy in messages about privacy and data protection. (If you enforce a data privacy policy, make sure that this page is not blocked.)
381          - '<br><strong>NOTE:</strong> The URL will only be displayed if <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=PrivacyPolicyConsent">PrivacyPolicyConsent</a> is set.'
382      -
383          - "Set data privacy policy consent to:"
384          - pref: PrivacyPolicyConsent
385            choices:
386                '': 'disabled'
387                Enforced: 'enforced'
388                Permissive: 'permissive'
389          - ". When you enforce a data privacy policy, patrons need to give consent before using the OPAC. If you set to permissive, Koha will warn but not enforce."
390          - '<br><strong>NOTE:</strong> If you enable this you will also have to set the URL of your public privacy policy with the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=PrivacyPolicyURL">PrivacyPolicyURL</a> setting.'
391      -
392          - Lock/expire patrons that submitted an unsubscribe request (refused consent) after
393          - pref: UnsubscribeReflectionDelay
394          - days, anonymize locked/expired accounts after
395          - pref: PatronAnonymizeDelay
396          - days and remove anonymized patron accounts after
397          - pref: PatronRemovalDelay
398          - "days.<br>IMPORTANT: No action is performed when these delays are empty (no text). But a zero value ('0') is interpreted as no delay (do it now)! The actions are performed by the cleanup database cron job."
399      -
400          - pref: CookieConsent
401            choices:
402                1: Require
403                0: "Don't require"
404          - cookie consent to be displayed in the OPAC and staff interface.
405      -
406          - Run the following JavaScript if cookie consent is provided (e.g. tracking code).
407          - pref: CookieConsentedJS
408            type: modaljs
409            initiator: populateCookieConsentedJS
410            processor: prepareCookieConsentedJS
411     Security:
412      -
413          - Login passwords for staff and patrons must be at least
414          - pref: minPasswordLength
415            class: integer
416          - characters long.
417      -
418          - pref: RequireStrongPassword
419            choices:
420                1: "Require"
421                0: "Don't require"
422          - a strong password for staff and patrons
423          - (must contain at least one digit, one lowercase and one uppercase).
424      -
425          - pref: EnableExpiredPasswordReset
426            choices:
427                1: "Enable"
428                0: "Don't enable"
429          - the ability for patrons to directly reset their password when it is expired.
430          - If not enabled patrons must either use the 'Forgot your password' feature or have staff
431          - reset their password.
432      -
433          - Block a patron's account if it reaches
434          - pref: FailedLoginAttempts
435            class: integer
436          - failed login attempts.
437      -
438          - pref: Pseudonymization
439            choices:
440                1: Enable
441                0: Disable
442          - "pseudonymization to comply with data privacy policies and regulations like GDPR for managing personal information."
443          - "Patrons and transactions will be copied to a separate table for statistical purposes."
444          - "<br/>Use the following fields for patrons:"
445          - pref: PseudonymizationPatronFields
446            multiple:
447              title: "Patron's title"
448              city: "City"
449              state: "State"
450              zipcode: "ZIP/Postal code"
451              country: "Country"
452              branchcode: "Patron's library"
453              categorycode: "Patron category"
454              dateenrolled: "Date the patron was added to Koha"
455              sex: "Patron's gender"
456              sort1: "Sort 1"
457              sort2: "Sort 2"
458          - "<br/> And the following fields for the transactions:"
459          - pref: PseudonymizationTransactionFields
460            multiple:
461              datetime: "Date and time of the transaction"
462              transaction_branchcode: "Library where the transaction occurred"
463              transaction_type: "Transaction type"
464              itemnumber: "Itemnumber"
465              itemtype: "Item type"
466              holdingbranch: "Holding library"
467              homebranch: "Home library"
468              location: "Location"
469              itemcallnumber: "Item's callnumber"
470              ccode: "Collection"