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