Bug 27835: Add new syspref ChargeFinesOnCloseDay
[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 RESERVE_WAITING and 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         -
397             - pref: OverdueNoticeCalendar
398               choices:
399                   1: "Use calendar"
400                   0: "Ignore calendar"
401             - "when working out the period for overdue notices."
402         -
403             - Include up to
404             - pref: PrintNoticesMaxLines
405               class: integer
406             - "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."
407         -
408             - pref: OverduesBlockCirc
409               choices:
410                   block: Block
411                   noblock: "Don't block"
412                   confirmation: Ask for confirmation
413             - "when checking out to a patron that has overdues outstanding."
414         -
415             - "When checking out an item with rental fees, "
416             - pref: RentalFeesCheckoutConfirmation
417               choices:
418                   1: ask
419                   0: "don't ask"
420             - "for confirmation."
421         -
422             - By default, set the LOST value of an item to
423             - pref: DefaultLongOverdueLostValue
424               class: integer
425             - when the item has been overdue for more than
426             - pref: DefaultLongOverdueDays
427               class: integer
428             - days.
429             - <br>WARNING â€” These preferences will activate the automatic item loss process. Leave these fields empty if you don't want to activate this feature.
430             - "<br>Example: [1] [30] Sets an item to the LOST value 1 when it has been overdue for more than 30 days."
431             - <br>(Used when the longoverdue.pl script is called without the --lost parameter)
432             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/longoverdue.pl</code> cronjob. Ask your system administrator to schedule it."
433         -
434             - "Charge a lost item to the patron's account when the LOST value of the item changes to:"
435             - pref: DefaultLongOverdueChargeValue
436               class: integer
437             - <br>Leave this field empty if you don't want to charge the patron for lost items.
438             - <br>(Used when the longoverdue.pl script is called without the --charge parameter)
439             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/longoverdue.pl</code> cronjob. Ask your system administrator to schedule it."
440         -
441             - When using the automatic item loss process, skip items with lost values matching any of
442             - pref: DefaultLongOverdueSkipLostStatuses
443             - "."
444             - <br>Leave this field empty if you don't want to skip any lost statuses.
445             - <br>Set to a list of comma separated values, e.g. <em>5,6,7</em>.
446         -
447             - "When issuing an item that has been marked as lost, "
448             - pref: IssueLostItem
449               choices:
450                   confirm: "require confirmation"
451                   alert: "display a message"
452                   nothing : "do nothing"
453             - .
454         -
455             - "When checking out an item, "
456             - pref: RecordStaffUserOnCheckout
457               choices:
458                   1: "record"
459                   0: "don't record"
460             - "the user who checked out the item."
461         -
462             - "Mark items as returned when flagged as lost "
463             - pref: MarkLostItemsAsReturned
464               multiple:
465                 cronjob: "from the longoverdue cronjob"
466                 batchmod: "from the batch item modification tool"
467                 additem: "when cataloguing an item"
468                 moredetail: "from the items tab of the catalog module"
469                 pendingreserves: "from the 'Holds to pull' list"
470                 onpayment: "when receiving payment for the item"
471                 claim_returned: "when marking an item as a return claim"
472             - .
473         -
474             - pref: AllowMultipleIssuesOnABiblio
475               choices:
476                   1: Allow
477                   0: "Don't allow"
478             - "patrons to check out multiple items from the same record. (<strong>NOTE:</strong> This will only affect records without a subscription attached.)"
479         -
480             - pref: OnSiteCheckouts
481               choices:
482                   1: Enable
483                   0: Disable
484             - the on-site checkouts feature.
485         -
486             - pref: OnSiteCheckoutsForce
487               choices:
488                   1: Enable
489                   0: Disable
490             - the on-site checkout for all cases (even if a patron is debarred, etc.).
491         -
492             - pref: ConsiderOnSiteCheckoutsAsNormalCheckouts
493               choices:
494                   1: Consider
495                   0: "Don't consider"
496             - on-site checkouts as normal checkouts.
497             - 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.
498             - If disabled, both values will be checked separately.
499         -
500             - pref: SwitchOnSiteCheckouts
501               choices:
502                   1: Switch
503                   0: "Don't switch"
504             - on-site checkouts to normal checkouts when checked out.
505         -
506             - When a patron's checked out item is overdue,
507             - pref: OverduesBlockRenewing
508               type: choice
509               choices:
510                   allow: allow renewing.
511                   blockitem: block renewing only for this item.
512                   block: block renewing for all the patron's items.
513         -
514             - If a patron is restricted,
515             - pref: RestrictionBlockRenewing
516               choices:
517                   1: block
518                   0: allow
519             - renewing of items.
520         -
521             - If a patron owes more than the value of <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACFineNoRenewals">OPACFineNoRenewals</a>,
522             - pref: OPACFineNoRenewalsBlockAutoRenew
523               choices:
524                   1: block
525                   0: allow
526             - their auto-renewals.
527         -
528             - If a patron pays off all fines on an overdue item that is accruing fines,
529             - pref: RenewAccruingItemWhenPaid
530               choices:
531                   1: renew
532                   0: "don't renew"
533             - 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.
534         -
535             - If a patron pays off all fines on an overdue item that is accruing fines in the OPAC via a payment plugin,
536             - pref: RenewAccruingItemInOpac
537               choices:
538                   1: renew
539                   0: "don't renew"
540             - 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.
541         -
542             - pref: ItemsDeniedRenewal
543               type: textarea
544               syntax: text/x-yaml
545               class: code
546             - Define custom rules to deny specific items from renewal.
547             - "<br />Can name any field in the items table followed by a colon then a space then"
548             - "a bracketed list of values separated by commas."
549             - "For example:"
550             - "<br />ccode: [NEWFIC,NULL,DVD]"
551             - "<br />itype: [NEWBK,\"\"]"
552             - "<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."
553     Checkin policy:
554         -
555             - pref: TrapHoldsOnOrder
556               choices:
557                   1: Trap
558                   0: "Don't trap"
559             - items that are not for loan but holdable ( notforloan < 0 ) to fill holds.
560         -
561             - Never trap items with 'not for loan' values of
562             - pref: SkipHoldTrapOnNotForLoanValue
563               class: integer
564             - to fill holds.
565             - "(list of not for loan values separated with a pipe '|')"
566         -
567             - pref: HoldsAutoFill
568               choices:
569                   1: Do
570                   0: "Don't"
571             - automatically fill holds instead of asking the librarian.
572         -
573             - pref: HoldsNeedProcessingSIP
574               choices:
575                   1: "Don't fulfill"
576                   0: Fulfill
577             - holds automatically if matching item is returned via SIP protocol.
578         -
579             - pref: HoldsAutoFillPrintSlip
580               choices:
581                   1: Do
582                   0: "Don't"
583             - automatically display the hold slip dialog for auto-filled holds.
584         -
585             - pref: BlockReturnOfWithdrawnItems
586               choices:
587                   1: Block
588                   0: "Don't block"
589             - returning of items that have been withdrawn.
590         -
591             - pref: BlockReturnOfLostItems
592               choices:
593                   1: Block
594                   0: "Don't block"
595             - returning of items that have been lost.
596         -
597             - pref: CalculateFinesOnReturn
598               choices:
599                   1: Do
600                   0: "Don't"
601             - calculate and update overdue charges when an item is returned.
602             - "<br /><strong>NOTE:</strong> If you are doing hourly loans then you should have this on."
603             - '<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."'
604         -
605             - pref: CalculateFinesOnBackdate
606               choices:
607                   1: Do
608                   0: "Don't"
609             - calculate and update overdue charges when an item is returned with a backdated return date.
610         -
611             - pref: UpdateItemLocationOnCheckin
612               type: textarea
613               syntax: text/x-yaml
614               class: code
615             - "This is a list of value pairs. The first value is followed immediately by colon space then the second value.<br/><br/>"
616             - "Examples:<br/>"
617             - "PROC: FIC - causes an item in the Processing Center location to be updated into the Fiction location on check in.<br/>"
618             - "FIC: GEN - causes an item in the Fiction location to be updated into the General stacks location on check in.<br/>"
619             - "_BLANK_: FIC - causes an item that has no location to be updated into the Fiction location on check in.<br/>"
620             - "FIC: _BLANK_ - causes an item in location FIC to be updated to a blank location on check in.<br/>"
621             - "_ALL_: FIC - causes all items to be updated into the Fiction location on check in.<br/>"
622             - "PROC: _PERM_ - causes an item that is in the Processing Center to be updated to it's permanent location.<br/><br/>"
623             - "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/>"
624             - "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/>"
625             - "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/>"
626             - "The special term _ALL_ is used on the left side of the colon (:) to affect all items, <strong>and overrides all other rules.</strong>"
627         -
628             - pref: UpdateNotForLoanStatusOnCheckin
629               type: textarea
630               syntax: text/x-yaml
631               class: code
632             - 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
633             - "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."
634             - Each pair of values should be on a separate line.
635         -
636             - pref: CumulativeRestrictionPeriods
637               choices:
638                   1: Cumulate
639                   0: "Don't cumulate"
640             - the restriction periods.
641         -
642             - pref: HidePersonalPatronDetailOnCirculation
643               choices:
644                   1: "Hide"
645                   0: "Don't hide"
646             - "a patron's phone number, email address, street address and city on the circulation page."
647         -
648             - pref: TransfersBlockCirc
649               choices:
650                   1: "Block"
651                   0: "Don't block"
652             - staff from continuing to checkin items when a transfer is triggered.
653         -
654             - pref: StoreLastBorrower
655               default: 0
656               choices:
657                   1: Store
658                   0: "Don't store"
659             - '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.'
660     Holds policy:
661         -
662             - In the staff interface, split the holds queue into separate tables by
663             - pref: HoldsSplitQueue
664               choices:
665                   nothing: nothing
666                   branch: "pickup library"
667                   itemtype: "hold item type"
668                   branch_itemtype: "pickup library and item type"
669             - "."
670         -
671             - If the holds queue is split, show librarians
672             - pref: HoldsSplitQueueNumbering
673               choices:
674                   actual: "the actual priority, which may be out of order"
675                   virtual: "'virtual' priorities, where each group is numbered separately"
676             - "."
677         -
678             - pref: AllowHoldItemTypeSelection
679               choices:
680                   1: Allow
681                   0: "Don't allow"
682             - hold fulfillment to be limited by item type.
683         -
684             - pref: AllowRenewalIfOtherItemsAvailable
685               choices:
686                   1: Allow
687                   0: "Don't allow"
688             - a patron to renew an item with unfilled holds if other available items can fill that hold.
689         -
690             - pref: AllowHoldPolicyOverride
691               choices:
692                   1: Allow
693                   0: "Don't allow"
694             - staff to override hold policies when placing holds.
695         -
696             - pref: AllowHoldsOnDamagedItems
697               choices:
698                   1: Allow
699                   0: "Don't allow"
700             - hold requests to be placed on and filled by damaged items.
701         -
702             - pref: AllowHoldDateInFuture
703               choices:
704                   1: Allow
705                   0: "Don't allow"
706             - hold requests to be placed that do not enter the waiting list until a certain future date.
707         -
708             - pref: OPACAllowHoldDateInFuture
709               choices:
710                   1: Allow
711                   0: "Don't allow"
712             - 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).
713         -
714             - Confirm future hold requests (starting no later than
715             - pref: ConfirmFutureHolds
716               class: integer
717             - 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.
718         -
719             - Check the
720             - pref: ReservesControlBranch
721               choices:
722                   ItemHomeLibrary: "item's home library"
723                   PatronLibrary: "patron's home library"
724             - to see if the patron can place a hold on the item.    
725         -
726             - Mark a hold as problematic if it has been waiting for more than
727             - pref: ReservesMaxPickUpDelay
728               class: integer
729             - days.
730         -
731             - pref: ExpireReservesMaxPickUpDelay
732               choices:
733                   1: Allow
734                   0: "Don't allow"
735             - '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.'
736         -
737             - 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
738             - pref: ExpireReservesMaxPickUpDelayCharge
739               class: currency
740             - "."
741         -
742             - Satisfy holds using items from the libraries
743             - pref: StaticHoldsQueueWeight
744               class: multi
745             - (as branchcodes, separated by commas; if empty, uses all libraries)
746             - when they are
747             - pref: HoldsQueueSkipClosed
748               choices:
749                   1: open
750                   0: open or closed
751             - pref: RandomizeHoldsQueueWeight
752               choices:
753                   1: in random order.
754                   0: in that order.
755             - "<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."
756             -
757         -
758             - pref: canreservefromotherbranches
759               choices:
760                   1: Allow
761                   0: "Don't allow (with independentbranches)"
762             - a user from one library to place a hold on an item from another library
763         -
764             - pref: OPACAllowUserToChooseBranch
765               choices:
766                   1: Allow
767                   0: "Don't allow"
768             - a user to choose the library to pick up a hold from.
769         -
770             - pref: ReservesNeedReturns
771               choices:
772                   1: "Don't automatically"
773                   0: Automatically
774             - mark a hold as found and waiting when a hold is placed on a specific item and that item is already checked in.
775         -
776             - Patrons can only have
777             - pref: maxreserves
778               class: integer
779             - holds at once.
780         -
781             - pref: emailLibrarianWhenHoldIsPlaced
782               choices:
783                   1: Enable
784                   0:  "Don't enable"
785             - "sending an email to the Koha administrator email address whenever a hold request is placed."
786         -
787             - pref: DisplayMultiPlaceHold
788               choices:
789                   1: Enable
790                   0:  "Don't enable"
791             - "the ability to place holds on multiple bibliographic records from the search results"
792         -
793             - pref: TransferWhenCancelAllWaitingHolds
794               choices:
795                   1: Transfer
796                   0: "Don't transfer"
797             - items when cancelling all waiting holds.
798         -
799             - pref: AutoResumeSuspendedHolds
800               choices:
801                   1: Allow
802                   0: "Don't allow"
803             - "suspended holds to be automatically resumed by a set date."
804             - "<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."
805         -
806             - pref: SuspendHoldsIntranet
807               choices:
808                   1: Allow
809                   0: "Don't allow"
810             - holds to be suspended from the staff interface.
811         -
812             - pref: SuspendHoldsOpac
813               choices:
814                   1: Allow
815                   0: "Don't allow"
816             - holds to be suspended from the OPAC.
817         -
818             - pref: ExpireReservesOnHolidays
819               choices:
820                   1: Allow
821                   0: "Don't allow"
822             - expired holds to be canceled on days the library is closed.
823         -
824             - pref: ExcludeHolidaysFromMaxPickUpDelay
825               choices:
826                   1: Use the calendar
827                   0: Ignore the calendar
828             - when calculating the period for a hold's max pickup delay.
829         -
830             - pref: decreaseLoanHighHolds
831               choices:
832                   1: Enable
833                   0:  "Don't enable"
834             - the reduction of loan period to
835             - pref: decreaseLoanHighHoldsDuration
836               class: integer
837             - days for high demand items with more than
838             - pref: decreaseLoanHighHoldsValue
839               class: integer
840             - holds
841             - pref: decreaseLoanHighHoldsControl
842               choices:
843                   static: "on the record"
844                   dynamic: "over the number of holdable items on the record"
845             - ". Ignore items with the following statuses when counting items:"
846             - pref: decreaseLoanHighHoldsIgnoreStatuses
847               multiple:
848                 damaged: Damaged
849                 itemlost: Lost
850                 withdrawn: Withdrawn
851                 notforloan: Not for loan
852             - "Note: The reduced loan period can also be set up in the circulation conditions and will then overwrite the setting here."
853         -
854             - pref: AllowHoldsOnPatronsPossessions
855               choices:
856                   1: Allow
857                   0: "Don't allow"
858             - a patron to place a hold on a record where the patron already has one or more items attached to that record checked out.
859         -
860             - pref: LocalHoldsPriority
861               choices:
862                   1: Give
863                   0: "Don't give"
864             - priority for filling holds to patrons whose
865             - pref: LocalHoldsPriorityPatronControl
866               choices:
867                   PickupLibrary: "pickup library"
868                   HomeLibrary: "home library"
869             - matches the item's
870             - pref: LocalHoldsPriorityItemControl
871               choices:
872                   homebranch: "home library"
873                   holdingbranch: "holding library"
874         -
875             - pref: OPACHoldsIfAvailableAtPickup
876               choices:
877                   1: Allow
878                   0: "Don't allow"
879             - to pickup holds at libraries where the item is available.
880         -
881             - 'Patron categories not affected by <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACHoldsIfAvailableAtPickup">OPACHoldsIfAvailableAtPickup</a>:'
882             - pref: OPACHoldsIfAvailableAtPickupExceptions
883               choices: patron-categories
884               class: multiple
885         -
886             - pref: CanMarkHoldsToPullAsLost
887               choices:
888                   do_not_allow: "Do not allow to mark items as lost"
889                   allow: "Allow to mark items as lost"
890                   allow_and_notify: "Allow to mark items as lost and notify the patron"
891             - 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>.
892         -
893             - A list of values to update an item's values with when it is marked as lost from the 'Holds to pull' page.
894             - '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>)'
895             - pref: UpdateItemWhenLostFromHoldList
896               type: textarea
897               syntax: text/x-yaml
898     Interlibrary loans:
899         -
900             - pref: ILLModule
901               default: 0
902               choices:
903                   1: Enable
904                   0: Disable
905             - the interlibrary loans module (master switch).
906         -
907             - "Adding text will enable the copyright clearance stage in request creation. The text you enter will be the text displayed."
908             - pref: ILLModuleCopyrightClearance
909               type: textarea
910               class: long
911         -
912             - "Enabled ILL backends for OPAC initiated requests:"
913             - pref: ILLOpacbackends
914               class: multi
915             - (separated with |). If left empty, all installed backends will be enabled.
916         -
917             - pref: ILLModuleUnmediated
918               default: 0
919               choices:
920                   1: Enable
921                   0: Disable
922             - unmediated interlibrary loan requests. If enabled and the ILL backend supports it, the newly created requests are immediately requested by backend.
923         -
924             - pref: CirculateILL
925               default: 0
926               choices:
927                   1: Enable
928                   0: Disable
929             - the circulation of ILL requested items.
930         -
931             - pref: ILLCheckAvailability
932               default: 0
933               choices:
934                   1: Check
935                   0: "Don't check"
936             - external sources for availability during the request process.
937         -
938             - "ILL statuses that are considered finished and should not be displayed in the ILL module: "
939             - pref: ILLHiddenRequestStatuses
940               class: multi
941             - (separated with |). If left empty, all ILL requests will be displayed. The request codes can be found in the ILLSTATUS authorized value category.
942         -
943             - "Send these ILL notices to staff when appropriate:"
944             - pref: ILLSendStaffNotices
945               class: multi
946             - "(separated with |). e.g. ILL_REQUEST_CANCEL|ILL_REQUEST_MODIFIED If left empty, no staff ILL notices will be sent."
947         -
948             - "Fallback email address for staff ILL notices to be sent to in the absence of a library address:"
949             - pref: ILLDefaultStaffEmail
950     Fines Policy:
951         -
952             - pref: finesCalendar
953               type: choice
954               choices:
955                   ignoreCalendar: Ignore the calendar
956                   noFinesWhenClosed: Use the calendar
957             - when calculating the period for fines.
958         -
959             - pref: SuspensionsCalendar
960               type: choice
961               choices:
962                   ignoreCalendar: Ignore the calendar
963                   noSuspensionsWhenClosed: Use the calendar
964             - when calculating the period for suspension expiration.
965         -
966             - pref: finesMode
967               type: choice
968               choices:
969                   off: "Don't calculate"
970                   production: Calculate and charge
971             - fines (when <code>cronjobs/fines.pl</code> is being run).
972             - '<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/>'
973             - pref: ChargeFinesOnCloseDay
974               type: choice
975               choices:
976                   0: "Don't charge"
977                   1: Charge
978             - on close days. If set the fines.pl cronjob will not generate fines when run on days marked as closed in the calendar.
979         -
980             - If a lost item is returned, apply the refunding rules defined for the
981             - pref: RefundLostOnReturnControl
982               choices:
983                   CheckinLibrary: "check-in library."
984                   ItemHomeBranch: "item's home library."
985                   ItemHoldingBranch: "item's holding library."
986         -
987             - pref: FinesIncludeGracePeriod
988               choices:
989                   1: Include
990                   0: "Don't include"
991             - the grace period when calculating the fine for an overdue item.
992         -
993             - pref: WhenLostForgiveFine
994               choices:
995                   1: Forgive
996                   0: "Don't forgive"
997             - the fines on an item when it is marked as lost.
998         -
999             - "Don't refund lost fees if a lost item is checked in more than"
1000             - pref: NoRefundOnLostReturnedItemsAge
1001               class: integer
1002             - days after it was marked lost.
1003         -
1004             - pref: WhenLostChargeReplacementFee
1005               choices:
1006                   1: Charge
1007                   0: "Don't charge"
1008             - the replacement price when a patron loses an item.
1009         -
1010             - Charge a hold fee
1011             - pref: HoldFeeMode
1012               choices:
1013                   any_time_is_placed: "any time a hold is placed."
1014                   not_always: "only if all items are checked out and the record has at least one hold already."
1015                   any_time_is_collected: "any time a hold is collected."
1016         -
1017             - pref: useDefaultReplacementCost
1018               choices:
1019                   1: Use
1020                   0: "Don't use"
1021             - the default replacement cost defined for the item type.
1022         -
1023             - "Text to be recorded in the column 'note', table 'accountlines' when the processing fee (defined for the item type) is applied:"
1024             - pref: ProcessingFeeNote
1025               type: textarea
1026               class: code
1027     Self check-in module:
1028         -
1029             - "Include the following HTML on the self check-in screen:"
1030             - pref: SelfCheckInMainUserBlock
1031               type: textarea
1032               syntax: text/html
1033               class: code
1034         -
1035             - pref: SelfCheckInModule
1036               choices:
1037                   1: Enable
1038                   0: "Don't enable"
1039             - "the standalone self check-in module (available at: /cgi-bin/koha/sci/sci-main.pl)."
1040         -
1041             - "Reset the current self check-in screen after"
1042             - pref: SelfCheckInTimeout
1043               class: integer
1044             - seconds.
1045         -
1046             - "Include the following CSS on all the self check-in screens:"
1047             - pref: SelfCheckInUserCSS
1048               type: textarea
1049               syntax: css
1050               class: code
1051         -
1052             - "Include the following JavaScript on all the self check-in screens:"
1053             - pref: SelfCheckInUserJS
1054               type: textarea
1055               syntax: javascript
1056               class: code
1057     Self check-out module:
1058         -
1059             - "Include the following JavaScript on all pages in the web-based self checkout:"
1060             - pref: SCOUserJS
1061               type: textarea
1062               syntax: javascript
1063               class: code
1064         -
1065             - "Include the following HTML on the the web-based self checkout screen:"
1066             - pref: SCOMainUserBlock
1067               type: textarea
1068               syntax: text/html
1069               class: code
1070         -
1071             - "Include the following CSS on all pages in the web-based self checkout:"
1072             - pref: SCOUserCSS
1073               type: textarea
1074               syntax: css
1075               class: code
1076         -
1077             - pref: ShowPatronImageInWebBasedSelfCheck
1078               choices:
1079                   1: Show
1080                   0: "Don't show"
1081             - "the patron's picture (if one has been added) when they use the web-based self checkout."
1082         -
1083             - pref: WebBasedSelfCheck
1084               choices:
1085                   1: Enable
1086                   0: "Don't enable"
1087             - "the web-based self checkout system (available at: /cgi-bin/koha/sco/sco-main.pl)."
1088         -
1089             - Have patrons log into the web-based self checkout system with their
1090             - pref: SelfCheckoutByLogin
1091               choices:
1092                   1: username and password
1093                   0: cardnumber
1094             - "."
1095         -
1096             - "Time out the current patron's web-based self checkout system login after"
1097             - pref: SelfCheckTimeout
1098               class: integer
1099             - seconds.
1100         -
1101             - pref: SCOAllowCheckin
1102               choices:
1103                   1: Allow
1104                   0: "Don't allow"
1105             - patrons to return items through web-based self checkout system. 
1106         -
1107             - "Include the following HTML in the Help page of the web-based self checkout system:"
1108             - pref: SelfCheckHelpMessage
1109               type: textarea
1110               syntax: text/html
1111               class: code
1112         -
1113             - pref: AutoSelfCheckAllowed
1114               choices:
1115                   1: Allow
1116                   0: "Don't allow"
1117             - "the web-based self checkout system to automatically log in with this staff login"
1118             - pref: AutoSelfCheckID
1119             - and this password
1120             - pref: AutoSelfCheckPass
1121               class: password
1122             - .
1123             - "Note: Any patron entered here will be unable to log into the OPAC."
1124         -
1125             - pref: SelfCheckReceiptPrompt
1126               choices:
1127                   1: Show
1128                   0: "Don't show"
1129             - "the print receipt popup dialog when self checkout is finished."
1130         -
1131             - "Allow access to the self check from the following IP addresses:"
1132             - pref: SelfCheckAllowByIPRanges
1133               class: short
1134             - (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>.)
1135     Course reserves:
1136         -
1137             - pref: UseCourseReserves
1138               choices:
1139                   1: Use
1140                   0: "Don't use"
1141             - "course reserves."
1142     Batch checkout:
1143         -
1144             - pref: BatchCheckouts
1145               choices:
1146                   1: Allow
1147                   0: "Don't allow"
1148             - "batch checkouts."
1149         -
1150             - "Patron categories allowed to checkout in a batch:"
1151             - pref: BatchCheckoutsValidCategories
1152               choices: patron-categories
1153               class: multiple
1154     Housebound module:
1155         -
1156             - pref: HouseboundModule
1157               choices:
1158                   1: Enable
1159                   0: Disable
1160             - "the housebound module."
1161     Stock rotation module:
1162         -
1163             - pref: StockRotation
1164               choices:
1165                   1: Enable
1166                   0: Disable
1167             - "the stock rotation module."
1168     Article requests:
1169         -
1170             - pref: ArticleRequests
1171               choices:
1172                   1: Enable
1173                   0: "Don't enable"
1174             - patrons to place article requests.
1175         -
1176             - pref: ArticleRequestsLinkControl
1177               choices:
1178                   always: Always show
1179                   calc: Use algorithm to show or hide
1180             - article request links on search results.
1181         -
1182             - "For records that are record level or item level requestable, make the following fields mandatory:"
1183             - pref: ArticleRequestsMandatoryFields
1184               multiple:
1185                 title: Title
1186                 author: Author
1187                 volume: Volume
1188                 issue: Issue
1189                 date: Date
1190                 pages: Pages
1191                 chapters: Chapters
1192             -
1193         -
1194             - "For records that are only record level requestable, make the following fields mandatory:"
1195             - pref: ArticleRequestsMandatoryFieldsRecordOnly
1196               multiple:
1197                 title: Title
1198                 author: Author
1199                 volume: Volume
1200                 issue: Issue
1201                 date: Date
1202                 pages: Pages
1203                 chapters: Chapters
1204             -
1205         -
1206             - "For records that are only item level requestable, make the following fields mandatory:"
1207             - pref: ArticleRequestsMandatoryFieldsItemOnly
1208               multiple:
1209                 title: Title
1210                 author: Author
1211                 volume: Volume
1212                 issue: Issue
1213                 date: Date
1214                 pages: Pages
1215                 chapters: Chapters
1216             -
1217     Return claims:
1218         -
1219             - When marking a checkout as "claims returned",
1220             - pref: ClaimReturnedChargeFee
1221               default: ask
1222               choices:
1223                   ask: ask if a lost fee should be charged
1224                   charge: charge a lost fee
1225                   no_charge: don't charge a lost fee
1226             - .
1227         -
1228             - Use the LOST authorised value
1229             - pref: ClaimReturnedLostValue
1230             - to represent 'claims returned'.
1231         -
1232             - Warn librarians that a patron has excessive return claims if the patron has claimed the return of more than
1233             - pref: ClaimReturnedWarningThreshold
1234               class: integer
1235             - items.