Bug 23681: (QA follow-up) Fix preferences
[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          - "Comma separated list defining the default fields to be used during a patron search using the \"standard\" option:"
60          - pref: DefaultPatronSearchFields
61            class: multi
62          - "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."
63      -
64          - "Show the following fields from the items database table as columns on the statistics tab on the patron record: "
65          - pref: StatisticsFields
66            type: modalselect
67            source: items
68          - "If empty, defaults to: location|itype|ccode"
69      -
70          - pref: EnableBorrowerFiles
71            choices:
72                1: Do
73                0: "Don't"
74          - enable the ability to upload and attach arbitrary files to a borrower record.
75      -
76          - pref: useDischarge
77            choices:
78                1: Allow
79                0: "Don't allow"
80          - librarians to discharge borrowers and borrowers to request a discharge.
81      -
82          - pref: FeeOnChangePatronCategory
83            choices:
84                1: Do
85                0: "Don't"
86          - charge a fee when a patron changes to a category with an enrollment fee.
87      -
88          - pref: TrackLastPatronActivity
89            choices:
90                1: Do
91                0: "Don't"
92          - track last patron activity.
93          - 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.
94      -
95          - pref: AutoApprovePatronProfileSettings
96            choices:
97                1: Enable
98                0: Disable
99          - "automatic approval of patron detail changes from the OPAC."
100          - Requires <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACPatronDetails">OPACPatronDetails</a> to be activated.
101      -
102          - pref: ProtectSuperlibrarianPrivileges
103            choices:
104                1: Allow only superlibrarians
105                0: Allow all permitted users
106          - "to access/change superlibrarian privileges."
107          - "<br><strong>NOTE:</strong> A permitted user needs to have the 'permissions' flag (if no superlibrarian)."
108      -
109          - pref: AllowPatronToControlAutorenewal
110            choices:
111                1: Allow patrons
112                0: Allow only staff
113          - "to allow/disallow auto-renewal for account. If allowed a patron will be able to update their own account to allow/disallow auto-renewal."
114      -
115          - Lock expired patrons after
116          - pref: LockExpiredDelay
117            class: integer
118          - days. Leave empty to disable this behavior.
119          - "<br><strong>NOTE:</strong> This system preference requires the misc/cronjobs/cleanup_database.pl cronjob. Ask your system administrator to schedule it."
120
121     Membership expiry:
122      -
123          - When renewing borrowers, base the new expiry date on
124          - pref: BorrowerRenewalPeriodBase
125            choices:
126                now: current date.
127                dateexpiry: current membership expiry date.
128                combination: the latter of the current and expiry date.
129      -
130          - Show a notice if the patron is about to expire or has expired
131          - pref: NotifyBorrowerDeparture
132            class: integer
133          - days beforehand.
134      -
135          - Send an account expiration notice when a patron's card will expire in
136          - pref: MembershipExpiryDaysNotice
137            class: integer
138          - days.
139          - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/membership_expiry.pl</code> cronjob. Ask your system administrator to schedule it."
140     Notices and notifications:
141      -
142          - pref: EnhancedMessagingPreferences
143            choices:
144                1: Allow
145                0: "Don't allow"
146          - "staff to manage which notices patrons will receive and when they will receive them."
147          - '<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>.'
148          - "<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."
149      -
150          - pref: EnhancedMessagingPreferencesOPAC
151            choices:
152                1: Show
153                0: "Don't show"
154          - "patron messaging setting on the OPAC."
155          - '<br><strong>NOTE:</strong> <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=EnhancedMessagingPreferences">EnhancedMessagingPreferences</a> must be enabled.'
156      -
157          - pref: AutoEmailNewUser
158            choices:
159                1: Send
160                0: "Don't send"
161          - an email to newly created patrons.
162          - '<br><strong>NOTE:</strong> This uses the WELCOME notice.'
163      -
164          - pref: UseEmailReceipts
165            choices:
166                1: Send
167                0: "Don't send"
168          - email receipts to patrons for payments and writeoffs.
169      -
170          - "Use"
171          - pref: AutoEmailPrimaryAddress
172            default: "OFF"
173            choices:
174                email: home
175                emailpro: work
176                B_email: alternate
177                cardnumber: cardnumber as
178                "OFF": first valid
179          - "patron email address for sending out emails."
180      -
181          - pref: TalkingTechItivaPhoneNotification
182            choices:
183                1: Enable
184                0: Disable
185          - patron phone notifications using Talking Tech i-tiva (overdues, predues and holds notices currently supported).
186          - <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.
187      -
188          - pref: PhoneNotification
189            choices:
190                1: Enable
191                0: Disable
192          - patron phone notifications generation. A plugin will be required to process the phone notifications.
193          - <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.
194      -
195          - "Use the SMS::Send::"
196          - pref: SMSSendDriver
197          - driver to send SMS messages.
198          - "<br>If you would prefer to send SMS via E-mail, set SMSSendDriver to: Email"
199          - "<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."
200      -
201          - "Define a username/login"
202          - pref: SMSSendUsername
203          - "and a password"
204          - pref: SMSSendPassword
205          - ". Override from address with"
206          - pref: EmailSMSSendDriverFromAddress
207            class: email
208          - "for emails sent using \"Email\" send driver."
209      -
210          - pref: FallbackToSMSIfNoEmail
211            choices:
212                1: Enable
213                0: Disable
214          - sending purchase suggestion messages by SMS if no patron email is defined.
215      -
216          - "Send automatic renewal notices: "
217          - pref: AutoRenewalNotices
218            choices:
219                never: never
220                preferences: according to patron messaging preferences
221                cron: (Deprecated) according to --send-notices cron switch
222     Patron forms:
223      -
224          - "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:"
225          - pref: BorrowerMandatoryField
226            type: modalselect
227            source: borrowers
228          - '<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>.'
229      -
230          - "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:"
231          - pref: BorrowerUnwantedField
232            type: modalselect
233            source: borrowers
234            exclusions: branchcode|categorycode
235      -
236          - "Borrowers can have the following titles:"
237          - pref: BorrowersTitles
238            class: multi
239          - (separate multiple choices with |)
240      -
241          - pref: autoMemberNum
242            choices:
243                1: Do
244                0: "Don't"
245          - 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).
246          - '<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>.'
247      -
248          - Card numbers for patrons must be
249          - pref: CardnumberLength
250          - "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')."
251          - '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.'
252      -
253          - pref: uppercasesurnames
254            choices:
255                1: Do
256                0: "Don't"
257          - store and display surnames in upper case.
258      -
259          - "The following <a href='http://schema.koha-community.org/__VERSION__/tables/borrowers.html' target='blank'>database columns</a>:"
260          - pref: PatronQuickAddFields
261            type: modalselect
262            source: borrowers
263          - "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."
264      -
265          - "When adding new patrons or editing existing patrons, collapse the following fields from the full form (can still be expanded later):"
266          - pref: CollapseFieldsPatronAddForm
267            multiple:
268                identity: "Patron identity"
269                guarantor: "Guarantor information"
270                primary_address: "Main address"
271                primary_contact: "Contact information"
272                alt_address: "Alternate address"
273                alt_contact: "Alternate contact"
274                lib_mgmt: "Library management"
275                lib_setup: "Library setup"
276                login: "OPAC/Staff interface login"
277                flags: "Patron account flags (existing patrons)"
278                debarments: "Patron restrictions (existing patrons)"
279                housebound: "Housebound roles"
280                additional: "Additional attributes and identifiers"
281                messaging: "Patron messaging preferences"
282      -
283          - "The following <a href='http://schema.koha-community.org/__VERSION__/tables/borrowers.html' target='blank'>database columns</a>:"
284          - pref: PatronDuplicateMatchingAddFields
285            type: modalselect
286            source: borrowers
287          - "will be used to detect possible duplicates when adding a new patron."
288     Patron relationships:
289      -
290          - "Guarantors can be the following of those they guarantee:"
291          - pref: borrowerRelationship
292            class: multi
293          - (input multiple choices separated by |). Leave empty to deactivate.
294      -
295          - "When adding a guarantee to a guarantor patron fill the following fields in the guarantee's member entry form from the guarantors record:"
296          - pref: PrefillGuaranteeField
297            multiple:
298                B_streettype: "Alternate address - Street type"
299                B_address: "Alternate address - Address"
300                B_address2: "Alternate address - Address 2"
301                B_city: "Alternate address - City"
302                contactnote: "Alternate address - Contact note"
303                B_country: "Alternate address - Country"
304                B_email: "Alternate address - Email"
305                B_phone: "Alternate address - Phone"
306                B_state: "Alternate address - State"
307                B_streetnumber: "Alternate address - Street number"
308                B_zipcode: "Alternate address - ZIP/Postal code"
309                altcontactaddress1: "Alternate contact - Address"
310                altcontactaddress2: "Alternate contact - Address 2"
311                altcontactaddress3: "Alternate contact - City"
312                altcontactcountry: "Alternate contact - Country"
313                altcontactfirstname: "Alternate contact - First name"
314                altcontactphone: "Alternate contact - Phone"
315                altcontactstate: "Alternate contact - State"
316                altcontactsurname: "Alternate contact - Surname"
317                altcontactzipcode: "Alternate contact - ZIP/Postal code"
318                fax: "Contact - Fax"
319                mobile: "Contact - Other phone"
320                email: "Contact - Primary email"
321                phone: "Contact - Primary phone"
322                emailpro: "Contact - Secondary email"
323                phonepro: "Contact - Secondary phone"
324                streettype: "Main address - Street type"
325                address: "Main address - Address"
326                address2: "Main address - Address 2"
327                city: "Main address - City"
328                country: "Main address - Country"
329                state: "Main address - State"
330                zipcode: "Main address - ZIP/Postal code"
331                streetnumber: "Main address - Street number"
332      -
333          - pref: AllowStaffToSetCheckoutsVisibilityForGuarantor
334            choices:
335                1: Allow
336                0: "Don't allow"
337          - staff to set the ability for a patron's checkouts to be viewed by linked patrons in the OPAC.
338      -
339          - pref: AllowStaffToSetFinesVisibilityForGuarantor
340            choices:
341                1: Allow
342                0: "Don't allow"
343          - staff to set the ability for a patron's fines to be viewed by linked patrons in the OPAC.
344      -
345          - pref: PatronRestrictionTypes
346            choices:
347                1: Allow
348                0: Don't allow
349          - "the type of patron restriction to be specified when applying manually."
350
351     Privacy:
352      -
353          - Use the following URL
354          - pref: PrivacyPolicyURL
355          - to refer to your local privacy policy in messages about privacy and data protection. (If you enforce GDPR policy, make sure that this page is not blocked.)
356          - '<br><strong>NOTE:</strong> The URL will only be displayed if <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=GDPR_Policy">GDPR_Policy</a> is set.'
357      -
358          - "Set GDPR policy to:"
359          - pref: GDPR_Policy
360            choices:
361                '': 'disabled'
362                Enforced: 'enforced'
363                Permissive: 'permissive'
364          - ". GDPR is the EU General Data Protection Regulation. When you enforce, patrons need to give consent before using the OPAC. If you set to permissive, Koha will warn but not enforce."
365          - '<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.'
366      -
367          - Lock/expire patrons that submitted an unsubscribe request (refused consent) after
368          - pref: UnsubscribeReflectionDelay
369          - days, anonymize locked/expired accounts after
370          - pref: PatronAnonymizeDelay
371          - days and remove anonymized patron accounts after
372          - pref: PatronRemovalDelay
373          - "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."
374     Security:
375      -
376          - Login passwords for staff and patrons must be at least
377          - pref: minPasswordLength
378            class: integer
379          - characters long.
380      -
381          - pref: RequireStrongPassword
382            choices:
383                1: "Require"
384                0: "Don't require"
385          - a strong password for staff and patrons
386          - (must contain at least one digit, one lowercase and one uppercase).
387      -
388          - pref: EnableExpiredPasswordReset
389            choices:
390                1: "Enable"
391                0: "Don't enable"
392          - the ability for patrons to directly reset their password when it is expired.
393          - If not enable patrons must either use the 'Forgot your password' feature or have staff
394          - reset their password.
395      -
396          - Block a patron's account if it reaches
397          - pref: FailedLoginAttempts
398            class: integer
399          - failed login attempts.
400      -
401          - pref: Pseudonymization
402            choices:
403                1: Enable
404                0: Disable
405          - "pseudonymization to comply with GDPR for personal information."
406          - "Patrons and transactions will be copied to a separate table for statistics purpose."
407          - "<br/>Use the following fields for patrons:"
408          - pref: PseudonymizationPatronFields
409            multiple:
410              title: "Patron's title"
411              city: "City"
412              state: "State"
413              zipcode: "Zipcode"
414              country: "Country"
415              branchcode: "Patron's library"
416              categorycode: "Patron's category"
417              dateenrolled: "Date the patron was added to Koha"
418              sex: "Patron's gender"
419              sort1: "Sort1"
420              sort2: "Sort2"
421          - "<br/> And the following fields for the transactions:"
422          - pref: PseudonymizationTransactionFields
423            multiple:
424              datetime: "Date and time of the transaction"
425              transaction_branchcode: "Library where the transaction occurred"
426              transaction_type: "Transaction type"
427              itemnumber: "Itemnumber"
428              itemtype: "Item type"
429              holdingbranch: "Holding library"
430              homebranch: "Home library"
431              location: "Location"
432              itemcallnumber: "Item's callnumber"
433              ccode: "Collection"