Bug 13592: Add an option to charge for any hold placed
[koha.git] / koha-tmpl / intranet-tmpl / prog / en / modules / admin / preferences / circulation.pref
1 Circulation:
2 # FIXME: printcirculationslips is also omitted. It _technically_ could work, but C4::Print is HLT specific and needs a little bit of refactoring.
3     Interface:
4         -
5             - pref: CircAutocompl
6               choices:
7                   yes: Try
8                   no: "Don't try"
9             - to guess the patron being entered while typing a patron search on the circulation screen.
10             - Only returns the first 10 results at a time.
11         -
12             - pref: itemBarcodeInputFilter
13               choices:
14                   OFF: "Don't filter"
15                   whitespace: Remove spaces from
16                   cuecat: Convert from CueCat form
17                   T-prefix: Remove the first number from T-prefix style
18                   libsuite8: Convert from Libsuite8 form
19                   EAN13: EAN-13 or zero-padded UPC-A from
20             - scanned item barcodes.
21         -
22             - pref: itemBarcodeFallbackSearch
23               choices:
24                   yes: "Enable"
25                   no: "Don't enable"
26             - 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.
27         -
28             - Sort previous checkouts on the circulation page from
29             - pref: previousIssuesDefaultSortOrder
30               choices:
31                   asc: earliest to latest
32                   desc: latest to earliest
33             - due date.
34         -
35             - "Sort today's checkouts on the circulation page from"
36             - pref: todaysIssuesDefaultSortOrder
37               type: choice
38               choices:
39                   asc: earliest to latest
40                   desc: latest to earliest
41             - due date.
42         -
43             - pref: SpecifyDueDate
44               choices:
45                   yes: Allow
46                   no: "Don't allow"
47             - staff to specify a due date for a checkout.
48         -
49             - pref: SpecifyReturnDate
50               choices:
51                   yes: Allow
52                   no: "Don't allow"
53             - staff to specify a return date for a check in.
54         -
55             - Set the default start date for the Holds to pull list to
56             - pref: HoldsToPullStartDate
57               class: integer
58             - day(s) ago. Note that the default end date is controlled by preference ConfirmFutureHolds.
59         -
60             - pref: AllowAllMessageDeletion
61               choices:
62                   yes: Allow
63                   no: "Don't allow"
64             - staff to delete messages added from other libraries.
65         -
66             - Show the
67             - pref: numReturnedItemsToShow
68               class: integer
69             - last returned items on the checkin screen.
70         -
71             - pref: FineNotifyAtCheckin
72               choices:
73                   yes: Notify
74                   no: "Don't notify"
75             - librarians of overdue fines on the items they are checking in.
76         -
77             - pref: WaitingNotifyAtCheckin
78               choices:
79                   yes: Notify
80                   no: "Don't notify"
81             - librarians of waiting holds for the patron whose items they are checking in.
82         -
83             - pref: FilterBeforeOverdueReport
84               choices:
85                   yes: Require
86                   no: "Don't require"
87             - staff to choose which checkouts to show before running the overdues report.
88         -
89             - pref: DisplayClearScreenButton
90               choices:
91                   yes: Show
92                   no: "Don't show"
93             - a button to clear the current patron from the screen on the circulation screen.
94         -
95             - pref: RecordLocalUseOnReturn
96               choices:
97                   yes: Record
98                   no: "Don't record"
99             - local use when an unissued item is checked in.
100         -
101             - When an empty barcode field is submitted in circulation
102             - pref: CircAutoPrintQuickSlip
103               choices:
104                   clear: "clear the screen"
105                   qslip: "open a print quick slip window"
106                   slip: "open a print slip window"
107             - .
108         -
109             - Include the stylesheet at
110             - pref: NoticeCSS
111               class: url
112             - on Notices. (This should be a complete URL, starting with <code>http://</code>)
113         -
114             - pref: UpdateTotalIssuesOnCirc
115               choices:
116                   yes: Do
117                   no: "Do not"
118             - 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).
119         -
120             - Use the
121             - pref: ExportWithCsvProfile
122             - CSV profile when exporting patron checkout history (enter CSV Profile name)
123         -
124             - The following fields should be excluded from the patron checkout history CSV or iso2709 export
125             - pref: ExportRemoveFields
126             - (separate fields with space, e.g. 100a 200b 300c)
127         -
128             - pref: AllowOfflineCirculation
129               choices:
130                   yes: Enable
131                   no: "Do not enable"
132             - "offline circulation on regular circulation computers. (NOTE: This system preference does not affect the Firefox plugin or the desktop application)"
133
134     Checkout Policy:
135         -
136             - pref: AllowTooManyOverride
137               choices:
138                   yes: Allow
139                   no: "Don't allow"
140             - staff to override and check out items when the patron has reached the maximum number of allowed checkouts.
141         -
142             - pref: AutoRemoveOverduesRestrictions
143               choices:
144                   yes: "Do"
145                   no: "Do not"
146             - allow OVERDUES restrictions triggered by sent notices to be cleared automatically when all overdue items are returned by a patron.
147         -
148             - pref: AllowNotForLoanOverride
149               choices:
150                   yes: Allow
151                   no: "Don't allow"
152             - staff to override and check out items that are marked as not for loan.
153         -
154             - pref: AllowRenewalLimitOverride
155               choices:
156                   yes: Allow
157                   no: "Don't allow"
158             - 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.
159         -
160             - pref: AllowItemsOnHoldCheckout
161               choices:
162                   yes: Allow
163                   no: "Don't allow"
164             - checkouts of items reserved to someone else. If allowed do not generate RESERVE_WAITING and RESERVED warning. This allows self checkouts for those items.
165         -
166             - pref: AllFinesNeedOverride
167               choices:
168                   yes: Require
169                   no: "Don't require"
170             - staff to manually override all fines, even fines less than noissuescharge.
171         -
172             - pref: AllowFineOverride
173               choices:
174                   yes: Allow
175                   no: "Don't allow"
176             - staff to manually override and check out items to patrons who have more than noissuescharge in fines.
177         -
178             - pref: InProcessingToShelvingCart
179               choices:
180                   yes: Move
181                   no: "Don't move"
182             - items that have the location PROC to the location CART when they are checked in.
183         -
184             - pref: ReturnToShelvingCart
185               choices:
186                   yes: Move
187                   no: "Don't move"
188             - all items to the location CART when they are checked in.
189         -
190             - pref: AutomaticItemReturn
191               choices:
192                   yes: Do
193                   no: "Don't"
194             - automatically transfer items to their home library when they are returned.
195         -
196             - pref: UseBranchTransferLimits
197               choices:
198                   yes: Enforce
199                   no: "Don't enforce"
200             - library transfer limits based on
201             - pref: BranchTransferLimitsType
202               choices:
203                   ccode: collection code
204                   itemtype: item type
205             - .
206         -
207             - pref: UseTransportCostMatrix
208               choices:
209                   yes: Use
210                   no: "Don't use"
211             - Transport Cost Matrix for calculating optimal holds filling between branches.
212         -
213             - Use the checkout and fines rules of
214             - pref: CircControl
215               type: choice
216               choices:
217                   PickupLibrary: the library you are logged in at.
218                   PatronLibrary: the library the patron is from.
219                   ItemHomeLibrary: the library the item is from.
220         -
221             - Use the checkout and fines rules of
222             - pref: HomeOrHoldingBranch
223               type: choice
224               choices:
225                   homebranch: the library the item is from.
226                   holdingbranch: the library the item was checked out from.
227         -
228             - Allow materials to be returned to
229             - pref: AllowReturnToBranch
230               type: choice
231               choices:
232                   anywhere: to any library.
233                   homebranch: only the library the item is from.
234                   holdingbranch: only the library the item was checked out from.
235                   homeorholdingbranch: either the library the item is from or the library it was checked out from.
236         -
237             - For search results in the staff client, display the branch of
238             - pref: StaffSearchResultsDisplayBranch
239               type: choice
240               choices:
241                   homebranch: the library the item is from.
242                   holdingbranch: the library the item is held by.
243         -
244             - Calculate the due date using 
245             - pref: useDaysMode
246               choices:
247                   Days: circulation rules only.
248                   Calendar: the calendar to skip all days the library is closed.
249                   Datedue: the calendar to push the due date to the next open day
250         -
251             - When renewing checkouts, base the new due date on
252             - pref: RenewalPeriodBase
253               choices:
254                   date_due: the old due date of the checkout.
255                   now: the current date.
256         -
257             - pref: RenewalSendNotice
258               choices:
259                   yes: Send
260                   no: "Don't send"
261             - a renewal notice according to patron checkout alert preferences.
262         -
263             - Prevent patrons from making holds on the OPAC if they owe more than
264             - pref: maxoutstanding
265               class: currency
266             - '[% local_currency %] in fines.'
267         -
268             - Show a warning on the "Transfers to Receive" screen if the transfer has not been received
269             - pref: TransfersMaxDaysWarning
270               class: integer
271             - days after it was sent.
272         -
273             - pref: IssuingInProcess
274               choices:
275                   yes: "Don't prevent"
276                   no: "Prevent"
277             - patrons from checking out an item whose rental charge would take them over the limit.
278         -
279             - "Restrict patrons with the following target audience values from checking out inappropriate materials:"
280             - pref: AgeRestrictionMarker
281             - "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."
282         -
283             - pref: AgeRestrictionOverride
284               choices:
285                   yes: Allow
286                   no: "Don't allow"
287             - staff to check out an item with age restriction.
288         -
289             - Prevent patrons from checking out books if they have more than
290             - pref: noissuescharge
291               class: integer
292             - '[% local_currency %] in fines.'
293         -
294             - pref: RentalsInNoissuesCharge
295               choices:
296                   yes: Include
297                   no: "Don't include"
298             - rental charges when summing up charges for noissuescharge.
299         -
300             - pref: ManInvInNoissuesCharge
301               choices:
302                   yes: Include
303                   no: "Don't include"
304             - MANUAL_INV charges when summing up charges for noissuescharge.
305         -
306             - pref: HoldsInNoissuesCharge
307               choices:
308                   yes: Include
309                   no: "Don't include"
310             - hold charges when summing up charges for noissuescharge.
311         -
312             - pref: ReturnBeforeExpiry
313               choices:
314                   yes: Require
315                   no: "Don't require"
316             - "patrons to return books before their accounts expire (by restricting due dates to before the patron's expiration date)."
317         -
318             - Send all notices as a BCC to this email address
319             - pref: OverdueNoticeBcc
320         -
321             - pref: OverdueNoticeCalendar
322               choices:
323                   yes: "Use Calendar"
324                   no: "Ignore Calendar"
325             - when working out the period for overdue notices
326         -
327             - Include up to
328             - pref: PrintNoticesMaxLines
329               class: integer
330             - "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."
331         -
332             - pref: OverduesBlockCirc
333               choices:
334                   block: Block
335                   noblock: "Don't block"
336                   confirmation: Ask for confirmation
337             - when checking out to a borrower that has overdues outstanding
338         -
339             - "When checking out an item with rental fees, "
340             - pref: RentalFeesCheckoutConfirmation
341               choices:
342                   yes: ask
343                   no: "do not ask"
344             - "for confirmation."
345         -
346             - By default, set the LOST value of an item to
347             - pref: DefaultLongOverdueLostValue
348               class: integer
349             - when the item has been overdue for more than
350             - pref: DefaultLongOverdueDays
351               class: integer
352             - days.
353             - <br>WARNING â€” These preferences will activate the automatic item loss process. Leave these fields empty if you don't want to activate this feature.
354             - "<br>Example: [1] [30] Sets an item to the LOST value 1 when it has been overdue for more than 30 days."
355             - <br>(Used when the longoverdue.pl script is called without the --lost parameter)
356         -
357             - "Charge a lost item to the borrower's account when the LOST value of the item changes to :"
358             - pref: DefaultLongOverdueChargeValue
359               class: integer
360             - <br>Leave this field empty if you don't want to charge the user for lost items.
361             - <br>(Used when the longoverdue.pl script is called without the --charge parameter)
362         -
363             - "When issuing an item that has been marked as lost, "
364             - pref: IssueLostItem
365               choices:
366                   confirm: "require confirmation"
367                   alert: "display a message"
368                   nothing : "do nothing"
369             - .
370         -
371             - pref: AllowMultipleIssuesOnABiblio
372               choices:
373                   yes: Allow
374                   no: "Don't allow"
375             - "patrons to check out multiple items from the same record.  (NOTE: This will only effect records without a subscription attached.)"
376         -
377             - pref: OnSiteCheckouts
378               choices:
379                   yes: Enable
380                   no: Disable
381             - the on-site checkouts feature.
382         -
383             - pref: OnSiteCheckoutsForce
384               choices:
385                   yes: Enable
386                   no: Disable
387             - the on-site for all cases (Even if a user is debarred, etc.).
388         -
389             - pref: ConsiderOnSiteCheckoutsAsNormalCheckouts
390               choices:
391                   yes: Consider
392                   no: "Don't consider"
393             - on-site checkouts as normal checkouts.
394             - If enabled, the number of checkouts allowed will be normal checkouts + on-site checkouts.
395             - If disabled, both values will be checked separately.
396         -
397             - When a patron's checked out item is overdue,
398             - pref: OverduesBlockRenewing
399               type: choice
400               choices:
401                   allow: allow renewing.
402                   blockitem: block renewing only for this item.
403                   block: block renewing for all the patron's items.
404         -
405             - If patron is restricted,
406             - pref: RestrictionBlockRenewing
407               choices:
408                   yes: Block
409                   no: Allow
410             - renewing of items.
411     Checkin Policy:
412         -
413             - pref: BlockReturnOfWithdrawnItems
414               choices:
415                   yes: Block
416                   no: "Don't block"
417             - returning of items that have been withdrawn.
418         -
419             - pref: CalculateFinesOnReturn
420               choices:
421                   yes: Do
422                   no: "Don't"
423             - calculate and update overdue charges when an item is returned.
424             - <br /><b>NOTE If you are doing hourly loans then you should have this on.</b>
425         -
426             - pref: UpdateNotForLoanStatusOnCheckin
427               type: textarea
428               class: code
429             - 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
430             - "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."
431             - Each pair of values should be on a separate line.
432     Holds Policy:
433         -
434             - pref: AllowRenewalIfOtherItemsAvailable
435               choices:
436                   yes: Allow
437                   no: "Don't allow"
438             - a patron to renew an item with unfilled holds if other available items can fill that hold.
439         -
440             - pref: AllowHoldPolicyOverride
441               choices:
442                   yes: Allow
443                   no: "Don't allow"
444             - staff to override hold policies when placing holds.
445         -
446             - pref: AllowHoldsOnDamagedItems
447               choices:
448                   yes: Allow
449                   no: "Don't allow"
450             - hold requests to be placed on and filled by damaged items.
451         -
452             - pref: AllowHoldDateInFuture
453               choices:
454                   yes: Allow
455                   no: "Don't allow"
456             - hold requests to be placed that do not enter the waiting list until a certain future date.
457         -
458             - pref: OPACAllowHoldDateInFuture
459               choices:
460                   yes: Allow
461                   no: "Don't allow"
462             - "patrons to place holds that don't enter the waiting list until a certain future date. (AllowHoldDateInFuture must also be enabled)."
463         -
464             - Confirm future hold requests (starting no later than
465             - pref: ConfirmFutureHolds
466               class: integer
467             - 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.
468         -
469             - Check the
470             - pref: ReservesControlBranch
471               choices:
472                   ItemHomeLibrary: "item's home library"
473                   PatronLibrary: "patron's home library"
474             - to see if the patron can place a hold on the item.    
475         -
476             - Mark a hold as problematic if it has been waiting for more than
477             - pref: ReservesMaxPickUpDelay
478               class: integer
479             - days.
480         -
481             - pref: ExpireReservesMaxPickUpDelay
482               choices:
483                   yes: Allow
484                   no: "Don't allow"
485             - "holds to expire automatically if they have not been picked by within the time period specified in ReservesMaxPickUpDelay"
486         -
487             - If using ExpireReservesMaxPickUpDelay, charge a borrower who allows his or her waiting hold to expire a fee of
488             - pref: ExpireReservesMaxPickUpDelayCharge
489               class: currency
490         -
491             - Satisfy holds from the libraries
492             - pref: StaticHoldsQueueWeight
493               class: multi
494             - (as branchcodes, separated by commas; if empty, uses all libraries)
495             - pref: RandomizeHoldsQueueWeight
496               choices:
497                   yes: in random order.
498                   no: in that order.
499             -
500         -
501             - pref: canreservefromotherbranches
502               choices:
503                   yes: Allow
504                   no: "Don't allow (with independent branches)"
505             - a user from one library to place a hold on an item from another library
506         -
507             - pref: OPACAllowUserToChooseBranch
508               choices:
509                   yes: Allow
510                   no: "Don't allow"
511             - a user to choose the library to pick up a hold from.
512         -
513             - pref: ReservesNeedReturns
514               choices:
515                   yes: "Don't automatically"
516                   no: Automatically
517             - mark a hold as found and waiting when a hold is placed on a specific item and that item is already checked in.
518         -
519             - Patrons can only have
520             - pref: maxreserves
521               class: integer
522             - holds at once.
523         -
524             - pref: emailLibrarianWhenHoldIsPlaced
525               choices:
526                   yes: Enable
527                   no:  "Don't enable"
528             - "sending an email to the Koha administrator email address whenever a hold request is placed."
529         -
530             - pref: DisplayMultiPlaceHold
531               choices:
532                   yes: Enable
533                   no:  "Don't enable"
534             - "the ability to place holds on multiple biblio from the search results"       
535         -
536             - pref: TransferWhenCancelAllWaitingHolds
537               choices:
538                   yes: Transfer
539                   no: "Don't transfer"
540             - items when cancelling all waiting holds.
541         -
542             - pref: AutoResumeSuspendedHolds
543               choices:
544                   yes: Allow
545                   no: "Don't allow"
546             - suspended holds to be automatically resumed by a set date.
547         -
548             - pref: SuspendHoldsIntranet
549               choices:
550                   yes: Allow
551                   no: "Don't allow"
552             - holds to be suspended from the intranet.
553         -
554             - pref: SuspendHoldsOpac
555               choices:
556                   yes: Allow
557                   no: "Don't allow"
558             - holds to be suspended from the OPAC.
559         -
560             - pref: ExpireReservesOnHolidays
561               choices:
562                   yes: Allow
563                   no: "Don't allow"
564             - expired holds to be canceled on days the library is closed.
565         -
566             - pref: decreaseLoanHighHolds
567               choices:
568                   yes: Enable
569                   no:  "Don't enable"
570             - the reduction of loan period to
571             - pref: decreaseLoanHighHoldsDuration
572               class: integer
573             - days for items with more than
574             - pref: decreaseLoanHighHoldsValue
575               class: integer
576             - holds.
577         -
578             - pref: AllowHoldsOnPatronsPossessions
579               choices:
580                   yes: Allow
581                   no: "Don't allow"
582             - a patron to place a hold on a record where the patron already has one or more items attached to that record checked out.
583         -
584             - pref: LocalHoldsPriority
585               choices:
586                   yes: Give
587                   no: "Don't give"
588             - priority for filling holds to patrons whose
589             - pref: LocalHoldsPriorityPatronControl
590               choices:
591                   PickupLibrary: "pickup library"
592                   HomeLibrary: "home library"
593             - matches the item's
594             - pref: LocalHoldsPriorityItemControl
595               choices:
596                   homebranch: "home library"
597                   holdingbranch: "holding library"
598     Fines Policy:
599         -
600             - Calculate fines based on days overdue
601             - pref: finesCalendar
602               type: choice
603               choices:
604                   ignoreCalendar: directly.
605                   noFinesWhenClosed: not including days the library is closed.
606             -
607         -
608             - pref: finesMode
609               type: choice
610               choices:
611                   off: "Don't calculate"
612                   test: Calculate (but only for mailing to the admin)
613                   production: Calculate and charge
614             - fines (when <code>misc/cronjobs/fines.pl</code> is being run).
615             - <br><b>Note:</b> Fines can also be charged by the CalculateFinesOnReturn system preference.
616         -
617             - pref: RefundLostItemFeeOnReturn
618               choices:
619                   yes: Refund
620                   no: "Don't refund"
621             - lost item fees charged to a borrower when the lost item is returned.
622         -
623             - pref: FinesIncludeGracePeriod
624               choices:
625                   yes: Include
626                   no: "Don't include"
627             - the grace period when calculating the fine for an overdue item.
628         -
629             - pref: WhenLostForgiveFine
630               choices:
631                   yes: Forgive
632                   no: "Don't Forgive"
633             - the fines on an item when it is lost.
634         -
635             - pref: WhenLostChargeReplacementFee
636               choices:
637                   yes: Charge
638                   no: "Don't Charge"
639             - the replacement price when a patron loses an item.
640         -
641             - pref: HoldFeeMode
642               choices:
643                   always: Always
644                   not_always: "Don't always"
645             - Charge fee when a hold is placed.
646     Self Checkout:
647         -
648             - "Include the following JavaScript on all pages in the web-based self checkout:"
649             - pref: SCOUserJS
650               type: textarea
651               class: code
652         -
653             - "Include the following CSS on all pages in the web-based self checkout:"
654             - pref: SCOUserCSS
655               type: textarea
656               class: code
657         -
658             - pref: ShowPatronImageInWebBasedSelfCheck
659               choices:
660                   yes: Show
661                   no: "Don't show"
662             - "the patron's picture (if one has been added) when they use the web-based self checkout."
663         -
664             - pref: WebBasedSelfCheck
665               choices:
666                   yes: Enable
667                   no: "Don't enable"
668             - "the web-based self checkout system. (available at: /cgi-bin/koha/sco/sco-main.pl)"
669         -
670             - Have patrons login into the web-based self checkout system with their 
671             - pref: SelfCheckoutByLogin
672               choices:
673                   yes: Username and Password
674                   no: Barcode
675         -
676             - "Time out the current patron's web-based self checkout system login after"
677             - pref: SelfCheckTimeout
678               class: integer
679             - seconds.
680         -
681             - pref: AllowSelfCheckReturns
682               choices:
683                   yes: Allow
684                   no: "Don't allow"
685             - patrons to return items through web-based self checkout system. 
686         -
687             - "Include the following HTML in the Help page of the web-based self checkout system:"
688             - pref: SelfCheckHelpMessage
689               type: htmlarea
690               class: code
691         -
692             - pref: AutoSelfCheckAllowed
693               choices:
694                   yes: Allow
695                   no: "Don't allow"
696             - "the web-based self checkout system to automatically login with this staff login"
697             - pref: AutoSelfCheckID
698             - and this password
699             - pref: AutoSelfCheckPass
700             - .
701         -
702             - pref: SelfCheckReceiptPrompt
703               choices:
704                   yes: Show
705                   no: "Don't show"
706             - "the print receipt popup dialog when self checkout is finished"
707     Course Reserves:
708         -
709             - pref: UseCourseReserves
710               choices:
711                   yes: Use
712                   no: "Don't use"
713             - course reserves
714     Batch checkout:
715         -
716             - pref: BatchCheckouts
717               choices:
718                   yes: Allow
719                   no: "Don't allow"
720             - "batch checkouts"
721         -
722             - "Patron categories allowed to checkout in a batch"
723             - pref: BatchCheckoutsValidCategories
724             - "(list of patron categories separated with a pipe '|')"