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