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