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