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