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