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