Bug 27805: (follow-up) Update more instances
[koha.git] / koha-tmpl / intranet-tmpl / prog / en / modules / admin / preferences / circulation.pref
1 Circulation:
2     Interface:
3         -
4             - pref: CircSidebar
5               choices:
6                   1: Activate
7                   0: Deactivate
8             - the navigation sidebar on all circulation pages.
9         -
10             - pref: CircConfirmItemParts
11               choices:
12                   1: "Require"
13                   0: "Don't require"
14             - staff to confirm that all parts of an item are present at checkin/checkout.
15         -
16             - pref: AutoSwitchPatron
17               choices:
18                   1: "Enable"
19                   0: "Don't enable"
20             - the automatic redirection to another patron when a patron barcode is scanned instead of a book.
21             - This should not be enabled if you have overlapping patron and book barcodes.
22         -
23             - pref: PatronAutoComplete
24               choices:
25                   1: Try
26                   0: "Don't try"
27             - to guess the patron being entered while typing a patron search for circulation or patron search.
28             - Only returns the first 10 results at a time.
29         -
30             - pref: itemBarcodeInputFilter
31               choices:
32                   OFF: "Don't filter"
33                   whitespace: Remove spaces from
34                   cuecat: Convert from CueCat form
35                   T-prefix: Remove the first number from T-prefix style
36                   libsuite8: Convert from Libsuite8 form
37                   EAN13: EAN-13 or zero-padded UPC-A form
38             - scanned item barcodes.
39         -
40             - pref: itemBarcodeFallbackSearch
41               choices:
42                   1: "Enable"
43                   0: "Don't enable"
44             - the automatic use of a keyword catalog search if the phrase entered as a barcode on the checkout page does not turn up any results during an item barcode search.
45         -
46             - Sort previous checkouts on the circulation page from
47             - pref: previousIssuesDefaultSortOrder
48               choices:
49                   asc: earliest to latest
50                   desc: latest to earliest
51             - due date.
52         -
53             - "Sort today's checkouts on the circulation page from"
54             - pref: todaysIssuesDefaultSortOrder
55               type: choice
56               choices:
57                   asc: earliest to latest
58                   desc: latest to earliest
59             - checkout time.
60         -
61             - pref: SpecifyDueDate
62               choices:
63                   1: Allow
64                   0: "Don't allow"
65             - staff to specify a due date for a checkout.
66         -
67             - pref: SpecifyReturnDate
68               choices:
69                   1: Allow
70                   0: "Don't allow"
71             - staff to specify a return date for a check in.
72         -
73             - Set the default start date for the Holds to pull list to
74             - pref: HoldsToPullStartDate
75               class: integer
76             - day(s) ago. Note that the default end date is controlled by the system preference <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=ConfirmFutureHolds">ConfirmFutureHolds</a>.
77         -
78             - pref: AllowAllMessageDeletion
79               choices:
80                   1: Allow
81                   0: "Don't allow"
82             - staff to delete messages added from other libraries.
83         -
84             - Show the
85             - pref: numReturnedItemsToShow
86               class: integer
87             - last returned items on the checkin screen.
88         -
89             - pref: FineNotifyAtCheckin
90               choices:
91                   1: Notify
92                   0: "Don't notify"
93             - librarians of overdue fines on the items they are checking in.
94         -
95             - pref: WaitingNotifyAtCheckin
96               choices:
97                   1: Notify
98                   0: "Don't notify"
99             - librarians of waiting holds for the patron whose items they are checking in.
100         -
101             - pref: FilterBeforeOverdueReport
102               choices:
103                   1: Require
104                   0: "Don't require"
105             - staff to choose which checkouts to show before running the overdues report.
106         -
107             - pref: DisplayClearScreenButton
108               choices:
109                   1: Show
110                   0: "Don't show"
111             - a button to clear the current patron from the screen on the circulation screen.
112         -
113             - pref: RecordLocalUseOnReturn
114               choices:
115                   1: Record
116                   0: "Don't record"
117             - local use when an unissued item is checked in.
118         -
119             - When an empty barcode field is submitted in circulation
120             - pref: CircAutoPrintQuickSlip
121               choices:
122                   clear: "clear the screen"
123                   qslip: "open a print quick slip window"
124                   slip: "open a print slip window"
125             - .
126         -
127             - Include the stylesheet at
128             - pref: NoticeCSS
129               class: url
130             - on notices. (This should be a complete URL, starting with <code>http://</code>)
131         -
132             - pref: UpdateTotalIssuesOnCirc
133               choices:
134                   1: Do
135                   0: "Don't"
136             - update a bibliographic record's total checkouts count whenever an item is checked out (WARNING! This increases server load significantly; if performance is a concern, use the update_totalissues.pl cron job to update the total checkouts count).
137         -
138             - pref: ExportCircHistory
139               choices:
140                   1: Show
141                   0: "Don't show"
142             - the export patron checkout history options.
143         -
144             - "The following fields should be excluded from the patron checkout history CSV or MARC (ISO 2709) export:"
145             - pref: ExportRemoveFields
146             - (separate fields with space, e.g. 100a 200b 300c).
147         -
148             - pref: AllowOfflineCirculation
149               choices:
150                   1: Enable
151                   0: "Don't enable"
152             - "offline circulation on regular circulation computers. (<strong>NOTE:</strong> This system preference does not affect the Firefox add-on or the desktop application)."
153         -
154             - pref: ShowAllCheckins
155               choices:
156                   1: Show
157                   0: "Don't show"
158             - all items in the "Checked-in items" list, even items that were not checked out.
159         -
160             - pref: AllowCheckoutNotes
161               choices:
162                   1: Allow
163                   0: "Don't allow"
164             - patrons to submit notes about checked out items.
165         -
166             - pref: UseCirculationDesks
167               choices:
168                   1: "Use"
169                   0: "Don't use"
170             - circulation desks with circulation.
171
172     Checkout policy:
173         -
174             - pref: OnSiteCheckoutAutoCheck
175               choices:
176                   1: Enable
177                   0: Don't enable
178             - on-site checkout by default if last checkout was an on-site one.
179         -
180             - pref: AutoReturnCheckedOutItems
181               choices:
182                   1: Don't
183                   0: Do
184             - require librarians to manually confirm a checkout where the item is already checked out to another patron.
185         -
186             - pref: AllowTooManyOverride
187               choices:
188                   1: Allow
189                   0: "Don't allow"
190             - staff to override and check out items when the patron has reached the maximum number of allowed checkouts.
191         -
192             - pref: AutoRemoveOverduesRestrictions
193               choices:
194                   1: "Do"
195                   0: "Don't"
196             - allow OVERDUES restrictions triggered by sent notices to be cleared automatically when all overdue items are returned by a patron.
197         -
198             - pref: AllowNotForLoanOverride
199               choices:
200                   1: Allow
201                   0: "Don't allow"
202             - staff to override and check out items that are marked as not for loan.
203         -
204             - pref: AllowRenewalLimitOverride
205               choices:
206                   1: Allow
207                   0: "Don't allow"
208             - staff to manually override renewal blocks and renew a checkout when it would go over the renewal limit or be premature for the "No renewal before" setting in the circulation policy or has been scheduled for automatic renewal.
209         -
210             - pref: AllowRenewalOnHoldOverride
211               choices:
212                   1: Allow
213                   0: "Don't allow"
214             - staff to renew items that are on hold by manually specifying a due date.
215         -
216             - pref: AllowItemsOnHoldCheckoutSIP
217               choices:
218                   1: Allow
219                   0: "Don't allow"
220             - checkouts of items reserved to someone else via SIP checkout messages.
221             - If allowed do not generate RESERVED warning.
222             - This allows self checkouts for those items. If using the holds queue items with pending holds will be marked as "unavailable" if this set to "Don't allow".
223         -
224             - pref: AllowItemsOnHoldCheckoutSCO
225               choices:
226                   1: Allow
227                   0: "Don't allow"
228             - checkouts of items reserved to someone else in the SCO module. If allowed do not generate RESERVE_WAITING and RESERVED warning. This allows self checkouts for those items.
229         -
230             - pref: AllFinesNeedOverride
231               choices:
232                   1: Require
233                   0: "Don't require"
234             - staff to manually override all fines, even fines less than set in the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=noissuescharge">noissuescharge</a> system preference.
235         -
236             - pref: AllowFineOverride
237               choices:
238                   1: Allow
239                   0: "Don't allow"
240             - staff to manually override and check out items to patrons who have more in fines than set in the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=noissuescharge">noissuescharge</a> system preference.
241         -
242             - pref: AutomaticItemReturn
243               choices:
244                   1: Do
245                   0: "Don't"
246             - automatically transfer items to their home library when they are checked in.
247         -
248             - pref: UseBranchTransferLimits
249               choices:
250                   1: Enforce
251                   0: "Don't enforce"
252             - library transfer limits based on
253             - pref: BranchTransferLimitsType
254               choices:
255                   ccode: collection code
256                   itemtype: item type
257             - .
258         -
259             - pref: UseTransportCostMatrix
260               choices:
261                   1: Use
262                   0: "Don't use"
263             - the transport cost matrix for calculating optimal holds filling between libraries.
264         -
265             - Use the checkout and fines rules of
266             - pref: CircControl
267               type: choice
268               choices:
269                   PickupLibrary: the library you are logged in at.
270                   PatronLibrary: the library the patron is from.
271                   ItemHomeLibrary: the library the item is from.
272         -
273             - Use the checkout and fines rules of
274             - pref: HomeOrHoldingBranch
275               type: choice
276               choices:
277                   homebranch: the item's home library (homebranch).
278                   holdingbranch: the item's holding library (holdingbranch).
279         -
280             - Allow items to be checked in
281             - pref: AllowReturnToBranch
282               type: choice
283               choices:
284                   anywhere: at any library.
285                   homebranch: only at the library the item is from.
286                   holdingbranch: only at the library the item was checked out from.
287                   homeorholdingbranch: either at the library the item is from or the library it was checked out from.
288         -
289             - For search results in the staff interface, display
290             - pref: StaffSearchResultsDisplayBranch
291               type: choice
292               choices:
293                   homebranch: the library the item is from.
294                   holdingbranch: the library the item is held by.
295         -
296             - pref: useDaysMode
297               choices:
298                   Days: Ignore the calendar
299                   Calendar: Use the calendar to skip days the library is closed
300                   Datedue: Use the calendar to push the due date to the next open day
301                   Dayweek: Use the calendar to push the due date to the next open matching weekday for weekly loan periods, or the next open day otherwise
302             - when calculating the date due.
303         -
304             - Calculate "No renewal before" based on
305             - pref: NoRenewalBeforePrecision
306               choices:
307                   date: date.
308                   exact_time: exact time.
309             - Only relevant for loans calculated in days, hourly loans are not affected.
310         -
311             - When renewing checkouts, base the new due date on
312             - pref: RenewalPeriodBase
313               choices:
314                   date_due: the old due date of the checkout.
315                   now: the current date.
316         -
317             - pref: RenewalSendNotice
318               choices:
319                   1: Send
320                   0: "Don't send"
321             - "a renewal notice according to patron's messaging preferences for 'Item checkout'."
322         -
323             - pref: UnseenRenewals
324               choices:
325                   1: Allow
326                   0: "Don't allow"
327             - renewals to be recorded as "unseen" by the library, and count against the patrons unseen renewals limit.
328         -
329             - Prevent patrons from making holds on the OPAC if they owe more than
330             - pref: maxoutstanding
331               class: currency
332             - '[% local_currency %] in fines.'
333         -
334             - Show a warning on the "Transfers to receive" screen if the transfer has not been received
335             - pref: TransfersMaxDaysWarning
336               class: integer
337             - days after it was sent.
338         -
339             - pref: IssuingInProcess
340               choices:
341                   1: "Don't prevent"
342                   0: "Prevent"
343             - patrons from checking out an item whose rental charge would take them over the limit.
344         -
345             - "Restrict patrons with the following target audience values from checking out inappropriate materials:"
346             - pref: AgeRestrictionMarker
347             - ". For example, enter target audience keyword(s) split by | (bar) FSK|PEGI|Age| (No white space near |). Be sure to map agerestriction in Koha to MARC mapping (e.g. 521$a). A MARC field value of FSK 12 or PEGI 12 would mean: Borrower must be 12 years old. Leave empty to not apply an age restriction."
348         -
349             - pref: AgeRestrictionOverride
350               choices:
351                   1: Allow
352                   0: "Don't allow"
353             - staff to check out an item with age restriction.
354         -
355             - Prevent patrons from checking out items if they have more than
356             - pref: noissuescharge
357               class: integer
358             - '[% local_currency %] in fines.'
359         -
360             - Prevent a patron from checking out if the patron has guarantees owing in total more than
361             - pref: NoIssuesChargeGuarantees
362               class: integer
363             - '[% local_currency %] in fines.'
364         -
365             - Prevent a patron from checking out if the patron has guarantors and those guarantor's guarantees owing in total more than
366             - pref: NoIssuesChargeGuarantorsWithGuarantees
367               class: integer
368             - '[% local_currency %] in fines.'
369         -
370             - pref: RentalsInNoissuesCharge
371               choices:
372                   1: Include
373                   0: "Don't include"
374             - rental charges when summing up charges for limit set in the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=noissuescharge">noissuescharge</a> system preference.
375         -
376             - pref: ManInvInNoissuesCharge
377               choices:
378                   1: Include
379                   0: "Don't include"
380             - custom debit type charges when summing up charges for limit set in the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=noissuescharge">noissuescharge</a> system preference.
381         -
382             - pref: HoldsInNoissuesCharge
383               choices:
384                   1: Include
385                   0: "Don't include"
386             - hold charges when summing up charges for limit set in the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=noissuescharge">noissuescharge</a> system preference.
387         -
388             - pref: ReturnBeforeExpiry
389               choices:
390                   1: Require
391                   0: "Don't require"
392             - "patrons to return items before their accounts expire (by restricting due dates to before the patron's expiration date)."
393         -
394             - "Send all notices as a BCC to this email address:"
395             - pref: NoticeBcc
396               class: email
397         -
398             - pref: OverdueNoticeCalendar
399               choices:
400                   1: "Use calendar"
401                   0: "Ignore calendar"
402             - "when working out the period for overdue notices."
403         -
404             - Include up to
405             - pref: PrintNoticesMaxLines
406               class: integer
407             - "item lines in a printed overdue notice. If the number of items is greater than this number, the notice will end with a warning asking the patron to check their online account for a full list of overdue items. Set to 0 to include all overdue items in the notice, no matter how many there are."
408         -
409             - pref: OverduesBlockCirc
410               choices:
411                   block: Block
412                   noblock: "Don't block"
413                   confirmation: Ask for confirmation
414             - "when checking out to a patron that has overdues outstanding."
415         -
416             - "When checking out an item with rental fees, "
417             - pref: RentalFeesCheckoutConfirmation
418               choices:
419                   1: ask
420                   0: "don't ask"
421             - "for confirmation."
422         -
423             - By default, set the LOST value of an item to
424             - pref: DefaultLongOverdueLostValue
425               class: integer
426             - when the item has been overdue for more than
427             - pref: DefaultLongOverdueDays
428               class: integer
429             - days.
430             - <br>WARNING â€” These preferences will activate the automatic item loss process. Leave these fields empty if you don't want to activate this feature.
431             - "<br>Example: [1] [30] Sets an item to the LOST value 1 when it has been overdue for more than 30 days."
432             - <br>(Used when the longoverdue.pl script is called without the --lost parameter)
433             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/longoverdue.pl</code> cronjob. Ask your system administrator to schedule it."
434         -
435             - "Charge a lost item to the patron's account when the LOST value of the item changes to:"
436             - pref: DefaultLongOverdueChargeValue
437               class: integer
438             - <br>Leave this field empty if you don't want to charge the patron for lost items.
439             - <br>(Used when the longoverdue.pl script is called without the --charge parameter)
440             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/longoverdue.pl</code> cronjob. Ask your system administrator to schedule it."
441         -
442             - When using the automatic item loss process, skip items with lost values matching any of
443             - pref: DefaultLongOverdueSkipLostStatuses
444             - "."
445             - <br>Leave this field empty if you don't want to skip any lost statuses.
446             - <br>Set to a list of comma separated values, e.g. <em>5,6,7</em>.
447         -
448             - "When issuing an item that has been marked as lost, "
449             - pref: IssueLostItem
450               choices:
451                   confirm: "require confirmation"
452                   alert: "display a message"
453                   nothing : "do nothing"
454             - .
455         -
456             - "When checking out an item, "
457             - pref: RecordStaffUserOnCheckout
458               choices:
459                   1: "record"
460                   0: "don't record"
461             - "the user who checked out the item."
462         -
463             - "Mark items as returned when flagged as lost "
464             - pref: MarkLostItemsAsReturned
465               multiple:
466                 cronjob: "from the longoverdue cronjob"
467                 batchmod: "from the batch item modification tool"
468                 additem: "when cataloguing an item"
469                 moredetail: "from the items tab of the catalog module"
470                 pendingreserves: "from the 'Holds to pull' list"
471                 onpayment: "when receiving payment for the item"
472                 claim_returned: "when marking an item as a return claim"
473             - .
474         -
475             - pref: AllowMultipleIssuesOnABiblio
476               choices:
477                   1: Allow
478                   0: "Don't allow"
479             - "patrons to check out multiple items from the same record. (<strong>NOTE:</strong> This will only affect records without a subscription attached.)"
480         -
481             - pref: OnSiteCheckouts
482               choices:
483                   1: Enable
484                   0: Disable
485             - the on-site checkouts feature.
486         -
487             - pref: OnSiteCheckoutsForce
488               choices:
489                   1: Enable
490                   0: Disable
491             - the on-site checkout for all cases (even if a patron is debarred, etc.).
492         -
493             - pref: ConsiderOnSiteCheckoutsAsNormalCheckouts
494               choices:
495                   1: Consider
496                   0: "Don't consider"
497             - on-site checkouts as normal checkouts.
498             - If enabled, on-site checkouts will count toward the checkout limit for regular checkouts. The on-site limit will still apply for on-site checkouts.
499             - If disabled, both values will be checked separately.
500         -
501             - pref: SwitchOnSiteCheckouts
502               choices:
503                   1: Switch
504                   0: "Don't switch"
505             - on-site checkouts to normal checkouts when checked out.
506         -
507             - When a patron's checked out item is overdue,
508             - pref: OverduesBlockRenewing
509               type: choice
510               choices:
511                   allow: allow renewing.
512                   blockitem: block renewing only for this item.
513                   block: block renewing for all the patron's items.
514         -
515             - If a patron is restricted,
516             - pref: RestrictionBlockRenewing
517               choices:
518                   1: block
519                   0: allow
520             - renewing of items.
521         -
522             - If a patron owes more than the value of <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACFineNoRenewals">OPACFineNoRenewals</a>,
523             - pref: OPACFineNoRenewalsBlockAutoRenew
524               choices:
525                   1: block
526                   0: allow
527             - their auto-renewals.
528         -
529             - If a patron pays off all fines on an overdue item that is accruing fines,
530             - pref: RenewAccruingItemWhenPaid
531               choices:
532                   1: renew
533                   0: "don't renew"
534             - the item automatically. If the system preference <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=RenewalPeriodBase">RenewalPeriodBase</a> is set to "due date", renewed items may still be overdue.
535         -
536             - If a patron pays off all fines on an overdue item that is accruing fines in the OPAC via a payment plugin,
537             - pref: RenewAccruingItemInOpac
538               choices:
539                   1: renew
540                   0: "don't renew"
541             - the item automatically. If the system preference <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=RenewalPeriodBase">RenewalPeriodBase</a> is set to "due date", renewed items may still be overdue.
542         -
543             - pref: ItemsDeniedRenewal
544               type: textarea
545               syntax: text/x-yaml
546               class: code
547             - Define custom rules to deny specific items from renewal.
548             - "<br />Can name any field in the items table followed by a colon then a space then"
549             - "a bracketed list of values separated by commas."
550             - "For example:"
551             - "<br />ccode: [NEWFIC,NULL,DVD]"
552             - "<br />itype: [NEWBK,\"\"]"
553             - "<br /> <strong>NOTE:</strong> The word 'NULL' can be used to block renewal on undefined fields, while an empty string \"\" will block on an empty (but defined) field."
554     Checkin policy:
555         -
556             - pref: TrapHoldsOnOrder
557               choices:
558                   1: Trap
559                   0: "Don't trap"
560             - items that are not for loan but holdable ( notforloan < 0 ) to fill holds.
561         -
562             - Never trap items with 'not for loan' values of
563             - pref: SkipHoldTrapOnNotForLoanValue
564               class: integer
565             - to fill holds.
566             - "(list of not for loan values separated with a pipe '|')"
567         -
568             - pref: HoldsAutoFill
569               choices:
570                   1: Do
571                   0: "Don't"
572             - automatically fill holds instead of asking the librarian.
573         -
574             - pref: HoldsNeedProcessingSIP
575               choices:
576                   1: "Don't fulfill"
577                   0: Fulfill
578             - holds automatically if matching item is returned via SIP protocol.
579         -
580             - pref: HoldsAutoFillPrintSlip
581               choices:
582                   1: Do
583                   0: "Don't"
584             - automatically display the hold slip dialog for auto-filled holds.
585         -
586             - pref: BlockReturnOfWithdrawnItems
587               choices:
588                   1: Block
589                   0: "Don't block"
590             - returning of items that have been withdrawn.
591         -
592             - pref: BlockReturnOfLostItems
593               choices:
594                   1: Block
595                   0: "Don't block"
596             - returning of items that have been lost.
597         -
598             - pref: CalculateFinesOnReturn
599               choices:
600                   1: Do
601                   0: "Don't"
602             - calculate and update overdue charges when an item is returned.
603             - "<br /><strong>NOTE:</strong> If you are doing hourly loans then you should have this on."
604             - '<br /><strong>NOTE:</strong> This system preference requires <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=FinesMode">FinesMode</a> to be set to "Calculate and charge."'
605         -
606             - pref: CalculateFinesOnBackdate
607               choices:
608                   1: Do
609                   0: "Don't"
610             - calculate and update overdue charges when an item is returned with a backdated return date.
611         -
612             - pref: UpdateItemLocationOnCheckin
613               type: textarea
614               syntax: text/x-yaml
615               class: code
616             - "This is a list of value pairs. The first value is followed immediately by colon space then the second value.<br/><br/>"
617             - "Examples:<br/>"
618             - "PROC: FIC - causes an item in the Processing Center location to be updated into the Fiction location on check in.<br/>"
619             - "FIC: GEN - causes an item in the Fiction location to be updated into the General stacks location on check in.<br/>"
620             - "_BLANK_: FIC - causes an item that has no location to be updated into the Fiction location on check in.<br/>"
621             - "FIC: _BLANK_ - causes an item in location FIC to be updated to a blank location on check in.<br/>"
622             - "_ALL_: FIC - causes all items to be updated into the Fiction location on check in.<br/>"
623             - "PROC: _PERM_ - causes an item that is in the Processing Center to be updated to it's permanent location.<br/><br/>"
624             - "General rule: if the location value on the left of the colon (:) matches the item's current location, it will be updated to match the location value on the right of the colon (:).<br/>"
625             - "Note: PROC and CART are special values, for these locations the location and permanent_location can differ, in all other cases an update will affect both. Items in the CART location will be returned to their permanent location on checkout.<br/>"
626             - "The special term _BLANK_ may be used on either side of a value pair to update or remove the location from items with no location assigned.<br/>"
627             - "The special term _ALL_ is used on the left side of the colon (:) to affect all items, <strong>and overrides all other rules.</strong>"
628         -
629             - pref: UpdateNotForLoanStatusOnCheckin
630               type: textarea
631               syntax: text/x-yaml
632               class: code
633             - This is a list of value pairs. When an item is checked in, if the not for loan value on the left matches the items not for loan value
634             - "it will be updated to the right-hand value. For example, '-1: 0' will cause an item that was set to 'Ordered' to now be available for loan."
635             - Each pair of values should be on a separate line.
636         -
637             - pref: CumulativeRestrictionPeriods
638               choices:
639                   1: Cumulate
640                   0: "Don't cumulate"
641             - the restriction periods.
642         -
643             - pref: HidePersonalPatronDetailOnCirculation
644               choices:
645                   1: "Hide"
646                   0: "Don't hide"
647             - "a patron's phone number, email address, street address and city on the circulation page."
648         -
649             - pref: TransfersBlockCirc
650               choices:
651                   1: "Block"
652                   0: "Don't block"
653             - staff from continuing to checkin items when a transfer is triggered.
654         -
655             - pref: StoreLastBorrower
656               default: 0
657               choices:
658                   1: Store
659                   0: "Don't store"
660             - 'the last patron to return an item. This setting is independent of the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=opacreadinghistory">opacreadinghistory</a> and <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=AnonymousPatron">AnonymousPatron</a> system preferences.'
661     Holds policy:
662         -
663             - In the staff interface, split the holds queue into separate tables by
664             - pref: HoldsSplitQueue
665               choices:
666                   nothing: nothing
667                   branch: "pickup library"
668                   itemtype: "hold item type"
669                   branch_itemtype: "pickup library and item type"
670             - "."
671         -
672             - If the holds queue is split, show librarians
673             - pref: HoldsSplitQueueNumbering
674               choices:
675                   actual: "the actual priority, which may be out of order"
676                   virtual: "'virtual' priorities, where each group is numbered separately"
677             - "."
678         -
679             - pref: AllowHoldItemTypeSelection
680               choices:
681                   1: Allow
682                   0: "Don't allow"
683             - hold fulfillment to be limited by item type.
684         -
685             - pref: AllowRenewalIfOtherItemsAvailable
686               choices:
687                   1: Allow
688                   0: "Don't allow"
689             - a patron to renew an item with unfilled holds if other available items can fill that hold.
690         -
691             - pref: AllowHoldPolicyOverride
692               choices:
693                   1: Allow
694                   0: "Don't allow"
695             - staff to override hold policies when placing holds.
696         -
697             - pref: AllowHoldsOnDamagedItems
698               choices:
699                   1: Allow
700                   0: "Don't allow"
701             - hold requests to be placed on and filled by damaged items.
702         -
703             - pref: AllowHoldDateInFuture
704               choices:
705                   1: Allow
706                   0: "Don't allow"
707             - hold requests to be placed that do not enter the waiting list until a certain future date.
708         -
709             - pref: OPACAllowHoldDateInFuture
710               choices:
711                   1: Allow
712                   0: "Don't allow"
713             - patrons to place holds that don't enter the waiting list until a certain future date. (<a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=AllowHoldDateInFuture">AllowHoldDateInFuture</a> must also be enabled).
714         -
715             - Confirm future hold requests (starting no later than
716             - pref: ConfirmFutureHolds
717               class: integer
718             - days from now) at checkin time. Note that this number of days will be used too in calculating the default end date for the Holds to pull-report. But it does not interfere with issuing, renewing or transferring items.
719         -
720             - Check the
721             - pref: ReservesControlBranch
722               choices:
723                   ItemHomeLibrary: "item's home library"
724                   PatronLibrary: "patron's home library"
725             - to see if the patron can place a hold on the item.    
726         -
727             - Mark a hold as problematic if it has been waiting for more than
728             - pref: ReservesMaxPickUpDelay
729               class: integer
730             - days.
731         -
732             - pref: ExpireReservesMaxPickUpDelay
733               choices:
734                   1: Allow
735                   0: "Don't allow"
736             - 'holds to expire automatically if they have not been picked by within the time period specified in the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=ReservesMaxPickUpDelay">ReservesMaxPickUpDelay</a> system preference.<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/holds/cancel_expired_holds.pl</code> cronjob. Ask your system administrator to schedule it.'
737         -
738             - If using <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=ExpireReservesMaxPickUpDelay">ExpireReservesMaxPickUpDelay</a>, charge a patron who allows their waiting hold to expire a fee of
739             - pref: ExpireReservesMaxPickUpDelayCharge
740               class: currency
741             - "."
742         -
743             - Satisfy holds using items from the libraries
744             - pref: StaticHoldsQueueWeight
745               class: multi
746             - (as branchcodes, separated by commas; if empty, uses all libraries)
747             - when they are
748             - pref: HoldsQueueSkipClosed
749               choices:
750                   1: open
751                   0: open or closed
752             - pref: RandomizeHoldsQueueWeight
753               choices:
754                   1: in random order.
755                   0: in that order.
756             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/holds/build_holds_queue.pl</code> cronjob. Ask your system administrator to schedule it."
757             -
758         -
759             - pref: canreservefromotherbranches
760               choices:
761                   1: Allow
762                   0: "Don't allow (with independentbranches)"
763             - a user from one library to place a hold on an item from another library
764         -
765             - pref: OPACAllowUserToChooseBranch
766               choices:
767                   1: Allow
768                   0: "Don't allow"
769             - a user to choose the library to pick up a hold from.
770         -
771             - pref: ReservesNeedReturns
772               choices:
773                   1: "Don't automatically"
774                   0: Automatically
775             - mark a hold as found and waiting when a hold is placed on a specific item and that item is already checked in.
776         -
777             - Patrons can only have
778             - pref: maxreserves
779               class: integer
780             - holds at once.
781         -
782             - pref: emailLibrarianWhenHoldIsPlaced
783               choices:
784                   1: Enable
785                   0:  "Don't enable"
786             - "sending an email to the Koha administrator email address whenever a hold request is placed."
787         -
788             - pref: DisplayMultiPlaceHold
789               choices:
790                   1: Enable
791                   0:  "Don't enable"
792             - "the ability to place holds on multiple bibliographic records from the search results"
793         -
794             - pref: TransferWhenCancelAllWaitingHolds
795               choices:
796                   1: Transfer
797                   0: "Don't transfer"
798             - items when cancelling all waiting holds.
799         -
800             - pref: AutoResumeSuspendedHolds
801               choices:
802                   1: Allow
803                   0: "Don't allow"
804             - "suspended holds to be automatically resumed by a set date."
805             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/holds/auto_unsuspend_holds.pl</code> cronjob. Ask your system administrator to schedule it."
806         -
807             - pref: SuspendHoldsIntranet
808               choices:
809                   1: Allow
810                   0: "Don't allow"
811             - holds to be suspended from the staff interface.
812         -
813             - pref: SuspendHoldsOpac
814               choices:
815                   1: Allow
816                   0: "Don't allow"
817             - holds to be suspended from the OPAC.
818         -
819             - pref: ExpireReservesOnHolidays
820               choices:
821                   1: Allow
822                   0: "Don't allow"
823             - expired holds to be canceled on days the library is closed.
824         -
825             - pref: ExcludeHolidaysFromMaxPickUpDelay
826               choices:
827                   1: Use the calendar
828                   0: Ignore the calendar
829             - when calculating the period for a hold's max pickup delay.
830         -
831             - pref: decreaseLoanHighHolds
832               choices:
833                   1: Enable
834                   0:  "Don't enable"
835             - the reduction of loan period to
836             - pref: decreaseLoanHighHoldsDuration
837               class: integer
838             - days for high demand items with more than
839             - pref: decreaseLoanHighHoldsValue
840               class: integer
841             - holds
842             - pref: decreaseLoanHighHoldsControl
843               choices:
844                   static: "on the record"
845                   dynamic: "over the number of holdable items on the record"
846             - ". Ignore items with the following statuses when counting items:"
847             - pref: decreaseLoanHighHoldsIgnoreStatuses
848               multiple:
849                 damaged: Damaged
850                 itemlost: Lost
851                 withdrawn: Withdrawn
852                 notforloan: Not for loan
853             - "Note: The reduced loan period can also be set up in the circulation conditions and will then overwrite the setting here."
854         -
855             - pref: AllowHoldsOnPatronsPossessions
856               choices:
857                   1: Allow
858                   0: "Don't allow"
859             - a patron to place a hold on a record where the patron already has one or more items attached to that record checked out.
860         -
861             - pref: LocalHoldsPriority
862               choices:
863                   1: Give
864                   0: "Don't give"
865             - priority for filling holds to patrons whose
866             - pref: LocalHoldsPriorityPatronControl
867               choices:
868                   PickupLibrary: "pickup library"
869                   HomeLibrary: "home library"
870             - matches the item's
871             - pref: LocalHoldsPriorityItemControl
872               choices:
873                   homebranch: "home library"
874                   holdingbranch: "holding library"
875         -
876             - pref: OPACHoldsIfAvailableAtPickup
877               choices:
878                   1: Allow
879                   0: "Don't allow"
880             - to pickup holds at libraries where the item is available.
881         -
882             - 'Patron categories not affected by <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACHoldsIfAvailableAtPickup">OPACHoldsIfAvailableAtPickup</a>:'
883             - pref: OPACHoldsIfAvailableAtPickupExceptions
884               choices: patron-categories
885               class: multiple
886         -
887             - pref: CanMarkHoldsToPullAsLost
888               choices:
889                   do_not_allow: "Do not allow to mark items as lost"
890                   allow: "Allow to mark items as lost"
891                   allow_and_notify: "Allow to mark items as lost and notify the patron"
892             - from the 'Holds to pull' page. Values to be applied must be defined in <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=UpdateItemWhenLostFromHoldList">UpdateItemWhenLostFromHoldList</a>.
893         -
894             - A list of values to update an item's values with when it is marked as lost from the 'Holds to pull' page.
895             - 'Example: "itemlost: 1" to set items.itemlost to 1 when the item is marked as lost. (Requires <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=CanMarkHoldsToPullAsLost">CanMarkHoldsToPullAsLost</a>)'
896             - pref: UpdateItemWhenLostFromHoldList
897               type: textarea
898               syntax: text/x-yaml
899     Interlibrary loans:
900         -
901             - pref: ILLModule
902               default: 0
903               choices:
904                   1: Enable
905                   0: Disable
906             - the interlibrary loans module (master switch).
907         -
908             - "Adding text will enable the copyright clearance stage in request creation. The text you enter will be the text displayed."
909             - pref: ILLModuleCopyrightClearance
910               type: textarea
911               class: long
912         -
913             - "Enabled ILL backends for OPAC initiated requests:"
914             - pref: ILLOpacbackends
915               class: multi
916             - (separated with |). If left empty, all installed backends will be enabled.
917         -
918             - pref: ILLModuleUnmediated
919               default: 0
920               choices:
921                   1: Enable
922                   0: Disable
923             - unmediated interlibrary loan requests. If enabled and the ILL backend supports it, the newly created requests are immediately requested by backend.
924         -
925             - pref: CirculateILL
926               default: 0
927               choices:
928                   1: Enable
929                   0: Disable
930             - the circulation of ILL requested items.
931         -
932             - pref: ILLCheckAvailability
933               default: 0
934               choices:
935                   1: Check
936                   0: "Don't check"
937             - external sources for availability during the request process.
938         -
939             - "ILL statuses that are considered finished and should not be displayed in the ILL module: "
940             - pref: ILLHiddenRequestStatuses
941               class: multi
942             - (separated with |). If left empty, all ILL requests will be displayed. The request codes can be found in the ILLSTATUS authorized value category.
943         -
944             - "Send these ILL notices to staff when appropriate:"
945             - pref: ILLSendStaffNotices
946               class: multi
947             - "(separated with |). e.g. ILL_REQUEST_CANCEL|ILL_REQUEST_MODIFIED If left empty, no staff ILL notices will be sent."
948         -
949             - "Fallback email address for staff ILL notices to be sent to in the absence of a library address:"
950             - pref: ILLDefaultStaffEmail
951               class: email
952     Fines Policy:
953         -
954             - pref: finesCalendar
955               type: choice
956               choices:
957                   ignoreCalendar: Ignore the calendar
958                   noFinesWhenClosed: Use the calendar
959             - when calculating the period for fines.
960         -
961             - pref: SuspensionsCalendar
962               type: choice
963               choices:
964                   ignoreCalendar: Ignore the calendar
965                   noSuspensionsWhenClosed: Use the calendar
966             - when calculating the period for suspension expiration.
967         -
968             - pref: finesMode
969               type: choice
970               choices:
971                   off: "Don't calculate"
972                   production: Calculate and charge
973             - fines (when <code>cronjobs/fines.pl</code> is being run).
974             - '<br><strong>NOTE:</strong> If the cronjobs/fines.pl cronjob is being run, accruing and final fines will be calculated when the cron runs and accruing fines will be finalized when an item is returned. If <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=CalculateFinesOnReturn">CalculateFinesOnReturn</a> is enabled, final fines will be calculated when an item is returned.<br/>'
975             - pref: ChargeFinesOnClosedDays
976               type: choice
977               choices:
978                   0: "Don't charge"
979                   1: Charge
980             - on close days. If set the fines.pl cronjob will not generate fines when run on days marked as closed in the calendar.
981         -
982             - If a lost item is returned, apply the refunding rules defined for the
983             - pref: RefundLostOnReturnControl
984               choices:
985                   CheckinLibrary: "check-in library."
986                   ItemHomeBranch: "item's home library."
987                   ItemHoldingBranch: "item's holding library."
988         -
989             - pref: FinesIncludeGracePeriod
990               choices:
991                   1: Include
992                   0: "Don't include"
993             - the grace period when calculating the fine for an overdue item.
994         -
995             - pref: WhenLostForgiveFine
996               choices:
997                   1: Forgive
998                   0: "Don't forgive"
999             - the fines on an item when it is marked as lost.
1000         -
1001             - "Don't refund lost fees if a lost item is checked in more than"
1002             - pref: NoRefundOnLostReturnedItemsAge
1003               class: integer
1004             - days after it was marked lost.
1005         -
1006             - pref: WhenLostChargeReplacementFee
1007               choices:
1008                   1: Charge
1009                   0: "Don't charge"
1010             - the replacement price when a patron loses an item.
1011         -
1012             - Charge a hold fee
1013             - pref: HoldFeeMode
1014               choices:
1015                   any_time_is_placed: "any time a hold is placed."
1016                   not_always: "only if all items are checked out and the record has at least one hold already."
1017                   any_time_is_collected: "any time a hold is collected."
1018         -
1019             - pref: useDefaultReplacementCost
1020               choices:
1021                   1: Use
1022                   0: "Don't use"
1023             - the default replacement cost defined for the item type.
1024         -
1025             - "Text to be recorded in the column 'note', table 'accountlines' when the processing fee (defined for the item type) is applied:"
1026             - pref: ProcessingFeeNote
1027               type: textarea
1028               class: code
1029     Self check-in module:
1030         -
1031             - "Include the following HTML on the self check-in screen:"
1032             - pref: SelfCheckInMainUserBlock
1033               type: textarea
1034               syntax: text/html
1035               class: code
1036         -
1037             - pref: SelfCheckInModule
1038               choices:
1039                   1: Enable
1040                   0: "Don't enable"
1041             - "the standalone self check-in module (available at: /cgi-bin/koha/sci/sci-main.pl)."
1042         -
1043             - "Reset the current self check-in screen after"
1044             - pref: SelfCheckInTimeout
1045               class: integer
1046             - seconds.
1047         -
1048             - "Include the following CSS on all the self check-in screens:"
1049             - pref: SelfCheckInUserCSS
1050               type: textarea
1051               syntax: css
1052               class: code
1053         -
1054             - "Include the following JavaScript on all the self check-in screens:"
1055             - pref: SelfCheckInUserJS
1056               type: textarea
1057               syntax: javascript
1058               class: code
1059     Self check-out module:
1060         -
1061             - "Include the following JavaScript on all pages in the web-based self checkout:"
1062             - pref: SCOUserJS
1063               type: textarea
1064               syntax: javascript
1065               class: code
1066         -
1067             - "Include the following HTML on the the web-based self checkout screen:"
1068             - pref: SCOMainUserBlock
1069               type: textarea
1070               syntax: text/html
1071               class: code
1072         -
1073             - "Include the following CSS on all pages in the web-based self checkout:"
1074             - pref: SCOUserCSS
1075               type: textarea
1076               syntax: css
1077               class: code
1078         -
1079             - pref: ShowPatronImageInWebBasedSelfCheck
1080               choices:
1081                   1: Show
1082                   0: "Don't show"
1083             - "the patron's picture (if one has been added) when they use the web-based self checkout."
1084         -
1085             - pref: WebBasedSelfCheck
1086               choices:
1087                   1: Enable
1088                   0: "Don't enable"
1089             - "the web-based self checkout system (available at: /cgi-bin/koha/sco/sco-main.pl)."
1090         -
1091             - Have patrons log into the web-based self checkout system with their
1092             - pref: SelfCheckoutByLogin
1093               choices:
1094                   1: username and password
1095                   0: cardnumber
1096             - "."
1097         -
1098             - "Time out the current patron's web-based self checkout system login after"
1099             - pref: SelfCheckTimeout
1100               class: integer
1101             - seconds.
1102         -
1103             - pref: SCOAllowCheckin
1104               choices:
1105                   1: Allow
1106                   0: "Don't allow"
1107             - patrons to return items through web-based self checkout system. 
1108         -
1109             - "Include the following HTML in the Help page of the web-based self checkout system:"
1110             - pref: SelfCheckHelpMessage
1111               type: textarea
1112               syntax: text/html
1113               class: code
1114         -
1115             - pref: AutoSelfCheckAllowed
1116               choices:
1117                   1: Allow
1118                   0: "Don't allow"
1119             - "the web-based self checkout system to automatically log in with this staff login"
1120             - pref: AutoSelfCheckID
1121             - and this password
1122             - pref: AutoSelfCheckPass
1123               class: password
1124             - .
1125             - "Note: Any patron entered here will be unable to log into the OPAC."
1126         -
1127             - pref: SelfCheckReceiptPrompt
1128               choices:
1129                   1: Show
1130                   0: "Don't show"
1131             - "the print receipt popup dialog when self checkout is finished."
1132         -
1133             - "Allow access to the self check from the following IP addresses:"
1134             - pref: SelfCheckAllowByIPRanges
1135               class: short
1136             - (Leave blank if not used. Use ranges or simple IP addresses separated by spaces, like <code>192.168.1.1 192.168.0.0/24</code>.)
1137     Course reserves:
1138         -
1139             - pref: UseCourseReserves
1140               choices:
1141                   1: Use
1142                   0: "Don't use"
1143             - "course reserves."
1144     Batch checkout:
1145         -
1146             - pref: BatchCheckouts
1147               choices:
1148                   1: Allow
1149                   0: "Don't allow"
1150             - "batch checkouts."
1151         -
1152             - "Patron categories allowed to checkout in a batch:"
1153             - pref: BatchCheckoutsValidCategories
1154               choices: patron-categories
1155               class: multiple
1156     Housebound module:
1157         -
1158             - pref: HouseboundModule
1159               choices:
1160                   1: Enable
1161                   0: Disable
1162             - "the housebound module."
1163     Stock rotation module:
1164         -
1165             - pref: StockRotation
1166               choices:
1167                   1: Enable
1168                   0: Disable
1169             - "the stock rotation module."
1170     Article requests:
1171         -
1172             - pref: ArticleRequests
1173               choices:
1174                   1: Enable
1175                   0: "Don't enable"
1176             - patrons to place article requests.
1177         -
1178             - pref: ArticleRequestsLinkControl
1179               choices:
1180                   always: Always show
1181                   calc: Use algorithm to show or hide
1182             - article request links on search results.
1183         -
1184             - "For records that are record level or item level requestable, make the following fields mandatory:"
1185             - pref: ArticleRequestsMandatoryFields
1186               multiple:
1187                 title: Title
1188                 author: Author
1189                 volume: Volume
1190                 issue: Issue
1191                 date: Date
1192                 pages: Pages
1193                 chapters: Chapters
1194             -
1195         -
1196             - "For records that are only record level requestable, make the following fields mandatory:"
1197             - pref: ArticleRequestsMandatoryFieldsRecordOnly
1198               multiple:
1199                 title: Title
1200                 author: Author
1201                 volume: Volume
1202                 issue: Issue
1203                 date: Date
1204                 pages: Pages
1205                 chapters: Chapters
1206             -
1207         -
1208             - "For records that are only item level requestable, make the following fields mandatory:"
1209             - pref: ArticleRequestsMandatoryFieldsItemOnly
1210               multiple:
1211                 title: Title
1212                 author: Author
1213                 volume: Volume
1214                 issue: Issue
1215                 date: Date
1216                 pages: Pages
1217                 chapters: Chapters
1218             -
1219     Return claims:
1220         -
1221             - When marking a checkout as "claims returned",
1222             - pref: ClaimReturnedChargeFee
1223               default: ask
1224               choices:
1225                   ask: ask if a lost fee should be charged
1226                   charge: charge a lost fee
1227                   no_charge: don't charge a lost fee
1228             - .
1229         -
1230             - Use the LOST authorised value
1231             - pref: ClaimReturnedLostValue
1232             - to represent 'claims returned'.
1233         -
1234             - Warn librarians that a patron has excessive return claims if the patron has claimed the return of more than
1235             - pref: ClaimReturnedWarningThreshold
1236               class: integer
1237             - items.