Bug 28850: (QA follow-up) Add "patrons with fines" for clarification
[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. Enabling this system preference will block all checkouts for patrons with fines both via the web-based self checkout system and via SIP.
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 calendar and circulation 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 from the staff interface.
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 rule from 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             - If using <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=ExpireReservesMaxPickUpDelay">ExpireReservesMaxPickUpDelay</a>,
820             - pref: ExpireReservesOnHolidays
821               choices:
822                   1: allow
823                   0: "don't allow"
824             - expired holds to be canceled on days the library is closed per the calendar.
825         -
826             - pref: ExcludeHolidaysFromMaxPickUpDelay
827               choices:
828                   1: Use the calendar
829                   0: Ignore the calendar
830             - when calculating the period for a hold's max pickup delay.
831         -
832             - pref: decreaseLoanHighHolds
833               choices:
834                   1: Enable
835                   0:  "Don't enable"
836             - the reduction of loan period to
837             - pref: decreaseLoanHighHoldsDuration
838               class: integer
839             - days for high demand items with more than
840             - pref: decreaseLoanHighHoldsValue
841               class: integer
842             - holds
843             - pref: decreaseLoanHighHoldsControl
844               choices:
845                   static: "on the record"
846                   dynamic: "over the number of holdable items on the record"
847             - ". Ignore items with the following statuses when counting items:"
848             - pref: decreaseLoanHighHoldsIgnoreStatuses
849               multiple:
850                 damaged: Damaged
851                 itemlost: Lost
852                 withdrawn: Withdrawn
853                 notforloan: Not for loan
854             - "Note: The reduced loan period can also be set up in the circulation conditions and will then overwrite the setting here."
855         -
856             - pref: AllowHoldsOnPatronsPossessions
857               choices:
858                   1: Allow
859                   0: "Don't allow"
860             - a patron to place a hold on a record where the patron already has one or more items attached to that record checked out.
861         -
862             - pref: LocalHoldsPriority
863               choices:
864                   1: Give
865                   0: "Don't give"
866             - priority for filling holds to patrons whose
867             - pref: LocalHoldsPriorityPatronControl
868               choices:
869                   PickupLibrary: "pickup library"
870                   HomeLibrary: "home library"
871             - matches the item's
872             - pref: LocalHoldsPriorityItemControl
873               choices:
874                   homebranch: "home library"
875                   holdingbranch: "holding library"
876         -
877             - pref: OPACHoldsIfAvailableAtPickup
878               choices:
879                   1: Allow
880                   0: "Don't allow"
881             - to pickup holds at libraries where the item is available.
882         -
883             - 'Patron categories not affected by <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACHoldsIfAvailableAtPickup">OPACHoldsIfAvailableAtPickup</a>:'
884             - pref: OPACHoldsIfAvailableAtPickupExceptions
885               choices: patron-categories
886               class: multiple
887         -
888             - pref: CanMarkHoldsToPullAsLost
889               choices:
890                   do_not_allow: "Do not allow to mark items as lost"
891                   allow: "Allow to mark items as lost"
892                   allow_and_notify: "Allow to mark items as lost and notify the patron"
893             - 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>.
894         -
895             - A list of values to update an item's values with when it is marked as lost from the 'Holds to pull' page.
896             - '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>)'
897             - pref: UpdateItemWhenLostFromHoldList
898               type: textarea
899               syntax: text/x-yaml
900         -
901             - pref: DefaultHoldExpirationdate
902               default: 0
903               choices:
904                   yes: Set
905                   no: Don't set
906             - default expiration date for holds automatically.
907             - If enabled, set expiration date
908             - pref: DefaultHoldExpirationdatePeriod
909               default: 0
910               class: integer
911             - pref: DefaultHoldExpirationdateUnitOfTime
912               default: days
913               choices:
914                   days: days
915                   months: months
916                   years: years
917             - from reserve date.
918     Interlibrary loans:
919         -
920             - pref: ILLModule
921               default: 0
922               choices:
923                   1: Enable
924                   0: Disable
925             - the interlibrary loans module (master switch).
926         -
927             - "Adding text will enable the copyright clearance stage in request creation. The text you enter will be the text displayed."
928             - pref: ILLModuleCopyrightClearance
929               type: textarea
930               class: long
931         -
932             - "Enabled ILL backends for OPAC initiated requests:"
933             - pref: ILLOpacbackends
934               class: multi
935             - (separated with |). If left empty, all installed backends will be enabled.
936         -
937             - pref: ILLModuleUnmediated
938               default: 0
939               choices:
940                   1: Enable
941                   0: Disable
942             - unmediated interlibrary loan requests. If enabled and the ILL backend supports it, the newly created requests are immediately requested by backend.
943         -
944             - pref: CirculateILL
945               default: 0
946               choices:
947                   1: Enable
948                   0: Disable
949             - the circulation of ILL requested items.
950         -
951             - pref: ILLCheckAvailability
952               default: 0
953               choices:
954                   1: Check
955                   0: "Don't check"
956             - external sources for availability during the request process.
957         -
958             - "ILL statuses that are considered finished and should not be displayed in the ILL module: "
959             - pref: ILLHiddenRequestStatuses
960               class: multi
961             - (separated with |). If left empty, all ILL requests will be displayed. The request codes can be found in the ILLSTATUS authorized value category.
962         -
963             - "Send these ILL notices to staff when appropriate:"
964             - pref: ILLSendStaffNotices
965               class: multi
966             - "(separated with |). e.g. ILL_REQUEST_CANCEL|ILL_REQUEST_MODIFIED If left empty, no staff ILL notices will be sent."
967         -
968             - "Fallback email address for staff ILL notices to be sent to in the absence of a library address:"
969             - pref: ILLDefaultStaffEmail
970               class: email
971     Fines Policy:
972         -
973             - pref: finesCalendar
974               type: choice
975               choices:
976                   ignoreCalendar: Ignore the calendar
977                   noFinesWhenClosed: Use the calendar
978             - when calculating the period for fines.
979         -
980             - pref: SuspensionsCalendar
981               type: choice
982               choices:
983                   ignoreCalendar: Ignore the calendar
984                   noSuspensionsWhenClosed: Use the calendar
985             - when calculating the period for suspension expiration.
986         -
987             - pref: finesMode
988               type: choice
989               choices:
990                   off: "Don't calculate"
991                   production: Calculate and charge
992             - fines (when <code>cronjobs/fines.pl</code> is being run).
993             - '<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/>'
994             - pref: ChargeFinesOnClosedDays
995               type: choice
996               choices:
997                   0: "Don't charge"
998                   1: Charge
999             - on close days. If set the fines.pl cronjob will not generate fines when run on days marked as closed in the calendar.
1000         -
1001             - If a lost item is returned, apply the refunding rules defined for the
1002             - pref: RefundLostOnReturnControl
1003               choices:
1004                   CheckinLibrary: "check-in library."
1005                   ItemHomeBranch: "item's home library."
1006                   ItemHoldingBranch: "item's holding library."
1007         -
1008             - pref: FinesIncludeGracePeriod
1009               choices:
1010                   1: Include
1011                   0: "Don't include"
1012             - the grace period when calculating the fine for an overdue item.
1013         -
1014             - pref: WhenLostForgiveFine
1015               choices:
1016                   1: Forgive
1017                   0: "Don't forgive"
1018             - the fines on an item when it is marked as lost.
1019         -
1020             - "Don't refund lost fees if a lost item is checked in more than"
1021             - pref: NoRefundOnLostReturnedItemsAge
1022               class: integer
1023             - days after it was marked lost.
1024         -
1025             - pref: WhenLostChargeReplacementFee
1026               choices:
1027                   1: Charge
1028                   0: "Don't charge"
1029             - the replacement price when a patron loses an item.
1030         -
1031             - Charge a hold fee
1032             - pref: HoldFeeMode
1033               choices:
1034                   any_time_is_placed: "any time a hold is placed."
1035                   not_always: "only if all items are checked out and the record has at least one hold already."
1036                   any_time_is_collected: "any time a hold is collected."
1037         -
1038             - pref: useDefaultReplacementCost
1039               choices:
1040                   1: Use
1041                   0: "Don't use"
1042             - the default replacement cost defined for the item type.
1043         -
1044             - "Text to be recorded in the column 'note', table 'accountlines' when the processing fee (defined for the item type) is applied:"
1045             - pref: ProcessingFeeNote
1046               type: textarea
1047               class: code
1048     Self check-in module:
1049         -
1050             - "Include the following HTML on the self check-in screen:"
1051             - pref: SelfCheckInMainUserBlock
1052               type: textarea
1053               syntax: text/html
1054               class: code
1055         -
1056             - pref: SelfCheckInModule
1057               choices:
1058                   1: Enable
1059                   0: "Don't enable"
1060             - "the standalone self check-in module (available at: /cgi-bin/koha/sci/sci-main.pl)."
1061         -
1062             - "Reset the current self check-in screen after"
1063             - pref: SelfCheckInTimeout
1064               class: integer
1065             - seconds.
1066         -
1067             - "Include the following CSS on all the self check-in screens:"
1068             - pref: SelfCheckInUserCSS
1069               type: textarea
1070               syntax: css
1071               class: code
1072         -
1073             - "Include the following JavaScript on all the self check-in screens:"
1074             - pref: SelfCheckInUserJS
1075               type: textarea
1076               syntax: javascript
1077               class: code
1078     Self check-out module:
1079         -
1080             - "Include the following JavaScript on all pages in the web-based self checkout:"
1081             - pref: SCOUserJS
1082               type: textarea
1083               syntax: javascript
1084               class: code
1085         -
1086             - "Include the following HTML on the the web-based self checkout screen:"
1087             - pref: SCOMainUserBlock
1088               type: textarea
1089               syntax: text/html
1090               class: code
1091         -
1092             - "Include the following CSS on all pages in the web-based self checkout:"
1093             - pref: SCOUserCSS
1094               type: textarea
1095               syntax: css
1096               class: code
1097         -
1098             - pref: ShowPatronImageInWebBasedSelfCheck
1099               choices:
1100                   1: Show
1101                   0: "Don't show"
1102             - "the patron's picture (if one has been added) when they use the web-based self checkout."
1103         -
1104             - pref: WebBasedSelfCheck
1105               choices:
1106                   1: Enable
1107                   0: "Don't enable"
1108             - "the web-based self checkout system (available at: /cgi-bin/koha/sco/sco-main.pl)."
1109         -
1110             - Have patrons log into the web-based self checkout system with their
1111             - pref: SelfCheckoutByLogin
1112               choices:
1113                   1: username and password
1114                   0: cardnumber
1115             - "."
1116         -
1117             - "Time out the current patron's web-based self checkout system login after"
1118             - pref: SelfCheckTimeout
1119               class: integer
1120             - seconds.
1121         -
1122             - pref: SCOAllowCheckin
1123               choices:
1124                   1: Allow
1125                   0: "Don't allow"
1126             - patrons to return items through web-based self checkout system. 
1127         -
1128             - "Include the following HTML in the Help page of the web-based self checkout system:"
1129             - pref: SelfCheckHelpMessage
1130               type: textarea
1131               syntax: text/html
1132               class: code
1133         -
1134             - pref: AutoSelfCheckAllowed
1135               choices:
1136                   1: Allow
1137                   0: "Don't allow"
1138             - "the web-based self checkout system to automatically log in with this staff login"
1139             - pref: AutoSelfCheckID
1140             - and this password
1141             - pref: AutoSelfCheckPass
1142               class: password
1143             - .
1144             - "Note: Any patron entered here will be unable to log into the OPAC."
1145         -
1146             - pref: SelfCheckReceiptPrompt
1147               choices:
1148                   1: Show
1149                   0: "Don't show"
1150             - "the print receipt popup dialog when self checkout is finished."
1151         -
1152             - "Allow access to the self check from the following IP addresses:"
1153             - pref: SelfCheckAllowByIPRanges
1154               class: short
1155             - (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>.)
1156     Course reserves:
1157         -
1158             - pref: UseCourseReserves
1159               choices:
1160                   1: Use
1161                   0: "Don't use"
1162             - "course reserves."
1163     Batch checkout:
1164         -
1165             - pref: BatchCheckouts
1166               choices:
1167                   1: Allow
1168                   0: "Don't allow"
1169             - "batch checkouts."
1170         -
1171             - "Patron categories allowed to checkout in a batch:"
1172             - pref: BatchCheckoutsValidCategories
1173               choices: patron-categories
1174               class: multiple
1175     Housebound module:
1176         -
1177             - pref: HouseboundModule
1178               choices:
1179                   1: Enable
1180                   0: Disable
1181             - "the housebound module."
1182     Stock rotation module:
1183         -
1184             - pref: StockRotation
1185               choices:
1186                   1: Enable
1187                   0: Disable
1188             - "the stock rotation module."
1189     Article requests:
1190         -
1191             - pref: ArticleRequests
1192               choices:
1193                   1: Enable
1194                   0: "Don't enable"
1195             - patrons to place article requests.
1196         -
1197             - pref: ArticleRequestsOpacHostRedirection
1198               choices:
1199                   yes: Enable
1200                   no: Disable
1201             - " redirection from child to host based on MARC21 773$w when the child has no items when requesting articles on the Opac."
1202         -
1203             - pref: ArticleRequestsLinkControl
1204               choices:
1205                   always: Always show
1206                   calc: Use algorithm to show or hide
1207             - article request links on search results.
1208         -
1209             - "For records that are record level or item level requestable, make the following fields mandatory:"
1210             - pref: ArticleRequestsMandatoryFields
1211               multiple:
1212                 title: Title
1213                 author: Author
1214                 volume: Volume
1215                 issue: Issue
1216                 date: Date
1217                 pages: Pages
1218                 chapters: Chapters
1219             -
1220         -
1221             - "For records that are only record level requestable, make the following fields mandatory:"
1222             - pref: ArticleRequestsMandatoryFieldsRecordOnly
1223               multiple:
1224                 title: Title
1225                 author: Author
1226                 volume: Volume
1227                 issue: Issue
1228                 date: Date
1229                 pages: Pages
1230                 chapters: Chapters
1231             -
1232         -
1233             - "For records that are only item level requestable, make the following fields mandatory:"
1234             - pref: ArticleRequestsMandatoryFieldsItemOnly
1235               multiple:
1236                 title: Title
1237                 author: Author
1238                 volume: Volume
1239                 issue: Issue
1240                 date: Date
1241                 pages: Pages
1242                 chapters: Chapters
1243             -
1244         -
1245             - "The following article request formats are supported:"
1246             - pref: ArticleRequestsSupportedFormats
1247             - "(Valid choices are currently: PHOTOCOPY and SCAN. Separate the supported formats by a vertical bar. The first listed format is selected by default when you request via the OPAC.)"
1248
1249     Return claims:
1250         -
1251             - When marking a checkout as "claims returned",
1252             - pref: ClaimReturnedChargeFee
1253               default: ask
1254               choices:
1255                   ask: ask if a lost fee should be charged
1256                   charge: charge a lost fee
1257                   no_charge: don't charge a lost fee
1258             - .
1259         -
1260             - Use the LOST authorised value
1261             - pref: ClaimReturnedLostValue
1262             - to represent 'claims returned'.
1263         -
1264             - Warn librarians that a patron has excessive return claims if the patron has claimed the return of more than
1265             - pref: ClaimReturnedWarningThreshold
1266               class: integer
1267             - items.