4cd4483b88afb9bd797f98682d99647665c1c02a
[srvgit] / 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. Mind that any leading or trailing whitespace in a barcode gets removed before this filter.
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                   no: "Don't show clear screen button"
110                   issueslip: "Show print slip and clear screen buttons"
111                   issueqslip: "Show print quick slip and clear screen buttons"
112             - to clear the current patron from the screen on the circulation screen.
113         -
114             - pref: RecordLocalUseOnReturn
115               choices:
116                   1: Record
117                   0: "Don't record"
118             - local use when an unissued item is checked in.
119         -
120             - When an empty barcode field is submitted in circulation
121             - pref: CircAutoPrintQuickSlip
122               choices:
123                   clear: "clear the screen"
124                   qslip: "open a print quick slip window"
125                   slip: "open a print slip window"
126             - .
127         -
128             - Include the stylesheet at
129             - pref: NoticeCSS
130               class: url
131             - on notices. (This should be a complete URL, starting with <code>http://</code>)
132         -
133             - pref: UpdateTotalIssuesOnCirc
134               choices:
135                   1: Do
136                   0: "Don't"
137             - 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).
138         -
139             - pref: ExportCircHistory
140               choices:
141                   1: Show
142                   0: "Don't show"
143             - the export patron checkout history options.
144         -
145             - "The following fields should be excluded from the patron checkout history CSV or MARC (ISO 2709) export:"
146             - pref: ExportRemoveFields
147             - (separate fields with space, e.g. 100a 200b 300c).
148         -
149             - pref: AllowOfflineCirculation
150               choices:
151                   1: Enable
152                   0: "Don't enable"
153             - "offline circulation on regular circulation computers. (<strong>NOTE:</strong> This system preference does not affect the Firefox add-on or the desktop application)."
154         -
155             - pref: ShowAllCheckins
156               choices:
157                   1: Show
158                   0: "Don't show"
159             - all items in the "Checked-in items" list, even items that were not checked out.
160         -
161             - pref: AllowCheckoutNotes
162               choices:
163                   1: Allow
164                   0: "Don't allow"
165             - patrons to submit notes about checked out items.
166         -
167             - pref: UseCirculationDesks
168               choices:
169                   1: "Use"
170                   0: "Don't use"
171             - circulation desks with circulation.
172
173     Checkout policy:
174         -
175             - pref: OnSiteCheckoutAutoCheck
176               choices:
177                   1: Enable
178                   0: Don't enable
179             - on-site checkout by default if last checkout was an on-site one.
180         -
181             - pref: AutoReturnCheckedOutItems
182               choices:
183                   1: Don't
184                   0: Do
185             - require librarians to manually confirm a checkout where the item is already checked out to another patron.
186         -
187             - pref: AllowSetAutomaticRenewal
188               choices:
189                   1: Allow
190                   0: "Don't allow"
191             - staff to flag items for autorenewal on the checkout page.
192         -
193             - pref: AllowTooManyOverride
194               choices:
195                   1: Allow
196                   0: "Don't allow"
197             - staff to override and check out items when the patron has reached the maximum number of allowed checkouts.
198         -
199             - pref: AllowNotForLoanOverride
200               choices:
201                   1: Allow
202                   0: "Don't allow"
203             - staff to override and check out items that are marked as not for loan.
204         -
205             - pref: AllowRenewalLimitOverride
206               choices:
207                   1: Allow
208                   0: "Don't allow"
209             - 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.
210         -
211             - pref: AllowRenewalOnHoldOverride
212               choices:
213                   1: Allow
214                   0: "Don't allow"
215             - staff to renew items that are on hold by manually specifying a due date.
216         -
217             - pref: AllowItemsOnHoldCheckoutSIP
218               choices:
219                   1: Allow
220                   0: "Don't allow"
221             - checkouts of items reserved to someone else via SIP checkout messages.
222             - If allowed do not generate RESERVED warning.
223             - 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".
224         -
225             - pref: AllowItemsOnHoldCheckoutSCO
226               choices:
227                   1: Allow
228                   0: "Don't allow"
229             - 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.
230         -
231             - pref: AllFinesNeedOverride
232               choices:
233                   1: Require
234                   0: "Don't require"
235             - staff to manually override all fines, even fines less than set in the <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=noissuescharge">noissuescharge</a> system preference. Enabling this system preference will block all checkouts for patrons with fines both via the web-based self checkout system and via SIP.
236         -
237             - pref: AllowFineOverride
238               choices:
239                   1: Allow
240                   0: "Don't allow"
241             - 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.
242         -
243             - pref: AutomaticItemReturn
244               choices:
245                   1: Do
246                   0: "Don't"
247             - automatically transfer items to their home library when they are checked in.
248         -
249             - pref: UseBranchTransferLimits
250               choices:
251                   1: Enforce
252                   0: "Don't enforce"
253             - library transfer limits based on
254             - pref: BranchTransferLimitsType
255               choices:
256                   ccode: collection code
257                   itemtype: item type
258             - .
259         -
260             - pref: UseTransportCostMatrix
261               choices:
262                   1: Use
263                   0: "Don't use"
264             - the transport cost matrix for calculating optimal holds filling between libraries.
265         -
266             - Use the calendar and circulation rules of
267             - pref: CircControl
268               type: choice
269               choices:
270                   PickupLibrary: the library you are logged in at.
271                   PatronLibrary: the library the patron is from.
272                   ItemHomeLibrary: the library the item is from.
273         -
274             - For check in, use the circulation rules of
275             - pref: CircControlReturnsBranch
276               type: choice
277               choices:
278                   ItemHoldingLibrary: the library the item is currently held by.
279                   CheckInLibrary: the library you are logged in at.
280                   ItemHomeLibrary: the library the item is owned by.
281         -
282             - Use the checkout and fines rules of
283             - pref: HomeOrHoldingBranch
284               type: choice
285               choices:
286                   homebranch: the item's home library (homebranch).
287                   holdingbranch: the item's holding library (holdingbranch).
288         -
289             - Allow items to be checked in
290             - pref: AllowReturnToBranch
291               type: choice
292               choices:
293                   anywhere: at any library.
294                   homebranch: only at the library the item is from.
295                   holdingbranch: only at the library the item was checked out from.
296                   homeorholdingbranch: either at the library the item is from or the library it was checked out from.
297         -
298             - For search results in the staff interface, display
299             - pref: StaffSearchResultsDisplayBranch
300               type: choice
301               choices:
302                   homebranch: the library the item is from.
303                   holdingbranch: the library the item is held by.
304         -
305             - pref: useDaysMode
306               choices:
307                   Days: Ignore the calendar
308                   Calendar: Use the calendar to skip days the library is closed
309                   Datedue: Use the calendar to push the due date to the next open day
310                   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
311             - when calculating the date due.
312         -
313             - Calculate "No renewal before" based on
314             - pref: NoRenewalBeforePrecision
315               choices:
316                   date: date.
317                   exact_time: exact time.
318             - Only relevant for loans calculated in days, hourly loans are not affected.
319         -
320             - When renewing checkouts, base the new due date on
321             - pref: RenewalPeriodBase
322               choices:
323                   date_due: the old due date of the checkout.
324                   now: the current date.
325         -
326             - pref: RenewalSendNotice
327               choices:
328                   1: Send
329                   0: "Don't send"
330             - "a renewal notice according to patron's messaging preferences for 'Item checkout'."
331         -
332             - pref: UnseenRenewals
333               choices:
334                   1: Allow
335                   0: "Don't allow"
336             - renewals to be recorded as "unseen" by the library, and count against the patrons unseen renewals limit.
337         -
338             - Prevent patrons from making holds on the OPAC if they owe more than
339             - pref: maxoutstanding
340               class: currency
341             - '[% local_currency %] in fines.'
342         -
343             - Show a warning on the "Transfers to receive" screen if the transfer has not been received
344             - pref: TransfersMaxDaysWarning
345               class: integer
346             - days after it was sent.
347         -
348             - pref: IssuingInProcess
349               choices:
350                   1: "Don't prevent"
351                   0: "Prevent"
352             - patrons from checking out an item whose rental charge would take them over the limit.
353         -
354             - "Restrict patrons with the following target audience values from checking out inappropriate materials:"
355             - pref: AgeRestrictionMarker
356             - ". 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."
357         -
358             - pref: AgeRestrictionOverride
359               choices:
360                   1: Allow
361                   0: "Don't allow"
362             - staff to check out an item with age restriction.
363         -
364             - Prevent patrons from checking out items if they have more than
365             - pref: noissuescharge
366               class: integer
367             - '[% local_currency %] in fines.'
368         -
369             - Prevent a patron from checking out if the patron has guarantees owing in total more than
370             - pref: NoIssuesChargeGuarantees
371               class: integer
372             - '[% local_currency %] in fines.'
373         -
374             - Prevent a patron from checking out if the patron has guarantors and those guarantor's guarantees owing in total more than
375             - pref: NoIssuesChargeGuarantorsWithGuarantees
376               class: integer
377             - '[% local_currency %] in fines.'
378         -
379             - pref: RentalsInNoissuesCharge
380               choices:
381                   1: Include
382                   0: "Don't include"
383             - 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.
384         -
385             - pref: ManInvInNoissuesCharge
386               choices:
387                   1: Include
388                   0: "Don't include"
389             - 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.
390         -
391             - pref: HoldsInNoissuesCharge
392               choices:
393                   1: Include
394                   0: "Don't include"
395             - 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.
396         -
397             - pref: ReturnBeforeExpiry
398               choices:
399                   1: Require
400                   0: "Don't require"
401             - "patrons to return items before their accounts expire (by restricting due dates to before the patron's expiration date)."
402         -
403             - "Send all notices as a BCC to this email address:"
404             - pref: NoticeBcc
405               class: email
406         -
407             - pref: OverdueNoticeCalendar
408               choices:
409                   1: "Use calendar"
410                   0: "Ignore calendar"
411             - "when working out the period for overdue notices."
412         -
413             - "Organize and send overdue notices using the"
414             - pref: OverdueNoticeFrom
415               choices:
416                   cron: "command-line option"
417                   item-issuebranch: "checkout library"
418                   item-homebranch: "item home library"
419             - .
420         -
421             - Include up to
422             - pref: PrintNoticesMaxLines
423               class: integer
424             - "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."
425         -
426             - pref: OverduesBlockCirc
427               choices:
428                   block: Block
429                   noblock: "Don't block"
430                   confirmation: Ask for confirmation
431             - "when checking out to a patron that has overdues outstanding."
432         -
433             - "When checking out an item with rental fees, "
434             - pref: RentalFeesCheckoutConfirmation
435               choices:
436                   1: ask
437                   0: "don't ask"
438             - "for confirmation."
439         -
440             - By default, set the LOST value of an item to
441             - pref: DefaultLongOverdueLostValue
442               class: integer
443             - when the item has been overdue for more than
444             - pref: DefaultLongOverdueDays
445               class: integer
446             - days.
447             - <br>WARNING â€” These preferences will activate the automatic item loss process. Leave these fields empty if you don't want to activate this feature.
448             - "<br>Example: [1] [30] Sets an item to the LOST value 1 when it has been overdue for more than 30 days."
449             - <br>(Used when the longoverdue.pl script is called without the --lost parameter)
450             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/longoverdue.pl</code> cronjob. Ask your system administrator to schedule it."
451         -
452             - "Charge a lost item to the patron's account when the LOST value of the item changes to:"
453             - pref: DefaultLongOverdueChargeValue
454               class: integer
455             - <br>Leave this field empty if you don't want to charge the patron for lost items.
456             - <br>(Used when the longoverdue.pl script is called without the --charge parameter)
457             - "<br><strong>NOTE:</strong> This system preference requires the <code>misc/cronjobs/longoverdue.pl</code> cronjob. Ask your system administrator to schedule it."
458         -
459             - When using the automatic item loss process, skip items with lost values matching any of
460             - pref: DefaultLongOverdueSkipLostStatuses
461             - "."
462             - <br>Leave this field empty if you don't want to skip any lost statuses.
463             - <br>Set to a list of comma separated values, e.g. <em>5,6,7</em>.
464         -
465             - "When issuing an item that has been marked as lost, "
466             - pref: IssueLostItem
467               choices:
468                   confirm: "require confirmation"
469                   alert: "display a message"
470                   nothing : "do nothing"
471             - .
472         -
473             - "When checking out an item, "
474             - pref: RecordStaffUserOnCheckout
475               choices:
476                   1: "record"
477                   0: "don't record"
478             - "the user who checked out the item."
479         -
480             - "Mark items as returned when flagged as lost "
481             - pref: MarkLostItemsAsReturned
482               multiple:
483                 cronjob: "from the longoverdue cronjob"
484                 batchmod: "from the batch item modification tool"
485                 additem: "when cataloguing an item"
486                 moredetail: "from the items tab of the catalog module"
487                 pendingreserves: "from the 'Holds to pull' list"
488                 onpayment: "when receiving payment for the item"
489                 claim_returned: "when marking an item as a return claim"
490             - .
491         -
492             - pref: AllowMultipleIssuesOnABiblio
493               choices:
494                   1: Allow
495                   0: "Don't allow"
496             - "patrons to check out multiple items from the same record. (<strong>NOTE:</strong> This will only affect records without a subscription attached.)"
497         -
498             - pref: OnSiteCheckouts
499               choices:
500                   1: Enable
501                   0: Disable
502             - the on-site checkouts feature.
503         -
504             - pref: OnSiteCheckoutsForce
505               choices:
506                   1: Enable
507                   0: Disable
508             - the on-site checkout for all cases (even if a patron is debarred, etc.).
509         -
510             - pref: ConsiderOnSiteCheckoutsAsNormalCheckouts
511               choices:
512                   1: Consider
513                   0: "Don't consider"
514             - on-site checkouts as normal checkouts.
515             - 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.
516             - If disabled, both values will be checked separately.
517         -
518             - pref: SwitchOnSiteCheckouts
519               choices:
520                   1: Switch
521                   0: "Don't switch"
522             - on-site checkouts to normal checkouts when checked out.
523         -
524             - When a patron's checked out item is overdue,
525             - pref: OverduesBlockRenewing
526               type: choice
527               choices:
528                   allow: allow renewing.
529                   blockitem: block renewing only for this item.
530                   block: block renewing for all the patron's items.
531         -
532             - If a patron owes more than the value of <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACFineNoRenewals">OPACFineNoRenewals</a>,
533             - pref: OPACFineNoRenewalsBlockAutoRenew
534               choices:
535                   1: block
536                   0: allow
537             - their auto-renewals.
538         -
539             - If a patron pays off all fines on an overdue item that is accruing fines,
540             - pref: RenewAccruingItemWhenPaid
541               choices:
542                   1: renew
543                   0: "don't renew"
544             - 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.
545         -
546             - If a patron pays off all fines on an overdue item that is accruing fines in the OPAC via a payment plugin,
547             - pref: RenewAccruingItemInOpac
548               choices:
549                   1: renew
550                   0: "don't renew"
551             - 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.
552         -
553             - pref: ItemsDeniedRenewal
554               type: textarea
555               syntax: text/x-yaml
556               class: code
557             - Define custom rules to deny specific items from renewal.
558             - "<br />Can name any field in the items table followed by a colon then a space then"
559             - "a bracketed list of values separated by commas."
560             - "For example:"
561             - "<br />ccode: [NEWFIC,NULL,DVD]"
562             - "<br />itype: [NEWBK,\"\"]"
563             - "<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."
564     Checkin policy:
565         -
566             - pref: TrapHoldsOnOrder
567               choices:
568                   1: Trap
569                   0: "Don't trap"
570             - items that are not for loan but holdable ( notforloan < 0 ) to fill holds.
571         -
572             - Never trap items with 'not for loan' values of
573             - pref: SkipHoldTrapOnNotForLoanValue
574               class: integer
575             - to fill holds.
576             - "(list of not for loan values separated with a pipe '|')"
577         -
578             - pref: HoldsAutoFill
579               choices:
580                   1: Do
581                   0: "Don't"
582             - automatically fill holds instead of asking the librarian.
583         -
584             - pref: HoldsNeedProcessingSIP
585               choices:
586                   1: "Don't fulfill"
587                   0: Fulfill
588             - holds automatically if matching item is returned via SIP protocol.
589         -
590             - pref: HoldsAutoFillPrintSlip
591               choices:
592                   1: Do
593                   0: "Don't"
594             - automatically display the hold slip dialog for auto-filled holds.
595         -
596             - pref: BlockReturnOfWithdrawnItems
597               choices:
598                   1: Block
599                   0: "Don't block"
600             - returning of items that have been withdrawn.
601         -
602             - pref: BlockReturnOfLostItems
603               choices:
604                   1: Block
605                   0: "Don't block"
606             - returning of items that have been lost.
607         -
608             - pref: CalculateFinesOnReturn
609               choices:
610                   1: Do
611                   0: "Don't"
612             - calculate and update overdue charges when an item is returned.
613             - "<br /><strong>NOTE:</strong> If you are doing hourly loans then you should have this on."
614             - '<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."'
615         -
616             - pref: CalculateFinesOnBackdate
617               choices:
618                   1: Do
619                   0: "Don't"
620             - calculate and update overdue charges when an item is returned with a backdated return date.
621         -
622             - pref: UpdateItemLocationOnCheckin
623               type: textarea
624               syntax: text/x-yaml
625               class: code
626             - "This is a list of value pairs. The first value is followed immediately by colon space then the second value.<br/><br/>"
627             - "Examples:<br/>"
628             - "PROC: FIC - causes an item in the Processing Center location to be updated into the Fiction location on check in.<br/>"
629             - "FIC: GEN - causes an item in the Fiction location to be updated into the General stacks location on check in.<br/>"
630             - "_BLANK_: FIC - causes an item that has no location to be updated into the Fiction location on check in.<br/>"
631             - "FIC: _BLANK_ - causes an item in location FIC to be updated to a blank location on check in.<br/>"
632             - "_ALL_: FIC - causes all items to be updated into the Fiction location on check in.<br/>"
633             - "PROC: _PERM_ - causes an item that is in the Processing Center to be updated to it's permanent location.<br/><br/>"
634             - "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/>"
635             - "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/>"
636             - "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/>"
637             - "The special term _ALL_ is used on the left side of the colon (:) to affect all items, <strong>and overrides all other rules.</strong>"
638         -
639             - pref: UpdateNotForLoanStatusOnCheckin
640               type: textarea
641               syntax: text/x-yaml
642               class: code
643             - 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
644             - "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."
645             - Each pair of values should be on a separate line.
646         -
647             - pref: HidePersonalPatronDetailOnCirculation
648               choices:
649                   1: "Hide"
650                   0: "Don't hide"
651             - "a patron's phone number, email address, street address and city on the circulation page."
652         -
653             - pref: TransfersBlockCirc
654               choices:
655                   1: "Block"
656                   0: "Don't block"
657             - staff from continuing to checkin items when a transfer is triggered.
658         -
659             - pref: StoreLastBorrower
660               default: 0
661               choices:
662                   1: Store
663                   0: "Don't store"
664             - '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.'
665     Holds policy:
666         -
667             - pref: EnableItemGroups
668               choices:
669                   yes: Enable
670                   no: "Don't enable"
671             - the item groups feature to allow collecting groups of items on a record together.
672         -
673             - In the staff client, split the holds queue into separate tables by
674             - pref: HoldsSplitQueue
675               choices:
676                   nothing: nothing
677                   branch: "pickup library"
678                   itemtype: "hold item type"
679                   branch_itemtype: "pickup library and item type"
680             - "."
681         -
682             - If the holds queue is split, show librarians
683             - pref: HoldsSplitQueueNumbering
684               choices:
685                   actual: "the actual priority, which may be out of order"
686                   virtual: "'virtual' priorities, where each group is numbered separately"
687             - "."
688         -
689             - pref: RealTimeHoldsQueue
690               choices:
691                   1: Enable
692                   0: Disable
693             - updating the holds queue in real time.
694         -
695             - pref: AllowHoldItemTypeSelection
696               choices:
697                   1: Allow
698                   0: "Don't allow"
699             - hold fulfillment to be limited by item type.
700         -
701             - pref: AllowRenewalIfOtherItemsAvailable
702               choices:
703                   1: Allow
704                   0: "Don't allow"
705             - a patron to renew an item with unfilled holds if other available items can fill that hold.
706         -
707             - pref: AllowHoldPolicyOverride
708               choices:
709                   1: Allow
710                   0: "Don't allow"
711             - staff to override hold policies when placing holds.
712         -
713             - pref: AllowHoldsOnDamagedItems
714               choices:
715                   1: Allow
716                   0: "Don't allow"
717             - hold requests to be placed on and filled by damaged items.
718         -
719             - pref: AllowHoldDateInFuture
720               choices:
721                   1: Allow
722                   0: "Don't allow"
723             - hold requests to be placed that do not enter the waiting list until a certain future date.
724         -
725             - pref: OPACAllowHoldDateInFuture
726               choices:
727                   1: Allow
728                   0: "Don't allow"
729             - 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).
730         -
731             - When placing a hold from the OPAC, make
732             - pref: OPACMandatoryHoldDates
733               choices:
734                   "": "no hold dates"
735                   "start": "hold start date"
736                   "end": "hold end date"
737                   "both": "both hold dates"
738             - mandatory.
739             - '<br><strong>NOTE:</strong> The hold start date option is only effective and shown on the hold form when <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=AllowHoldDateInFuture">AllowHoldDateInFuture</a> and <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACAllowHoldDateInFuture">OPACAllowHoldDateInFuture</a> are enabled.'
740         -
741             - Confirm future hold requests (starting no later than
742             - pref: ConfirmFutureHolds
743               class: integer
744             - 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.
745         -
746             - Check the rule from the
747             - pref: ReservesControlBranch
748               choices:
749                   ItemHomeLibrary: "item's home library"
750                   PatronLibrary: "patron's home library"
751             - to see if the patron can place a hold on the item.    
752         -
753             - Mark a hold as problematic if it has been waiting for more than
754             - pref: ReservesMaxPickUpDelay
755               class: integer
756             - days.
757         -
758             - pref: ExpireReservesMaxPickUpDelay
759               choices:
760                   1: Allow
761                   0: "Don't allow"
762             - '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>'
763             - pref: ExpireReservesAutoFill
764               choices:
765                   1: "Do"
766                   0: "Don't"
767             - automatically fill the next hold using the item.
768             - Send email notification of the new hold filled with a canceled item to
769             - pref: ExpireReservesAutoFillEmail
770               class: email
771             - . If no address is defined here, the email will be sent to the library's reply-to address.
772             - '<br><strong>NOTE:</strong> These system preferences require the <code>misc/cronjobs/holds/cancel_expired_holds.pl</code> cronjob. Ask your system administrator to schedule it.<br>'
773         -
774             - 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
775             - pref: ExpireReservesMaxPickUpDelayCharge
776               class: currency
777             - "."
778         -
779             - Satisfy holds using items from the libraries
780             - pref: StaticHoldsQueueWeight
781               class: multi
782             - (as branchcodes, separated by commas; if empty, uses all libraries)
783             - when they are
784             - pref: HoldsQueueSkipClosed
785               choices:
786                   1: open
787                   0: open or closed
788             - pref: RandomizeHoldsQueueWeight
789               choices:
790                   1: in random order.
791                   0: in that order.
792             - "<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."
793             -
794         -
795             - pref: canreservefromotherbranches
796               choices:
797                   1: Allow
798                   0: "Don't allow (with independentbranches)"
799             - a user from one library to place a hold on an item from another library
800         -
801             - pref: OPACAllowUserToChooseBranch
802               choices:
803                   1: Allow
804                   0: "Don't allow"
805             - a user to choose the library to pick up a hold from.
806         -
807             - 'Allow users to change the library to pick up a hold for these statuses:'
808             - pref: OPACAllowUserToChangeBranch
809               multiple:
810                 pending: Pending
811                 intransit: In transit
812                 suspended: Suspended
813         -
814             - pref: ReservesNeedReturns
815               choices:
816                   1: "Don't automatically"
817                   0: Automatically
818             - mark a hold as found and waiting when a hold is placed on a specific item and that item is already checked in.
819         -
820             - Patrons can have a maximum of
821             - pref: maxreserves
822               class: integer
823             - holds at once (leave blank or set to 0 to disable). Additional limits may apply based on circulation rules.
824         -
825             - pref: emailLibrarianWhenHoldIsPlaced
826               choices:
827                   1: Enable
828                   0:  "Don't enable"
829             - "sending an email to the Koha administrator email address whenever a hold request is placed."
830         -
831             - pref: DisplayMultiPlaceHold
832               choices:
833                   1: Enable
834                   0:  "Don't enable"
835             - "the ability to place holds on multiple bibliographic records from the search results"
836         -
837             - pref: TransferWhenCancelAllWaitingHolds
838               choices:
839                   1: Transfer
840                   0: "Don't transfer"
841             - items when cancelling all waiting holds.
842         -
843             - pref: AutoResumeSuspendedHolds
844               choices:
845                   1: Allow
846                   0: "Don't allow"
847             - "suspended holds to be automatically resumed by a set date."
848             - "<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."
849         -
850             - pref: SuspendHoldsIntranet
851               choices:
852                   1: Allow
853                   0: "Don't allow"
854             - holds to be suspended from the staff interface.
855         -
856             - pref: SuspendHoldsOpac
857               choices:
858                   1: Allow
859                   0: "Don't allow"
860             - holds to be suspended from the OPAC.
861         -
862             - If using <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=ExpireReservesMaxPickUpDelay">ExpireReservesMaxPickUpDelay</a>,
863             - pref: ExpireReservesOnHolidays
864               choices:
865                   1: allow
866                   0: "don't allow"
867             - expired holds to be canceled on days the library is closed per the calendar.
868         -
869             - pref: ExcludeHolidaysFromMaxPickUpDelay
870               choices:
871                   1: Use the calendar
872                   0: Ignore the calendar
873             - when calculating the period for a hold's max pickup delay.
874         -
875             - pref: decreaseLoanHighHolds
876               choices:
877                   1: Enable
878                   0:  "Don't enable"
879             - the reduction of loan period to
880             - pref: decreaseLoanHighHoldsDuration
881               class: integer
882             - days for high demand items with more than
883             - pref: decreaseLoanHighHoldsValue
884               class: integer
885             - holds
886             - pref: decreaseLoanHighHoldsControl
887               choices:
888                   static: "on the record"
889                   dynamic: "over the number of holdable items on the record"
890             - ". Ignore items with the following statuses when counting items:"
891             - pref: decreaseLoanHighHoldsIgnoreStatuses
892               multiple:
893                 damaged: Damaged
894                 itemlost: Lost
895                 withdrawn: Withdrawn
896                 notforloan: Not for loan
897             - "Note: The reduced loan period can also be set up in the circulation conditions and will then overwrite the setting here."
898         -
899             - pref: AllowHoldsOnPatronsPossessions
900               choices:
901                   1: Allow
902                   0: "Don't allow"
903             - a patron to place a hold on a record where the patron already has one or more items attached to that record checked out.
904         -
905             - pref: LocalHoldsPriority
906               choices:
907                   1: Give
908                   0: "Don't give"
909             - priority for filling holds to patrons whose
910             - pref: LocalHoldsPriorityPatronControl
911               choices:
912                   PickupLibrary: "pickup library"
913                   HomeLibrary: "home library"
914             - matches the item's
915             - pref: LocalHoldsPriorityItemControl
916               choices:
917                   homebranch: "home library"
918                   holdingbranch: "holding library"
919         -
920             - pref: OPACHoldsIfAvailableAtPickup
921               choices:
922                   1: Allow
923                   0: "Don't allow"
924             - to pickup holds at libraries where the item is available.
925         -
926             - 'Patron categories not affected by <a href="/cgi-bin/koha/admin/preferences.pl?op=search&searchfield=OPACHoldsIfAvailableAtPickup">OPACHoldsIfAvailableAtPickup</a>:'
927             - pref: OPACHoldsIfAvailableAtPickupExceptions
928               choices: patron-categories
929               class: multiple
930         -
931             - pref: CanMarkHoldsToPullAsLost
932               choices:
933                   do_not_allow: "Do not allow to mark items as lost"
934                   allow: "Allow to mark items as lost"
935                   allow_and_notify: "Allow to mark items as lost and notify the patron"
936             - 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>.
937         -
938             - A list of values to update an item's values with when it is marked as lost from the 'Holds to pull' page.
939             - '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>)'
940             - pref: UpdateItemWhenLostFromHoldList
941               type: textarea
942               syntax: text/x-yaml
943         -
944             - pref: DefaultHoldExpirationdate
945               default: 0
946               choices:
947                   1: Set
948                   0: Don't set
949             - default expiration date for holds automatically.
950             - If enabled, set expiration date
951             - pref: DefaultHoldExpirationdatePeriod
952               default: 0
953               class: integer
954             - pref: DefaultHoldExpirationdateUnitOfTime
955               default: days
956               choices:
957                   days: days
958                   months: months
959                   years: years
960             - from reserve date.
961         -
962             - When placing a hold via the staff interface default the pickup location to the
963             - pref: DefaultHoldPickupLocation
964               default: loggedinlibrary
965               choices:
966                   loggedinlibrary: "logged in library"
967                   homebranch: "item's home library"
968                   holdingbranch: "item's holding library"
969             - "."
970     Patron restrictions:
971         -
972             - pref: PatronRestrictionTypes
973               choices:
974                   1: Allow
975                   0: Don't allow
976             - "the type of patron restriction to be specified when applying manually."
977         -
978             - pref: CumulativeRestrictionPeriods
979               choices:
980                   1: Cumulate
981                   0: "Don't cumulate"
982             - the restriction periods.
983         -
984             - pref: AutoRemoveOverduesRestrictions
985               choices:
986                   1: "Do"
987                   0: "Don't"
988             - allow OVERDUES restrictions triggered by sent notices to be cleared automatically when all overdue items are returned by a patron.
989         -
990             - If a patron is restricted,
991             - pref: RestrictionBlockRenewing
992               choices:
993                   1: block
994                   0: allow
995             - renewing of items from the staff interface and via the <code>misc/cronjobs/automatic_renewals.pl</code> cronjob.
996     Interlibrary loans:
997         -
998             - pref: ILLModule
999               default: 0
1000               choices:
1001                   1: Enable
1002                   0: Disable
1003             - the interlibrary loans module (master switch).
1004         -
1005             - "Adding text will enable the copyright clearance stage in request creation. The text you enter will be the text displayed."
1006             - pref: ILLModuleCopyrightClearance
1007               type: textarea
1008               class: long
1009         -
1010             - "Enabled ILL backends for OPAC initiated requests:"
1011             - pref: ILLOpacbackends
1012               class: multi
1013             - (separated with |). If left empty, all installed backends will be enabled.
1014         -
1015             - pref: ILLModuleUnmediated
1016               default: 0
1017               choices:
1018                   1: Enable
1019                   0: Disable
1020             - unmediated interlibrary loan requests. If enabled and the ILL backend supports it, the newly created requests are immediately requested by backend.
1021         -
1022             - pref: CirculateILL
1023               default: 0
1024               choices:
1025                   1: Enable
1026                   0: Disable
1027             - the circulation of ILL requested items.
1028         -
1029             - pref: ILLCheckAvailability
1030               default: 0
1031               choices:
1032                   1: Check
1033                   0: "Don't check"
1034             - external sources for availability during the request process.
1035         -
1036             - "ILL statuses that are considered finished and should not be displayed in the ILL module: "
1037             - pref: ILLHiddenRequestStatuses
1038               class: multi
1039             - (separated with |). If left empty, all ILL requests will be displayed. The request codes can be found in the ILLSTATUS authorized value category.
1040         -
1041             - "Send these ILL notices to staff when appropriate:"
1042             - pref: ILLSendStaffNotices
1043               class: multi
1044             - "(separated with |). e.g. ILL_REQUEST_CANCEL|ILL_REQUEST_MODIFIED If left empty, no staff ILL notices will be sent."
1045         -
1046             - "Fallback email address for staff ILL notices to be sent to in the absence of a library address:"
1047             - pref: ILLDefaultStaffEmail
1048               class: email
1049     Fines Policy:
1050         -
1051             - pref: finesCalendar
1052               type: choice
1053               choices:
1054                   ignoreCalendar: Ignore the calendar
1055                   noFinesWhenClosed: Use the calendar
1056             - when calculating the period for fines.
1057         -
1058             - pref: SuspensionsCalendar
1059               type: choice
1060               choices:
1061                   ignoreCalendar: Ignore the calendar
1062                   noSuspensionsWhenClosed: Use the calendar
1063             - when calculating the period for suspension expiration.
1064         -
1065             - pref: finesMode
1066               type: choice
1067               choices:
1068                   off: "Don't calculate"
1069                   production: Calculate and charge
1070             - fines (when <code>cronjobs/fines.pl</code> is being run).
1071             - '<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/>'
1072             - pref: ChargeFinesOnClosedDays
1073               type: choice
1074               choices:
1075                   0: "Don't charge"
1076                   1: Charge
1077             - on close days. If set the fines.pl cronjob will not generate fines when run on days marked as closed in the calendar.
1078         -
1079             - If a lost item is returned, apply the refunding rules defined for the
1080             - pref: RefundLostOnReturnControl
1081               choices:
1082                   CheckinLibrary: "check-in library."
1083                   ItemHomeBranch: "item's home library."
1084                   ItemHoldingBranch: "item's holding library."
1085         -
1086             - pref: FinesIncludeGracePeriod
1087               choices:
1088                   1: Include
1089                   0: "Don't include"
1090             - the grace period when calculating the fine for an overdue item.
1091         -
1092             - pref: WhenLostForgiveFine
1093               choices:
1094                   1: Forgive
1095                   0: "Don't forgive"
1096             - the fines on an item when it is marked as lost.
1097         -
1098             - "Don't refund lost fees if a lost item is checked in more than"
1099             - pref: NoRefundOnLostReturnedItemsAge
1100               class: integer
1101             - days after it was marked lost.
1102         -
1103             - pref: WhenLostChargeReplacementFee
1104               choices:
1105                   1: Charge
1106                   0: "Don't charge"
1107             - the replacement price when a patron loses an item.
1108         -
1109             - Charge a hold fee
1110             - pref: HoldFeeMode
1111               choices:
1112                   any_time_is_placed: "any time a hold is placed."
1113                   not_always: "only if all items are checked out and the record has at least one hold already."
1114                   any_time_is_collected: "any time a hold is collected."
1115         -
1116             - pref: useDefaultReplacementCost
1117               choices:
1118                   1: Use
1119                   0: "Don't use"
1120             - the default replacement cost defined for the item type.
1121         -
1122             - "Text to be recorded in the column 'note', table 'accountlines' when the processing fee (defined for the item type) is applied:"
1123             - pref: ProcessingFeeNote
1124               type: textarea
1125               class: code
1126     Self check-in module:
1127         -
1128             - "Include the following HTML on the self check-in screen:"
1129             - pref: SelfCheckInMainUserBlock
1130               type: textarea
1131               syntax: text/html
1132               class: code
1133         -
1134             - pref: SelfCheckInModule
1135               choices:
1136                   1: Enable
1137                   0: "Don't enable"
1138             - "the standalone self check-in module (available at: /cgi-bin/koha/sci/sci-main.pl)."
1139         -
1140             - "Reset the current self check-in screen after"
1141             - pref: SelfCheckInTimeout
1142               class: integer
1143             - seconds.
1144         -
1145             - "Include the following CSS on all the self check-in screens:"
1146             - pref: SelfCheckInUserCSS
1147               type: textarea
1148               syntax: css
1149               class: code
1150         -
1151             - "Include the following JavaScript on all the self check-in screens:"
1152             - pref: SelfCheckInUserJS
1153               type: textarea
1154               syntax: javascript
1155               class: code
1156     Self check-out module:
1157         -
1158             - "Include the following JavaScript on all pages in the web-based self checkout:"
1159             - pref: SCOUserJS
1160               type: textarea
1161               syntax: javascript
1162               class: code
1163         -
1164             - "Include the following HTML on the the web-based self checkout screen:"
1165             - pref: SCOMainUserBlock
1166               type: textarea
1167               syntax: text/html
1168               class: code
1169         -
1170             - "Include the following CSS on all pages in the web-based self checkout:"
1171             - pref: SCOUserCSS
1172               type: textarea
1173               syntax: css
1174               class: code
1175         -
1176             - pref: ShowPatronImageInWebBasedSelfCheck
1177               choices:
1178                   1: Show
1179                   0: "Don't show"
1180             - "the patron's picture (if one has been added) when they use the web-based self checkout."
1181         -
1182             - pref: WebBasedSelfCheck
1183               choices:
1184                   1: Enable
1185                   0: "Don't enable"
1186             - "the web-based self checkout system (available at: /cgi-bin/koha/sco/sco-main.pl)."
1187         -
1188             - Have patrons log into the web-based self checkout system with their
1189             - pref: SelfCheckoutByLogin
1190               choices:
1191                   1: username and password
1192                   0: cardnumber
1193             - ".</br>NOTE: If using 'cardnumber' and AutoSelfCheckAllowed you should set SelfCheckAllowByIPRanges to prevent brute force attacks to gain patron information outside the library."
1194         -
1195             - "Time out the current patron's web-based self checkout system login after"
1196             - pref: SelfCheckTimeout
1197               class: integer
1198             - seconds.
1199         -
1200             - pref: SCOAllowCheckin
1201               choices:
1202                   1: Allow
1203                   0: "Don't allow"
1204             - patrons to return items through web-based self checkout system. 
1205         -
1206             - "Include the following HTML in the Help page of the web-based self checkout system:"
1207             - pref: SelfCheckHelpMessage
1208               type: textarea
1209               syntax: text/html
1210               class: code
1211         -
1212             - pref: AutoSelfCheckAllowed
1213               choices:
1214                   1: Allow
1215                   0: "Don't allow"
1216             - "the web-based self checkout system to automatically log in with this staff login"
1217             - pref: AutoSelfCheckID
1218             - and this password
1219             - pref: AutoSelfCheckPass
1220               class: password
1221             - .
1222             - "Note: Any patron entered here will be unable to log into the OPAC."
1223         -
1224             - pref: SelfCheckReceiptPrompt
1225               choices:
1226                   1: Show
1227                   0: "Don't show"
1228             - "the print receipt popup dialog when self checkout is finished."
1229         -
1230             - "Allow access to the self check from the following IP addresses:"
1231             - pref: SelfCheckAllowByIPRanges
1232               class: short
1233             - (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>.)
1234     Course reserves:
1235         -
1236             - pref: UseCourseReserves
1237               choices:
1238                   1: Use
1239                   0: "Don't use"
1240             - "course reserves."
1241     Batch checkout:
1242         -
1243             - pref: BatchCheckouts
1244               choices:
1245                   1: Allow
1246                   0: "Don't allow"
1247             - "batch checkouts."
1248         -
1249             - "Patron categories allowed to checkout in a batch:"
1250             - pref: BatchCheckoutsValidCategories
1251               choices: patron-categories
1252               class: multiple
1253     Housebound module:
1254         -
1255             - pref: HouseboundModule
1256               choices:
1257                   1: Enable
1258                   0: Disable
1259             - "the housebound module."
1260     Stock rotation module:
1261         -
1262             - pref: StockRotation
1263               choices:
1264                   1: Enable
1265                   0: Disable
1266             - "the stock rotation module."
1267     Article requests:
1268         -
1269             - pref: ArticleRequests
1270               choices:
1271                   1: Enable
1272                   0: "Don't enable"
1273             - patrons to place article requests.
1274         -
1275             - pref: ArticleRequestsOpacHostRedirection
1276               choices:
1277                   yes: Enable
1278                   no: Disable
1279             - " redirection from child to host based on MARC21 773$w when the child has no items when requesting articles on the Opac."
1280         -
1281             - pref: ArticleRequestsLinkControl
1282               choices:
1283                   always: Always show
1284                   calc: Use algorithm to show or hide
1285             - article request links on search results.
1286         -
1287             - "For records that are record level or item level requestable, make the following fields mandatory:"
1288             - pref: ArticleRequestsMandatoryFields
1289               multiple:
1290                 title: Title
1291                 author: Author
1292                 volume: Volume
1293                 issue: Issue
1294                 date: Date
1295                 pages: Pages
1296                 chapters: Chapters
1297             -
1298         -
1299             - "For records that are only record level requestable, make the following fields mandatory:"
1300             - pref: ArticleRequestsMandatoryFieldsRecordOnly
1301               multiple:
1302                 title: Title
1303                 author: Author
1304                 volume: Volume
1305                 issue: Issue
1306                 date: Date
1307                 pages: Pages
1308                 chapters: Chapters
1309             -
1310         -
1311             - "For records that are only item level requestable, make the following fields mandatory:"
1312             - pref: ArticleRequestsMandatoryFieldsItemOnly
1313               multiple:
1314                 title: Title
1315                 author: Author
1316                 volume: Volume
1317                 issue: Issue
1318                 date: Date
1319                 pages: Pages
1320                 chapters: Chapters
1321             -
1322         -
1323             - "The following article request formats are supported:"
1324             - pref: ArticleRequestsSupportedFormats
1325             - "(Valid choices are currently: PHOTOCOPY and SCAN. Separate the supported formats by a vertical bar. The first listed format is selected by default when you request via the OPAC.)"
1326
1327
1328     Item bundles:
1329         -
1330             - Use the LOST authorised value
1331             - pref: BundleLostValue
1332             - to represent 'missing from bundle' at return.
1333         -
1334             - Use the NOT_LOAN authorised value
1335             - pref: BundleNotLoanValue
1336             - to represent 'added to bundle' when an item is attached to bundle.
1337
1338     Return claims:
1339         -
1340             - When marking a checkout as "claims returned",
1341             - pref: ClaimReturnedChargeFee
1342               default: ask
1343               choices:
1344                   ask: ask if a lost fee should be charged
1345                   charge: charge a lost fee
1346                   no_charge: don't charge a lost fee
1347             - .
1348         -
1349             - Use the LOST authorised value
1350             - pref: ClaimReturnedLostValue
1351             - to represent 'claims returned'.
1352         -
1353             - Warn librarians that a patron has excessive return claims if the patron has claimed the return of more than
1354             - pref: ClaimReturnedWarningThreshold
1355               class: integer
1356             - items.
1357         -
1358             - Remove resolved return claims older than
1359             - pref: CleanUpDatabaseReturnClaims
1360               class: integer
1361             - days.
1362             - <span class="hint">This system preference is used by the cleanup_database.pl cronjob.</span>
1363
1364     Recalls:
1365         -
1366             - Mark a recall as problematic if it has been waiting to be picked up for
1367             - pref: RecallsMaxPickUpDelay
1368             - class: integer
1369             - days.
1370         -
1371             - pref: UseRecalls
1372               choices:
1373                   1: Use
1374                   0: "Don't use"
1375             - recalls. Make sure you configure <a href="/cgi-bin/koha/admin/smart-rules.pl">circulation and fines rules</a> for recalls once enabled.
1376
1377     SIP2:
1378         -
1379             - "Use the following mappings to determine the sort_bin of a returned item.<br/>"
1380             - "The mapping should be of the form 'branchcode:item field:comparator:item field value:sort bin number', with one mapping per line.<br/>"
1381             - "- 'branchcode' is the location where the checkin is being performed (i.e. branch assigned to SIP user)<br/>"
1382             - "- 'item field' is a database column in the items table<br/>"
1383             - "- 'comparator' is the type of comparison, possible values are: eq,<,<=,>,>=,ne<br/>"
1384             - "- 'item field value' is the value to compare against the value in the specified 'item field'<br/>"
1385             - "- 'sort bin number' is the expected return value in the CL field of the SIP response for an item matching a rule<br/><br/>"
1386             - "NOTE: Specifying 'item_field_value' with a leading '\\$' and an item field name will use the value of that field in the item for comparison:<br/>"
1387             - "i.e. \\$holdingbranch<br/></br>"
1388             - "Examples:<br/>"
1389             - "CPL:itype:eq:BOOK:1 - Will return sort bin 1 for an item of itemtype 'BOOK' returned to CPL.<br/>"
1390             - "CPL:itemcallnumber:<:339.6:3 - Will return sort bin 3 for an item with a callnumber less than 339.6 returned to CPL .<br/>"
1391             - "CPL:homebranch:ne:\\$holdingbranch:X - Will return sort bin 'X' for an item returned to CPL where the holdingbranch is not equal to the homebranch (i.e. any item belonging to a different branch than CPL).<br/><br/>"
1392             - pref: SIP2SortBinMapping
1393               type: textarea
1394               class: long
1395         -
1396             - Use
1397             - pref: UseLocationAsAQInSIP
1398               choices:
1399                   yes: permanent_location
1400                   no: homebranch
1401             - for AQ field in SIP protocol.
1402
1403     Curbside pickup module:
1404         -
1405             - pref: CurbsidePickup
1406               choices:
1407                   1: Enable
1408                   0: Disable
1409             - "the curbside pickup module."